Get started with Dreamdata
How to invite your colleagues to 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.
Onboarding for paying customers [VIDEO]
Onboarding process for free customers [VIDEO]
Setting Up Dreamdata
Single sign-on
The Onboarding Process
What is Dreamdata? [VIDEO]
Dashboards
Home
Engagement
Content Reporting
Analytics
Performance
Content Performance - Dashboard Options
Which channel performs best for different content?
Which content generates pipeline?
Measuring influenced pipeline for B2B content - the true conversion metric
Setup Content Reporting
What KPI to measure the effect of B2B content?
Performance
Paid
Ad Spend
Bing Ads
Capterra Ads
Facebook Ads
G2 Crowd
Google Display Ads
Google Search Ads
LinkedIn Ads
Overview
Return on Ads Spend
YouTube Ads
Organic
Acquisition
Conversions
Performance vs. Revenue attribution: A guide on when to use what
Web Traffic
Journeys
Revenue Analytics
Data Platform
Sources
Albacross
Clearbit Reveal
Custom Integration
Import cost data using Google Sheet
Importing historical data to Dreamdata using Google Sheets
RollWorks Site Traffic Revealer
Setting up AdRoll
Setting up Bing Ads
Setting up Capterra
Setting up Close
Setting up Data Export to BigQuery of CRM Properties
Setting up Facebook Ads
Setting up G2 Crowd
Setting up Google Ads
Setting up Google Search
Setting up HubSpot
Setting up Intercom
Setting up LinkedIn Ads
Setting up Marketo
Setting up Microsoft Dynamics
Setting up Pardot
Setting up Pipedrive
Setting up Salesforce
Setting up Twitter Ads
Setting up Zapier integration & Zaps for Lead Gen forms/Lead Ads
Setting up Zendesk Sell
Setting up Zoho CRM
Triblio ABM platform
Destinations
Connect to AWS Redshift using AWS Glue
Connect your Dreamdata data to Amazon Redshift
Connect your Dreamdata data to Snowflake
Getting Started with Google Data Studio Templates
Google BigQuery
Google Cloud Storage
Google Connected Sheets
Guides for Google Data Studio Reporting
LinkedIn Offline Conversion
Data Enrichment
Intent data
Overview
Table Schema
General Settings
Tracking
Segment
Advanced Identification of users and companies
Anonymizing IP
Calendly
Cookie Bar
Cookie Retention
Dreamdata Cookies
Form Tracking
How does Dreamdata track all relevant on-site customer data?
How to track your emails?
Pardot iframe form tracking
Query parameters
Reduce impact from ad-blockers and Apple ITP 2.x
Server Side Analytics APIs
Tracking Hubspot Forms with auto-identify script
Tracking SPAs (Single Page Applications)
Tracking iframes with auto-identify script
Tracking using Sleeknote or Drift
Allowed Domains
Menu: Settings
Setting up your customised Stage Models
Setting up your default Stage Models
UTM Mapping
FAQ
Can I exclude content or websites from being tracked?
Categories
Roles and Permissions
Some of my deals are flagged with "no-tracking". What does it mean?
What does Visitors, Contacts and Companies mean?
What is a Stage Model?
What is a company in Dreamdata?
What is a session?
Why are my dashboards empty?
Agency Partners
Contact
Ideal Customer Profile
Intro Template for your new clients
Partner Material
Partner Tiers
Referral Guide and UTM tracking
Welcome Partner!
Quick learning videos!
Are you using G2?
Do you know how your company is generating money?
Do you know which of your Marketing activities had the biggest impact on pipeline and revenue?
Dreamdata Content Analytics: Discover the real value of your content
Find the content that generates most pipeline
Helping BDRs break through to the hottest accounts
How Content Analytics tracks the influence of content of pipeline and revenue
How to cut the cost of your Google Search Ads
How to easily build a retargeting audience with Dreamdata
How to see the value of B2B Google Ads in pipeline and revenue generated
How to set up content categories on Dreamdata
Performance vs. Revenue Analytics reports- when to apply them best!
See the value of SEO in pipeline and revenue generated
What attribution really is and why you should care!
Which of your emails produce pipeline and revenue?
- 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