campaign_simulation

  • Campaign simulations support various combinations of advertising channel type, simulation type, and simulation modification method, including SEARCH, SHOPPING, MULTI_CHANNEL, DEMAND_GEN, DISPLAY, and PERFORMANCE_MAX channels with different simulation types and modification methods.

  • You can select fields from attributed resources like campaign and customer when querying campaign simulations, but these fields will not segment metrics.

  • Key fields available for campaign simulations include campaign ID, start and end dates of the simulation, the method and type of modification used, and projected metrics for various budget, CPC bid, target CPA, target impression share, and target ROAS amounts.

  • The resource name for a campaign simulation follows a specific format including the customer ID, campaign ID, simulation type, modification method, and the start and end dates.

A campaign simulation. Supported combinations of advertising channel type, simulation type and simulation modification method is detailed below respectively. * SEARCH - CPC_BID - UNIFORM * SEARCH - CPC_BID - SCALING * SEARCH - TARGET_CPA - UNIFORM * SEARCH - TARGET_CPA - SCALING * SEARCH - TARGET_ROAS - UNIFORM * SEARCH - TARGET_IMPRESSION_SHARE - UNIFORM * SEARCH - BUDGET - UNIFORM * SHOPPING - BUDGET - UNIFORM * SHOPPING - TARGET_ROAS - UNIFORM * MULTI_CHANNEL - TARGET_CPA - UNIFORM * MULTI_CHANNEL - TARGET_ROAS - UNIFORM * DEMAND_GEN - TARGET_CPA - DEFAULT * DISPLAY - TARGET_CPA - UNIFORM * PERFORMANCE_MAX - TARGET_CPA - UNIFORM * PERFORMANCE_MAX - TARGET_ROAS - UNIFORM * PERFORMANCE_MAX - BUDGET - UNIFORM

Attributed resources
campaign
customer

Fields from the above resources may be selected along with this resource in your SELECT and WHERE clauses. These fields will not segment metrics in your SELECT clause.

campaign_simulation.budget_point_list.points

Field descriptionProjected metrics for a series of budget amounts.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v19.common.BudgetSimulationPoint
FilterableFalse
SelectableTrue
SortableFalse
RepeatedTrue

campaign_simulation.campaign_id

Field descriptionOutput only. Campaign id of the simulation.
CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_simulation.cpc_bid_point_list.points

Field descriptionProjected metrics for a series of CPC bid amounts.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v19.common.CpcBidSimulationPoint
FilterableFalse
SelectableTrue
SortableFalse
RepeatedTrue

campaign_simulation.end_date

Field descriptionOutput only. Last day on which the simulation is based, in YYYY-MM-DD format
CategoryATTRIBUTE
Data TypeDATE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_simulation.modification_method

Field descriptionOutput only. How the simulation modifies the field.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v19.enums.SimulationModificationMethodEnum.SimulationModificationMethod
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_simulation.resource_name

Field descriptionOutput only. The resource name of the campaign simulation. Campaign simulation resource names have the form: customers/{customer_id}/campaignSimulations/{campaign_id}~{type}~{modification_method}~{start_date}~{end_date}
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

campaign_simulation.start_date

Field descriptionOutput only. First day on which the simulation is based, in YYYY-MM-DD format.
CategoryATTRIBUTE
Data TypeDATE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

campaign_simulation.target_cpa_point_list.points

Field descriptionProjected metrics for a series of target CPA amounts.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v19.common.TargetCpaSimulationPoint
FilterableFalse
SelectableTrue
SortableFalse
RepeatedTrue

campaign_simulation.target_impression_share_point_list.points

Field descriptionProjected metrics for a specific target impression share value.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v19.common.TargetImpressionShareSimulationPoint
FilterableFalse
SelectableTrue
SortableFalse
RepeatedTrue

campaign_simulation.target_roas_point_list.points

Field descriptionProjected metrics for a series of target ROAS amounts.
CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v19.common.TargetRoasSimulationPoint
FilterableFalse
SelectableTrue
SortableFalse
RepeatedTrue

campaign_simulation.type

Field descriptionOutput only. The field that the simulation modifies.
CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v19.enums.SimulationTypeEnum.SimulationType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse