Welcome to the Taboola Backstage API documentation. You'll find comprehensive guides and examples to help you get started with Taboola Backstage API quickly.
It looks like 'campaign_learning_state' is only available via the campaign-summary reporting, and not within the Campaign Object. Is that correct? Wouldn't it make more sense for this to be available within the current state of the Campaign Object, instead of in performance data?
Posted by Mike 2 days ago
We build a campaign reporting tool, using the Taboola API (among others). What we are trying to do is to see daily/hourly reports that show campaign/hour breakdown for money spent on Taboola per campaign. What is important for us for the hourly report is the ability to see campaign results in nearly real-time (let's say with a 1-hour delay - hence we would like to use the campaign_hour_breakdown dimension). It seems to be working almost fine. However, there are some discrepancies I don't understand. Has anyone experienced such weird behavior? We use the "Campaign Summary Report" with 3 different dimensions - day, campaign_hour_breakdown, and campaign_breakdown. I would expect that the sum of the spent column will always be the same regardless of the dimension we use. However, the numbers are slightly different, e.g. I ran three different reports/breakdowns for the same day. Here are the spent sums per each dimension: - campaign_hour_breakdown: $3,266.07 - day: $3,395.99 - campaign_breakdown: $3,400.41 Can you explain the discrepancy, please? Also, I have noticed the "last-used-rawdata-update-time" attribute. What is its meaning? To me, it looks like all reports are generated with a certain delay. Does that mean we cannot rely on them for our hourly breakdowns? Please advise. Thank you.
Posted by Jacek Francuz 5 days ago
Hello, The report /api/1.0/_networkId_/reports/revenue-summary/dimensions/day_site_placement_country_platform_breakdown returns 'subtotal' row site country platform with empty placement Basicly if we have two rows US DESKTOP placement1 X US DESKTOP placement2 Y the report will include 3rd row US DESKTOP X+Y Can't find anything in docs/a way to switch this off. We can just ignore rows with empty placements but the concern is the report can change one day and empty placements will have a different meaning (like missing placement info) Please advice Thanks Misha
Posted by Misha Makarevsky 7 days ago
Hi, Please can you let me know how often costs are updated via the API. Voluum claims they are pulling API cost data every 30 mins. my understanding is that the cost data is updated every few hours in line with the dashboard, can you share any transparency here, please? thanks
Posted by aaron 11 days ago
Is there a way to know if the users were added to the audience ? I get a 200 response from the API but I don't find a way to list users or get a count or list from the dashboard. Best, Ivan
Posted by Ivan Mak 12 days ago
Hi, I am getting some quite random errors when trying to retrieve all our ad accounts. Starting about a month ago or so our dashboard started throwing errors every once in a while when trying to retrieve all ad accounts. This doesn't occur all the time, it only seems to happen after our server catches a SIGTERM and therefore restarts. Any advice on what the root cause of the issue could be would be greatly appreciated!
Posted by Sander Post 12 days ago
We are working on the feature to allow uploading video creatives through our campaign creation feature and some questions: 1. Do you have integration to get videos from Getty images (or other provider) - just like you have with image creatives? 2. For the default images which accompany the video - can we get these from Getty images? I'm asking since you have a unique flow on how these getty images can be used so I'm trying to understand if it's possible to use it as the default images for the video item. 3. Can we upload more than one video at a time? 4. What about variations as we do with image creatives where we create combinations between all the images and the titles which are selected, is it possible to do with videos?
Posted by Lior 27 days ago
We were going through the API documents and it looks like the most granular data we can request is the "by_hour_of_day" dimension from the campaign summary dimensions endpoint. Two questions related to this: - Is this the most granular data we can request? We would love to be able to access our costs and clicks at a finer time grain. - Is this the only way to get data at a finer grain than "by-day" for a "by-campaign-by-site" analysis? What we mean is that if we want to do a site-by-site analysis for a campaign running on 500 sites, we would have to ping the "by_hour_by_day" endpoint 500 times for a single campaign. Is there another way to get hourly (or even more granular) data at the "by-campaign-by-site" level?
Posted by Alex Bank about a month ago
Hello Is there an option to create and update an Audience via the API? We have built audiences by uploading a list of email addresses manually before but we are looking to do this via API and updating everyday. I have looked in the documentation but cannot find the answer I am looking for. Can you point me to the documentation for this so I can send to our developers? Thanks
Posted by Ivan Mak about a month ago
Hi, we use Taboola Backstage API in our product, using this url "backstage/api/1.0/%s/reports/top-campaign-content/dimensions/item_breakdown?start_date=%s&end_date=%s", we see that there are items missing from the response, all items that are labeled "(old version)" that are present in the Taboola UI in Top Campaign Content are missing from the API response, I tried looking into the docs but couldn't find any clue related to (old version) items and how to pull them!! any advise on why there are missing?
Posted by Samer Kinaan about a month ago
Hello, we are getting this error when trying to block some site via API. The problem is that these sites do belong to the campaign and are also currently getting traffic. There are multiple examples but below I'm sending just one: Campaign id: 9761652 Sites we're trying to block: nbcsports-probasketballtalk, tegna-wxia
Posted by Ervin about a month ago
I sent a GET request to "https://backstage.taboola.com/backstage/api/1.0/<account_id>/reports/campaign-summary/dimensions/campaign_breakdown?start_date=2021-08-09&end_date=2021-08-31" with my access_token in the header. I get the following response: {"last-used-rawdata-update-time":"2021-08-11 16:00:00.0","last-used-rawdata-update-time-gmt-millisec":1628665200000,"timezone":"JST","results":[],"recordCount":0,"metadata":{"total":0,"count":0,"start_date":"2021-08-09T00:00:00UTC","end_date":"2021-08-31T00:00:00UTC","static_fields":[{"id":"date","format":null,"data_type":"DATE"},{"id":"campaign_name","format":null,"data_type":"STRING"},{"id":"campaign","format":null,"data_type":"STRING"},{"id":"clicks","format":null,"data_type":"NUMERIC"},{"id":"impressions","format":null,"data_type":"NUMERIC"},{"id":"visible_impressions","format":null,"data_type":"NUMERIC"},{"id":"spent","format":null,"data_type":"MONEY"},{"id":"conversions_value","format":".2f","data_type":"MONEY"},{"id":"roas","format":".2f","data_type":"PERCENT"},{"id":"ctr","format":null,"data_type":"PERCENT"},{"id":"vctr","format":null,"data_type":"PERCENT"},{"id":"cpm","format":null,"data_type":"MONEY"},{"id":"vcpm","format":null,"data_type":"MONEY"},{"id":"cpc","format":null,"data_type":"MONEY"},{"id":"campaigns_num","format":null,"data_type":"NUMERIC"},{"id":"cpa","format":null,"data_type":"MONEY"},{"id":"cpa_actions_num","format":null,"data_type":"NUMERIC"},{"id":"cpa_conversion_rate","format":null,"data_type":"PERCENT"},{"id":"currency","format":null,"data_type":"STRING"}]}} partner_types:["VIDEO_ADVERTISER"] campaign_types:null Is there a way to get the report with the VIDEO_ADVERTISER account? Thank you.
Posted by taka about a month ago
How to get additional fields in site level summary report? Hi Admin. I am trying to get site level summary report. I want to know how can I can get bid and bid modifier as well? This is the request URL : "https://backstage.taboola.com/backstage/api/1.0/" . env('TABOOLA_API_ACCOUNT_ID') . "/reports/campaign-summary/dimensions/site_breakdown" Could you please help me with how to get these additional fields in the summary report? Thanks.
Posted by Nithu Shan about a month ago
Hi, Admin I am trying to get campaign level summary report. I want to know if I can get campaign status, daily_cap, CPC as well? This is the request URL : "https://backstage.taboola.com/backstage/api/1.0/" . env('TABOOLA_API_ACCOUNT_ID') . "/reports/campaign-summary/dimensions/campaign_breakdown" Could you please help me with how to get additional fields in the summary report? Thanks. Legendary Phoenix
Posted by Legendary Phoenix about a month ago
Hi Admin I want to get flowing things through api Campaign level page 1.campaign play/paused function 2.Changing Daily budget function 3.Daily Bid changing function I tried many way .everything was getting error.could you please help me with specific reference link. or show me examples please Regards Nithushan.S
Posted by Nithu Shan about a month ago