Metas de ciclo de vida

Use os recursos CustomerLifecycleGoal e CampaignLifecycleGoal da API Google Ads para configurar metas relacionadas ao ciclo de vida do cliente. A API Google Ads oferece suporte a metas de aquisição de clientes para conquistar novos clientes de maneira eficiente nas suas campanhas de pesquisa e Performance Max do Google Ads.

Se a sua conta do Google Ads estiver usando o acompanhamento de conversões de várias contas, será necessário configurar as metas do ciclo de vida do cliente na conta de conversão do Google Ads, e não diretamente na sua conta do Google Ads. No entanto, você ainda precisa definir metas de ciclo de vida da campanha na sua conta. Isso é semelhante à forma como você gerencia outras metas ao usar o acompanhamento de conversões de várias contas.

Configurar as metas do ciclo de vida do cliente

No nível do cliente, configure uma meta do ciclo de vida criando ou atualizando um CustomerLifecycleGoal. É possível ter no máximo uma CustomerLifecycleGoal por conta do Google Ads. O campo customer_acquisition_goal_value_settings.value define o ajuste de valor extra a ser adicionado à conversão de primeira compra de um novo cliente. É possível ler o customer_acquisition_goal_value_settings.high_lifetime_value da meta, mas esse campo é imutável na API Google Ads.

Segmentar seus públicos-alvo

A partir da API Google Ads v17, é necessário usar o recurso UserListCustomerType para segmentar seus públicos-alvo para as metas do ciclo de vida do cliente. A configuração de públicos-alvo diretamente no recurso CustomerLifecycleGoal foi descontinuada. Os detalhes são os seguintes:

  • Antes da v17:
    • Adicione listas de usuários à coleção existing_user_lists de um CustomerLifecycleGoal.
  • A partir da v17:
    • Associe cada lista de usuários a uma ou mais categorias criando um UserListCustomerType para cada combinação de lista de usuários e categoria.

Na API Google Ads v17 e versões mais recentes

Use o UserListCustomerTypeService para criar instâncias UserListCustomerType. Se você já preencheu o campo CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists, sua conta já vai conter instâncias UserListCustomerType relacionadas.

O UserListCustomerTypeService só oferece suporte a operações create e remove. Portanto, se você quiser atualizar um UserListCustomerType, ele precisará ser removido e um novo terá que ser criado com as atualizações necessárias.

Um UserListCustomerType só pode ser atribuído a uma lista de usuários, mas uma lista de usuários pode ter várias instâncias UserListCustomerType associadas desde que não haja conflitos entre as instâncias UserListCustomerType. Tentar atribuir instâncias de UserListCustomerType com as seguintes combinações de customer_type_category à mesma lista de usuários resultará em um erro UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES:

Primeiros customer_type_category customer_type_category
COMPRADORES CONVERTED_LEADS
COMPRADORES QUALIFIED_LEADS
COMPRADORES CART_ABANDONERS
CONVERTED_LEADS QUALIFIED_LEADS
DISENGAGED_CUSTOMERS CONVERTED_LEADS
DISENGAGED_CUSTOMERS QUALIFIED_LEADS
DISENGAGED_CUSTOMERS CART_ABANDONERS

Na API Google Ads v16

Defina os seguintes campos na CustomerLifecycleGoal da sua conta:

  1. lifecycle_goal_customer_definition_settings.existing_user_lists indica quais listas de usuários contêm clientes.

  2. O campo lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists indica quais listas de usuários contêm clientes de alto valor da vida útil. É possível ler esse campo, mas ele é imutável na API Google Ads.

Comportamento de recursos compartilhados

Até que a API Google Ads v16 seja descontinuada em fevereiro de 2025, é importante lembrar que UserListCustomerType e os campos de segmentação de público-alvo em CustomerLifecycleGoal são um recurso compartilhado. Isso significa que a criação de novas instâncias de UserListCustomerType na v17 e versões mais recentes vai resultar em modificações na sua instância de CustomerLifecycleGoal na v16 e versões anteriores, e vice-versa.

Confira como os campos dos dois recursos são mapeados:

Mutação do campo "CustomerLifecycleGoal" na v16 Efeito colateral em "UserListCustomerType" na v17
lifecycle_goal_customer_definition_settings.existing_user_lists Cria ou remove instâncias de UserListCustomerType. O campo user_list contém o nome do recurso de lista de usuários associado.
Mutação de "UserListCustomerType" na v17 Efeito colateral no campo "CustomerLifecycleGoal" na v16
Crie ou remova instâncias de UserListCustomerType. Os nomes de recursos individuais serão adicionados ou removidos do lifecycle_goal_customer_definition_settings.existing_user_lists
Crie ou remova instâncias de UserListCustomerType, em que o customer_type_category é definido como HIGH_VALUE_CUSTOMERS. Os nomes de recursos individuais serão adicionados ou removidos do lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists

Configurar metas de ciclo de vida da campanha

No nível da campanha, configure uma meta do ciclo de vida criando ou atualizando uma CampaignLifecycleGoal. Pode haver no máximo uma CampaignLifecycleGoal por campanha.

O campo customer_acquisition_goal_settings de uma meta no nível da campanha permite definir o modo de otimização da campanha e substituir as configurações de valor da meta principal do cliente.

O optimization_mode pode ser um dos seguintes valores:

TARGET_ALL_EQUALLY
A campanha segmenta clientes novos e atuais da mesma forma. Esse é o modo de otimização padrão.
BID_HIGHER_FOR_NEW_CUSTOMERS
A campanha segmenta clientes novos e atuais, mas os lances são mais altos para clientes que são previstos como novos e não estão em um dos existing_user_lists.
TARGET_NEW_CUSTOMERS
A campanha é direcionada apenas a novos clientes.

O value_settings é igual ao customer_acquisition_goal_value_settings na meta do cliente. Use essas configurações para substituir os valores de uma campanha específica.

Extrair metas do ciclo de vida

Assim como em outros recursos da API Google Ads, use os métodos search ou searchStream de GoogleAdsService para recuperar as metas do ciclo de vida.

A consulta a seguir recupera os detalhes de cada CustomerLifecycleGoal em uma conta do Google Ads:

SELECT
  customer_lifecycle_goal.lifecycle_goal_customer_definition_settings.existing_user_lists,
  customer_lifecycle_goal.lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists,
  customer_lifecycle_goal.customer_acquisition_goal_value_settings.value,
  customer_lifecycle_goal.customer_acquisition_goal_value_settings.high_lifetime_value
FROM customer_lifecycle_goal

Da mesma forma, a consulta a seguir recupera os detalhes de cada CampaignLifecycleGoal:

SELECT
  campaign_lifecycle_goal.campaign,
  campaign_lifecycle_goal.customer_acquisition_goal_settings.optimization_mode,
  campaign_lifecycle_goal.customer_acquisition_goal_settings.value_settings.value,
  campaign_lifecycle_goal.customer_acquisition_goal_settings.value_settings.high_lifetime_value
FROM campaign_lifecycle_goal
Anterior
Metas da campanha