Community Discussion

Ask a Question
ANSWERED

API CAMPAIGN SUMMARY REPORT - Date timezone

Hi, I'm trying to get he CAMPAIGN SUMMARY REPORT by date. is the dates i'm providing as parameters are in utc?
ANSWERED

Add video item

We are working on the feature to allow uploading video creatives through our campaign creation feature and some questions: 1. Do you have integration to get videos from Getty images (or other provider) - just like you have with image creatives? 2. For the default images which accompany the video - can we get these from Getty images? I'm asking since you have a unique flow on how these getty images can be used so I'm trying to understand if it's possible to use it as the default images for the video item. 3. Can we upload more than one video at a time? 4. What about variations as we do with image creatives where we create combinations between all the images and the titles which are selected, is it possible to do with videos?
ANSWERED

Granular Data Request

We were going through the API documents and it looks like the most granular data we can request is the "by_hour_of_day" dimension from the campaign summary dimensions endpoint. Two questions related to this: - Is this the most granular data we can request? We would love to be able to access our costs and clicks at a finer time grain. - Is this the only way to get data at a finer grain than "by-day" for a "by-campaign-by-site" analysis? What we mean is that if we want to do a site-by-site analysis for a campaign running on 500 sites, we would have to ping the "by_hour_by_day" endpoint 500 times for a single campaign. Is there another way to get hourly (or even more granular) data at the "by-campaign-by-site" level?
ANSWERED

API Audience Creation/Update

Hello Is there an option to create and update an Audience via the API? We have built audiences by uploading a list of email addresses manually before but we are looking to do this via API and updating everyday. I have looked in the documentation but cannot find the answer I am looking for. Can you point me to the documentation for this so I can send to our developers? Thanks
ANSWERED

old version items missing from Top Campaign Content

Hi, we use Taboola Backstage API in our product, using this url "backstage/api/1.0/%s/reports/top-campaign-content/dimensions/item_breakdown?start_date=%s&end_date=%s", we see that there are items missing from the response, all items that are labeled "(old version)" that are present in the Taboola UI in Top Campaign Content are missing from the API response, I tried looking into the docs but couldn't find any clue related to (old version) items and how to pull them!! any advise on why there are missing?
ANSWERED

API Error: site does not belong to campaign targetting

Hello, we are getting this error when trying to block some site via API. The problem is that these sites do belong to the campaign and are also currently getting traffic. There are multiple examples but below I'm sending just one: Campaign id: 9761652 Sites we're trying to block: nbcsports-probasketballtalk, tegna-wxia
ANSWERED

Get Campaign Summary Report Returns Empty

I sent a GET request to "https://backstage.taboola.com/backstage/api/1.0/<account_id>/reports/campaign-summary/dimensions/campaign_breakdown?start_date=2021-08-09&end_date=2021-08-31" with my access_token in the header. I get the following response: {"last-used-rawdata-update-time":"2021-08-11 16:00:00.0","last-used-rawdata-update-time-gmt-millisec":1628665200000,"timezone":"JST","results":[],"recordCount":0,"metadata":{"total":0,"count":0,"start_date":"2021-08-09T00:00:00UTC","end_date":"2021-08-31T00:00:00UTC","static_fields":[{"id":"date","format":null,"data_type":"DATE"},{"id":"campaign_name","format":null,"data_type":"STRING"},{"id":"campaign","format":null,"data_type":"STRING"},{"id":"clicks","format":null,"data_type":"NUMERIC"},{"id":"impressions","format":null,"data_type":"NUMERIC"},{"id":"visible_impressions","format":null,"data_type":"NUMERIC"},{"id":"spent","format":null,"data_type":"MONEY"},{"id":"conversions_value","format":".2f","data_type":"MONEY"},{"id":"roas","format":".2f","data_type":"PERCENT"},{"id":"ctr","format":null,"data_type":"PERCENT"},{"id":"vctr","format":null,"data_type":"PERCENT"},{"id":"cpm","format":null,"data_type":"MONEY"},{"id":"vcpm","format":null,"data_type":"MONEY"},{"id":"cpc","format":null,"data_type":"MONEY"},{"id":"campaigns_num","format":null,"data_type":"NUMERIC"},{"id":"cpa","format":null,"data_type":"MONEY"},{"id":"cpa_actions_num","format":null,"data_type":"NUMERIC"},{"id":"cpa_conversion_rate","format":null,"data_type":"PERCENT"},{"id":"currency","format":null,"data_type":"STRING"}]}} partner_types:["VIDEO_ADVERTISER"] campaign_types:null Is there a way to get the report with the VIDEO_ADVERTISER account? Thank you.
ANSWERED

How to include new site on my account

Hi There is anyway to add new sites on my taboola using api.taboola has account level publisher excluding option.is it possible to get publisher adding option?
ANSWERED

