Community Discussion
Taboola API Testing Sandbox Environment
Hello,
I was curious if Taboola has a Sandobox environment to test API calls. Just so I don't have to use my production account all the time.
Thank you,
Surya
Posted by Gokul C about 4 years ago
Campaign Summary Report By Site and Country
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 over 4 years ago
Duplicate campaigns to different advertiser (within the same account)
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 over 4 years ago
Reports by OS Version
Hi,
Is there an option to get reports by OS versions? Clicks, Cost etc?
Thanks
Posted by Andrey 101 over 4 years ago
Duplicate a campaign to another advertiser
Hey,
Is there an option to choose a different provider (advertiser) when using a "duplicate campaign API"?
For example, if I have "demo-advertiser" (that contains campaign 123) and "another-advertiser", can I do something like:
curl --request POST \
--url https://backstage.taboola.com/backstage/api/1.0/demo-advertiser/campaigns/123/duplicate \
--header 'content-type: application/json' \
--data '{"name":"Copy to another", "advertiser": "another-advertiser"}'
Thanks!
Posted by Sasha over 4 years ago
Reporting API at the item / thumbnail level
Hi, is campaign reporting (through API) available at the item / thumbnail level?
I created items / thumbnails, each with title and URL in the Campaign Inventory. Is there any way to pull campaign reporting at such item / thumbnail level, through the reporting API ?
Thanks
Posted by Jack Qian over 4 years ago
Reporting issue with 'campaign_breakdown'
Hi,
We are requesting for this report (reports/campaign-summary/dimensions/campaign_breakdown) several times a day.
We request it for 2 time periods:
- 1 day
- 365 days (to get campaign lifetime spend)
I suspect that sometimes, depending on how long it took to respond, the response is not full.
It happens randomly when we try to parse the response to json and it fails:
`ValueError: Unterminated string starting at: line 1 column 25130053 (char 25130052)`
`ValueError: Unterminated string starting at: line 1 column 44233078 (char 44233077)`
This suggests the response is incomplete.
And indeed, catching the response itself when this happens shows HTTP200 but the response itself is not complete:
"..."conversions_value":0.00,"roas":0.00,"ctr":0E-18,"vctr":0E-18,"cpm":0.00,"vcpm":0.00,"cpc":0.00,"campaigns_num":1,"cpa":0.00,"cpa_actions_nu"
I do not think this is a timeout from our end as we wait for 360 seconds and the error happens much sooner than that.
So I suspect your server cut the response if it happens to take to long, and then I get a partial response.
Please advise on how to get this solved...
Perhaps there is a way to cut the report to chunks (paged report) or perhaps selecting which dimensions will be returned? (i only want the spend in this case).
example request that just failed:
GET 'https://backstage.taboola.com/backstage/api/1.0/samyonetwork/reports/campaign-summary/dimensions/campaign_breakdown?start_date=2019-05-27&end_date=2020-05-26'
response headers:
{'X-Timer': 'S1590508558.250668,VS0,VE5509', 'X-XSS-Protection': '1; mode=block', 'X-Cache': 'MISS', 'X-Content-Type-Options': 'nosniff, nosniff', 'transfer-encoding': 'chunked', 'Accept-Ranges': 'bytes', 'Expires': '0', 'Vary': 'Accept-Encoding', 'X-Served-By': 'cache-bwi5053-BWI', 'Server': 'nginx', 'Connection': 'keep-alive', 'Via': '1.1 varnish', 'X-Cache-Hits': '0', 'Pragma': 'no-cache', 'Cache-Control': 'no-cache, no-store, max-age=0, must-revalidate', 'Date': 'Tue, 26 May 2020 15:56:03 GMT', 'P3P': 'policyref="http://trc.taboola.com/p3p.xml", CP="NOI DSP COR LAW NID CURa ADMa DEVa PSAa PSDa OUR BUS IND UNI COM NAV INT DEM"', 'Content-Type': 'application/json;charset=utf-8', 'X-Frame-Options': 'DENY'}
Posted by Or over 4 years ago
Report By Hour + By Campaign
Hey team,
I am looking for a way to get hourly data (specifically spend, clicks) in an hourly resolution with the ability to get the data by campaign. So either:
a. By campaign breakdown with an hourly resolution.
b. Hourly data with the ability to filter by campaign.
Are any of these possible ?
Thanks !
p.s. Option b. is possible via your dashboard so I'm sure the data is there but not sure how to access it programmatically.
Posted by Shai over 4 years ago
You can not target/block more than 1,500 sites even if I can see only half blocked
Hi Peter,
I'm receiving this error:
{"http_status":400,"message":"You can not target\/block more than 1,500 sites.","offending_field":""}
I know the limit is 1500 per campaign and 1500 per account limit. We have blocked 1121 blocked on the account level and 463 at the campaign level.
But I don't understand why we cannot block anymore at the campaign level as I can see that we blocked only 463. There are some cases where we request to block some publisher_id and I can't see it in the blocked list even if I received the OK message.
Campaign id: 4667401
https://www.screencast.com/t/rpQvZ4Vdm
Our account is: "[email protected]"
Thank you!
Posted by alexandru ciocan over 4 years ago
Block Levels
I'm looking at your `Campaign Summary` reports (specifically in relation to the `platform_breakdown` dimension), and I'm trying to understand the potential `blocking_level` values listed in your documentation.
https://developers.taboola.com/backstage-api/reference#dimension-specific-columns
These three don't fit with my current mental model of how Taboola blocking works.
```
EMULATED - Emulated auto-block
NETWORK - Network level block
ADVERTISER_NETWORK - Advertiser network level block
```
Can you provide more color?
Assuming `NETWORK` or `ADVERTISER_NETWORK` spans multiple Taboola accounts, can we have an api access point to mutate these values? We currently have to iterate over all our accounts to perform blocks. During product planning, one of our major risks was the quantity limits at the different blocking levels. An additional Network level block would alleviate some of our current concerns, simplify our processes and reduce api calls.
Posted by Nesan Waran over 4 years ago