Skip to main content
POST
[DEPRECATED] Campaign Performance Forecasts

Autorizaciones

Authorization
string
header
requerido

A valid API key generated in Topsort's UI. Use the TSE API key if calling auctions or events API, otherwise use the TSC API key.

Cuerpo

application/json
dailyBudget
number
requerido

Daily budget for the campaign

dateRange
PublicDateRange · object
requerido

Campaign date range

targetRoas
number
requerido

Target Return on Ad Spend

campaignFormat
string
requerido

Campaign format type. Must be 'listing'.

Allowed value: "listing"
campaignType
string
requerido

Campaign type. Must be 'autobidding'.

Allowed value: "autobidding"
products
PublicProductRequest · object[]
requerido

List of products in the campaign (required)

Minimum array length: 1
triggers
PublicTriggerRequest · object[]

List of campaign triggers (optional, defaults to empty list)

targets
enum<string>[] | null

Optional list of target variables to forecast. If not provided, all targets will be forecasted.

Opciones disponibles:
ad_spend,
clicks,
impressions,
purchases,
sales
targetingFilters
PublicCampaignTargetingFilters · object | null

Optional audience targeting, in the same shape as campaign creation. When active, the forecast covers only users in these segments. Segment IDs are the marketplace's external segment IDs.

multiplierConfig
PublicCampaignMultiplierConfig · object | null

Optional audience bid multipliers, in the same shape as campaign creation. Segment IDs are the marketplace's external segment IDs.

exclusionFilters
PublicCampaignExclusionFilters · object | null

Optional audience exclusion, in the same shape as campaign creation. When active, the forecast leaves out users in these segments. Segment IDs are the marketplace's external segment IDs.

Respuesta

Successful Response

forecasts
PublicCampaignForecastMetrics · object
requerido

Campaign performance forecasts