Metas do cliente
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Cada CustomerConversionGoal
determina se você quer que o Google Ads otimize as ações de conversão com o
category
e o
origin
especificados. O Google Ads cria automaticamente CustomerConversionGoals
à medida que você adiciona ConversionActions
ao cliente de conversão do Google Ads da sua conta para garantir que haja um CustomerConversionGoal
para cada combinação de category
e origin
em uso.
Como o Google Ads processa automaticamente a criação de objetos CustomerConversionGoal
, você define o atributo biddable
de cada meta para especificar se uma meta de conversão é uma meta padrão da conta. Defina biddable
como true
se o Google Ads precisar otimizar as ações de conversão com category
e origin
da meta. Caso contrário, defina biddable
como false
. Os valores true
e false
são equivalentes às opções Usar como meta padrão da conta e Não usar como meta padrão da conta, respectivamente, nas configurações de ação de conversão.
Novas combinações de categoria e origem
Se um ConversionAction
for criado no cliente de conversão do Google Ads e a combinação de category
e origin
da nova ação não existir em nenhuma outra ação, o Google Ads vai criar automaticamente um novo CustomerConversionGoal
para o category
e o origin
e definir o atributo biddable
como true
por padrão.
No entanto, o Google Ads define biddable
como false
por padrão para as seguintes combinações de category
e origin
:
category |
origem |
BEGIN_CHECKOUT |
GOOGLE_HOSTED |
CONSIDERAÇÃO |
GOOGLE_HOSTED |
CONTATO |
GOOGLE_HOSTED |
CONVERTED_LEAD |
GOOGLE_HOSTED |
ENGAJAMENTO |
GOOGLE_HOSTED |
GET_DIRECTIONS |
GOOGLE_HOSTED |
PAGE_VIEW |
GOOGLE_HOSTED |
QUALIFIED_LEAD |
GOOGLE_HOSTED |
INSCREVA-SE |
GOOGLE_HOSTED |
COMPRAR |
GOOGLE_HOSTED |
STORE_SALE |
LOJA |
STORE_VISIT |
LOJA |
Recuperar metas do cliente
Use a consulta a seguir para recuperar a lista de CustomerConversionGoals
da sua conta.
SELECT
customer_conversion_goal.resource_name,
customer_conversion_goal.category,
customer_conversion_goal.origin,
customer_conversion_goal.biddable
FROM customer_conversion_goal
Um exemplo comum é a meta de conversão de visualização de página, que é representada por uma combinação de um category
de PAGE_VIEW
e um origin
de WEBSITE
.
Para recuperar as ações de conversão que pertencem a essa meta de conversão, correspondendo ao que você vê na interface do Google Ads na página de resumo de metas, use a seguinte consulta:
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'
Outro exemplo comum é receber o grupo mostrado na interface do Google Ads como Outro.
Isso é feito ao definir o
category
como DEFAULT
.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-09-05 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-05 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)."]]