AdWords API
Feedback on this document

type Experiment (v201209)

Class representing a experiment for the ExperimentService.


Namespace
https://adwords.google.com/api/adwords/cm/v201209
Fields
Field Type Description
id
Filterable
ReadOnly
Required
Selectable
xsd:long This field can be selected using the value "Id". This field can be filtered on. This field is read only and should not be set for following Operators : ADD. If this field is sent to the API, it will be ignored. This field is required and should not be null when it is contained within Operators : SET.
controlId
Filterable
ReadOnly
Selectable
xsd:long The id of the control associated with this experiment This field can be selected using the value "ControlId". This field can be filtered on. This field is read only and should not be set. If this field is sent to the API, it will be ignored.
campaignId
Filterable
Required
Selectable
xsd:long This field can be selected using the value "CampaignId". This field can be filtered on. This field is required and should not be null when it is contained within Operators : ADD.
name
Filterable
Required
Selectable
StringLength
xsd:string Experiment name. This field can be selected using the value "Name". This field can be filtered on. This field is required and should not be null when it is contained within Operators : ADD. This string must not be empty.
status
Filterable
Selectable
ExperimentStatus Status of the experiment. For ADD, this can only be ACTIVE, as nothing else makes sense. Default is ACTIVE for ADDs where this field is omitted. This field can be selected using the value "Status". This field can be filtered on.
Enumerations
ACTIVE
Experiment is currently active and can get traffic.
DELETED
Experiment has been deleted.
PROMOTED
Changes from the experiment have been applied.
servingStatus
ReadOnly
Selectable
ExperimentServingStatus Serving status of the experiment. This field can be selected using the value "ServingStatus". This field is read only and should not be set. If this field is sent to the API, it will be ignored.
Enumerations
RUNNING
Experiment is currently active and receiving traffic
PENDING
Experiment has not started running yet i.e. start date has not reached yet
ENDED
Experiment has already ended, but not promoted or deleted
DELETED
Experiment has been deleted.
PROMOTED
Changes from the experiment have been applied.
queryPercentage
Filterable
InRange
Required
Selectable
xsd:int The percentage of queries that will get routed to the experiment. It is also the percentage of budget that will be used for the experiment. Valid values for this field are 10, 20, 30, 40, 50, 60, 70, 80, 90. This field can be selected using the value "QueryPercentage". This field can be filtered on. This field must be between 0 and 100, inclusive. This field is required and should not be null when it is contained within Operators : ADD.
startDateTime
Filterable
Selectable
xsd:string Experiment started serving date; null indicates campaign start date is indefinitely in the future. This field can be selected using the value "StartDateTime". This field can be filtered on.
endDateTime
Filterable
Selectable
xsd:string Experiment ended serving date; null indicates campaign end date depends on start date. If start date is null, this is undefined. If start date is not null, this defaults to 30 days after the start date. This field can be selected using the value "EndDateTime". This field can be filtered on.
lastModifiedDateTime
Filterable
ReadOnly
Selectable
xsd:string The last time any change was made to this experiment, such as adding a keyword to the experiment only, adding a keyword to the control only, or updating a bid modifier. This field can be selected using the value "LastModifiedDateTime". This field can be filtered on. This field is read only and should not be set. If this field is sent to the API, it will be ignored.
experimentSummaryStats
ReadOnly
ExperimentSummaryStats This field is read only and should not be set. If this field is sent to the API, it will be ignored.

Authentication required

You need to be signed in with Google+ to do that.

Signing you in...

Google Developers needs your permission to do that.