Dreamdata
Datafly Signal sends page, track, identify and group messages to Dreamdata’s server-side Events API (Segment tracking spec) for B2B revenue attribution.
Prerequisites
Create a server-side source
In Dreamdata, open Data Platform > Sources > Server Side Analytics APIs and copy the Source API key. Signal sends it as the HTTP Basic username with an empty password.
Call identify and group
Dreamdata links contacts to companies from identify traits (email) and group traits (website or domain). Call datafly.identify() when a visitor is known and datafly.group() for their account.
Configure in Signal
Configuration Fields
| Field | Required | Description |
|---|---|---|
api_key | Yes | Your Dreamdata Source API key. Found in the Dreamdata platform under Data Platform > Sources > Server Side Analytics APIs. Used as the HTTP Basic auth username with an empty password. |
Management UI Setup
- Go to Integrations > Add Integration > Dreamdata.
- Choose a preset: Default (
default), B2B / SaaS (saas), Lead Generation (lead_gen). - Fill in the fields above and click Save.
Request format
An identify call:
POST https://api.dreamdata.cloud/v1/batch
{"batch":[{"anonymousId":"df_anon_t1","context":{"campaign":{"medium":"email","name":"autumn","source":"newsletter"},"ip":"203.0.113.9","locale":"en-GB","page":{"referrer":"https://www.example.com/","title":"Order complete","url":"https://shop.example.co.uk/checkout/done?x=1"},"userAgent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)"},"event":"identify","messageId":"msg-t1-1","timestamp":"2025-09-22T00:13:20Z","traits":{"company":"Acme Ltd","email":"jane.doe@example.com","firstName":"Jane","lastName":"Doe","name":"Jane Doe","title":"Head of Growth"},"type":"identify","userId":"crm-user-9"}]}Track and page messages carry the same context (IP, user agent, page, campaign) and no traits.
Event Mapping
| Signal event | Vendor event | Presets |
|---|---|---|
page | page | Default, B2B / SaaS, Lead Generation |
identify | identify | Default, B2B / SaaS, Lead Generation |
group | group | Default, B2B / SaaS, Lead Generation |
sign_up | sign_up | Default, B2B / SaaS, Lead Generation |
login | login | Default, B2B / SaaS |
generate_lead | lead_generated | Default, B2B / SaaS, Lead Generation |
purchase | purchase | Default |
demo_requested | demo_requested | B2B / SaaS, Lead Generation |
content_viewed | content_viewed | B2B / SaaS |
content_downloaded | content_downloaded | B2B / SaaS, Lead Generation |
trial_started | trial_started | B2B / SaaS |
trial_converted | trial_converted | B2B / SaaS |
subscription_started | subscription_started | B2B / SaaS |
Identity
Messages carry userId (your user ID) and anonymousId; messages with neither are not sent. Identify traits (email, first and last name, name, company, title) are sent raw by design: Dreamdata matches the email domain to the company website, which a hash cannot provide.
Consent
The Dreamdata API has no consent field. Assign a consent category to the integration in Signal to gate delivery.
Troubleshooting
| Problem | Solution |
|---|---|
| Contacts not matched to companies | Call identify with an email (free-mail domains are ignored) and group with the account’s website or domain. |
Blueprint
The Dreamdata blueprint version is 0.6.0. It was last reviewed against the vendor’s documentation on 2026-09-23.