Welcome to the Taboola Backstage API documentation. You'll find comprehensive guides and examples to help you get started with Taboola Backstage API quickly.
How can we calculate thru the api the cost per click by publisher and time of the day? we need an estimate for live traffic and the real cost for updated data Where can I find more information on how this works
Posted by Mansour Bennouna 8 days ago
Hi, For our requirements, in each account I need the last 24 hours' spend per Publisher. With the Java SDK, I can easily get the spend per site in daily chunks using the **SITE_BREAKDOWN** dimension, however this doesn't support anything finer-grained, for instance if I want to know the spend from midday yesterday until midday today. It doesn't look possible through the Java SDK. I've also looked at calling the Backstage API directly, but even then it looks like I can only perform what I need one site per call using **campaign_hour_breakdown** with a site filter... ``` https://backstage.taboola.com/backstage/api/1.0/<account>/reports/campaign-summary/dimensions/campaign_hour_breakdown?start_date=2021-02-08&end_date=2021-02-09&site=<site name> ``` Our app can then aggregate the values in the response to calculate our spend on a site for the last 24 hours. Given that we are using thousands of Publishers, this could take some time! I'd love to know if there another more performant way of doing this? Cheers, Colin
Posted by Colin MacLean 22 days ago
The impression, vimpression and click data that break down by campaign is bigger than the total data of items between Otc.18 and Otc.19 these two days. Can you please help me to figure out the reason?
Posted by Hongji Lai 4 months ago
Hello there! We use /api/1.0/{account}/reports/top-campaign-content/dimensions/item_breakdown API URI to request report for current date. However, the API response metric numbers is not the same as the number in UI.
Posted by Mark Wise 5 months ago
Hello there! I have a question, is it possible to get all my billing with taboola api? If it's possible, is there some documentation? I found nothing on : https://developers.taboola.com/backstage-api/reference Am I missing something??
Posted by Natacha Rivoire 5 months ago
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 5 months 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 7 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 7 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 8 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 9 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 9 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 9 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 9 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 10 months ago