campaign_simulation

  • Campaign simulation allows modeling different advertising scenarios across various channels and modification methods.

  • Supported simulations cover Search, Shopping, Multi-Channel, Demand Gen, Display, and Performance Max advertising channel types with various simulation types and modification methods.

  • You can select fields from campaign and customer resources along with campaign simulation fields in your queries.

  • Key fields available for selection and filtering include simulation details like budget, CPC bid, target CPA, target impression share, target ROAS, start and end dates, modification method, type, campaign ID, and the resource name.

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.v20.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.v20.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.v20.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.v20.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.v20.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.v20.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.v20.enums.SimulationTypeEnum.SimulationType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse