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 fields will not segment metrics in your SELECT clause.

goal.goal_id
Field description	Output only. The ID of this goal.
Category	`ATTRIBUTE`
Data Type	`INT64`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

goal.goal_type
Field description	Output only. The type of this goal.
Category	`ATTRIBUTE`
Data Type	`ENUM` `CUSTOMER_RETENTION` `UNKNOWN` `UNSPECIFIED`
Type URL	`google.ads.googleads.v24.enums.GoalTypeEnum.GoalType`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

goal.optimization_eligibility
Field description	Output only. Indicates if this goal is eligible for campaign optimization.
Category	`ATTRIBUTE`
Data Type	`ENUM` `ELIGIBLE` `INELIGIBLE` `UNKNOWN` `UNSPECIFIED`
Type URL	`google.ads.googleads.v24.enums.GoalOptimizationEligibilityEnum.GoalOptimizationEligibility`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

goal.owner_customer
Field description	Output only. The resource name of the goal owner customer.
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

goal.resource_name
Field description	Immutable. The resource name of the goal. Goal resource names have the form: `customers/{customer_id}/goals/{goal_id}`
Category	`ATTRIBUTE`
Data Type	`RESOURCE_NAME`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	False
Repeated	False

goal.retention_goal_settings.value_settings.additional_high_lifetime_value
Field description	High 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.
Category	`ATTRIBUTE`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

goal.retention_goal_settings.value_settings.additional_value
Field description	Value of the lifecycle goal. For example, for retention goals, value is the incremental conversion value for lapsed customers who are not of high value.
Category	`ATTRIBUTE`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

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

Last updated 2026-09-24 UTC.

Blog
Visit our blog for important announcements.
Client Libraries
Use our officially supported client libraries.
YouTube
Access our video contents.
Discord
Join the Google Ads Discord server.