Taboola Ads
Datafly Signal delivers conversion events to Taboola server-to-server for native advertising attribution, campaign optimisation, and audience targeting.
This blueprint is currently in alpha.
Prerequisites
Before configuring Taboola in Signal, you need:
- A Taboola Ads advertiser account
- A Backstage API client ID and client secret (OAuth)
- Your advertiser Account ID
Get your Taboola credentials
- Sign in to Taboola Ads.
- Your Account ID is shown in the dashboard URL and on account settings.
- Request a Backstage API application from your Taboola account manager; once issued you receive a Client ID and Client Secret.
- Exchange them for an OAuth access token via the Backstage authentication flow.
Configure the integration in Signal
- In the Management UI, go to Integrations → Add Integration.
- Select Taboola Ads from the catalogue.
- Give the integration a name (for your reference).
- Fill in the required fields:
| Field | Required | Description |
|---|---|---|
account_id | Yes | Taboola advertiser account ID. |
client_id | Yes | Backstage API client ID. |
client_secret | Yes | Backstage API client secret. |
- Choose which pipeline(s) this integration should run on.
- Select consent categories (defaults to marketing).
- Click Save.
Event mapping
| Signal event | Taboola 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 Taboola, subject to consent and availability:
| Capability | Notes |
|---|---|
| Taboola user ID | t_gid from the Taboola sync |
| Hashed email | SHA-256 (lowercase, trimmed) |
| 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 sent to Taboola.
- Check Reports → Conversions in the Taboola Ads dashboard.
Troubleshooting
401 Unauthorized.
Confirm the client ID/secret are still valid in Backstage and that the resulting access token has the conversion-upload scope.
Missing t_gid on events.
Taboola’s t_gid is set by their own sync; if you have no t_gid traffic, attribution falls back to hashed email / IP / UA.