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 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 7 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 7 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 7 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 7 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 7 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 7 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 7 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 8 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 8 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 8 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 8 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 8 months ago
When duplicating a campaign from an account A to account B after 6pm EST fails with "Start Date cannot be set in the past" error. The POST endpoint with JSON body is attached below : ------------------------------------------------------------------ https://backstage.taboola.com/backstage/api/1.0/{account_A}/campaigns/{campaignId}/duplicate?destination_account={account_B} {'tracking_code': 'parameter=1234', 'branding_text': 'Search', 'spending_limit': 40, 'name': 'this_is_the_campaign_name', 'daily_cap': 20, 'platform_targeting': {'type': 'INCLUDE', 'value': ['DESK']}, 'cpc': 0.5, 'country_targeting': {'type': 'INCLUDE', 'value': ['US']}, 'spending_limit_model': 'MONTHLY', 'marketing_objective': 'DRIVE_WEBSITE_TRAFFIC'} ------------------------------------------------------------------ Any recommendation on how to be able to duplicate without start date error?
Posted by Melody Song 9 months ago