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 are trying to get information about the sum of budget spent for 1 day, but we can see only total amount spent for the whole campaign time. Spending limit is set as "monthly". Is it possible to get daily budget spent without changing spending limit type? Update: we are asking about using the "get all campaigns" request, but we know that the spent is shown also in the reporting data. Just because we're trying to use as less as possible requests at once.
Posted by Natalia Smirova 4 months ago
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 6 months 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 6 months ago
Hello, I'd like to know how to obtein via the plateforme, the id audience taht API need in collection for targeting. The id audience in the plateform is not the same apparently.
Posted by MΓ©lanie Macias 10 months 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 11 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 about a year 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 about a year 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 about a year 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 about a year 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 about a year 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