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 currently researching the possibility of integrating Taboola Backstage, so that when changes happen in our account, we get some kind of event send to our internal Campaign Management system. To that end I want to ask if you have (or at least plan to have) any of the following: 1) Webhooks that fire when Campaigns and Items are created/updated with info on what changed 2) Some kind of account change event history that can be accessed from the API and provides the same info as the above 3) Fields with the time of the Campaign's or Item's creation/last update, preferably one you can filter on through the API 4) A way to all fetch Items in an account without having to make a separate API request for every Campaign. The UI has a screen like this, but the API seems to have no equivalent endpoint 5) Some kind of Sandbox environment or a testing account, where we can experiment with creating mock Campaigns without risking them being seen by our customers or getting charged/banned for it Thanks
Posted by Filip Filipov 8 months ago
I am trying to block a publisher within a single company via a POST request to a URL: https://backstage.taboola.com/backstage/api/1.0/account-id/campaigns/campaign-id Request body: { "publisher_targeting": { "type": "EXCLUDE", "value": [ "my-publisher" ], "href": null } } Next, I go to the control panel, where all the publishers of the campaign are located. Here I can see that the publishers I specified in the request body specified above are not blocked after the POST request is executed. What could be the problem? Perhaps there is a delay in the web interface until the actual data appears?
Posted by Danil Makogon 8 months ago
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 8 months ago
Hi there, we would like to integrate the Publisher Revenue Reporting API and have a few questions around limitations. Currently, the endpoint only supports a daily breakout. 1. Is there any non-documented feature that would allow hourly? The docs only show the option of UTM CAMPAIGN and UTM SOURCE + MEDIUM. 2. Is there any other option to get more granular data e.g. UTM CAMPAIGN + SOURCE + MEDIUM (ideally also TERM and CONTENT)? There is a Custom Key/Value report. With the account in use, these are always undefined. We couldn't find any documentation on how to set them and what the limits are. 3. Can you point us in the right direction?
Posted by Nils 8 months ago
If we have created custom conversions - is it possible to get statistics for them in reporting data by hour? For example, we've crated custom conversion 'specific' and we want to know how many 'specific' conversions we had for the last hour. From where should we take that data?
Posted by Natalia Smirova 9 months ago
Hello! I getting `campaign-summary` report using `campaign_site_day_breakdown`: https://backstage.taboola.com/backstage/api/1.0/<account_id>/reports/campaign-summary/dimensions/campaign_site_day_breakdown?start_date=2021-02-24&end_date=2021-02-24 API response is: { // omitted... "results": [ { "date": "2021-02-24 00:00:00.0", "site": "site-string-id", "site_name": "Site pretty name", "site_id": 1053067 // omitted... "site_url" field is not provided } } but there is no property containing `site_url`. How can I get it?
Posted by Skorokhodov Egor 9 months ago
Is there a chance to get data about not just conversions but about qualification conversions (ones on the customer's page) from the API ?
Posted by Natalia Smirova 9 months ago
Hello I am having problem with getting specifiec data from the api I am trying to get" Peres Academic Center - SC" data I got the Client ID and Client Secret and i got the token. but in the response i get message: 'Unknown publisher' what could be the problem?
Posted by shahar terem 9 months ago
How can we calculate thru the api the cost per click by publisher and time of the day? we need an estimate for live traffic and the real cost for updated data Where can I find more information on how this works
Posted by Mansour Bennouna 9 months ago
Hi, Iยดm trying to connect to TAboola APi via oAuth to google sheets, I have de credencials but when I log in in the account, Iยดm not redirect back to the google sheets. Example of the request: "https://authentication.taboola.com/authentication/login?grant_type=authorization_code&response_type=code&redirect_uri=https%3A%2F%2Fbackstage.taboola.com%2Fbackstage%2Fauthenticate%2Flogin&client_id=xxxxredir=https%3A%2F%2Fscript.google.com%2Fmacros%2Fd%2F12COOkin8nod....." Does this domain script.google.com need to be white listed by Taboola? Best.
Posted by Guilherme Malta 9 months ago
Hi, For our requirements, in each account I need the last 24 hours' spend per Publisher. With the Java SDK, I can easily get the spend per site in daily chunks using the **SITE_BREAKDOWN** dimension, however this doesn't support anything finer-grained, for instance if I want to know the spend from midday yesterday until midday today. It doesn't look possible through the Java SDK. I've also looked at calling the Backstage API directly, but even then it looks like I can only perform what I need one site per call using **campaign_hour_breakdown** with a site filter... ``` https://backstage.taboola.com/backstage/api/1.0/<account>/reports/campaign-summary/dimensions/campaign_hour_breakdown?start_date=2021-02-08&end_date=2021-02-09&site=<site name> ``` Our app can then aggregate the values in the response to calculate our spend on a site for the last 24 hours. Given that we are using thousands of Publishers, this could take some time! I'd love to know if there another more performant way of doing this? Cheers, Colin
Posted by Colin MacLean 10 months ago
I'm trying to toggle a campaign item's active status, however it returns with a 400 error: ``` Exception in thread "main" com.taboola.backstage.exceptions.BackstageAPIRequestException: Failed to perform API call with response code [400]. Response payload status [400], message [Unknown field name 'active'], offending field [null], message code [api.action.bad_request.null] at com.taboola.backstage.internal.SynchronousCallAdapterFactory$1.adapt(SynchronousCallAdapterFactory.java:70) at retrofit2.HttpServiceMethod$CallAdapted.adapt(HttpServiceMethod.java:165) at retrofit2.HttpServiceMethod.invoke(HttpServiceMethod.java:146) at retrofit2.Retrofit$1.invoke(Retrofit.java:160) at com.sun.proxy.$Proxy3.updateItem(Unknown Source) at com.taboola.backstage.services.CampaignItemsServiceImpl.updateItem(CampaignItemsServiceImpl.java:87) ``` My code is pretty simple (vars spoofed)... ``` Backstage backstage = Backstage.builder().build(); String accountName = "account123456"; String campaignId = "123456"; String itemId = "987654321"; CampaignItem item = backstage.campaignItemsService().readItem(clientAuth, accountName, campaignId, itemId); logger.info("ID:{} active:{} status:{} name:{}", item.getId(), item.getActive(), item.getStatus(), item.getTitle()); // Update status to opposite CampaignItemOperation operation = CampaignItemOperation.create().setActive(!item.getActive()); CampaignItem updatedItem = backstage.campaignItemsService().updateItem(clientAuth, accountName, campaignId, itemId, operation); ``` The code fails on the last line, with the above exception. Any ideas what I'm doing wrong? As you can see, I'm able to retrieve the Campaign Item just not update its active value.
Posted by Colin MacLean 10 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 10 months ago