Welcome to Taboola's Backstage API hub. You'll find comprehensive guides and documentation to help you start working with the Backstage API as quickly as possible, as well as support if you get stuck. Let's jump right in!
Hi, is there any delay in reporting through API for clicks / spend that took place ? For example, if there's click / spend event that takes place now, how soon is this information available for the reporting API ? Thanks
Posted by Jack Qian 5 days ago
Hi i am making this API call: https://backstage.taboola.com/backstage/api/1.0/1219366/reports/campaign-summary/dimensions/campaign_site_day_breakdown?start_date=2020-05-21&end_date=2020-05-21 and getting this answer back: Array ( [http_status] => 400 [message] => Unknown publisher ) can anyone explain why am i getting this and what am i doing wrong?
Posted by dotan guy 5 days ago
Hi, is campaign reporting (through API) available at the item / thumbnail level? I created items / thumbnails, each with title and URL in the Campaign Inventory. Is there any way to pull campaign reporting at such item / thumbnail level, through the reporting API ? Thanks
Posted by Jack Qian 9 days ago
Hi, We are requesting for this report (reports/campaign-summary/dimensions/campaign_breakdown) several times a day. We request it for 2 time periods: - 1 day - 365 days (to get campaign lifetime spend) I suspect that sometimes, depending on how long it took to respond, the response is not full. It happens randomly when we try to parse the response to json and it fails: `ValueError: Unterminated string starting at: line 1 column 25130053 (char 25130052)` `ValueError: Unterminated string starting at: line 1 column 44233078 (char 44233077)` This suggests the response is incomplete. And indeed, catching the response itself when this happens shows HTTP200 but the response itself is not complete: "..."conversions_value":0.00,"roas":0.00,"ctr":0E-18,"vctr":0E-18,"cpm":0.00,"vcpm":0.00,"cpc":0.00,"campaigns_num":1,"cpa":0.00,"cpa_actions_nu" I do not think this is a timeout from our end as we wait for 360 seconds and the error happens much sooner than that. So I suspect your server cut the response if it happens to take to long, and then I get a partial response. Please advise on how to get this solved... Perhaps there is a way to cut the report to chunks (paged report) or perhaps selecting which dimensions will be returned? (i only want the spend in this case). example request that just failed: GET 'https://backstage.taboola.com/backstage/api/1.0/samyonetwork/reports/campaign-summary/dimensions/campaign_breakdown?start_date=2019-05-27&end_date=2020-05-26' response headers: {'X-Timer': 'S1590508558.250668,VS0,VE5509', 'X-XSS-Protection': '1; mode=block', 'X-Cache': 'MISS', 'X-Content-Type-Options': 'nosniff, nosniff', 'transfer-encoding': 'chunked', 'Accept-Ranges': 'bytes', 'Expires': '0', 'Vary': 'Accept-Encoding', 'X-Served-By': 'cache-bwi5053-BWI', 'Server': 'nginx', 'Connection': 'keep-alive', 'Via': '1.1 varnish', 'X-Cache-Hits': '0', 'Pragma': 'no-cache', 'Cache-Control': 'no-cache, no-store, max-age=0, must-revalidate', 'Date': 'Tue, 26 May 2020 15:56:03 GMT', 'P3P': 'policyref="http://trc.taboola.com/p3p.xml", CP="NOI DSP COR LAW NID CURa ADMa DEVa PSAa PSDa OUR BUS IND UNI COM NAV INT DEM"', 'Content-Type': 'application/json;charset=utf-8', 'X-Frame-Options': 'DENY'}
Posted by Or 11 days ago
Hi there, are the Spend numbers coming from Taboola’s API ever inaccurate, in terms of costs related to real-time clicks? Are they ever ahead or behind, or inflated to predict Spend associated with future clicks? We’re seeing hourly data that reflects the possibility of Spend increasing before the clicks associated with it come through. Also, what time zone Taboola’s API is using? Thanks!
Posted by Justin Farber about a month ago
Are you guys currently experiencing reporting delays with your API? We have several "sub-accounts" within our Taboola account and one of them is not reporting any cost when we query the API for today. Other sub-accounts are returning cost when we query the API for today. Are you aware of any issues and if so, do you have any ETA when this will be resolved? Thanks!
Posted by Raj Kapoor 2 months ago
We have been using the backstage API for a while, and have been able to extract segmentation of conversion according to post click and post view attribution. These metrics came through the following values in the API response: cpa_actions_num_from_clicks cpa_actions_num_from_views Recently, the API response has not provided these values, and we only see cpa_actions_num when it comes to conversions. Checking the platform's UI, it appears the change is reflected there as well. The documentation still references these metrics. Has there been a change in the platform itself or is this a temporary issue? Thanks
Posted by Moshik 2 months ago
It is stated in the documentation that platform and country filters are available for by_hour_of_day dymention https://developers.taboola.com/backstage-api/reference#campaign-summary-dimensions, but they do not work. API returns success response, but the numbers do not change irrespective of the value of the filter Please check the following requests for ad account spine-deforg-sc 1. Request without any filters. curl --location --request GET 'https://backstage.taboola.com/backstage/api/1.0/spine-deforg-sc/reports/campaign-summary/dimensions/by_hour_of_day?start_date=2020-03-09&end_date=2020-03-10' \ --header 'Authorization: {token}' 2. Request with filter platform=DESK. curl --location --request GET 'https://backstage.taboola.com/backstage/api/1.0/spine-deforg-sc/reports/campaign-summary/dimensions/by_hour_of_day?start_date=2020-03-09&end_date=2020-03-10&platform=DESK' \ --header 'Authorization: {token}' 3. Request with filter country=CA. curl --location --request GET 'https://backstage.taboola.com/backstage/api/1.0/spine-deforg-sc/reports/campaign-summary/dimensions/by_hour_of_day?start_date=2020-03-09&end_date=2020-03-10&country=CA' \ --header 'Authorization: {token}' The sum of spend for all of them is the same
Posted by Alex Kolesnykov 2 months ago
We need to have an ability to get hourly statistic for specific campaigns. There is such an ability on the UI (https://i.imgur.com/LSP2LyO.png), but we did`t find a way to get this statistic via the API (https://i.imgur.com/R3rEqZS.png). Please let us know whether we can retrieve hourly statistic for a specific campaign via the API?
Posted by Alex Kolesnykov 2 months ago
Hi everyone! There’s the following note in API guide: “It’s important to note that data in Taboola reports can (and will) change retroactively during the Taboola billing cycle. This means that when fetching report data from Taboola for a data warehouse or BI solution, the data for the entire billing cycle (current calendar month + previous calendar month up to the 5th in any given month) should be periodically refreshed.” Does it mean that if we update report data daily, then today (for example) we need to request data for the period 5th of Jan - today? 2. There is a field “last_used_rawdata_update_time” in response. What does this value stand for? Does it indicate the date when the report was lastly updated? So if today we get a report with last_used_rawdata_update_time = 6th of Feb then we don’t need to update our DWH as nothing changed since this date?
Posted by Ivan Korsakov 3 months ago
I am trying to get hourly data, and the API only responds with hour 0. Is there a special parameter I need to pass in order to get the entire day of hourly? Here is an example of my API call: https://backstage.taboola.com/backstage/api/1.0/spigot-network/reports/campaign-summary/dimensions/by_hour_of_day?start_date=2020-02-20&end_date=2020-02-20&include_multi_conversions=true
Posted by Carl 3 months ago
hi ! im using reporting campaign-summary for a while now but i have been facing an issue in the last couple of days when i run the report for the endpoint : https://backstage.taboola.com/backstage/api/1.0/<account_name>/reports/campaign-summary/dimensions/campaign_day_breakdown?start_date=2020-01-29&end_date=2020-01-29 i get a list of all campaigns including paused which sums up to a lot of campaigns do i need to delete all paused campaigns for the not to show up in the reporting ? or is there another parameter so that the paused campaigns will not show up in the reporting ?
Posted by shani shamilovich 4 months ago