Ingest Taboola Campaign Summary (Campaign Day Breakdown) API for deleted campaigns
AnsweredConnector name: Taboola Ads
Table name: Campaign Summary
API documentation link: https://developers.taboola.com/backstage-api/reference/campaign-summary-report
Additional details:
The reason we are raising this request is to extract information for deleted campaigns as well. Currently, all the APIs return information for currently active campaigns, but for any campaigns that has been terminated these are excluded from the API response. Using the above campaign-summary endpoint, we are able to extract information of deleted campaigns. This would be useful for us as we need to report on deleted campaigns as well. The following link contains more information on how we can consume it, we are particularly interested in the campaign-site-day-breakdown dimension.
https://developers.taboola.com/backstage-api/docs/dimensions-cheat-sheet
Sample API curl:
curl --request GET \
--url "https://backstage.taboola.com/backstage/api/1.0/${ACCOUNT_ID}/reports/campaign-summary/dimensions/campaign_site_day_breakdown?start_date=${START_DATE}&end_date=${END_DATE}" \
--header "Authorization: Bearer ${TABOOLA_ACCESS_TOKEN}" \
--header "Accept: application/json"
I hope the requirement is clear. Please do let me know if there is any additional information required.
-
Official comment
Hi Gokul,
Thanks for the detailed write-up and for including the curl example.
I dug into Taboola's Campaign Summary Report API and the Taboola Ads connector's existing behavior. The connector calls this report endpoint and syncs the campaign_site_day_breakdown dimension into the campaign_site_day_report table, but it enumerates campaigns from Taboola's GET /campaigns/ endpoint and requests the report one campaign at a time. Per Taboola's docs, a terminated campaign no longer appears in that campaigns list, so it's never included when the connector builds its per-campaign report requests. That's the root cause of the gap you're describing.
Per the Campaign Summary Report reference, campaign is documented as an optional filter (only start_date/end_date are required), and Taboola's exclude_empty_campaigns changelog states that campaign-breakdown dimensions return all campaigns by default. That suggests an account-level request without a per-campaign filter should include terminated campaigns' delivery data, since the report reflects delivery facts rather than the active campaign list.
I've filed an internal ticket to explore this change. I can't provide a specific timeline for when this will be delivered, but I'll keep you updated. Additional upvotes for this request from other Fivetran users will help increase the prioritiy relative to the rest of our backlog.
Cheers,
Luke
Please sign in to leave a comment.
Comments
1 comment