Welcome to the Taboola Backstage API documentation. You'll find comprehensive guides and examples to help you get started with Taboola Backstage API quickly.
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 8 months ago
Some sites cannot be blocked through API: 1317418 caras.com.mx 1316462 levante-emv.com 1316357 dailystar.co.uk 1315252 musicmundial.com We are using the PATCH endpoint: https://backstage.taboola.com/backstage/api/1.0/{account}/campaigns/{campaign} API response is (404): { "http_status": 404, "message": "account" } Can you help checking why this happens?
Posted by Pirouzn Nilforoush 8 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 8 months ago
Hello, I'll be glad to know how do I get the 'lookalike' audiences ID's. It's possible to edit other audiences, and their ID's are presented on the editing page's URL, but for some reason, 'lookalike' audiences can't be edited, so it's impossible to get their URL (and ID). Thank you,
Posted by Noa Kaftory 8 months ago
I want to use the patch modify bids endpoint to change bids and strategies on certain sites, and I would want to change the bid occusainly, how could I know when to use `ADD` and when to use `REPLACE` as a `patch_operation`? I would usually patch multiple sites at once so I don't want to send a GET request for every site.
Posted by Abdallah AlHalees 9 months ago
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 9 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 9 months 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 9 months 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 9 months 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 9 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 9 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 9 months ago