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

[Help me build a query](https://developers.google.com/google-ads/api/fields/v23/experiment_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/v23/resources/experiment.proto)

A Google ads experiment for users to experiment changes on multiple
campaigns, compare the performance, and apply the effective changes.

| Attributed resources |
|---|
| [customer](https://developers.google.com/google-ads/api/fields/v23/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.

## experiment.description

Field descriptionThe description of the experiment. It must have a minimum length of 1 and
maximum length of 2048.
Category`ATTRIBUTE` Data Type`STRING` CapabilitiesSelectable: True  
Filterable: True  
Sortable: True  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

**Resources:** [experiment](https://developers.google.com/google-ads/api/fields/v23/experiment.md.txt), [experiment_arm](https://developers.google.com/google-ads/api/fields/v23/experiment_arm.md.txt)

## experiment.end_date

Field descriptionDate when the experiment ends. By default, the experiment ends on
the campaign's end date. If this field is set, then the experiment ends at
the end of the specified date in the customer's time zone.

Format: YYYY-MM-DD
Example: 2019-04-18
Category`ATTRIBUTE` Data Type`STRING` CapabilitiesSelectable: True  
Filterable: True  
Sortable: True  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

Same as [experiment.description](https://developers.google.com/google-ads/api/fields/v23/experiment.md.txt#experiment.description).

## experiment.experiment_id

Field descriptionOutput only. The ID of the experiment. Read only.
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:

Same as [experiment.description](https://developers.google.com/google-ads/api/fields/v23/experiment.md.txt#experiment.description).

## experiment.goals

Field descriptionThe goals of this experiment.
Category`ATTRIBUTE` Data Type`MESSAGE` Type URL`google.ads.googleads.v23.common.MetricGoal` CapabilitiesSelectable: True  
Filterable: False  
Sortable: False  
Repeated: True Selectable withThe following fields and resources can be selected with this field:

Same as [experiment.description](https://developers.google.com/google-ads/api/fields/v23/experiment.md.txt#experiment.description).

## experiment.long_running_operation

Field descriptionOutput only. The resource name of the long-running operation that can be
used to poll for completion of experiment schedule or promote. The most
recent long running operation is returned.
Category`ATTRIBUTE` Data Type`STRING` CapabilitiesSelectable: True  
Filterable: False  
Sortable: False  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

Same as [experiment.description](https://developers.google.com/google-ads/api/fields/v23/experiment.md.txt#experiment.description).

## experiment.name

Field descriptionRequired. The name of the experiment. It must have a minimum length of 1
and maximum length of 1024. It must be unique under a customer.
Category`ATTRIBUTE` Data Type`STRING` CapabilitiesSelectable: True  
Filterable: True  
Sortable: True  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

Same as [experiment.description](https://developers.google.com/google-ads/api/fields/v23/experiment.md.txt#experiment.description).

## experiment.promote_status

Field descriptionOutput only. The status of the experiment promotion process.
Category`ATTRIBUTE` Data Type`ENUM`
`COMPLETED``COMPLETED_WITH_WARNING``FAILED``IN_PROGRESS``NOT_STARTED``UNKNOWN``UNSPECIFIED` Type URL`google.ads.googleads.v23.enums.AsyncActionStatusEnum.AsyncActionStatus` CapabilitiesSelectable: True  
Filterable: True  
Sortable: True  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

Same as [experiment.description](https://developers.google.com/google-ads/api/fields/v23/experiment.md.txt#experiment.description).

## experiment.resource_name

Field descriptionImmutable. The resource name of the experiment.
Experiment resource names have the form:

`customers/{customer_id}/experiments/{experiment_id}`
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:

Same as [experiment.description](https://developers.google.com/google-ads/api/fields/v23/experiment.md.txt#experiment.description).

## experiment.start_date

Field descriptionDate when the experiment starts. By default, the experiment starts
now or on the campaign's start date, whichever is later. If this field is
set, then the experiment starts at the beginning of the specified date in
the customer's time zone.

Format: YYYY-MM-DD
Example: 2019-03-14
Category`ATTRIBUTE` Data Type`STRING` CapabilitiesSelectable: True  
Filterable: True  
Sortable: True  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

Same as [experiment.description](https://developers.google.com/google-ads/api/fields/v23/experiment.md.txt#experiment.description).

## experiment.status

Field descriptionThe Advertiser-chosen status of this experiment.
Category`ATTRIBUTE` Data Type`ENUM`
`ENABLED``GRADUATED``HALTED``INITIATED``PROMOTED``REMOVED``SETUP``UNKNOWN``UNSPECIFIED` Type URL`google.ads.googleads.v23.enums.ExperimentStatusEnum.ExperimentStatus` CapabilitiesSelectable: True  
Filterable: True  
Sortable: True  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

Same as [experiment.description](https://developers.google.com/google-ads/api/fields/v23/experiment.md.txt#experiment.description).

## experiment.suffix

Field descriptionFor system managed experiments, the advertiser must provide a suffix during
construction, in the setup stage before moving to initiated. The suffix
will be appended to the in-design and experiment campaign names so that the
name is base campaign name + suffix.
Category`ATTRIBUTE` Data Type`STRING` CapabilitiesSelectable: True  
Filterable: True  
Sortable: True  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

Same as [experiment.description](https://developers.google.com/google-ads/api/fields/v23/experiment.md.txt#experiment.description).

## experiment.sync_enabled

Field descriptionImmutable. Set to true if changes to base campaigns should be synced to the
trial campaigns. Any changes made directly to trial campaigns will be
preserved. This field can only be set when the experiment is being created.
Category`ATTRIBUTE` Data Type`BOOLEAN` CapabilitiesSelectable: True  
Filterable: True  
Sortable: True  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

Same as [experiment.description](https://developers.google.com/google-ads/api/fields/v23/experiment.md.txt#experiment.description).

## experiment.type

Field descriptionRequired. The product/feature that uses this experiment.
Category`ATTRIBUTE` Data Type`ENUM`
`AD_VARIATION``DISPLAY_AND_VIDEO_360``DISPLAY_AUTOMATED_BIDDING_STRATEGY``DISPLAY_CUSTOM``HOTEL_CUSTOM``SEARCH_AUTOMATED_BIDDING_STRATEGY``SEARCH_CUSTOM``SHOPPING_AUTOMATED_BIDDING_STRATEGY``SMART_MATCHING``UNKNOWN``UNSPECIFIED``YOUTUBE_CUSTOM` Type URL`google.ads.googleads.v23.enums.ExperimentTypeEnum.ExperimentType` CapabilitiesSelectable: True  
Filterable: True  
Sortable: True  
Repeated: False Selectable withThe following fields and resources can be selected with this field:

Same as [experiment.description](https://developers.google.com/google-ads/api/fields/v23/experiment.md.txt#experiment.description).