Welcome to the Taboola Backstage API documentation. You'll find comprehensive guides and examples to help you get started with Taboola Backstage API quickly.
Hi Taboola team, We want to use your {cpc} macro to get the cost for every click, and I see it in your help document. https://help.taboola.com/hc/en-us/articles/115006030688-Creating-and-Adding-URL-Parameters-for-Tracking And it show that β{cpc} -The realtime CPC bid of each click. The CPC value is encrypted, to decrypt it you will need to be able to execute a decryption script.Β This implementation requires technical programming knowledge. If you are able to code, contact your Taboola Account Manager to receive the guide. β We have tech team who can develop it, so pls tell me how to do it. And I try to get help from My Account Manager, but they also don't know this. So I check with it in your online help center. Thanks!
Posted by Calvin 27 days ago
Hi, I am trying the following API call to get a list of available account ids: https://backstage.taboola.com/backstage/api/1.0/users/current/allowed-accounts This gives a list of 4 PARTNER accounts and 1 NETWORK account. I then try the following: https://backstage.taboola.com/backstage/api/1.0/NETWORK_ACCOUNT_ID/reports/campaign-summary/dimensions/day Which gives the following error: {"http_status":403,"message":"Requested action is forbidden","message_code":"api.action.forbidden"} Please could you advise?
Posted by Matthew 28 days ago
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 about a month 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 about a month 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 about a month 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 about a month 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 about a month 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 about a month 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 about a month 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 2 months 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 2 months 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 2 months 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 2 months 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 2 months ago