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!
i am making this api and its giving this error to me https://backstage.taboola.com/backstage/api/1.0/digittopia-sonalifthyderra-sc/reports/campaign-summary/dimensions/by_hour_of_day?start_date=2019-12-05T05:00:00&end_date=9999-12-31T23:59:59 stdClass Object ( [http_status] => 400 [message] => Invalid format: "-12-31T23:59:59?campaign_id=3407135" is malformed at "?campaign_id=3407135" [offending_field] => end_date [message_code] => api.action.bad_request.end_date )
Posted by ahmadali 7 days ago
Hello, I`ve done an HTTP request to get the summary report. I`ve noticed that the response data is coming without total conversions (as you can see in the website) someone knows how can you get the total conversions in the same line as every campaign in the summary report? Thanks in advance!
Posted by Guy Horowitz 2 months ago
Hi, It would be amazing to see the performance by site and by the country for a given campaign at the same time. Is there any option available for that? If no, are you planning to add that anytime soon? Thanks, David
Posted by David Wilson 2 months ago
I sent a GET request to "https://backstage.taboola.com/backstage/api/1.0/<account_id>/campaigns/" with my access_token in the header. I get the following response: ``` data: { results: [], metadata: { total: 0, count: 0, static_fields: [], static_total_fields: [] } } ``` From this old github issue (https://github.com/singer-io/tap-taboola/issues/1) I found on the deprecated Backstage API docs (https://github.com/taboola/Backstage-API) says that: ``` Reading, creating or updating Campaigns is only possible when the [account-id] references an Account with ADVERTISER in its partner_types field. Trying to send a request with a non-Advertiser Account will result in a 404 Not Found response. ``` I checked, my<account_id> does not have "ADVERTISER" in its `partner_types`. I did not see any mention of this issue regarding `partner_types` in the current documentation. Could anyone confirm if "ADVERTISER" really is required to access Campaigns? Thank you.
Posted by Andy Shih 3 months ago
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 3 months 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 3 months 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 3 months 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 3 months 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 4 months 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 6 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 6 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 6 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 6 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 6 months ago