how can I can get bid and bid modifier as well

How to get additional fields in site level summary report? Hi Admin. I am trying to get site level summary report. I want to know how can I can get bid and bid modifier as well? This is the request URL : "https://backstage.taboola.com/backstage/api/1.0/" . env('TABOOLA_API_ACCOUNT_ID') . "/reports/campaign-summary/dimensions/site_breakdown" Could you please help me with how to get these additional fields in the summary report? Thanks.
ANSWERED

How to get campaign details in campaign level summary reports?

Hi, Admin I am trying to get campaign level summary report. I want to know if I can get campaign status, daily_cap, CPC as well? This is the request URL : "https://backstage.taboola.com/backstage/api/1.0/" . env('TABOOLA_API_ACCOUNT_ID') . "/reports/campaign-summary/dimensions/campaign_breakdown" Could you please help me with how to get additional fields in the summary report? Thanks. Legendary Phoenix
150030003014004014034044294_flows50050390_daysaccess_tokenaccountaccount_creationaccount_idaccount_levelaccount_level_blockaccount_typeaccountsactivity_scheduleactual_cpcadvertiser_idadvertisersallowed_accountsalphabeticapi_accessapi_changesapi_keyapi_newsletterapi_secretaudienceaudience_onboardingaudience_segmentsaudience_targetingaudiencesaudit_trailauthorization_codeauto_targetingaws_downtimeaws_serverbalancebasebasic_authenticationbibidbid_modifierbid_modifiersbillingbilling_cycleblockblock_publisherblock_publishersbrand_safetybrowser_breakdownbulk_createbulk_updatebulk_update_campaignsby_audienceby_campaignby_hour_of_daycachingcampaigncampaign_daycampaign_day_breakdowncampaign_fieldscampaign_learningcampaign_levelcampaign_ownercampaign_site_daycampaign_summarycampaignscity_targetingclick_idclicksclient_credentialscode_snippetconnectorcontent-typeconversion_dataconversion_ruleconversionsconversions_valuecorscountriescountrycountry_codescpa_actionscpa_actions_numcpccpc_macrocreate_campaigncreate_itemcreate_timecreation_datecustom_audiencecustom_audience_rulecustom_conversion_rulecustom_conversionscut_offdaily_capdaily_spenddata_freshnessdata_studiodata_studio_connectordayday_dimensiondelaydeletedictionarydifferent_accountdiscrepancydocs_issuedocumentationdomainduplicateduplicate_campaignempty_responseend_dateevent_basedexelatefeature_requestfetch_levelfiltersfirst_party_audienceflowfull_authenticationget_account_detailsgoogle_apps_scriptgoogle_scriptgoogle_sheetshidden_audiencehidden_segmentshourlyhourly_reportinghourly_spendhtmlhtml_login_pagehtml_responseiasimplicit_flowinactive_accountsinclude_multi_conversionsinclusionsintegrationinternal_support_ticketip_addressis_atomicitemitemsixudra_curljava_client_sdkjava_sdkjavascriptjsjupyter_notebooklaravellearning_statelimitlist_of_publisherslookalike_audiencelookalike_audienceslookback_windowloss_of_scalemacrosmalformed_jsonmarketplacemarketplace_audiencesmax_campaignsmax_itemsmax_resultsminimum_bidminimum_cpcmixedanalyticsmy_audiencesnetworknetwork_accountnew_featurenullnumeric_site_idoauth2os_breakdownpage_viewpagingpartner_typepassword_credentialspatchpausepermissionsphppixel_lookalikeplacementplacement_breakdownplacement_filterplacement_nameplatform_targetingpostmanprecannedprerequisites_not_metpublisherpublisher_bid_modifierpublisher_blockspublisher_idpublisher_namepublisher_networkpublisher_reportspublisher_targetingpublisher_urlpublisherspythonpython_clientrrate_limitreal_timereal_time_reportingrecommendation_apiredirect_urirejected_campaignsremove_allreport_cachingreportingreporting_discrepancyreportsretention_periodrevenuerevenue_summaryrevenue_summary_reportroadmaps2ssafety_ratingsalessandboxscalesitesite_breakdownsite_nameslowslownesssort_filterspecial_charsspendspending_limitsslssostatussub_accountssupermetricssupport_tickettataboola_adstaboola_pixeltargetingtcctest_accounttheoptimizertimeouttimezonetlstop_campaign_contenttop_contenttracking_codetypouiunblock_publishersunknown_publisherupdate_itemupload_imageurluser_accountsuser_segmentsutmvaluevideovideo_campaign_summaryvideo_campaignsvideo_completionsvideo_itemvideo_itemsviewsvisit_valuevoluumweb_hookswhitelistx-www-form-urlencodedyearly_reportingנ