type PerformanceTarget (v201806)

This class is used to configure various Performance Targets.


Namespace
https://adwords.google.com/api/adwords/cm/v201806

Field

volumeGoalType

VolumeGoalType

The volume goal of the performance target. This property defines the way stats data will be reported for the time period specified.


Enumerations
UNKNOWN
MAXIMIZE_CONVERSIONS
A volume goal that indicates that the performance target is meant to display progress in terms of maximizing conversions.
MAXIMIZE_CLICKS
A volume goal that indicates that the performance target is meant to display progress in terms of maximizing clicks.

This field can be selected using the value "VolumeGoalType".
This field can be filtered on.
This field is required and should not be null when it is contained within Operators : ADD.

volumeTargetValue

xsd:long

The value of the volume target. This corresponds directly to the volume_goal_type property and defines a target that the advertiser intends to reach during the time the performance target is active. As an example, if the volume_goal is MAXIMIZE_CONVERSIONS and the volume target is 3000, then the advertiser intends to reach at least 3000 conversions between start and end dates of the performance target.

This field can be selected using the value "VolumeTargetValue".
This field can be filtered on.

efficiencyTargetType

EfficiencyTargetType

This property specifies desired outcomes for some clicks, conversions or impressions statistic for the given time period. It's usually a constraint on the volume goal of the performance target, usually in terms of spending.

Only specific efficiency target types are allowed for a volume goal type. The following mapping explicitly specifies all allowed combinations. Volume Goal Type : List of Efficiency Target Types MAXIMIZE_CLICKS : CPC_LESS_THAN_OR_EQUAL_TO MAXIMIZE_CONVERSIONS : CPA_LESS_THAN_OR_EQUAL_TO


Enumerations
UNKNOWN
NONE
A value that is used to clear an efficiency target when it has already been set. This value will never be persisted.
CPA_LESS_THAN_OR_EQUAL_TO
An efficiency target that aims for average CPA over the runtime of the performance target to be less than or equal to some value.
CPC_LESS_THAN_OR_EQUAL_TO
An efficiency target that aims for average CPC over the runtime of the performance target to be less than or equal to some value.

This field can be selected using the value "EfficiencyTargetType".
This field can be filtered on.

efficiencyTargetValue

xsd:double

The numerical value that goes along with the expression specified by the efficiency target type.

This field can be selected using the value "EfficiencyTargetValue".
This field can be filtered on.

spendTarget

Money

A numerical value specifying just how much money the advertiser is willing to spend during the time period of this performance target. This does not affect serving. The spend target is always in micros of the customer's currency.

This field can be selected using the value "SpendTarget".
This field can be filtered on.

spendTargetType

SpendTargetType


Enumerations
UNKNOWN
NONE
A value that is used to clear a spend target type when it has already been set. This value will never be persisted.
MINIMUM
A spend target that indicates that over the course of the performance target at least the specified amount of money should be spent.
MAXIMUM
A spend target that indicates that over the course of the performance target at most the specified amount of money should be spent.

This field can be selected using the value "SpendTargetType".
This field can be filtered on.

forecastStatus

PerformanceTargetStatus

The forecast status specifies how well the campaigns of a performance targets are doing or have done in the past in relation to the targets set on the performance target.


Enumerations
UNKNOWN
ACTIVE_NEEDS_ATTENTION
A status that describes an active performance target that is likely to miss its targets.
ACTIVE_ON_TRACK
A status that describes an active performance target that is on track to meet its targets.
ACTIVE_TARGET_MET
A status that describes an active performance target with a defined spend or volume target that has already been met.
ACTIVE_INCONCLUSIVE
A status that describes an active performance target for which we are not able to make a status determination with certainty.
ACTIVE_NO_TARGETS
A status that describes an active performance target that does not have any targets set. It is not possible to make a status determination for such performance targets.
PAST_TARGET_MISSED
A status that describes a performance target that has ended and missed the targets that were set for it.
PAST_TARGET_MET
A status that describes a performance target that has ended and met the targets that were set for it.
PAST_INCONCLUSIVE
A status that describes a performance target that has recently ended, but we do not yet have all the information necessary to make a target met or missed determination.
PAST_MISSING_DATA
A status that describes a performance target that has ended and has no stats information in its time range and therefore cannot cannot make a target met or missed determination.
PAST_NO_TARGETS
A status that describes a performance target that has ended but does not have any targets defined for it.
NOT_YET_STARTED
A status that describes a performance target that has not yet started.

This field can be selected using the value "ForecastStatus".
This field can be filtered on.
This field is read only and will be ignored when sent to the API.

hasPromotedSuggestions

xsd:boolean

Specifies whether this performance target has promoted suggestions associated with it.

This field can be selected using the value "HasPromotedSuggestions".
This field can be filtered on.
This field is read only and will be ignored when sent to the API.

startDate

xsd:string

The start date for the performance target.

This field can be selected using the value "StartDate".
This field can be filtered on.

endDate

xsd:string

The end date for the performance target.

This field can be selected using the value "EndDate".
This field can be filtered on.

Send feedback about...

AdWords API
AdWords API
Need help? Visit our support page.