Outbrain Ads
Datafly Signal delivers conversion events to Outbrain server-to-server for native advertising attribution, campaign optimisation, and audience targeting across premium publisher networks.
This blueprint is currently in alpha.
Prerequisites
Before configuring Outbrain in Signal, you need:
- An Outbrain Amplify account with API access
- Your Marketer ID
- An API token for the Amplify API
Get your Outbrain credentials
- Sign in to Outbrain Amplify.
- Your Marketer ID is shown in the URL of the dashboard and on the account settings page.
- Generate an API token under Account settings → API access (or request one from your Outbrain account manager if not visible).
See Outbrain’s developer documentation for details.
Configure the integration in Signal
- In the Management UI, go to Integrations → Add Integration.
- Select Outbrain Ads from the catalogue.
- Give the integration a name (for your reference).
- Fill in the required fields:
| Field | Required | Description |
|---|---|---|
marketer_id | Yes | Outbrain marketer ID. |
api_token | Yes | Outbrain Amplify API token. |
- Choose which pipeline(s) this integration should run on.
- Select consent categories (defaults to marketing).
- Click Save.
Event mapping
| Signal event | Outbrain event |
|---|---|
page | page_view |
Product Viewed | view_content |
Product Added | add_to_cart |
Order Completed | purchase |
To customise, edit the integration’s Field Mappings.
Identity
Signal sends the following identity signals to Outbrain, subject to consent and availability:
| Capability | Notes |
|---|---|
| Click ID | ob_click_id from the URL |
| Hashed email | SHA-256 (lowercase, trimmed) |
| Outbrain user ID | Where available via the Outbrain sync |
| Client IP / User-Agent | Forwarded from the original request |
Consent
This integration is gated on the marketing canonical consent category.
Verify it’s working
- In the Management UI, open Pipelines → your pipeline → Live Events and trigger a test event.
- The event appears in the live feed; inspect the payload.
- Check the Conversions view in the Outbrain Amplify dashboard.
Troubleshooting
Events not attributed to a campaign.
Confirm Datafly.js is capturing ob_click_id from the landing URL and that the user reached the conversion in the same session.
401 Unauthorized.
Regenerate the API token in Outbrain and update the integration.