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. 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] 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 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