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 conquistar novos clientes de maneira eficiente nas campanhas de pesquisa e Performance Max do Google Ads.
Caso sua conta do Google Ads use o acompanhamento de conversões de várias contas, configure as metas de 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. No entanto, ainda é necessário 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)
Na API Google Ads v15, as operações compatíveis com CustomerLifecycleGoalService
e CampaignLifecycleGoalService
são um pouco diferentes de outros serviços na API Google Ads. Em vez de ter operações
create
e update
separadas, o
CustomerLifecycleGoalOperation
e o
CampaignLifecycleGoalOperation
v15 têm apenas uma operação create
, e você indica sua intent usando o
update_mask
desta maneira:
Para criar uma meta de ciclo de vida usando a v15, preencha
create
com a meta, mas não defina oresource_name
nem oupdate_mask
da operação.Para atualizar uma meta de ciclo de vida usando a v15, preencha
create
com a meta, defina oresource_name
dela e defina oupdate_mask
para listar os campos 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 um
CustomerLifecycleGoal
. Pode haver no máximo um CustomerLifecycleGoal
por conta do Google Ads. O campo customer_acquisition_goal_value_settings.value
define o ajuste de valor extra a ser adicionado à primeira conversão de compra de um novo cliente. Você pode ler o customer_acquisition_goal_value_settings.high_lifetime_value
da meta, mas esse campo não pode ser alterado na API Google Ads.
Segmente seus públicos-alvo
A partir da API Google Ads v17, é necessário usar o recurso UserListCustomerType
para segmentar seus públicos-alvo de acordo com as metas de ciclo de vida do cliente. A configuração de públicos-alvo diretamente no CustomerLifecycleGoal
foi descontinuada. Os detalhes são os seguintes:
- Antes da v17:
- Adicione listas de usuários à coleção
existing_user_lists
de umCustomerLifecycleGoal
.
- Adicione listas de usuários à coleção
- 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.
- Associe cada lista de usuários a uma ou mais categorias criando um
Na API Google Ads v17 e mais recentes
Use
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á instâncias UserListCustomerType
relacionadas.
O UserListCustomerTypeService
é compatível apenas com operações create
e remove
. Portanto, se você quiser atualizar um UserListCustomerType
atual, será necessário 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, mas uma
lista de usuários pode ter várias instâncias de UserListCustomerType
associadas,
desde que não haja conflitos entre as instâncias de
UserListCustomerType
. A tentativa de atribuir instâncias de UserListCustomerType
com as
seguintes combinações de
customer_type_category
à mesma lista de usuários vai resultar em um
erro UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES
:
Primeiros customer_type_category |
Segundo 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 e anteriores
Defina os seguintes campos no CustomerLifecycleGoal
da sua conta:
lifecycle_goal_customer_definition_settings.existing_user_lists
indica quais listas de usuários contêm clientes atuais.O campo
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 em CustomerLifecycleGoal
são um recurso compartilhado, o que significa que a criação de novas instâncias de UserListCustomerType
na v17 e posteriores resultará em modificações na sua instância CustomerLifecycleGoal
na v16 e anteriores e vice-versa.
Veja como os campos nos dois recursos são mapeados:
Mutação do campo "CustomerLifecycleGoal" na v16 | Efeito colateral em "BidRequestCustomerType" 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 da lista de usuários associado.
|
Mutação de "PCollectionCustomerType" na v17 | Efeito colateral no campo "CustomerLifecycleGoal" na v16 |
---|---|
Criar ou remover UserListCustomerType instâncias.
|
Os nomes de recursos individuais serão adicionados ou removidos do
lifecycle_goal_customer_definition_settings.existing_user_lists
|
Criar ou remover instâncias UserListCustomerType , em que 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 de ciclo de vida criando ou atualizando um 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 ter um destes valores:
TARGET_ALL_EQUALLY
- A campanha segmenta igualmente clientes novos e atuais. Esse é o modo de otimização padrão.
BID_HIGHER_FOR_NEW_CUSTOMERS
- A campanha segmenta clientes novos e atuais, mas dá lances mais altos para clientes previstos para serem novos e que não estão em uma das
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 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 na API Google Ads, use os métodos search
ou searchStream
de GoogleAdsService
para recuperar 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 abaixo 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