Customer goals
Stay organized with collections
Save and categorize content based on your preferences.
Each CustomerConversionGoal
determines whether you want Google Ads to optimize for conversion actions with the
specified category
and origin
. Google Ads automatically creates CustomerConversionGoals
as you add ConversionActions
to your account's Google Ads conversion
customer
to
ensure that there's a CustomerConversionGoal
for every combination of category
and origin
that's in use.
Since Google Ads automatically handles the creation of CustomerConversionGoal
objects, you set the biddable
attribute of each goal to specify whether a
conversion goal is an account-default
goal
. Set biddable
to true
if Google Ads should optimize for conversion actions with the
goal's category
and origin
, and set biddable
to false
otherwise. The
values true
and false
are equivalent to the Use as an account-default
goaland Do not use as an account-default goaloptions, respectively, in
the conversion action
settings
.
New category and origin combinations
If a ConversionAction
is created in your Google Ads conversion customer and
the category
and origin
combination of the new action doesn't exist on any
other actions, Google Ads automatically creates a new CustomerConversionGoal
for
the category
and origin
and sets the biddable
attribute to true
by
default.
However, Google Ads sets biddable
to false
by default for the following category
and origin
combinations:
Retrieve customer goals
Use the following query to retrieve the list of CustomerConversionGoals
for your account.
SELECT
customer_conversion_goal
.
resource_name
,
customer_conversion_goal
.
category
,
customer_conversion_goal
.
origin
,
customer_conversion_goal
.
biddable
FROM
customer_conversion_goal
A common example is the page view conversion goal, which is represented by a
combination of a category
of PAGE_VIEW
and an origin
of WEBSITE
.
In order to retrieve the conversion actions that belong to this conversion
goal—matching what you see in the Google Ads UI in the goals summary
page—use the following query:
SELECT
conversion_action
.
category
,
conversion_action
.
origin
,
conversion_action
.
name
FROM
conversion_action
WHERE
conversion_action
.
category
=
'PAGE_VIEW'
AND
conversion_action
.
origin
=
'WEBSITE'
AND
conversion_action
.
status
=
'ENABLED'
Another common example is getting the group shown in the Google Ads UI as Other.
This is done by setting the category
to DEFAULT
.
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 2025-09-03 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-03 UTC."],[[["\u003cp\u003eGoogle Ads automatically creates and manages \u003ccode\u003eCustomerConversionGoals\u003c/code\u003e based on the \u003ccode\u003ecategory\u003c/code\u003e and \u003ccode\u003eorigin\u003c/code\u003e of your conversion actions to streamline optimization.\u003c/p\u003e\n"],["\u003cp\u003eYou can control whether Google Ads optimizes for a specific conversion goal by setting the \u003ccode\u003ebiddable\u003c/code\u003e attribute to \u003ccode\u003etrue\u003c/code\u003e (optimize) or \u003ccode\u003efalse\u003c/code\u003e (don't optimize).\u003c/p\u003e\n"],["\u003cp\u003eNew conversion actions with unique category and origin combinations will automatically have a corresponding \u003ccode\u003eCustomerConversionGoal\u003c/code\u003e created, typically set to \u003ccode\u003ebiddable\u003c/code\u003e by default, unless they fall within specific combinations listed in the documentation.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve and analyze your \u003ccode\u003eCustomerConversionGoals\u003c/code\u003e and associated conversion actions using provided sample queries to gain insights into your conversion setup.\u003c/p\u003e\n"],["\u003cp\u003eCommon use cases like analyzing page view goals or the "Other" group in the Google Ads UI are easily achievable with the provided query examples and category/origin understanding.\u003c/p\u003e\n"]]],[],null,["# Customer goals\n\nEach [`CustomerConversionGoal`](/google-ads/api/reference/rpc/v21/CustomerConversionGoal)\ndetermines whether you want Google Ads to optimize for conversion actions with the\nspecified [`category`](/google-ads/api/reference/rpc/v21/ConversionAction#category) and\n[`origin`](/google-ads/api/reference/rpc/v21/ConversionAction#origin). Google Ads automatically creates\n`CustomerConversionGoals` as you add\n[`ConversionActions`](/google-ads/api/reference/rpc/v21/ConversionAction) to your account's\n[Google Ads conversion\ncustomer](/google-ads/api/docs/conversions/getting-started#enable_conversion_tracking) to\nensure that there's a `CustomerConversionGoal` for every combination of\n`category` and `origin` that's in use.\n\nSince Google Ads automatically handles the creation of `CustomerConversionGoal`\nobjects, you set the `biddable` attribute of each goal to specify whether a\nconversion goal is an [account-default\ngoal](//support.google.com/google-ads/answer/10995103#account_default). Set\n`biddable` to `true` if Google Ads should optimize for conversion actions with the\ngoal's `category` and `origin`, and set `biddable` to `false` otherwise. The\nvalues `true` and `false` are equivalent to the **Use as an account-default\ngoal** and **Do not use as an account-default goal** options, respectively, in\nthe [conversion action\nsettings](//support.google.com/google-ads/answer/10993988#edit_account_default).\n\nNew category and origin combinations\n------------------------------------\n\nIf a `ConversionAction` is created in your Google Ads conversion customer and\nthe `category` and `origin` combination of the new action doesn't exist on any\nother actions, Google Ads automatically creates a new `CustomerConversionGoal` for\nthe `category` and `origin` and sets the `biddable` attribute to `true` by\ndefault.\n\nHowever, Google Ads sets `biddable` to `false` by default for the following\n`category` and `origin` combinations:\n\n| [category](/google-ads/api/reference/rpc/v21/ConversionActionCategoryEnum.ConversionActionCategory) | [origin](/google-ads/api/reference/rpc/v21/ConversionOriginEnum.ConversionOrigin) |\n|-----------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------|\n| BEGIN_CHECKOUT | GOOGLE_HOSTED |\n| CONSIDERATION | GOOGLE_HOSTED |\n| CONTACT | GOOGLE_HOSTED |\n| CONVERTED_LEAD | GOOGLE_HOSTED |\n| ENGAGEMENT | GOOGLE_HOSTED |\n| GET_DIRECTIONS | GOOGLE_HOSTED |\n| PAGE_VIEW | GOOGLE_HOSTED |\n| QUALIFIED_LEAD | GOOGLE_HOSTED |\n| SIGNUP | GOOGLE_HOSTED |\n| PURCHASE | GOOGLE_HOSTED |\n| STORE_SALE | STORE |\n| STORE_VISIT | STORE |\n\nRetrieve customer goals\n-----------------------\n\nUse the following query to retrieve the list of `CustomerConversionGoals`\nfor your account. \n\n SELECT\n customer_conversion_goal.resource_name,\n customer_conversion_goal.category,\n customer_conversion_goal.origin,\n customer_conversion_goal.biddable\n FROM customer_conversion_goal\n\nA common example is the page view conversion goal, which is represented by a\ncombination of a [`category`](/google-ads/api/reference/rpc/v21/ConversionAction#category) of\n[`PAGE_VIEW`](/google-ads/api/reference/rpc/v21/ConversionActionCategoryEnum.ConversionActionCategory#page_view)\nand an [`origin`](/google-ads/api/reference/rpc/v21/ConversionAction#origin) of\n[`WEBSITE`](/google-ads/api/reference/rpc/v21/ConversionOriginEnum.ConversionOrigin#website).\n\nIn order to retrieve the conversion actions that belong to this conversion\ngoal---matching what you see in the Google Ads UI in the goals summary\npage---use the following query: \n\n SELECT\n conversion_action.category,\n conversion_action.origin,\n conversion_action.name\n FROM conversion_action\n WHERE conversion_action.category = 'PAGE_VIEW'\n AND conversion_action.origin = 'WEBSITE'\n AND conversion_action.status = 'ENABLED'\n\nAnother common example is getting the group shown in the Google Ads UI as **Other** .\nThis is done by setting the\n[`category`](/google-ads/api/reference/rpc/v21/ConversionAction#category) to [`DEFAULT`](/google-ads/api/reference/rpc/v21/ConversionActionCategoryEnum.ConversionActionCategory#default)."]]