> [!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).

[<button style="margin-top:15px">Help me build a query</button>](https://developers.google.com/google-ads/api/fields/v23/experiment_query_builder.md.txt) [<button style="margin-top:15px">Proto definition ![GitHub](https://developers.google.com/site-assets/logo-github.svg)</button>](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 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.

## 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` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[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` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[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.experiment_id

Field descriptionOutput only. The ID of the experiment. Read only.
Category`ATTRIBUTE` Data Type`INT64` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[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.goals

Field descriptionThe goals of this experiment.
Category`ATTRIBUTE` Data Type`MESSAGE` Type URL`google.ads.googleads.v23.common.MetricGoal` FilterableFalse SelectableTrue SortableFalse RepeatedTrue Selectable with The following fields/resources can be selected with this field:
[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.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` Type URL`N/A` FilterableFalse SelectableTrue SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[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.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` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[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.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` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[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.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` Type URL`N/A` FilterableTrue SelectableTrue SortableFalse RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[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.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` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[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.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` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[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.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` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[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.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` Type URL`N/A` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[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.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` FilterableTrue SelectableTrue SortableTrue RepeatedFalse Selectable with The following fields/resources can be selected with this field:
[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)