Welcome to the Taboola Backstage API documentation. You'll find comprehensive guides and examples to help you get started with Taboola Backstage API quickly.
Hello, I`ve done an HTTP request to get the summary report. I`ve noticed that the response data is coming without total conversions (as you can see in the website) someone knows how can you get the total conversions in the same line as every campaign in the summary report? Thanks in advance!
Posted by Guy Horowitz 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
Greetings, We've worked with the backstage API a bit before, but for a new project, we had a sandbox environment set up for testing purposes. We are having difficulty getting our API call to work, and the errors that are returning are not at all helpful. I really wish the API responded with more information to help troubleshoot. If we use the numerical account ID provide by our account manager we get the following error: {http_status: 403, message: "Requested action is forbidden”} If we use the alpha string ID ie. "Your Account Sandbox Name" with letters and spaces we get the following error: "Bad Request" Our payload follows the JSON structure outlined here: https://developers.taboola.com/backstage-api/reference#creating-a-batch-of-campaign-items That is the method we are calling from our application, which submits the JSON object via an AJAX post. Here is a section of our code to show what we are doing: $url = 'https://backstage.taboola.com/backstage/oauth/token'; $data = array('client_id' => $taboolaCID, 'client_secret' => $taboolaSecret, 'grant_type' => 'client_credentials'); $options = array( 'http' => array( 'header' => "Content-type: application/x-www-form-urlencoded\r\n", 'method' => 'POST', 'content' => http_build_query($data), ) ); $context = stream_context_create($options); $result = file_get_contents($url, false, $context); $taboolaAccessToken = json_decode($result)->{'access_token'}; $ch = curl_init('https://backstage.taboola.com/backstage/api/1.0/'.$taboolaAccount.'/campaigns/'.$campaign_id.'/items/mass' ); $payload = json_encode($collection, JSON_UNESCAPED_SLASHES); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_USERAGENT, ‘Our Application Name'); curl_setopt($ch, CURLOPT_POST, true); curl_setopt($ch, CURLOPT_POSTFIELDS, $payload ); curl_setopt($ch, CURLOPT_HTTPHEADER, array( 'Content-Type: application/json', 'cache-control: no-cache', 'Authorization: Bearer ' . $taboolaAccessToken )); $data = curl_exec($ch); $info = curl_getinfo($ch); curl_close($ch); Any assistance would be greatly appreciated. Thanks!
Posted by Chris Ellerby about a year ago
Per the Taboola Backstage API documentation: "Ask your Taboola account manager for a client_id and client_secret" It isn't clear if the account manager is an individual with Taboola or the actual Taboola account owner. At any rate- we need our client_id and client_secret and we're don't know where to generate these values. Could you please point me in the right direction to obtaining these?
Posted by Michael Petruniak about a year ago
Hello, I have already accessed this endpoint, retrieved a list of accounts, and stored their account_id values. https://backstage.taboola.com/backstage/api/1.0/backstage/api/1.0/users/current/allowed-accounts Later, I would like to look up the details for one Account using its account_id. Is there an API endpoint for this operation?
Posted by Andy Shih 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
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
Hey, I am trying to patch publisher bid modifier trough backstage api but i get an error 404 with message "account" Could you provide any information what could cause this kind of error? request body: { "patch_operation": "ADD", "publisher_targeting": null, "publisher_bid_modifier": { "values": [ { "target": "123456", "cpc_modification": 1.1 } ] }, "publisher_bid_strategy_modifiers": null } response body { "http_status": 404, "message": "account" } Elvar
Posted by Elvar Liiv about a year ago
Hello, We noticed that some campaign does not have spent report by markerplace audiences (aka user segements) For example this campaign is running and spending https://backstage.taboola.com/backstage/api/1.0/hooch-sc/reports/campaign-summary/dimensions/day?campaign=4630143&start_date=2020-05-24&end_date=2020-06-24 Results": [ { ... lot of numbers ... }] https://backstage.taboola.com/backstage/api/1.0/hooch-sc/reports/campaign-summary/dimensions/user_segment_breakdown?campaign=4630143&start_date=2020-05-24&end_date=2020-06-24 "results": [], "recordCount": 0, Yet for this campaign we can get marketplace re[ort: https://backstage.taboola.com/backstage/api/1.0/hooch-sc/reports/campaign-summary/dimensions/user_segment_breakdown?campaign=4510509&start_date=2020-05-24&end_date=2020-06-24 I tried different dates range. So far I can't find an explanation why some spending campaigns have marketplace data and some not: seems not to be connected to having audiences, age, etc More examples of campaigns without marketplace data (from the same advertiser): 4437436 4630143 4469611 - about 20% of spending campaigns are missing Taboola UI also does not show "by audience" data. We are starting audience research project and have data from all campaigns or understand why some does not have marketplace data will be great. Thanks, Misha
Posted by Michael Makarevsky about a year ago
Hello, In taboola UI: When we select "network" in advertiser selection in top right corner and then duplicate campaign (by click the last icon in campaign management) we have option to select advertiser on the next screen (its called provider). However if we select specific advertiser we can duplicate only to the same advertiser - "provider" selection is grayed out. We try to use the first behavior via API, duplicate campaign to different advertiser. This is attempt to duplicate to different advertiser from network level as its done in UI: https://backstage.taboola.com/backstage/api/1.0/webfoxconetwork/campaigns/5159895/duplicate RES { "http_status": 404, "message": "Resource not found" } This is attempt to duplicate to different advertiser (we not expected this will work as its not working in taboola UI) https://backstage.taboola.com/backstage/api/1.0/bleacherbreaker-sc/campaigns/5159895/duplicate BODY: { "advertiser_id": "bleacherbreaker-m-sc", "name": "wuz-d-uk-c-0-p3-200623-bb-tb-0--dev" } RES { "http_status": 400, "message": "Trying to modify a read-only field", "offending_field": "advertiser_id" } Without passing "advertiser_id" duplication works fine. Can we somehow duplicate to different advertiser_id from API as its done from taboola UI? This can help us to avoid manual operations/error and reduce usage of taboola UI. Thanks, Misha
Posted by Misha Makarevsky about a year ago
I'm getting 404 status response when trying to call https://backstage.taboola.com/backstage/api/1.0/{accountId}/campaigns/{campaignId}/items/{campaignItemId}. The account/campaign/campaign item, all them exists, and are valid.. but still the endpoint is giving me 404, can you please let me know why that can happen?
Posted by Gabriel Diaz about a year ago
Hi, I'm getting this error trying to create a campaign through API: Failed to perform API call with response code [400]. Response payload status [400], message [You have exceeded the maximal number of active campaigns per account]. According to our research on this topic, the maximum is 3000, but so far we have created only 554 campaigns in one of our accounts. Can you please let me know the real threshold.
Posted by Gabriel Diaz about a year ago
If I want to get Taboola data into Tableau directly, do I have to have a database to store this, or can I do this locally if I don't have much data? I am trying to figure out if it is necessary for me to use an integrator and storage solution like Panoply for this. Thanks.
Posted by Alex about a year ago
I've tried to connect SuperMetrics for Google Sheet with my Taboola account but only got this error: https://share.online-marketingagentur.com/AJNBzK That's strange because, in the past, the same connection already worked fine. Any suggestions?
Posted by Marcel 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
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. about a year 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 about a year 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 about a year ago