Realtime Campaign Report

get

https://backstage.taboola.com/backstage/api/1.0/{account_id}/reports/realtime-campaign-summary/dimensions/{dimension}

Provides performance data for campaigns in (near) real time.

Rate limit: Tier 4

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

📍
Important

Metrics and amounts are not accurate for billing.

📘
Dimensions & filters

Pass a dimension path param, and the relevant query param filters.

The chosen dimension determines which filters are supported.

Make sure to follow the specific guidelines for your chosen dimension and filters - see Dimensions Cheat Sheet and Filters.

📘
Sample requests
Some sample requests are provided below.

Rate limit

🚧
Rate limit
Tier 4. Each dimension has its own budget, separate from one another and from every other report.
See Rate limits for the request allowance each tier carries.

Path Params

account_id

string

required

An alphabetic ID. See Get Account Details.

dimension

string

enum

required

The report dimension (aka view) e.g. by_hour.
See: Dimensions Cheat Sheet

Query Params

start_date

string

required

E.g. 2023-03-28T00:00:00

end_date

string

required

E.g. 2023-03-28T23:59:59

campaign

string

1 or more numeric Campaign IDs, as a comma-separated list.
E.g.campaign=101,102,103

platform

string

1 or more platform enums, as a comma-separated list.
Possible values:
DESK
PHON
TBLT

country

string

1 or more 2-letter ISO-3166 country codes, passed as a comma-separated list.
Use the Dictionary to fetch a list of supported values.

site_id

string

1 or more numeric Site IDs (publisher Account IDs), as a comma-separated list.

fetch_config

boolean

If set to true, the report will return additional campaign columns for the by_campaign dimension, and will be limited to 1,000 rows.