Welcome to the Taboola Backstage API documentation. You'll find comprehensive guides and examples to help you get started with Taboola Backstage API quickly.
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
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 2 months 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 2 months ago
Hello all, I have this script to extract my campaign data splited by plateform (see bellow). But now, I want to know how to extract the revenues earn by my publisher. Do you knwo how I can do that ? ___________________________ My Script : client_id =XXXXXXXXXXX client_secret = XXXXXXXXXXXXX start_date = "2021-06-08" end_date = "2021-06-08" account_id = "XXXXXXXX" dimension = "content_provider_breakdown" folder_path = r"/Users//Documents/" url = "https://backstage.taboola.com/backstage/oauth/token" payload = f"client_id={client_id}&client_secret={client_secret}&grant_type=client_credentials" headers = {"Content-Type": "application/x-www-form-urlencoded"} response = requests.request("POST", url, data=payload, headers=headers) data = response.json() access_token = data["access_token"] url = f"https://backstage.taboola.com/backstage/api/1.0/{account_id}/reports/campaign-summary/dimensions/{dimension}" url = f"https://backstage.taboola.com/backstage/api/1.0/{account_id}" querystring = {"start_date":start_date,"end_date":end_date,"platform":"DESK"} bearer = f"Bearer {access_token}" headers = {"Authorization": bearer} response = requests.request("GET", url, headers=headers, params=querystring) data = response.json() _____________________________
Posted by Charles M. 4 months ago
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 months 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 8 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 about a year ago