Join us live onDiscord on the Google Advertising and Measurement Community server and onYouTube on February 26th at 11:00 AM EST! We will discuss the new features added in v23.1 of the Google Ads API.

goal

Representation of goals.

Attributed resources
customer

Fields from the above resources may be selected along with this resource in your SELECT and WHERE clauses. These fieldswill not segment metrics in yourSELECT clause.

goal.goal_id

Field descriptionOutput only. The ID of this goal.
CategoryATTRIBUTE
Data TypeINT64
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

goal.goal_type

Field descriptionOutput only. The type of this goal.
CategoryATTRIBUTE
Data Type

ENUM

CUSTOMER_RETENTION
UNKNOWN
UNSPECIFIED
Type URLgoogle.ads.googleads.v23.enums.GoalTypeEnum.GoalType
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

goal.optimization_eligibility

Field descriptionOutput only. Indicates if this goal is eligible for campaign optimization.
CategoryATTRIBUTE
Data Type

ENUM

ELIGIBLE
INELIGIBLE
UNKNOWN
UNSPECIFIED
Type URLgoogle.ads.googleads.v23.enums.GoalOptimizationEligibilityEnum.GoalOptimizationEligibility
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

goal.owner_customer

Field descriptionOutput only. The resource name of the goal owner customer.
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

goal.resource_name

Field descriptionImmutable. The resource name of the goal. Goal resource names have the form:customers/{customer_id}/goals/{goal_id}
CategoryATTRIBUTE
Data TypeRESOURCE_NAME
Type URLN/A
FilterableTrue
SelectableTrue
SortableFalse
RepeatedFalse

goal.retention_goal_settings.value_settings.additional_high_lifetime_value

Field descriptionHigh lifetime value of the lifecycle goal. For example, for customer acquisition goals, high lifetime value is the incremental conversion value for lapsed customers who are of high value. High lifetime value should be greater than value, if set.
CategoryATTRIBUTE
Data TypeDOUBLE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

goal.retention_goal_settings.value_settings.additional_value

Field descriptionValue of the lifecycle goal. For example, for retention goals, value is the incremental conversion value for lapsed customers who are not of high value.
CategoryATTRIBUTE
Data TypeDOUBLE
Type URLN/A
FilterableTrue
SelectableTrue
SortableTrue
RepeatedFalse

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-01-29 UTC.