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!
We are receiving a null value for 'item' in the "top_campaign_content_report" table. We have made the primary key for the table "top_campaign_content_report", which is a hash value of item, date, item_name, campaign_id fields. Sometimes, we get a null value for the item field in the response, for eg: curl -H 'Authorization: Bearer XXX' -A 'Jesey/2.25.1' 'https://backstage.taboola.com/backstage/api/1.0/xxxxxxxxxx/reports/top-campaign-content/dimensions/item_breakdown?end_date=2019-09-21&campaign=898661&start_date=2019-09-21' | jq Returns: { "item": null, "item_name": "xxxxxxxxx", "thumbnail_url": "xxxxxxx", "url": "xxxxxxxx", "campaign": "898661", "campaign_name": "xxxxxxxx", "content_provider": "1121684", "content_provider_name": "xxxxxxxx", "impressions": 1371, "visible_impressions": 376, "ctr": 0.15, "vctr": 0.53, "clicks": 2, "cpc": 0.108, "cvr": 50.00, "cvr_clicks": 50.00, "cvr_views": 0.00, "cpa": 0.22, "cpa_clicks": 0.22, "cpa_views": 0.00, "actions": 1, "actions_num_from_clicks": 1, "actions_num_from_views": 0, "cpm": 0.16, "vcpm": 0.57, "spent": 0.22, "conversions_value": 0.00, "roas": 0.00, "currency": "USD" }, The same request executed on a different date sometimes returns a valid 'item' and the hash value will get changed and this causes us to add duplicate records while upserting the data. We do not expect to be getting a null value because the item value is the same as id in the "campaign_item" table, and we do not see any null id value in the campaign_item table. After more discovery, we found that these values are being returned as 'null' because that item has been deleted from the campaign history. Can everything be paused instead of deleted to try overcome this data integrity issue?
Posted by Sean 5 months ago
Hi I have a network/agency account with a bunch of sub accounts under. My account rep at Taboola gave me the ID and the Secret Code, but it was for my Network account and it seems that The Optimizer does not connect that way. I was told by my account rep that he did not know how else to help and to post a quesiton here. How do I connect all of my Taboola accounts under my network account to The Optimizer? Do I need to connect each account individually with different login and passwords?
Posted by Jon Carmen 5 months ago
Lots of 502 responses at around 2020-02-20 05:16:18.006 PST Were there server issues? Could this be load related? Most of the API calls are for campaign updates. Thanks
Posted by Raymond Ho 5 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 5 months ago
I'm getting an error sometimes when accessing the item_breakdown endpoint. It'll work fine the first few times and then I'll get his error. I'm masking out specific information in the calls and responses to paste them here. The endpoint: Request URL: https://backstage.taboola.com/backstage/api/1.0/##########-altium-sc1/reports/top-campaign-content/dimensions/item_breakdown?start_date=1900-01-01&end_date=2020-02-17&campaign=########## Referrer Policy: no-referrer-when-downgrade The response message after the call errors out is: accept-ranges: bytes content-length: 0 date: Mon, 17 Feb 2020 21:27:02 GMT server: nginx status: 429 via: 1.1 varnish x-cache: MISS x-cache-hits: 0 x-served-by: cache-chi21133-CHI x-timer: S1581974823.691708,VS0,VE160 The error in the browser console is: Access to XMLHttpRequest at 'https://backstage.taboola.com/backstage/api/1.0/###########-altium-sc1/reports/top-campaign-content/dimensions/item_breakdown?start_date=1900-01-01&end_date=2020-02-17&campaign=###########' from origin 'https://###############.com' has been blocked by CORS policy: No 'Access-Control-Allow-Origin' header is present on the requested resource.
Posted by Brendan Malone 5 months ago
Hi, I am having troubles getting right responses from API. I get '502 Bad Gateway' as response when I try to get some of the reports. It's been couple of months since I started getting some reports using API everyday and I came across this problem for the first time yesterday(2/11). ``` "<html> <head><title>502 Bad Gateway</title></head> <body bgcolor="white"> <center><h1>502 Bad Gateway</h1></center> <hr><center>nginx</center> </body> </html> " ``` Here is the request. （ {XXX} is for security reasons. ） ``` https://backstage.taboola.com/backstage/api/1.0/{campaign_id}/reports/top-campaign-content/dimensions/item_breakdown?start_date=2020-02-04&end_date=2020-02-04&campaign={id} ``` Could you help me out solve this issue? Thank you in advance.
Posted by kamei 6 months ago
When obtaining a campaign list or specific campaign ID, I get zero responses, or a forbidden error: - https://backstage.taboola.com/backstage/api/1.0/users/current/account gives me the account id - https://backstage.taboola.com/backstage/<ACCOUNT_ID>/campaigns/ gives me zero responses - https://backstage.taboola.com/backstage/<ACCOUNT_ID>/campaigns/<CAMPAIGN_ID/ gives me 403 forbidden. Where do I go now?
Posted by Karel 6 months ago
I'm looking to download settings for all campaign items, and it seems like the only documented way is to iterate through each campaign and download item settings. This means we'd need an HTTP request per campaign. Do you happen to know if there's an endpoint for getting ALL campaign item settings, at the account level?
Posted by Tyler 6 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 6 months ago
Hello again, For reporting purposes I am attempting to generate a map from site -> site_id for all of the publishers which are sending us impressions. I am attempting to use the API endpoint documented here to generate that map: https://backstage-api.readme.io/reference#list-of-publishers I queried for the `taboola-network` admin network, but received records for only 80% of the publishers which are sending us impressions. As noted in the docs, I contacted our account manager to see what other admin networks are relevant to our accounts, but he said that `taboola-network` should be the extent of it. How can I look up the remaining publishers? `newsuk-thesun` is a notable missing value. Thanks! Cleve
Posted by Cleve Pasarell 6 months ago
I'm not sure why, but it appears that it takes two requests to update the status on a campaign item. Here's an example of the first response: {'id': '225041018', 'campaign_id': '2258352', 'status': 'RUNNING', 'policy_review': {'reject_reason': None}, 'is_active': True, 'thumbnail_url': 'https://media.workandmoney.com/96/56/9656faa856ba4ccbb80632b03aa83c23.jpg', 'title': 'Who Are the Best Liverpool Players of All Time?', 'approval_state': 'APPROVED', 'type': 'ITEM', 'url': 'https://www.stadiumtalk.com/s/greatest-liverpool-football-club-all-time-2910538a984a4f5e'} Then the same exact request seconds later: {'url': 'https://www.stadiumtalk.com/s/greatest-liverpool-football-club-all-time-2910538a984a4f5e', 'thumbnail_url': 'https://media.workandmoney.com/96/56/9656faa856ba4ccbb80632b03aa83c23.jpg', 'campaign_id': '2258352', 'id': '225041018', 'status': 'PAUSED', 'title': 'Who Are the Best Liverpool Players of All Time?', 'approval_state': 'APPROVED', 'policy_review': {'reject_reason': None}, 'type': 'ITEM', 'is_active': False} Any help would be greatly appreciated. Thank you.
Posted by Tyler 6 months ago
Hi there, 2 questions related to the API: 1. Are there any formal API rate limits? We have not bumped into any limits, but are about to ramp up our ingest of performance data and want to make sure we are good citizens. 2. I have found API docs for the campaign-level blacklisting (https://backstage-api.readme.io/reference#patching-targeted-publishers) but no docs for an account-level blacklist. However, in the backstage UI if I go to Campaign Summary -> By Site, there does appear to be the ability to manually blacklist sites for my account. Is there a way to ingest or update this list via the API? Thanks! Cleve
Posted by Cleve Pasarell 6 months ago