Metas de ciclo de vida

Use as APIs CustomerLifecycleGoal e CampaignLifecycleGoal recursos do API Google Ads para configurar metas relacionadas ao ciclo de vida do cliente. A partir da v15, a A API Google Ads é compatível com a aquisição de clientes para metas Conquiste novos clientes com as campanhas Performance Max e de pesquisa do Google Ads. campanhas.

Se sua conta do Google Ads usa o acompanhamento de conversões de várias contas, você precisa configurar as metas de ciclo de vida do cliente na coluna Conversão do Google Ads cliente em vez de diretamente na 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.

Processar operações de criação e atualização (somente para a v15)

Na API Google Ads v15, as operações suportadas na CustomerLifecycleGoalService e CampaignLifecycleGoalService diferem um pouco de outros serviços da API do Google Ads. Em vez de ter separado Operações create e update, a API v15 CustomerLifecycleGoalOperation e CampaignLifecycleGoalOperation tem apenas uma operação create e indica sua intenção usando o update_mask da seguinte forma:

• Para criar uma meta de ciclo de vida usando a v15, preencha create com a meta, mas não defina o resource_name nem o update_mask do operação

• Para atualizar uma meta de ciclo de vida usando a v15, preencha create com a meta, defina a resource_name da meta e defina a update_mask para listar os que você quer atualizar.

Configurar as metas de ciclo de vida do cliente

No nível do cliente, configure uma meta de ciclo de vida criando ou atualizando uma CustomerLifecycleGoal Pode haver no máximo um CustomerLifecycleGoal por conta do Google Ads. A O campo customer_acquisition_goal_value_settings.value define ajuste de valor para adicionar à conversão de primeira compra de um novo cliente. Você pode leia o customer_acquisition_goal_value_settings.high_lifetime_value do mas esse campo não pode ser alterado 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.

Na API Google Ads v17 e mais recentes

Use o UserListCustomerTypeService para criar instâncias da 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 é compatível apenas com 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.

Uma UserListCustomerType só pode ser atribuída a uma lista de usuários, lista de usuários pode ter várias instâncias UserListCustomerType associadas desde que não haja conflitos entre UserListCustomerType instâncias. 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:

Na API Google Ads v16 e anteriores

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 atuais.

2. A lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists indica quais listas de usuários contêm clientes com alto valor de 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.

Veja como os campos nos dois recursos são mapeados:

Configurar as metas do ciclo de vida da campanha

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

O campo customer_acquisition_goal_settings de uma meta no nível da campanha permite que você define o modo de otimização da campanha, além de substituir as configurações de valor da meta principal do cliente.

O optimization_mode pode ter um destes valores:

TARGET_ALL_EQUALLY

A campanha segmenta igualmente clientes novos e atuais. Esse é o padrão modo de otimização.

BID_HIGHER_FOR_NEW_CUSTOMERS

A campanha segmenta clientes novos e atuais, mas dá lances mais altos para clientes que estão previstos para serem novos e que 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.

Recuperar 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