Get started with Dreamdata
What is Dreamdata? [VIDEO]
Setting Up Dreamdata
How to set up Dreamdata Web tracking (analytics.js) manually
How to set up up Dreamdata web tracking (analytics.js) using Google Tag Manager
How to track forms adding the auto-identify script via Google Tag Manager.
The Onboarding Process
Onboarding process for free customers [VIDEO]
Onboarding for paying customers [VIDEO]
Single sign-on
How to invite your colleagues to Dreamdata
Dashboards
Home
Engagement
Performance
Content Performance
Analytics
Which channel performs best for different content?
Which content influenced the MQLs created in a time period?
Content Performance - Dashboard Options
Which content generates pipeline?
Measuring influenced pipeline for B2B content - the true conversion metric
What KPI to measure the effect of B2B content?
Setup Content Reporting
Content Analytics - Dashboard Options
Paid
Overview
Ad Spend
Return on Ads Spend
Google Search Ads
Google Display Ads
LinkedIn Ads
Bing Ads
Facebook Ads
YouTube Ads
Capterra Ads
G2 Crowd
Organic
Acquisition
Conversions
Web Traffic
Performance vs. Revenue attribution: A guide on when to use what
Journeys
Revenue Analytics
Data Platform
Sources
Intent Data
Paid
Setting up Facebook Ads
Setting up AdRoll
Setting up Twitter Ads
Setting up Bing Ads
Setting up LinkedIn Ads
Setting up Google Ads
Setting up G2
Setting up Capterra
CRM
Marketing Automation
Import Other
Import fixed cost data using Google Sheet
Importing data not in your CRM (using Google Sheets)
Import cost data using Google Sheet
Custom data
Setting up Outreach
Setting up Zapier integration & Zaps for Lead Ads
Setting up Google Search
Setting up Intercom
Destinations
Ad Network
Data Warehouse
Google BigQuery
Connect to AWS Redshift using AWS Glue
Connect your Dreamdata data to Snowflake
Connect your Dreamdata data to Amazon Redshift
Cloud Storage
Business Intelligence
Guides for Looker Studio Reporting
Getting Started with Looker Studio Templates
Google Connected Sheets
Setting up Data Export to BigQuery of CRM Properties
Overview
Company Data Enrichment
Table Schema
Intent data
General Settings
Tracking
Segment
Dreamdata Cookies
Form Tracking
Reduce impact from ad-blockers and Apple ITP 2.x
Pardot iframe form tracking
Anonymizing IP
Tracking using Sleeknote or Drift
How to track your emails?
Cookie Bar
How does Dreamdata track all relevant on-site customer data?
Cookie Retention
Tracking Hubspot Forms with auto-identify script
Server Side Analytics APIs
URL query parameters
Calendly
Tracking iframes with auto-identify script
Tracking SPAs (Single Page Applications)
Across domain & device tracking
Advanced Identification of users and companies
Stage Models
Setup Guide: All Salesforce Opportunities entering specific Stage
Setup Guide: Creation of Opportunities/Deals
Setup Guide: Tracked sign-up events
Setup Guide: All Hubspot Deals entering specific Stage
Stage Models - Customization
Menu: Settings
Allowed Domains
UTM Mapping
Branded Search filter
CRM-Based Channel and Source in the Absence of Tracking Activity
CRM filters
FAQ
Glossary
Categories
Some of my deals are flagged with "Unknown". What does it mean?
Data retention
Can I exclude content or websites from being tracked?
How are activity mapped to companies?
What does Visitors, Contacts and Companies mean?
What is a session?
Roles and Permissions
What is the reporting Time Zone?
Why are my dashboards empty?
Agency Partners
Welcome Partner!
Partner Tiers
Referral Guide and UTM tracking
Partner Material
Intro Template for your new clients
Ideal Customer Profile
Co-marketing and account mapping
Contact
Quick learning videos!
Find the content that generates most pipeline
How to set up content categories on Dreamdata
Do you know how your company is generating money?
How to see the value of B2B Google Ads in pipeline and revenue generated
How Content Analytics tracks the influence of content of pipeline and revenue
How to easily build a retargeting audience with Dreamdata
Are you using G2?
Performance vs. Revenue Analytics reports- when to apply them best!
What attribution really is and why you should care!
Helping BDRs break through to the hottest accounts
Dreamdata Content Analytics: Discover the real value of your content
Do you know which of your Marketing activities had the biggest impact on pipeline and revenue?
Which of your emails produce pipeline and revenue?
See the value of SEO in pipeline and revenue generated
How to cut the cost of your Google Search Ads
- All Categories
- General Settings
- Tracking
- Server Side Analytics APIs
Server Side Analytics APIs
Updated
by Patrick Madsen
Authentication
Authenticate to the Tracking API by sending your account's Write Key along with a request. Authentication uses HTTP Basic Auth, which involves a username:password
that is base64 encoded and prepended with the string Basic
.
In practice that means taking a Dreamdata source API Key, 'abc123'
, as the username, adding a colon, and then the password field is left empty:
curl -u "abc123:" -X POST https://api.dreamdata.cloud/v1/batch \
-H 'Content-Type: application/json' \
-d ...
Payloads: Track & Identify
The endpoint only supports batch events of up to 500kb worth of data (the total size of the body of the request). The below example shows how to construct such a request with an a couple of identify
and track
events in it:
{
"messageId": "6f47f5a0-4118-42de-9e15-95cf9ed2a426",
"sentAt": "2015-12-02T00:30:08.276Z",
"batch": [
{
"type": "identify",
"messageId":"6ad2be86-6d78-43bd-8a5b-846ddbc042c2",
"userId": "019mr8mf4r",
"traits": {
"email": "jake@yahoo.com",
"name": "Jake Peterson",
"age": 26
},
"context": {
"ip": "24.5.68.47",
"library": {
"name": "customer",
"version": "v1"
},
"campaign": {
"name": "my_campaign",
"source": "demo",
"medium": "calendly",
"term": "",
"content": ""
}
},
"timestamp": "2012-12-02T00:30:08.276Z"
},
{
"type": "track",
"messageId":"3f8236bc-c010-43bb-a341-cd30b5228e9d",
"userId": "019mr8mf4r",
"event": "Song Played",
"properties": {
"name": "Fallin for You",
"artist": "Dierks Bentley"
},
"context": {
"ip": "24.5.68.47",
"library": {
"name": "customer",
"version": "v1"
},
"campaign": {
"name": "my_campaign",
"source": "demo",
"medium": "calendly",
"term": "",
"content": ""
}
},
"timestamp": "2012-12-02T00:30:12.984Z"
},
{
"type": "identify",
"messageId":"8f9b32ce-5809-411b-8b26-c780e4a1cee1",
"anonymousId": "971msfsdfsdfberj8mk7p",
"traits": {
"email": "cindy@example.com",
"name": "Cindy Gonzalez",
"age": 23
},
"context": {
"ip": "24.5.68.47",
"library": {
"name": "customer",
"version": "v1"
},
"campaign": {
"name": "my_campaign",
"source": "demo",
"medium": "calendly",
"term": "",
"content": ""
}
},
"timestamp": "2015-2-02T00:30:08.276Z"
},
{
"type": "track",
"messageId":"092c8cc9-b0f0-48e2-b602-b34d235533d8",
"anonymousId": "971msfsdfsdfberj8mk7p",
"event": "Song Played",
"properties": {
"name": "Get Right",
"artist": "Jennifer Lopez"
},
"context": {
"ip": "24.5.68.47",
"library": {
"name": "customer",
"version": "v1"
},
"campaign": {
"name": "my_campaign",
"source": "demo",
"medium": "calendly",
"term": "",
"content": ""
}
},
"timestamp": "2015-2-02T00:30:12.984Z"
}
]
}
Endpoint
To send a list of events to the Dreamdata Analytics Serverside APIs send a POST request to the following endpoint. The example uses the example payload from above:
curl -u "abc123:" -X POST https://api.dreamdata.cloud/v1/batch \
-H 'Content-Type: application/json' \
-d @example.json
Software Development Kit (SDKs)
Here are the SDKs supported by Dreamdata.
NodeJS SDK
The Node SDK is documented in the public GitHub repository here.
Go SDK
The Go SDK is documented in the public GitHub repository here.
Curl
Combining the above sections into an example payload, and with the above batch payload example written to a file called example.json
, the below would be the curl request that would result in those events being tracked by the dreamdata analytics api:
curl -u "abc123:" -X POST https://api.dreamdata.cloud/v1/batch \
-H 'Content-Type: application/json' \
-d @example.json