Community Discussion

Hi, do you know what 'API endpoint URL' I could use to pull hourly statistics for a particular data range? I've tried this <https://backstage.taboola.com/backstage/api/1.0/stats/campaigns/performance?dimensions=hour_of_day&start_date=2023-0113&end_date=2023-01-13> but it returns the following error: { "http_status": 400, "message": "The requested operation failed since the API server cannot parse the request", "message_code": "api.action.bad_request.null" } Thanks!

campaignscampaign_summarycampaignhourly_reportinghourly

Posted by Steward over 1 year ago

ANSWERED

Calculating the Publisher spend for the last 24 hours

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

site_breakdownhourlyjava_sdkreports

Posted by Colin MacLean over 3 years ago

ANSWERED

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

reportsitemhourlyfeature_request

Posted by Jack Qian over 4 years ago

ANSWERED

Questions on Spend data

Hi there, are the Spend numbers coming from Taboola’s API ever inaccurate, in terms of costs related to real-time clicks? Are they ever ahead or behind, or inflated to predict Spend associated with future clicks? We’re seeing hourly data that reflects the possibility of Spend increasing before the clicks associated with it come through. Also, what time zone Taboola’s API is using? Thanks!

spendreportsreal_timehourlycachingdata_freshnesstimezone

Posted by Justin Farber over 4 years ago

ANSWERED

Hour of Day Reporting API

I am trying to get hourly data, and the API only responds with hour 0. Is there a special parameter I need to pass in order to get the entire day of hourly? Here is an example of my API call: https://backstage.taboola.com/backstage/api/1.0/spigot-network/reports/campaign-summary/dimensions/by_hour_of_day?start_date=2020-02-20&end_date=2020-02-20&include_multi_conversions=true

reportsby_hour_of_dayend_dateitemhourly

Posted by Carl over 4 years ago

1500 3000 301 400 401 403 404 429 4_flows 500 503 90_days access_token account account_creation account_id account_level account_level_block account_type accounts activity_schedule actual_cpc advertiser_id advertisers allowed_accounts alphabetic api_access api_changes api_key api_newsletter api_secret archive audience audience_onboarding audience_segments audience_targeting audiences audit_trail authorization_code auto_targeting aws_downtime aws_server balance base basic_authentication bi bid bid_modifier bid_modifiers bid_strategy billing billing_cycle block block_publisher block_publishers brand_safety browser_breakdown bulk_create bulk_update bulk_update_campaigns by_audience by_campaign by_hour_of_day caching campaign campaign_day campaign_day_breakdown campaign_fields campaign_learning campaign_level campaign_owner campaign_site_day campaign_summary campaigns city_targeting click_id clicks client_credentials client_id client_secret code_snippet connector content-type converesion_rule conversion_data conversion_rule conversions conversions_value cors countries country country_codes cpa_actions cpa_actions_num cpc cpc_macro create_campaign create_item create_time creation_date cta custom_audience custom_audience_rule custom_conversion_rule custom_conversions cut_off daily_cap daily_spend data_freshness data_studio data_studio_connector day day_dimension day_parting delay delete dictionary different_account discrepancy docs_issue documentation domain duplicate duplicate_campaign duplicate_campaigns empty_response end_date event_based exelate feature_request fetch_level filters first_party_audience flow full_authentication get_account_details google_apps_script google_script google_sheets hidden_audience hidden_segments hourly hourly_reporting hourly_spend html html_login_page html_response ias implicit_flow inactive_accounts include_multi_conversions inclusions integration internal_support_ticket ip_address is_atomic item items ixudra_curl java_client_sdk java_sdk javascript js jupyter_notebook languages laravel learning_state limit list_of_publishers lookalike_audience lookalike_audiences lookback_window loss_of_scale macros malformed_json marketplace marketplace_audiences max_campaigns max_items max_results minimum_bid minimum_cpc mixedanalytics my_audiences network network_account new_feature null numeric_site_id oauth2 os_breakdown page_view paging partner_type password_credentials patch pause permissions php pixel_lookalike placement placement_breakdown placement_filter placement_name platform_targeting postman precanned prerequisites_not_met publisher publisher_bid_modifier publisher_blocks publisher_id publisher_name publisher_network publisher_reports publisher_targeting publisher_url publishers python python_client r rate_limit real_time real_time_reporting realtime_reports recommendation_api redirect_uri rejected_campaigns remove_all report_caching reporting reporting_discrepancy reports retention_period revenue revenue_summary revenue_summary_report roadmap s2s safety_rating sales sandbox scale site site_breakdown site_name slow slowness sort_filter special_chars spend spending_limit ssl sso status sub_accounts supermetrics support_ticket ta taboola_ads taboola_pixel targeting tcc test_account theoptimizer timeout timezone tls top_campaign_content top_content tracking_code typo ui unblock_publishers unknown_publisher update_item upload_image url user_accounts user_segments utm value video video_campaign_summary video_campaigns video_completions video_item video_items views visit_value voluum web_hooks whitelist x-www-form-urlencoded yearly_reporting נ

Using 'hour_of_day' dimension

Calculating the Publisher spend for the last 24 hours

Reporting API at the item / thumbnail level

Questions on Spend data

Hour of Day Reporting API