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 é compatível com as metas de aquisição de clientes para conseguir novos clientes de maneira eficiente por meio das suas campanhas Performance Max e de pesquisa do Google Ads.

Se a 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 conta de cliente de conversão do Google Ads, e não diretamente na conta do Google Ads. No entanto, você ainda precisa definir metas de ciclo de vida da campanha na sua conta. Esse processo é semelhante à forma como você gerencia 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)

Dica :a API Google Ads v16 removeu o comportamento exclusivo das operações de mutação da meta do ciclo de vida. Se você estiver usando a v16, crie e atualize metas de ciclo de vida usando a abordagem padrão.

Na API Google Ads v15, as operações compatíveis com CustomerLifecycleGoalService e CampaignLifecycleGoalService são um pouco diferentes de outros serviços da API. Em vez de ter operações create e update separadas, as CustomerLifecycleGoalOperation e CampaignLifecycleGoalOperation v15 têm apenas uma operação create, e você indica sua intent usando o update_mask da seguinte maneira:

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

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

Configurar as metas do 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 meta do ciclo de vida do cliente contém dois campos:

lifecycle_goal_customer_definition_settings

Defina o campo existing_user_lists para indicar quais listas de usuários contêm clientes.

O campo 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 é imutável na API Google Ads.

customer_acquisition_goal_value_settings

Defina o campo value para definir o ajuste de valor extra a ser incluído na primeira conversão de compra de um novo cliente.

É possível ler o high_lifetime_value da meta, mas esse campo é imutável na API Google Ads.

Configurar metas de ciclo de vida da campanha

No nível da campanha, configure uma meta de ciclo de vida criando ou atualizando uma 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 definir o modo de otimização da campanha e substituir as configurações de valor da meta de cliente principal.

O optimization_mode pode ser um destes valores:

TARGET_ALL_EQUALLY

A campanha segmenta clientes novos e atuais igualmente. 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 maiores para clientes com previsão de novos e que não fazem parte de uma das existing_user_lists.

TARGET_NEW_CUSTOMERS

A campanha só segmenta novos clientes.

O value_settings é igual ao customer_acquisition_goal_value_settings na meta no nível do cliente. Use essas 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 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