Welcome to the Taboola Backstage API documentation. You'll find comprehensive guides and examples to help you get started with Taboola Backstage API quickly.
Are special characters scrubbed if passed into the placement variable? One of the string we pass into the placement variable contains ! in it. The reporting api endpoint passes that string back without !. Are there are characters that are scrubbed out? If so, why?
Posted by Carmen Ruder 7 months ago
Hello all. I have requested via email, several times, access to the API but no one is responding to me. Does anyone know a method I could use in order to get my client_id and client_secret so I can gain access to the API? Thanks in advance.
Posted by Chris 7 months ago
Hello. A cording to docs hours are in 0-24 range, inclusive, 'from' must be smaller then 'to'. Its bit confusing: 0-0 does not work, so if 0-1 means 'first hour of the day' then 'to' is not inclusive. 0-24 does not work (25 hours if 'to' is inclusive) 0-23 works and so does 1-24 - both means 'whole day' because its 24 hours? Then, if I set 1-23. is 23 hours (not including the first hour of the day)? I think few examples can help because we can't have both hour 0 and hour 24 - at least not on this planet :) Thanks Misha
Posted by Misha Makarevsky 7 months ago
Our revenue data are provided on UTC timezone. To perform our analysis with our Taboola expenses we use the by_hour_of_day dimension to get expenses from day <d-1> 7pm to day <d> 6pm (Taboola uses ET timezone), details: 1/ To get expenses by campaign for day <d> "UTC", 2 requests: /reports/campaign-summary/dimensions/by_hour_of_day?campaign=<idCampaign>&start_date=<d>&end_date=<d> (we keep datas from 12am to 6pm) /reports/campaign-summary/dimensions/by_hour_of_day?campaign=<idCampaign>&start_date=<d-1>&end_date=<d-1> (we keep data from 7pm to 12am) 2/ To get expenses by site for day <d> "UTC": 2.a/ we get all idsite for day <d-1> and <d>: /reports/campaign-summary/dimensions/site_breakdown?campaign=<idCampaign>&start_date=<d>&end_date=<d> /reports/campaign-summary/dimensions/site_breakdown?campaign=<idCampaign>&start_date=<d-1>&end_date=<d-1> 2.b/ for each idsite: /reports/campaign-summary/dimensions/by_hour_of_day?site=<site_name>&campaign=<idCampaign>&start_date=<d>&end_date=<d> (we keep datas from 12am to 6pm) /reports/campaign-summary/dimensions/by_hour_of_day?site=<site_name>&campaign=<idCampaign>&start_date=<d-1>&end_date=<d-1> (we keep data from 7pm to 12am) -- But it doesn't work as expected, the total of expenses for an "UTC day" is far (always less) from our estimations (based on an average for few days). What is wrong? Thank you!
Posted by Peter 8 months ago
Hi, According to the Backstage API doc, there are only a number of available preset dimensions to pull a Campaign Summary Report. I am currently using 'campaign_site_day_breakdown'. I'm trying to get reporting data down to the creative/item level but none of them go down to that level. Is it possible to pull a report down to a creative/item level? Thanks, Ed
Posted by Edward Tan 8 months ago
Dear support, I would love your assistance, I feel like I am missing something basic We have just started working on an integration with the backstage API. To authorize we use the 'Client Credentials' flow, with client_id and client_secret, and recieve an access_token. When making any requests with the access_token, e.g. '/users/current/account' the response is a 200 o.k. with a login page, instead of the actual JSON data we want. Thanks in advance
Posted by Sapir Malka 8 months ago
I'm updating the tracking_code for a campaign and noticed I'm able to update the campaign item url too for tracking. After reading the documentation I found this: Use each parameter only once, and only to apply them at either the campaign or item level - not both. URL parameters cannot be added at both the individual URL level AND campaign level, it will cause the data to be incorrect in your analytics platform. (For example, you cannot have "utm_source=Taboola" added at the campaign level and "utm_source=cpc" appended to a URL in the campaign.) So question here is if on the campaign level I have utm_source=Taboola, am I able to add ?utm_source=Taboola on the campaign item level too?
Posted by Chelsea 8 months ago
Hi Guys, We are using a Rule tool (through the API) and it seems that it's having difficulties to exclude sites from campaigns that have a total exclusion of 1,500 sites from both account + campaign level. we do manage to exclude manually, however, the API getting an error. after discussing our Taboola AM, we understnad that we are limited with 1,500 (from the campaign level) + 1,500 (from the account level). For example, on the below campaign we didn't reach our limitation and our API tool is getting error when it try to exclude any other site: Campaign ID: 6436943 Campaign Name: Taboola_Bras_Mob_US_144181212_iOS_RON_TN Blocked on Account Level: 1255 Blocked for this Campaign: 563 any suggestion what could be the problem when we are trying to exclude through API?
Posted by Nissim Duek 8 months ago
Hi, I'm having this message : {"http_status":400,"message":"You can not target/block more than 1,500 sites.","offending_field":"","message_code":"campaign.blockedPublishers.error.server.limitReached"} Is there any way to increase this limit?
Posted by Melanie Macias 9 months 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 9 months ago
Hello, We trying to Upload an image to the Taboola CDN using Backstage-API. POST request sent successfully and received response with StatusCode: OK, but without any data. Request screenshot: https://prnt.sc/uz42my Response screenshot: https://prnt.sc/uz43iv Please help us to solve the problem. Thanks
Posted by Yana Taube 9 months ago
We are having problems blacklisting a publisher. We are sending this request curl --location --request PATCH 'https://backstage.taboola.com/backstage/api/1.0/[acctId]/campaigns/[cid]' \ --data-raw '{ "patch_operation": "ADD", "publisher_targeting": { "publishers": [ "reachmobi-whowizzle-slideshow", "reachmobi-travelmanner-slideshow" ] } }' And getting a 2020-10-05 12:57:54 INFO CommunicationInterceptor:19 [main] - --> PATCH https://backstage.taboola.com/backstage/api/1.0/[accountId]/campaigns/[campaignId]' (131-byte body) 2020-10-05 12:57:54 INFO CommunicationInterceptor:19 [main] - <-- 200 OK https://backstage.taboola.com/backstage/api/1.0/[accountId]/campaigns/[campaignId]' (392ms, unknown-length body) But when we look into the blacklisted publishers these sites do not show up. Can you someone check why this is happening?
Posted by Hank 10 months ago