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 partir da v15, 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 cliente de conversão do Google Ads, e não diretamente na sua conta do Google Ads. Você ainda deve definir metas de ciclo de vida da campanha na sua conta. É semelhante a como você gerenciar outras metas ao usar o acompanhamento de conversões de várias contas.

Configurar 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 O campo customer_acquisition_goal_value_settings.value define ajuste de valor para adicionar à 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.

Segmente seus públicos-alvo

A partir da API Google Ads v17, você precisa usar as APIs UserListCustomerType recurso a ser segmentado seus públicos-alvo para metas de ciclo de vida do cliente. Configurar públicos-alvo diretamente no o recurso CustomerLifecycleGoal está 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 uma UserListCustomerType para cada combinação de lista de usuários e categoria.

Aviso :UserListCustomerType e os campos de segmentação de público-alvo CustomerLifecycleGoal são recursos compartilhados, ou seja, a criação de novos As instâncias UserListCustomerType na v17 resultarão em modificações no CustomerLifecycleGoal na v16 e vice-versa. Recomendamos que os usuários migrem para o UserListCustomerType na v17 assim que possível.

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á conterá UserListCustomerType relacionadas instâncias.

O UserListCustomerTypeService só oferece suporte a create e remove operações. Portanto, se quiser atualizar um UserListCustomerType existente, precisar removê-lo e criar um novo 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. Ao tentar atribuir instâncias de UserListCustomerType com o 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 campos a seguir na sua conta CustomerLifecycleGoal:

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. Você pode ler esse campo, mas ele não pode ser alterado na API Google Ads.

Comportamento de recursos compartilhados

Até a API Google Ads v16 ser desativada em janeiro de 2025, é importante lembrar que UserListCustomerType e os campos de segmentação de público-alvo Os CustomerLifecycleGoal são recursos compartilhados, ou seja, a criação Instâncias do UserListCustomerType na v17 e posteriores resultarão em modificações à instância CustomerLifecycleGoal na v16 e anteriores e de outra forma ao redor.

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

Mutação do campo "CustomerLifecycleGoal" na v16	Efeito colateral em "PCollectionCustomerType" na v17
lifecycle_goal_customer_definition_settings.existing_user_lists	Cria ou remove instâncias 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 as metas do 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 segmenta apenas novos clientes.

Os value_settings são iguais aos customer_acquisition_goal_value_settings na meta no nível do cliente. Use estas as configurações no nível da campanha para substituir os valores de uma campanha específica.

Extrair metas do ciclo de vida

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

A consulta a seguir recupera os detalhes de cada CustomerLifecycleGoal em um 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