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 I am starting to work with the api. After fetching the access token I am trying to get all campaigns (as listed here https://developers.taboola.com/backstage-api/reference#fetching-campaigns) but I am getting an empty array result. Please advise.
Posted by David Baruch about a month ago
We are looking to create campaigns via the API and have run into an issue with the API documentation. https://developers.taboola.com/backstage-api/reference#create-a-campaign We would like to be able to set the advertiser ID for the campaign during the creation process, but there appears to be no field listed for it. The call would be to https://backstage.taboola.com/backstage/api/1.0/account_id/campaigns/ but I suspect we have to use our main account ID in that URL. then later provide the advertiser ID that lives within our account? It would be awesome if the documentation could be updated at some point to mention things like this, as there are a lot of blind spots in what it covers. Under "Campaign Fields" there is advertiser_id but it is listed as read-only. Also, is there an API call that will return all advertiser IDs for an account? Thanks! /Chris
Posted by Chris Ellerby about a month ago
Hey, When I Fetch campaigns I get the results as an empty array, but when I run the summary report I get the report as it should be with campaigns. The Request: https://backstage.taboola.com/backstage/api/1.0/account_id/campaigns/
Posted by Guy Horowitz 6 months ago
์๋ ํ์ธ์. ํ๋ธ๋ผ API๋ฅผ ์ด์ฉํด์ ๊ฐ์ ์กฐํํ๋ ค๊ณ ํฉ๋๋ค. client_id + client_secret ๋ฅผ ์ด์ฉํ์ฌ "access_token" ์ ์ฑ๊ณตํ์ต๋๋ค. access_token ์ ์ด์ฉํ์ฌ "account_id" ๋ ์ฑ๊ณตํ์ต๋๋ค. ๊ทธ๋ฌ๋ "Get All Campaigns" ์ ์คํจํ์ต๋๋ค. "https://backstage.taboola.com/backstage/api/1.0/{{account_id}}/campaigns/?fetch_level=R" ๋ก ํธ์ถํ์ต๋๋ค. ๊ฒฐ๊ณผ๋ "200"์ผ๋ก ์ฑ๊ณตํ์ต๋๋ค. ๊ทธ๋ฌ๋ "total:0, count:0"์ผ๋ก ๋ฆฌ์คํธ๋ฅผ ์กฐํํ์ง ๋ชปํ์ต๋๋ค. ๋์์ด ํ์ํฉ๋๋ค. ๋์์ ๋ถํ๋๋ฆฝ๋๋ค.
Posted by Seok 7 months ago
Quite similar to this issue: https://developers.taboola.com/backstage-api/discuss/5ee15745fdb1010136aa891c Sending a GET request to "/backstage/api/1.0/{{account_id}}/campaigns" with relevant account_id and bearer token in the Authorization header returns an empty list. account_id passed is returned in "/backstage/api/1.0/users/current/allowed-accounts" so no issues there. Account also has at least one campaign which passes "minimum CPC" enforcement as verified from the Taboola Backstage UI. Link to private Google doc: https://docs.google.com/document/d/1C2uRE0js0dNxjae64YB611J7pL1yMUnWhNM0gFZIB54/edit?usp=sharing Link to Backstage UI: https://backstage.taboola.com/backstage/1169136/reports/campaigns/campaign-summary#%7B%22id%22%3A%22xdp2a6m7h29%22%2C%22groupId%22%3A%22campaigns%22%2C%22reportId%22%3A%22campaign-summary%22%2C%22dateRangeSelector%22%3A%7B%22id%22%3A%223%22%2C%22term%22%3A%22last%207%20day%22%2C%22range%22%3A6%2C%22dateStart%22%3A%222020-07-10%22%2C%22dateEnd%22%3A%222020-07-16%22%7D%2C%22queryFilter%22%3A%5B%7B%22id%22%3A%22campaign_param%22%2C%22operator%22%3A%22equal%22%2C%22value%22%3A%22-1%22%7D%2C%7B%22id%22%3A%22top_results%22%2C%22operator%22%3A%22equal%22%2C%22value%22%3A%22100%22%7D%5D%2C%22currentDimension%22%3A%7B%22tab%22%3A%22tab-campaign_breakdown%22%2C%22pages%22%3A%5B%7B%22dim%22%3A%22campaigns%2Fcampaign-summary%2Fday%22%2C%22table%22%3A%7B%22key%22%3A%22date%22%2C%22order%22%3A%22desc%22%2C%22page%22%3A1%7D%2C%22legend%22%3A%2200001000000100%22%7D%2C%7B%22dim%22%3A%22campaigns%2Fcampaign-summary%2Fweek%22%2C%22table%22%3A%7B%22key%22%3A%22date%22%2C%22order%22%3A%22desc%22%2C%22page%22%3A1%7D%2C%22legend%22%3A%2200001000000100%22%7D%2C%7B%22dim%22%3A%22campaigns%2Fcampaign-summary%2Fmonth%22%2C%22table%22%3A%7B%22key%22%3A%22date%22%2C%22order%22%3A%22desc%22%2C%22page%22%3A1%7D%2C%22legend%22%3A%2200001000000100%22%7D%2C%7B%22dim%22%3A%22campaigns%2Fcampaign-summary%2Fby_day_of_week%22%2C%22table%22%3A%7B%22key%22%3A%22dow%22%2C%22order%22%3A%22asc%22%2C%22page%22%3A1%7D%2C%22legend%22%3A%2200000000000100%22%7D%2C%7B%22dim%22%3A%22campaigns%2Fcampaign-summary%2Fby_hour_of_day%22%2C%22table%22%3A%7B%22key%22%3A%22hour_of_day%22%2C%22order%22%3A%22asc%22%2C%22page%22%3A1%7D%2C%22legend%22%3A%2200000000000100%22%7D%2C%7B%22dim%22%3A%22campaigns%2Fcampaign-summary%2Fcontent_provider_breakdown%22%2C%22table%22%3A%7B%22key%22%3A%22spent%22%2C%22order%22%3A%22desc%22%2C%22page%22%3A1%7D%2C%22legend%22%3A%2200000000000100%22%7D%2C%7B%22dim%22%3A%22campaigns%2Fcampaign-summary%2Fcampaign_breakdown%22%2C%22table%22%3A%7B%22key%22%3A%22spent%22%2C%22order%22%3A%22desc%22%2C%22page%22%3A1%7D%2C%22legend%22%3A%2200000000000100%22%7D%2C%7B%22dim%22%3A%22campaigns%2Fcampaign-summary%2Fsite_breakdown%22%2C%22table%22%3A%7B%22key%22%3A%22spent%22%2C%22order%22%3A%22desc%22%2C%22page%22%3A1%7D%2C%22legend%22%3A%2200000000000100%22%7D%2C%7B%22dim%22%3A%22campaigns%2Fcampaign-summary%2Fcountry_breakdown%22%2C%22table%22%3A%7B%22key%22%3A%22spent%22%2C%22order%22%3A%22desc%22%2C%22page%22%3A1%7D%2C%22legend%22%3A%2200000000000100%22%7D%2C%7B%22dim%22%3A%22campaigns%2Fcampaign-summary%2Fregion_breakdown%22%2C%22table%22%3A%7B%22key%22%3A%22spent%22%2C%22order%22%3A%22desc%22%2C%22page%22%3A1%7D%2C%22legend%22%3A%2200000000000100%22%7D%2C%7B%22dim%22%3A%22campaigns%2Fcampaign-summary%2Fdma_breakdown%22%2C%22table%22%3A%7B%22key%22%3A%22spent%22%2C%22order%22%3A%22desc%22%2C%22page%22%3A1%7D%2C%22legend%22%3A%22000000000%22%7D%2C%7B%22dim%22%3A%22campaigns%2Fcampaign-summary%2Fplatform_breakdown%22%2C%22table%22%3A%7B%22key%22%3A%22spent%22%2C%22order%22%3A%22desc%22%2C%22page%22%3A1%7D%2C%22legend%22%3A%2200000000000100%22%7D%2C%7B%22dim%22%3A%22campaigns%2Fcampaign-summary%2Fuser_segment_breakdown%22%2C%22table%22%3A%7B%22key%22%3A%22%22%2C%22order%22%3A%22asc%22%2C%22page%22%3A1%7D%2C%22legend%22%3A%220000000000010%22%7D%5D%7D%7D
Posted by Rijumone Choudhuri 7 months ago
I've been using publisher_bid_modifier for months with no problems. Today, my system is unable to change CPC (site level). Below, the message that my system is receiving due to the cpc_modification sent. I paused all my campaigns. Waiting for a return. cpc_modification | message 0.2 | The bid amount cannot be less than the minimum 0.01 USD 0.4 | The bid amount cannot be less than the minimum 0.025 BRL 1.0 | The bid amount cannot be less than the minimum 1.0 JPY 1.2 | The bid amount cannot be less than the minimum 1.0 JPY
Posted by David 7 months ago
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 8 months ago
We need to have an ability to get hourly statistic for specific campaigns. There is such an ability on the UI (https://i.imgur.com/LSP2LyO.png), but we did`t find a way to get this statistic via the API (https://i.imgur.com/R3rEqZS.png). Please let us know whether we can retrieve hourly statistic for a specific campaign via the API?
Posted by Alex Kolesnykov 11 months ago
I am trying to get hourly data, and the API only responds with hour 0. Is there a special parameter I need to pass in order to get the entire day of hourly? Here is an example of my API call: https://backstage.taboola.com/backstage/api/1.0/spigot-network/reports/campaign-summary/dimensions/by_hour_of_day?start_date=2020-02-20&end_date=2020-02-20&include_multi_conversions=true
Posted by Carl about a year ago
hi ! im using reporting campaign-summary for a while now but i have been facing an issue in the last couple of days when i run the report for the endpoint : https://backstage.taboola.com/backstage/api/1.0/<account_name>/reports/campaign-summary/dimensions/campaign_day_breakdown?start_date=2020-01-29&end_date=2020-01-29 i get a list of all campaigns including paused which sums up to a lot of campaigns do i need to delete all paused campaigns for the not to show up in the reporting ? or is there another parameter so that the paused campaigns will not show up in the reporting ?
Posted by shani shamilovich about a year ago
Hi there, 2 questions related to the API: 1. Are there any formal API rate limits? We have not bumped into any limits, but are about to ramp up our ingest of performance data and want to make sure we are good citizens. 2. I have found API docs for the campaign-level blacklisting (https://backstage-api.readme.io/reference#patching-targeted-publishers) but no docs for an account-level blacklist. However, in the backstage UI if I go to Campaign Summary -> By Site, there does appear to be the ability to manually blacklist sites for my account. Is there a way to ingest or update this list via the API? Thanks! Cleve
Posted by Cleve Pasarell about a year ago