Connecting a new Taboola datasource
To connect a Taboola datasource you first need to acquire API access from Taboola. Please reach out to your Taboola contact to acquire this. You will be provided with a Client ID and Client Secret which should both be 32 characters long.
When you connect a new Taboola datasource you will have to decide whether you want your dataset broken down on Site dimensions, Country dimensions or Campaign Item dimensions. This is because how the data is structured at Taboola. If you want more than one of them you need to create separate connections - one for each of the dimensions.
Campaign item breakdown report limitation
Please note that if you choose the Campaign item breakdown report and you have more than 500 items in a campaign, the dataset we are downloading may be incomplete. This endpoint in the Taboola API does not offer any pagination but rather always returns the 500 top ranked campaign items and this is not something we are able to affect.
So if you have 600 items for a campaign we will only be able to provide you with the top 500 ranked items, and the remaining 100 will not be available. Unless these 100 items all have zero valued metrics, the totals will not add up with the other reports.
Metric & Dimensions
Depending on the report type you've chosen for your datasource the dimensions available for you data will differ. However, the metrics are identical for all three reports except Conversion breakdown. Below you will see what dimensions and metrics that are available.
All of the metrics below are available regardless of the report type chosen
- [Metric] Actions
- [Metric] Clicks
- [Metric] Impressions
- [Metric] Visible impressions
- [Metric] Spent
Dimensions - shared for all reports
All of the dimensions below are available regardless of the report type chosen
- [Dimension] Account ID
- [Dimension] Campaign ID
- [Dimension] Campaign Name
- [Dimension] Date
Dimensions - Site breakdown
For the Site breakdown report you will additionally from the shared dimensions have these dimensions to look at
- [Dimension] Site
- [Dimension] Site ID
- [Dimension] Site Name
Dimensions - Country breakdown
For the Country breakdown report you will additionally from the shared dimensions have these dimensions to look at
- [Dimension] Country Code
- [Dimension] Country Name
Dimensions - Campaign Item breakdown
For the Campaign item breakdown report you will additionally from the shared dimensions have these dimensions to look at.
- [Dimension] Item ID
- [Dimension] Item Name
- [Dimension] Content Provider ID
- [Dimension] Content Provider Name
- [Dimension] URL
- [Dimension] Thumbnail URL
Dimensions - Conversion breakdown
The Conversion breakdown report only contains the shared dimensions
Metrics - Conversion breakdown
The list of metrics for the Conversion breakdown report is dynamic and contain the Conversion metrics you have set up in your account. These can, for example, be 'Lead - FB Content: Conversions (Clicks)' or 'Start Checkout: Conversions (Clicks)'. These fields are limited to numeric and monetary metrics, metrics of type percentage are not collected.
On top of these metrics the Conversion breakdown report also contains the following metrics:
- Visible impressions
- Conversion value
Video campaign data for Taboola
Currently it's not possible to fetch any video campaign data through Taboola's API. Therefore if a Taboola video account is connected in Funnel, it wont fetch any data.
If you are in need of Taboola video campaign data you can submit it as a data request.