Welcome to the Taboola Backstage API documentation. You'll find comprehensive guides and examples to help you get started with Taboola Backstage API quickly.
I’m hoping someone can help with a stumbling block I’m facing with our auth flow. I’m trying to use the Authorisation Code method outlined in the api docs (https://developers.taboola.com/backstage-api/reference#authorization-code) as follows: This flow is similar to Implicit Grant (above), but involves an additional step: User clicks on Connect within your App. Your App redirects the user to a Taboola login page: [authentication_domain]/authentication/oauth/authorize/?client_id=[client_id]&redirect_uri=[redirect-uri]&response_type=code Note: set authentication_domain = 'https://authentication.taboola.com’ I’ve built the Taboola login url as outlined above using our client id and desired redirect however when I test the URL and subsequent login process there is no redirect back to our app, instead the user is taken to this page within Taboola that asks whether I want to go to backstage or newsroom, both of which keep the user in Taboola. Anyone know why I can’t redirect back out to our app to complete the authors flow?
Posted by Matt 7 months ago
Hi there, I'm looking for an example request for a Revenue Summary report by day and placement. I've looked at both the github and taboola.com docs and have produced the below request but I'm getting a 400 response. The error is clear that my placement filter is wrong but I can't find a resolution. Request: https://backstage.taboola.com/backstage/api/1.0/[account_id]/reports/revenue-summary/dimensions/day/?start_date=2020-06-01&end_date=2020-06-02&placement=[placement] Response: { "http_status": 400, "message": "Filter 'placement' has invalid value", "offending_field": "placement" } Thanks!
Posted by Kent S. 7 months ago
Hello, We getting lot of errors when coping marketplace audiences from one campaign to another (the same country and account): "Targeting: [111983] is not available in the targeted countries due to limited scale. In Taboola UI exelate audiences does not have size and when we trying to remove them getting a popup telling that the audience is no longer available. We will check market place audiences dictionary to filter out non available audiences or parse returned error and retry unless there are other reconditions 1. exelate audiences are gone and they not coming back? 2. lot of our campaigns lost audiences targeting (some even lost all targeting) - any recommendations what to do with them? Thanks Michael
Posted by Michael Makarevsky 7 months ago
Can we achieve similar kind of restriction for getting all campaigns using Java Client SDK? In Back stage API we have option like below: Get all campaigns Using the the optional fetch_level param, you have 3 options: Fetch a list of all campaigns for the specified account (fetch_level param is omitted). Fetch recent campaigns for the specified account (fetch_level = R). Returns all recent, non-paused campaigns that have not been deleted. In this context, recent means: a. Created within the last 30 days (regardless of status) Or b. status = APPROVED (regardless of creation date) Fetch recent and paused campaigns for the specified account (fetch_level = RAP). Returns the same as previous - but also includes paused campaigns.
Posted by rakesh 7 months ago
Hi. Is it possible to have reports for country-placement granularity in revenue-summary reporting? How often are reports updated? Do you support intra-day reporting? Do you provide live cpc in response?
Posted by Vasilii Parshkin 7 months ago
I sent a GET request to "https://backstage.taboola.com/backstage/api/1.0/<account_id>/campaigns/" with my access_token in the header. I get the following response: ``` data: { results: [], metadata: { total: 0, count: 0, static_fields: [], static_total_fields: [] } } ``` From this old github issue (https://github.com/singer-io/tap-taboola/issues/1) I found on the deprecated Backstage API docs (https://github.com/taboola/Backstage-API) says that: ``` Reading, creating or updating Campaigns is only possible when the [account-id] references an Account with ADVERTISER in its partner_types field. Trying to send a request with a non-Advertiser Account will result in a 404 Not Found response. ``` I checked, my<account_id> does not have "ADVERTISER" in its `partner_types`. I did not see any mention of this issue regarding `partner_types` in the current documentation. Could anyone confirm if "ADVERTISER" really is required to access Campaigns? Thank you.
Posted by Andy Shih 7 months ago
Where can I find the best resource about future changes that are being made which will require us to make changes? Is there a newsletter that goes out, a specific page I can visit, etc? I see the changelog is available for already released updates but to get ahead and plan for changes we are looking for potential upcoming things. Thank you!
Posted by Daniel 7 months ago
I couldn't find how to create a network-level conversion in the documentation. Is there anyway to implement that? I only found account-level conversion creation here: https://developers.taboola.com/backstage-api/reference#create-a-conversion-rule Thanks
Posted by Kais Salha 7 months ago
Hi there, Can you share how up to date are the campaigns settings (budget, cpc, status) in the API? If I were to make changes at 2pm and try to pull this information at 2:05pm, am I going to get the correct information? Thanks, Sandra
Posted by Sandra 7 months ago
Hi, is there any delay in reporting through API for clicks / spend that took place ? For example, if there's click / spend event that takes place now, how soon is this information available for the reporting API ? Thanks
Posted by Jack Qian 7 months ago
Hi i am making this API call: https://backstage.taboola.com/backstage/api/1.0/1219366/reports/campaign-summary/dimensions/campaign_site_day_breakdown?start_date=2020-05-21&end_date=2020-05-21 and getting this answer back: Array ( [http_status] => 400 [message] => Unknown publisher ) can anyone explain why am i getting this and what am i doing wrong?
Posted by dotan guy 7 months ago
Hey, Is there an option to choose a different provider (advertiser) when using a "duplicate campaign API"? For example, if I have "demo-advertiser" (that contains campaign 123) and "another-advertiser", can I do something like: curl --request POST \ --url https://backstage.taboola.com/backstage/api/1.0/demo-advertiser/campaigns/123/duplicate \ --header 'content-type: application/json' \ --data '{"name":"Copy to another", "advertiser": "another-advertiser"}' Thanks!
Posted by Sasha 7 months ago
Hi, is campaign reporting (through API) available at the item / thumbnail level? I created items / thumbnails, each with title and URL in the Campaign Inventory. Is there any way to pull campaign reporting at such item / thumbnail level, through the reporting API ? Thanks
Posted by Jack Qian 8 months ago
## H3 Looks like something went wrong! **Our server reports an error occurring while preparing this page. Please try again later once we have solved the problem.** --- Every time [duplicate API](https://developers.taboola.com/backstage-api/reference#duplicate-a-campaign) is executed, 200 OK status with above error msg is received in HTML. Is this API ready to be used or is the sample call (below) constructed incorrectly? https://backstage.taboola.com/backstage/api/1.0/`{{account id}}`/campaigns/`{{campaign id}}`/duplicate with JSON body: `{"name":"duplicate-or-clone-this-campaign"}`
Posted by Melody Song 8 months ago
Hi, We are requesting for this report (reports/campaign-summary/dimensions/campaign_breakdown) several times a day. We request it for 2 time periods: - 1 day - 365 days (to get campaign lifetime spend) I suspect that sometimes, depending on how long it took to respond, the response is not full. It happens randomly when we try to parse the response to json and it fails: `ValueError: Unterminated string starting at: line 1 column 25130053 (char 25130052)` `ValueError: Unterminated string starting at: line 1 column 44233078 (char 44233077)` This suggests the response is incomplete. And indeed, catching the response itself when this happens shows HTTP200 but the response itself is not complete: "..."conversions_value":0.00,"roas":0.00,"ctr":0E-18,"vctr":0E-18,"cpm":0.00,"vcpm":0.00,"cpc":0.00,"campaigns_num":1,"cpa":0.00,"cpa_actions_nu" I do not think this is a timeout from our end as we wait for 360 seconds and the error happens much sooner than that. So I suspect your server cut the response if it happens to take to long, and then I get a partial response. Please advise on how to get this solved... Perhaps there is a way to cut the report to chunks (paged report) or perhaps selecting which dimensions will be returned? (i only want the spend in this case). example request that just failed: GET 'https://backstage.taboola.com/backstage/api/1.0/samyonetwork/reports/campaign-summary/dimensions/campaign_breakdown?start_date=2019-05-27&end_date=2020-05-26' response headers: {'X-Timer': 'S1590508558.250668,VS0,VE5509', 'X-XSS-Protection': '1; mode=block', 'X-Cache': 'MISS', 'X-Content-Type-Options': 'nosniff, nosniff', 'transfer-encoding': 'chunked', 'Accept-Ranges': 'bytes', 'Expires': '0', 'Vary': 'Accept-Encoding', 'X-Served-By': 'cache-bwi5053-BWI', 'Server': 'nginx', 'Connection': 'keep-alive', 'Via': '1.1 varnish', 'X-Cache-Hits': '0', 'Pragma': 'no-cache', 'Cache-Control': 'no-cache, no-store, max-age=0, must-revalidate', 'Date': 'Tue, 26 May 2020 15:56:03 GMT', 'P3P': 'policyref="http://trc.taboola.com/p3p.xml", CP="NOI DSP COR LAW NID CURa ADMa DEVa PSAa PSDa OUR BUS IND UNI COM NAV INT DEM"', 'Content-Type': 'application/json;charset=utf-8', 'X-Frame-Options': 'DENY'}
Posted by Or 8 months ago
Hi! Yesterday starting from 7PM GMT+1 we faced API authorization problems. We work with Ubuntu 16.04, which is located on Amazon. The problem is when we try to get the token we get the "401" response. Sreenshot: https://prnt.sc/snzqlc The authorization code is absolutely the same on the working PC, and everything works correctly. Screenshot: https://prnt.sc/snzskf Also, everything works correctly via Postman. Screenshot: https://prnt.sc/snztko Please help us find and solve the problem.
Posted by Ivan Borokh 8 months ago
Hey team, I am looking for a way to get hourly data (specifically spend, clicks) in an hourly resolution with the ability to get the data by campaign. So either: a. By campaign breakdown with an hourly resolution. b. Hourly data with the ability to filter by campaign. Are any of these possible ? Thanks ! p.s. Option b. is possible via your dashboard so I'm sure the data is there but not sure how to access it programmatically.
Posted by Shai 8 months ago
I see it in the retired documntation on github https://github.com/taboola/Backstage-API/blob/master/Backstage%20API%20-%20Users.pdf but it's not documented here, is it deprecated?
Posted by Abdallah AlHalees 8 months ago