> [!CAUTION]
> **Caution:** This documentation is for Google Ads API **v25** . The latest active version is [**v26**](https://developers.google.com/google-ads/api/fields/latest/ad_group_simulation).

[Help me build a query](https://developers.google.com/google-ads/api/fields/v25/ad_group_simulation_query_builder.md.txt) [Proto definition ![on GitHub](https://developers.google.com/site-assets/logo-github.svg)](https://github.com/googleapis/googleapis/blob/master/google/ads/googleads/v25/resources/ad_group_simulation.proto)

An ad group simulation. Supported combinations of advertising
channel type, simulation type and simulation modification method is
detailed below respectively.

1. SEARCH - CPC_BID - DEFAULT

2. SEARCH - CPC_BID - UNIFORM

3. SEARCH - TARGET_CPA - UNIFORM

4. SEARCH - TARGET_ROAS - UNIFORM

5. DISPLAY - CPC_BID - DEFAULT

6. DISPLAY - CPC_BID - UNIFORM

7. DISPLAY - TARGET_CPA - UNIFORM

| Attributed resources |
|---|
| [ad_group](https://developers.google.com/google-ads/api/fields/v25/ad_group.md.txt) |
| [campaign](https://developers.google.com/google-ads/api/fields/v25/campaign.md.txt) |
| [customer](https://developers.google.com/google-ads/api/fields/v25/customer.md.txt) |

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.

## ad_group_simulation.ad_group_id

Field descriptionOutput only. Ad group id of the simulation.
Category`ATTRIBUTE` Data Type`INT64` CapabilitiesSelectable: True  
Filterable: True  
Sortable: True  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

**Resources:** [ad_group_simulation](https://developers.google.com/google-ads/api/fields/v25/ad_group_simulation.md.txt)

## ad_group_simulation.cpc_bid_point_list.points

Field descriptionProjected metrics for a series of CPC bid amounts.
Category`ATTRIBUTE` Data Type`MESSAGE` Type URL`google.ads.googleads.v25.common.CpcBidSimulationPoint` CapabilitiesSelectable: True  
Filterable: False  
Sortable: False  
Repeated: True Selectable withThe following fields and resources can be selected with this field:

**Resources:** [ad_group_simulation](https://developers.google.com/google-ads/api/fields/v25/ad_group_simulation.md.txt)

## ad_group_simulation.cpv_bid_point_list.points

Field descriptionProjected metrics for a series of CPV bid amounts.
Category`ATTRIBUTE` Data Type`MESSAGE` Type URL`google.ads.googleads.v25.common.CpvBidSimulationPoint` CapabilitiesSelectable: True  
Filterable: False  
Sortable: False  
Repeated: True Selectable withThe following fields and resources can be selected with this field:

**Resources:** [ad_group_simulation](https://developers.google.com/google-ads/api/fields/v25/ad_group_simulation.md.txt)

## ad_group_simulation.end_date

Field descriptionOutput only. Last day on which the simulation is based, in YYYY-MM-DD
format
Category`ATTRIBUTE` Data Type`DATE` CapabilitiesSelectable: True  
Filterable: True  
Sortable: True  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

**Resources:** [ad_group_simulation](https://developers.google.com/google-ads/api/fields/v25/ad_group_simulation.md.txt)

## ad_group_simulation.modification_method

Field descriptionOutput only. How the simulation modifies the field.
Category`ATTRIBUTE` Data Type`ENUM`
`DEFAULT``SCALING``UNIFORM``UNKNOWN``UNSPECIFIED` Type URL`google.ads.googleads.v25.enums.SimulationModificationMethodEnum.SimulationModificationMethod` CapabilitiesSelectable: True  
Filterable: True  
Sortable: True  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

**Resources:** [ad_group_simulation](https://developers.google.com/google-ads/api/fields/v25/ad_group_simulation.md.txt)

## ad_group_simulation.resource_name

Field descriptionOutput 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` CapabilitiesSelectable: True  
Filterable: True  
Sortable: False  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

**Resources:** [ad_group_simulation](https://developers.google.com/google-ads/api/fields/v25/ad_group_simulation.md.txt)

## ad_group_simulation.start_date

Field descriptionOutput only. First day on which the simulation is based, in YYYY-MM-DD
format.
Category`ATTRIBUTE` Data Type`DATE` CapabilitiesSelectable: True  
Filterable: True  
Sortable: True  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

**Resources:** [ad_group_simulation](https://developers.google.com/google-ads/api/fields/v25/ad_group_simulation.md.txt)

## ad_group_simulation.target_cpa_point_list.points

Field descriptionProjected metrics for a series of target CPA amounts.
Category`ATTRIBUTE` Data Type`MESSAGE` Type URL`google.ads.googleads.v25.common.TargetCpaSimulationPoint` CapabilitiesSelectable: True  
Filterable: False  
Sortable: False  
Repeated: True Selectable withThe following fields and resources can be selected with this field:

**Resources:** [ad_group_simulation](https://developers.google.com/google-ads/api/fields/v25/ad_group_simulation.md.txt)

## ad_group_simulation.target_roas_point_list.points

Field descriptionProjected metrics for a series of target ROAS amounts.
Category`ATTRIBUTE` Data Type`MESSAGE` Type URL`google.ads.googleads.v25.common.TargetRoasSimulationPoint` CapabilitiesSelectable: True  
Filterable: False  
Sortable: False  
Repeated: True Selectable withThe following fields and resources can be selected with this field:

**Resources:** [ad_group_simulation](https://developers.google.com/google-ads/api/fields/v25/ad_group_simulation.md.txt)

## ad_group_simulation.type

Field descriptionOutput 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.v25.enums.SimulationTypeEnum.SimulationType` CapabilitiesSelectable: True  
Filterable: True  
Sortable: True  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

**Resources:** [ad_group_simulation](https://developers.google.com/google-ads/api/fields/v25/ad_group_simulation.md.txt)