Use the CustomerLifecycleGoal and
CampaignLifecycleGoal resources of the
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 campanhas da Rede de pesquisa do Google Ads, do Shopping e Performance
Max do Google Ads.
Se a conta do Google Ads usa o acompanhamento de conversões de várias contas, então você deve configurar as metas de ciclo de vida do cliente na conta de conversão do Google Ads em vez de fazer isso diretamente na conta do Google Ads. No entanto, ainda é necessário definir as 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 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. O campo customer_acquisition_goal_value_settings.high_lifetime_value define o valor de conversão incremental para novos clientes de alto valor. O valor da vida útil precisa ser maior que o valor, se definido.
Segmentar seus públicos-alvo
Você precisa usar o
UserListCustomerType recurso para segmentar
seus públicos-alvo para metas do ciclo de vida do cliente. 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.
Use o
UserListCustomerTypeService para
criar UserListCustomerType instâncias.
Se você já tiver preenchido o campo CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists, que agora está descontinuado, sua conta já vai conter instâncias UserListCustomerType relacionadas.
O UserListCustomerTypeService só oferece suporte às 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 elas.UserListCustomerType Tentar atribuir instâncias UserListCustomerType com as
seguintes combinações de customer_type_category à mesma lista de usuários
vai resultar em um erro UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES:
Primeira customer_type_category |
Segunda customer_type_category |
|---|---|
| PURCHASERS | CONVERTED_LEADS |
| PURCHASERS | QUALIFIED_LEADS |
| PURCHASERS | CART_ABANDONERS |
| CONVERTED_LEADS | QUALIFIED_LEADS |
| DISENGAGED_CUSTOMERS | CONVERTED_LEADS |
| DISENGAGED_CUSTOMERS | QUALIFIED_LEADS |
| DISENGAGED_CUSTOMERS | CART_ABANDONERS |
| LOYALTY_TIER_X_MEMBERS | LOYALTY_TIER_Y_MEMBERS |
Configurar metas de ciclo de vida da campanha
No nível da campanha, você pode configurar as metas de aquisição de clientes
criando ou atualizando um
CampaignLifecycleGoal. Pode haver no máximo um CampaignLifecycleGoal por campanha para aquisição de clientes.
Outros tipos de metas, como as de retenção, são configurados separadamente.
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 do cliente principal.
O optimization_mode pode ser um dos seguintes 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 oferece lances mais altos para clientes que são previstos como novos e não estão em uma das
existing_user_lists. TARGET_NEW_CUSTOMERS- A campanha segmenta apenas novos clientes.
Os value_settings são os mesmos que os
customer_acquisition_goal_value_settings no objetivo do cliente. Use essas configurações no nível da campanha para substituir os valores de uma campanha específica.
Metas de retenção
As metas de retenção foram criadas para incentivar a fidelidade do cliente e aumentar o valor da vida útil (LTV) da sua empresa. Elas oferecem vários modos nas campanhas Performance Max, permitindo que você segmente segmentos específicos de clientes atuais.
Antes de criar uma meta de retenção, você precisa atender aos pré-requisitos descritos em Sobre a meta de retenção. Isso inclui ter uma campanha Performance Max e uma lista de usuários da Segmentação por lista de clientes.
Para criar uma meta de retenção, primeiro inicialize o
GoalService e emita uma solicitação usando o
mutate_goals método para criar uma nova
meta.
def create_goal(client: GoogleAdsClient, customer_id: str) -> None:
"""Sends an API request to add a new Goal.
Args:
client: an initialized GoogleAdsClient instance.
customer_id: a client customer ID.
"""
goal_operation: GoalOperation = client.get_type("GoalOperation")
goal = goal_operation.create
goal.retention_goal_settings.value_settings.additional_value = 50.0
goal.retention_goal_settings.value_settings.additional_high_lifetime_value = 100.0
goal_service = client.get_service("GoalService")
goal_service.mutate_goals(
customer_id=customer_id, operations=[goal_operation]
)
Isso vai criar uma nova meta de retenção no nível da conta para a conta de cliente especificada, que será aplicada a todas as campanhas dela. Por padrão, essa meta vai segmentar todos os usuários nas suas listas de usuários da Segmentação por lista de clientes.
É possível substituir essa meta com configurações no nível da campanha, usando um
CampaignGoalConfig. Depois de ter um
objetivo no nível da conta, use o resource_name dele para criar um CampaignGoalConfig
usando o
mutate_campaign_goal_configs
método no
CampaignGoalConfigService.
def create_campaign_goal_config(
client: GoogleAdsClient,
customer_id: str,
goal_resource_name: str,
campaign_resource_name: str
) -> None:
"""Sends an API request to add a new CampaignGoalConfig.
Args:
client: an initialized GoogleAdsClient instance.
customer_id: a client customer ID.
goal_resource_name: the resource name of an existing Goal.
campaign_resource_name: the resource name of an existing Campaign.
"""
operation: CampaignGoalConfigOperation = client.get_type("CampaignGoalConfigOperation")
goal_config = operation.create
goal_config.campaign = campaign_resource_name
goal_config.goal = goal_resource_name
# Note that the target_option will be set to TARGET_ALL by default. In order
# to set it to TARGET_SPECIFIC your account must be on the appropriate
# allowlist.
#
# goal_config.campaign_retention_settings.target_option = (
# client.enums.CustomerLifecycleOptimizationModeEnum.TARGET_SPECIFIC
# )
campaign_goal_config_service = client.get_service("CampaignGoalConfigService")
campaign_goal_config_service.mutate_campaign_goal_configs(
customer_id=customer_id, operations=[operation]
)
O
campaign_retention_settings.target_option
será definido como TARGET_ALL por padrão se não estiver definido. A opção de definir como TARGET_SPECIFIC só está disponível para usuários na lista de permissões apropriada.
Recuperar metas de ciclo de vida
Assim como outros recursos na API Google Ads, use os search ou searchStream
métodos de GoogleAdsService para recuperar
metas de ciclo de vida.
A consulta a seguir recupera os detalhes de cada CustomerLifecycleGoal em uma conta do Google Ads:
SELECT
customer_lifecycle_goal.owner_customer,
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