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 com suas campanhas de pesquisa, Shopping e Performance Max do Google Ads.

Se a sua conta do Google Ads estiver usando o acompanhamento de conversões de várias contas, configure as metas de ciclo de vida do cliente na conta de conversão do Google Ads, em vez de fazer isso 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 a como você gerencia outras metas ao usar o acompanhamento de conversões de várias contas.

Configurar metas do ciclo de vida do cliente

No nível do cliente, configure uma meta de ciclo de vida criando ou atualizando um CustomerLifecycleGoal. Só pode haver um CustomerLifecycleGoal por conta do Google Ads. O campo customer_acquisition_goal_value_settings.value define o ajuste de valor adicional a ser adicionado à primeira conversão de compra de um novo cliente. O customer_acquisition_goal_value_settings.high_lifetime_value define o valor de conversão incremental para novos clientes de alto valor. O valor alto do ciclo de vida precisa ser maior que o valor, se definido.

Segmentar seus públicos-alvo

Use o recurso UserListCustomerType para segmentar seus públicos-alvo de acordo com as 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 instâncias UserListCustomerType. Se você já preencheu o campo CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists, que agora está descontinuado, sua conta já vai ter instâncias UserListCustomerType relacionadas.

O UserListCustomerTypeService só aceita 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 de UserListCustomerType associadas desde que não haja conflitos entre as instâncias de 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:

Configurar metas de ciclo de vida da campanha

No nível da campanha, é possível 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 meta, 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 ter 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 faz lances mais altos para clientes que devem ser novos e não estão em um dos 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 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.

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 em campanhas Performance Max para que você possa segmentar grupos específicos de clientes.

Antes de criar uma meta de retenção, é preciso 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 faça uma solicitação usando o método mutate_goals 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 segmenta todos os usuários nas suas listas de público-alvo por lista de clientes.

É possível substituir essa meta com configurações no nível da campanha usando um CampaignGoalConfig. Depois de ter uma meta no nível da conta, use o resource_name dela 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 for definido. A opção de definir como TARGET_SPECIFIC está disponível apenas para usuários na lista de permissões adequada.

Recuperar metas de ciclo de vida

Assim como outros recursos da API Google Ads, use os métodos search ou searchStream 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