Teads

Datafly Signal delivers conversion events to Teads server-to-server for outstream video and display ad attribution, viewability measurement, and campaign performance optimisation.

Prerequisites

Before configuring Teads in Signal, you need a Teads account with a tracking pixel created and API credentials generated.

Create a Teads Account

Go to teads.com and contact the sales team or your Teads account representative to set up an advertiser account.
Once your account is provisioned, log in to Teads Ad Manager at admanager.teads.com.
Note your Advertiser ID from Advertiser Settings.

Teads operates on a managed service model for new advertisers. Contact your Teads representative if you do not yet have access to Teads Ad Manager.

Create a Tracking Pixel

In Teads Ad Manager, navigate to Pixels > Manage in the left sidebar.
Click Create Pixel to set up a new tracking pixel.
Name your pixel (e.g. “Website Conversions”) and configure the conversion type.
Note the Pixel ID — you will need this for Signal configuration.

Get API Credentials

In Teads Ad Manager, go to Settings > API.
Click Generate API Key to create credentials for server-side event delivery.
Copy the API Key immediately — it may only be shown once.

⚠️

Store the API key securely. If you lose it, you will need to generate a new one.

Configure in Signal

Now that you have your Advertiser ID, Pixel ID, and API key, configure the integration in Signal.

Configuration Fields

Field	Required	Description
`advertiser_id`	Yes	Your Teads advertiser ID. Found in Teads Ad Manager under Advertiser Settings.
`pixel_id`	Yes	Your Teads tracking pixel ID. Found in Teads Ad Manager under Pixels > Manage.
`api_key`	Yes	API key for authenticating server-side event delivery. Generated in Teads Ad Manager under Settings > API.

Management UI Setup

Go to Integrations > Add Integration > Teads.
Enter your advertiser_id, pixel_id, and api_key.
Select consent categories (typically advertising).
Click Save.

Management API Setup

curl -X POST http://localhost:8084/v1/admin/integrations \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "source_id": "src_abc123",
    "vendor": "teads",
    "name": "Teads Production",
    "enabled": true,
    "config": {
      "advertiser_id": "teads-adv-12345",
      "pixel_id": "teads-px-67890",
      "api_key": "ak_teads_abc123..."
    },
    "consent_categories": ["advertising"]
  }'

Event Mapping

Datafly Event	Teads Event	Notes
`page` (page view)	`PageView`	Sent for every page view
`Order Completed`	`Purchase`	Requires `value`, `currency`
`Product Added`	`AddToCart`	Includes product details
`Checkout Started`	`InitiateCheckout`	Includes `value`, `currency`
`Product Viewed`	`ViewContent`	Includes content identifiers
`Lead Generated`	`Lead`	Lead form submission
`Signed Up`	`CompleteRegistration`	User registration
Custom events	Passed through	Sent as custom event name

Testing Your Integration

Step 1: Send a Test Event

Trigger a page view or conversion event on your website.
Check the Signal event debugger in the Management UI to confirm the event was captured and delivered.

Step 2: Verify in Teads Ad Manager

In Teads Ad Manager, go to Pixels > your pixel.
Check the pixel activity log to confirm events are being received.
Events should appear within a few minutes of delivery.

Step 3: Validate Campaign Attribution

Create a test campaign and associate it with your pixel.
Confirm that conversion events are attributed correctly in campaign reports.
Review viewability metrics to ensure ad impressions are tracked alongside conversions.

Troubleshooting

Problem	Solution
Events not appearing in Teads	Verify the `advertiser_id`, `pixel_id`, and `api_key` are correct. Check that the API key has not been revoked.
Authentication errors	Regenerate the API key in Teads Ad Manager under Settings > API and update the integration config in Signal.
Pixel not tracking conversions	Ensure the pixel is associated with an active campaign in Teads Ad Manager.
Events delayed	Teads may take up to 15 minutes to display server-side events. Allow time before investigating further.
`Invalid pixel_id` error	Verify the pixel exists and is active in Teads Ad Manager under Pixels > Manage.

Visit Teads documentation for full API documentation and credential setup instructions.

Snapchat Ads The Trade Desk First-Party Advertiser Data