Teads
Datafly Signal sends page views and conversions to Teads server-to-server through the Teads Conversion API, attributed by the Teads click ID.
Prerequisites
Generate a Conversion API token
In Teads Ads Manager open the settings panel and generate the Conversion API token.
Find your Buyer Pixel ID
The numeric Buyer Pixel ID is shown in Teads Ads Manager.
Keep the click parameter
Teads adds dicbo (or auctid) to landing URLs. Signal needs it to report an event.
Configure in Signal
Configuration Fields
| Field | Required | Description |
|---|---|---|
pixel_id | Yes | Your numeric Teads Buyer Pixel ID, visible in Teads Ads Manager. Sent as buyer_pixel_id. |
api_token | Yes | The Conversion API token generated in the Teads Ads Manager settings panel. Sent as a Bearer token. |
Management UI Setup
- Go to Integrations > Add Integration > Teads.
- Choose a preset: Default (
default), Retail (ecommerce), Lead Generation (lead_gen), Insurance (insurance). - Fill in the fields above and click Save.
Request format
POST https://ca.teads.tv/v1/event
{
"action": "conversion",
"buyer_pixel_id": "123456",
"click_id": "dicbo-777",
"conversion_params": {
"currency": "GBP",
"price": 259.99
},
"conversion_type": "Purchase",
"environment": "server-gtm",
"event_source_url": "https://shop.example.co.uk/checkout/done?x=1",
"event_time": 1758500000123,
"privacy": {
"consent_granted": true
}
}click_id, action (pageView or conversion), buyer_pixel_id, conversion_type (on conversions), conversion_params (price, currency), event_source_url, event_time (milliseconds), environment and privacy.consent_granted. https://ca.teads.tv/v1/test/event validates a payload.
Event Mapping
| Signal event | Vendor event | Presets |
|---|---|---|
page | pageView | Default, Retail, Lead Generation, Insurance |
view_item | ViewContent | Default, Retail |
search | Search | Default, Retail |
add_to_cart | AddToCart | Default, Retail |
begin_checkout | InitiateCheckout | Default, Retail |
purchase | Purchase | Default, Retail, Insurance |
generate_lead | Lead | Default, Retail, Lead Generation |
sign_up | CompleteRegistration | Default, Retail, Lead Generation |
add_to_wishlist | AddToWishlist | Retail |
lead_submitted | Lead | Lead Generation |
quote_requested | Lead | Insurance |
quote_completed | Lead | Insurance |
Signal forwards properties the preset does not map unless the integration’s strict output contract is on. Turn on strict_output_contract for this integration so only the documented fields are sent.
Identity
Attribution is by the Teads click ID only; events without it are not sent. No personal data is sent. The collector does not capture dicbo/auctid yet (#1449).
Consent
Teads is an advertising destination and requires marketing consent by default. privacy.consent_granted carries the visitor’s marketing consent.
Troubleshooting
| Problem | Solution |
|---|---|
| Events dropped in Signal | The visitor has no Teads click ID. |
Blueprint
The Teads blueprint version is 0.5.0. It was last reviewed against the vendor’s documentation on 2026-09-22.