campaign_simulation

Help me build a query Proto definition on GitHub

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 preceding resources can be selected along with this resource in your SELECT and WHERE clauses. These fields do not segment metrics in your SELECT clause.

campaign_simulation.budget_point_list.points

Field description

Projected metrics for a series of budget amounts.

CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v26.common.BudgetSimulationPoint
CapabilitiesSelectable: True
Filterable: False
Sortable: False
Repeated: True
Selectable with

campaign_simulation.campaign_id

Field description

Output only. Campaign id of the simulation.

CategoryATTRIBUTE
Data TypeINT64
CapabilitiesSelectable: True
Filterable: True
Sortable: True
Repeated: False
Selectable with

campaign_simulation.cpc_bid_point_list.points

Field description

Projected metrics for a series of CPC bid amounts.

CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v26.common.CpcBidSimulationPoint
CapabilitiesSelectable: True
Filterable: False
Sortable: False
Repeated: True
Selectable with

campaign_simulation.end_date

Field description

Output only. Last day on which the simulation is based, in YYYY-MM-DD format

CategoryATTRIBUTE
Data TypeDATE
CapabilitiesSelectable: True
Filterable: True
Sortable: True
Repeated: False
Selectable with

campaign_simulation.modification_method

Field description

Output only. How the simulation modifies the field.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v26.enums.SimulationModificationMethodEnum.SimulationModificationMethod
CapabilitiesSelectable: True
Filterable: True
Sortable: True
Repeated: False
Selectable with

campaign_simulation.resource_name

Field description

Output 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
CapabilitiesSelectable: True
Filterable: True
Sortable: False
Repeated: False
Selectable with

campaign_simulation.start_date

Field description

Output only. First day on which the simulation is based, in YYYY-MM-DD format.

CategoryATTRIBUTE
Data TypeDATE
CapabilitiesSelectable: True
Filterable: True
Sortable: True
Repeated: False
Selectable with

campaign_simulation.target_cpa_point_list.points

Field description

Projected metrics for a series of target CPA amounts.

CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v26.common.TargetCpaSimulationPoint
CapabilitiesSelectable: True
Filterable: False
Sortable: False
Repeated: True
Selectable with

campaign_simulation.target_impression_share_point_list.points

Field description

Projected metrics for a specific target impression share value.

CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v26.common.TargetImpressionShareSimulationPoint
CapabilitiesSelectable: True
Filterable: False
Sortable: False
Repeated: True
Selectable with

campaign_simulation.target_roas_point_list.points

Field description

Projected metrics for a series of target ROAS amounts.

CategoryATTRIBUTE
Data TypeMESSAGE
Type URLgoogle.ads.googleads.v26.common.TargetRoasSimulationPoint
CapabilitiesSelectable: True
Filterable: False
Sortable: False
Repeated: True
Selectable with

campaign_simulation.type

Field description

Output only. The field that the simulation modifies.

CategoryATTRIBUTE
Data Type
Type URLgoogle.ads.googleads.v26.enums.SimulationTypeEnum.SimulationType
CapabilitiesSelectable: True
Filterable: True
Sortable: True
Repeated: False
Selectable with