Join us live on
Discord on the Google Advertising and Measurement Community server and on
YouTube on October 15th at 10:00 AM EST! We will discuss the new features added in v26 of the Google Ads API.
ad_group_simulation
Stay organized with collections
Save and categorize content based on your preferences.
Help me build a query
Proto definition
An ad group simulation. Supported combinations of advertising
channel type, simulation type and simulation modification method is
detailed below respectively.
SEARCH - CPC_BID - DEFAULT
SEARCH - CPC_BID - UNIFORM
SEARCH - TARGET_CPA - UNIFORM
SEARCH - TARGET_ROAS - UNIFORM
DISPLAY - CPC_BID - DEFAULT
DISPLAY - CPC_BID - UNIFORM
DISPLAY - TARGET_CPA - UNIFORM
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_simulation.ad_group_id
Field description Output only. Ad group id of the simulation.
Category ATTRIBUTE
Data Type INT64
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False
Selectable with
The following fields/resources can be selected with this field:
ad_group_simulation.cpc_bid_point_list.points
Field description Projected metrics for a series of CPC bid amounts.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v26.common.CpcBidSimulationPoint
Filterable False
Selectable True
Sortable False
Repeated True
Selectable with
The following fields/resources can be selected with this field:
ad_group_simulation.cpv_bid_point_list.points
Field description Projected metrics for a series of CPV bid amounts.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v26.common.CpvBidSimulationPoint
Filterable False
Selectable True
Sortable False
Repeated True
Selectable with
The following fields/resources can be selected with this field:
ad_group_simulation.end_date
Field description Output only. Last day on which the simulation is based, in YYYY-MM-DD
format
Category ATTRIBUTE
Data Type DATE
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False
Selectable with
The following fields/resources can be selected with this field:
ad_group_simulation.resource_name
Field description Output only. The resource name of the ad group simulation.
Ad group simulation resource names have the form:
customers/{customer_id}/adGroupSimulations/{ad_group_id}~{type}~{modification_method}~{start_date}~{end_date}
Category ATTRIBUTE
Data Type RESOURCE_NAME
Type URL N/A
Filterable True
Selectable True
Sortable False
Repeated False
Selectable with
The following fields/resources can be selected with this field:
ad_group_simulation.start_date
Field description Output only. First day on which the simulation is based, in YYYY-MM-DD
format.
Category ATTRIBUTE
Data Type DATE
Type URL N/A
Filterable True
Selectable True
Sortable True
Repeated False
Selectable with
The following fields/resources can be selected with this field:
ad_group_simulation.target_cpa_point_list.points
Field description Projected metrics for a series of target CPA amounts.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v26.common.TargetCpaSimulationPoint
Filterable False
Selectable True
Sortable False
Repeated True
Selectable with
The following fields/resources can be selected with this field:
ad_group_simulation.target_roas_point_list.points
Field description Projected metrics for a series of target ROAS amounts.
Category ATTRIBUTE
Data Type MESSAGE
Type URL google.ads.googleads.v26.common.TargetRoasSimulationPoint
Filterable False
Selectable True
Sortable False
Repeated True
Selectable with
The following fields/resources can be selected with this field:
ad_group_simulation.type
Field description Output only. The field that the simulation modifies.
Category ATTRIBUTE
Data Type
ENUM
BID_MODIFIER
BUDGET
CPC_BID
CPV_BID
PERCENT_CPC_BID
TARGET_CPA
TARGET_IMPRESSION_SHARE
TARGET_ROAS
UNKNOWN
UNSPECIFIED
Type URL google.ads.googleads.v26.enums.SimulationTypeEnum.SimulationType
Filterable True
Selectable True
Sortable True
Repeated False
Selectable with
The following fields/resources can be selected with this field:
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-10-14 UTC.
[null,null,["Last updated 2026-10-14 UTC."],[],[]]