Join us live on Discord on the Google Advertising and Measurement Community server and on YouTube on July 23rd at 10:00 AM EST! We will discuss the new features added in v25 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 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` `LOYALTY_RETENTION` `NEW_CUSTOMER_ACQUISITION` `UNKNOWN` `UNSPECIFIED`
Type URL	`google.ads.googleads.v25.enums.GoalTypeEnum.GoalType`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

goal.loyalty_retention_goal_settings.value_settings.value_multiplier
Field description	Conversion value multiplier.
Category	`ATTRIBUTE`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

goal.new_customer_acquisition_goal_settings.value_settings.additional_high_lifetime_value
Field description	Incremental high lifetime conversion value.
Category	`ATTRIBUTE`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

goal.new_customer_acquisition_goal_settings.value_settings.additional_value
Field description	Incremental conversion value.
Category	`ATTRIBUTE`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

goal.new_customer_acquisition_goal_settings.value_settings.high_lifetime_value_multiplier
Field description	High lifetime conversion value multiplier.
Category	`ATTRIBUTE`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

goal.new_customer_acquisition_goal_settings.value_settings.value_multiplier
Field description	Conversion value multiplier.
Category	`ATTRIBUTE`
Data Type	`DOUBLE`
Type URL	`N/A`
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.v25.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	Incremental high lifetime conversion value.
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	Incremental conversion value.
Category	`ATTRIBUTE`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

goal.retention_goal_settings.value_settings.high_lifetime_value_multiplier
Field description	High lifetime conversion value multiplier.
Category	`ATTRIBUTE`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

goal.retention_goal_settings.value_settings.value_multiplier
Field description	Conversion value multiplier.
Category	`ATTRIBUTE`
Data Type	`DOUBLE`
Type URL	`N/A`
Filterable	True
Selectable	True
Sortable	True
Repeated	False

goal Stay organized with collections Save and categorize content based on your preferences.

goal.goal_id

goal.goal_type

goal.loyalty_retention_goal_settings.value_settings.value_multiplier

goal.new_customer_acquisition_goal_settings.value_settings.additional_high_lifetime_value

goal.new_customer_acquisition_goal_settings.value_settings.additional_value

goal.new_customer_acquisition_goal_settings.value_settings.high_lifetime_value_multiplier

goal.new_customer_acquisition_goal_settings.value_settings.value_multiplier

goal.optimization_eligibility

goal.owner_customer

goal.resource_name

goal.retention_goal_settings.value_settings.additional_high_lifetime_value

goal.retention_goal_settings.value_settings.additional_value

goal.retention_goal_settings.value_settings.high_lifetime_value_multiplier

goal.retention_goal_settings.value_settings.value_multiplier

goal