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 oresource_name
nem oupdate_mask
do operaçãoPara atualizar uma meta de ciclo de vida usando a v15, preencha
create
com a meta, defina aresource_name
da meta e defina aupdate_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 umCustomerLifecycleGoal
.
- Adicione listas de usuários à coleção
- 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.
- Associe cada lista de usuários a uma ou mais categorias criando uma
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
:
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 campos a seguir na sua conta
CustomerLifecycleGoal
:
lifecycle_goal_customer_definition_settings.existing_user_lists
indica quais listas de usuários contêm clientes atuais.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:
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 . A
O campo user_list contém o recurso da lista de usuários associado.
nome.
|
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 o
customer_type_category está 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
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