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

Use o recurso UserListCustomerType para segmentar seus públicos-alvo para as metas do ciclo de vida do cliente. É necessário associar cada lista de usuários a uma ou mais categorias criando um UserListCustomerType para cada combinação de lista de usuários e categoria.

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 oferece suporte apenas a operações create e remove. Portanto, se você quiser atualizar um UserListCustomerType, remova-o e crie 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. 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

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 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 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 define lances 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