ad_group_criterion_simulation

  • Ad group criterion simulations provide insights into the impact of potential changes to ad group criteria.

  • Supported simulations vary based on advertising channel type, criterion type, simulation type, and modification method, including options for DISPLAY, SEARCH, SHOPPING, and HOTEL channels.

  • You can select fields from associated resources like ad_group, ad_group_criterion, campaign, and customer in your queries.

  • Available fields provide details such as ad group ID, criterion ID, simulation dates, modification method, and projected metrics for different bid amounts.

  • The resource name uniquely identifies each ad group criterion simulation and includes key parameters like customer ID, ad group ID, criterion ID, type, modification method, start date, and end date.

An ad group criterion simulation. Supported combinations of advertising channel type, criterion type, simulation type, and simulation modification method are detailed below respectively. Hotel AdGroupCriterion simulation operations starting in V5. 1. DISPLAY - KEYWORD - CPC_BID - UNIFORM 2. SEARCH - KEYWORD - CPC_BID - UNIFORM 3. SHOPPING - LISTING_GROUP - CPC_BID - UNIFORM 4. HOTEL - LISTING_GROUP - CPC_BID - UNIFORM 5. HOTEL - LISTING_GROUP - PERCENT_CPC_BID - UNIFORM

Attributed resources
ad_group
ad_group_criterion
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.

ad_group_criterion_simulation.ad_group_id

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

ad_group_criterion_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

ad_group_criterion_simulation.criterion_id

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

ad_group_criterion_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

ad_group_criterion_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

ad_group_criterion_simulation.percent_cpc_bid_point_list.points

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

ad_group_criterion_simulation.resource_name

Field descriptionOutput only. The resource name of the ad group criterion simulation. Ad group criterion simulation resource names have the form: customers/{customer_id}/adGroupCriterionSimulations/{ad_group_id}~{criterion_id}~{type}~{modification_method}~{start_date}~{end_date}
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

ad_group_criterion_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

ad_group_criterion_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