Metas de ciclo de vida

Use os recursos Goal e CampaignGoalConfig 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 e metas de retenção para gerenciar com eficiência os ajustes de valor do ciclo de vida do cliente nas suas campanhas do Google Ads.

Se a sua conta do Google Ads usa o rastreamento de conversões entre contas, configure as metas de 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, ainda é necessário definir as configurações no nível da campanha na sua conta. Isso é semelhante à forma como você gerencia outras metas ao usar o rastreamento de conversões entre contas.

Tipos de metas de ciclo de vida do cliente

As metas do ciclo de vida do cliente são configuradas no nível da conta usando o Goal recurso. Uma meta representa um objetivo específico do ciclo de vida e é definida pelo goal_type.

Os tipos de metas de ciclo de vida com suporte são:

NEW_CUSTOMER_ACQUISITION

Para adquirir novos clientes de maneira eficiente, atribuindo ajustes de valor às conversões deles.

CUSTOMER_RETENTION

Para reengajar clientes atuais, de alto valor e inativos.

LOYALTY_RETENTION

Para aumentar a retenção e o engajamento especificamente entre os membros do programa de fidelidade.

Configurar metas de ciclo de vida do cliente

No nível do cliente, configure uma meta de ciclo de vida criando um Goal. Pode haver no máximo um Goal por tipo de meta (NEW_CUSTOMER_ACQUISITION, CUSTOMER_RETENTION ou LOYALTY_RETENTION) em uma conta do Google Ads.

Configurações da meta de aquisição de novos clientes

Para configurar a aquisição de novos clientes (NCA, na sigla em inglês), defina o goal_type como NEW_CUSTOMER_ACQUISITION e configure as definições no campo new_customer_acquisition_goal_settings usando o GoalService.

As configurações usam CustomerLifecycleOptimizationValueSettings para especificar ajustes de valor de conversão para clientes adquiridos:

• value_adjustment (oneof):
  • additional_value (double): valor de conversão incremental a ser adicionado à primeira conversão de compra de um novo cliente.
  • value_multiplier (double): multiplicador a ser aplicado ao valor de conversão da primeira compra de um novo cliente (indisponível).
• high_lifetime_value_adjustment (oneof):
  • additional_high_lifetime_value (double): valor de conversão incremental para novos clientes identificados como de alto valor da vida útil.
  • high_lifetime_value_multiplier (double): multiplicador do valor de conversão a ser aplicado a novos clientes de alto valor da vida útil (indisponível).

O alto valor da vida útil precisa ser maior que o valor, se definido.

def create_nca_goal(client: GoogleAdsClient, customer_id: str) -> None:
    """Sends an API request to add a new New Customer Acquisition 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.goal_type = client.enums.GoalTypeEnum.NEW_CUSTOMER_ACQUISITION

    # Configure the value adjustments.
    goal.new_customer_acquisition_goal_settings.value_settings.additional_value = 50.0
    goal.new_customer_acquisition_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]
    )

Configurações da meta de retenção de clientes

Para configurar a retenção de clientes, defina o goal_type como CUSTOMER_RETENTION e configure as definições no campo retention_goal_settings.

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.

def create_retention_goal(client: GoogleAdsClient, customer_id: str) -> None:
    """Sends an API request to add a new Customer Retention 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.goal_type = client.enums.GoalTypeEnum.CUSTOMER_RETENTION
    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.

Configurações da meta de retenção de fidelidade

Para configurar metas de retenção de fidelidade para membros do programa de fidelidade, defina o goal_type como LOYALTY_RETENTION e configure as definições no campo loyalty_retention_goal_settings (LoyaltyRetentionGoal).

Para metas de retenção de fidelidade, apenas a configuração value_multiplier tem suporte em value_settings usando CustomerLifecycleOptimizationValueSettings:

def create_loyalty_retention_goal(client: GoogleAdsClient, customer_id: str) -> None:
    """Sends an API request to add a new Loyalty Retention 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.goal_type = client.enums.GoalTypeEnum.LOYALTY_RETENTION
    goal.loyalty_retention_goal_settings.value_settings.value_multiplier = 1.5

    goal_service = client.get_service("GoalService")
    goal_service.mutate_goals(
        customer_id=customer_id, operations=[goal_operation]
    )

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 (incluindo metas de aquisição de novos clientes, retenção de clientes e retenção de fidelidade). É 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.

O UserListCustomerTypeService só oferece suporte às operações create e remove. Portanto, se você quiser atualizar um UserListCustomerType atual, 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 UserListCustomerType com as seguintes combinações de customer_type_category à mesma lista de usuários vai resultar em um erro UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES:

Configurar as metas de ciclo de vida da campanha

No nível da campanha, é possível configurar substituições ou opções de segmentação específicas da campanha usando CampaignGoalConfig. Depois de ter uma meta no nível da conta, use o resource_name dela para criar um CampaignGoalConfig usando o método mutate_campaign_goal_configs no CampaignGoalConfigService.

Configurações de aquisição de novos clientes da campanha

Para substituir as configurações ou configurar a segmentação da NCA no nível da campanha, configure o campo campaign_new_customer_acquisition_settings do tipo CampaignNewCustomerAcquisitionGoalSettings:

• value_settings_override (tipo: CustomerLifecycleOptimizationValueSettings): ajustes de valor personalizados para substituir as configurações no nível da conta.
• target_option (tipo: CustomerLifecycleOptimizationMode): controla o modo de otimização do ciclo de vida do cliente. As opções são:
  • TARGET_ALL: a campanha segmenta clientes novos e atuais, mas dá lances mais altos para novos clientes usando os ajustes de valor configurados.
  • TARGET_SPECIFIC: a campanha segmenta apenas novos clientes. Os ajustes de lances não são aplicáveis a essa opção.

def create_campaign_nca_config(
    client: GoogleAdsClient,
    customer_id: str,
    goal_resource_name: str,
    campaign_resource_name: str,
) -> None:
    """Sends an API request to add a new CampaignGoalConfig for NCA.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
        goal_resource_name: the resource name of an existing NCA 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

    # Set the target option to target both new and existing customers.
    goal_config.campaign_new_customer_acquisition_settings.target_option = (
        client.enums.CustomerLifecycleOptimizationModeEnum.TARGET_ALL
    )
    # Optionally override value settings.
    goal_config.campaign_new_customer_acquisition_settings.value_settings_override.additional_value = 60.0

    campaign_goal_config_service = client.get_service("CampaignGoalConfigService")
    campaign_goal_config_service.mutate_campaign_goal_configs(
        customer_id=customer_id, operations=[operation]
    )

Configurações de retenção de clientes da campanha

Para substituir as configurações ou configurar a segmentação de metas de retenção no nível da campanha, configure o campaign_retention_settings campo do tipo CampaignRetentionGoalSettings:

• value_settings_override (tipo: CustomerLifecycleOptimizationValueSettings): ajustes de valor personalizados para substituir as configurações no nível da conta.
• target_option (tipo: CustomerLifecycleOptimizationMode): controla o modo de otimização. O padrão é TARGET_ALL. Para definir como TARGET_SPECIFIC, sua conta precisa estar na lista de permissões apropriada.

def create_campaign_retention_config(
  client: GoogleAdsClient,
  customer_id: str,
  goal_resource_name: str,
  campaign_resource_name: str
) -> None:
    """Sends an API request to add a new CampaignGoalConfig for Retention.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
        goal_resource_name: the resource name of an existing Retention 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

    # 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.

Configurações de retenção de fidelidade da campanha

Para substituir as configurações ou configurar o comportamento específico do membro da fidelidade no nível da campanha para metas LOYALTY_RETENTION, configure o campo campaign_loyalty_retention_settings do tipo CampaignLoyaltyRetentionGoalSettings em CampaignGoalConfig:

• value_settings_override (tipo: CustomerLifecycleOptimizationValueSettings): ajustes de valor personalizados para substituir as configurações de valor de retenção de fidelidade no nível da conta.
• enable_bid_adjustments_for_loyalty_members (tipo: bool): se os ajustes de lances para membros do programa de fidelidade estão ativados nesta campanha.
• show_targeted_loyalty_member_benefits_in_pla (tipo: bool): se os benefícios de membros de fidelidade segmentados serão exibidos no formato de anúncio com informações do produto (PLA, na sigla em inglês) em países qualificados.

def create_campaign_loyalty_retention_config(
    client: GoogleAdsClient,
    customer_id: str,
    goal_resource_name: str,
    campaign_resource_name: str,
) -> None:
    """Sends an API request to add a new CampaignGoalConfig for Loyalty Retention.

    Args:
        client: an initialized GoogleAdsClient instance.
        customer_id: a client customer ID.
        goal_resource_name: the resource name of an existing Loyalty Retention 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

    # Enable bid adjustments and targeted loyalty benefits in PLAs.
    goal_config.campaign_loyalty_retention_settings.enable_bid_adjustments_for_loyalty_members = True
    goal_config.campaign_loyalty_retention_settings.show_targeted_loyalty_member_benefits_in_pla = True

    campaign_goal_config_service = client.get_service("CampaignGoalConfigService")
    campaign_goal_config_service.mutate_campaign_goal_configs(
        customer_id=customer_id, operations=[operation]
    )

Validação e erros

Ao configurar metas de ciclo de vida do cliente, as seguintes restrições e erros podem ser encontrados:

Erros de validação de objetivos

Configuração de meta duplicada

A criação de uma meta de ciclo de vida duplicada quando já existe uma resulta em um erro GoalError.NEW_CUSTOMER_ACQUISITION_GOAL_ALREADY_EXISTS (para NCA), GoalError.RETENTION_GOAL_ALREADY_EXISTS (para metas de retenção) ou GoalError.LOYALTY_RETENTION_GOAL_ALREADY_EXISTS (para metas de retenção de fidelidade).

Configurações de valor inválidas

Ao configurar as definições de valor da meta de ciclo de vida, se o alto valor da vida útil estiver presente, o valor padrão também deverá estar (GoalError.HIGH_LIFETIME_VALUE_PRESENT_BUT_VALUE_ABSENT). Além disso, o alto valor da vida útil precisa ser maior que o valor, se definido (GoalError.HIGH_LIFETIME_VALUE_LESS_THAN_OR_EQUAL_TO_VALUE).

Erros de validação de configuração de metas da campanha

Conflito de substituição de valor específico do destino

Para metas de aquisição de novos clientes, se target_option estiver definido como TARGET_SPECIFIC (para segmentar apenas novos clientes), as substituições de valor no nível da campanha não poderão ser configuradas (CampaignGoalConfigError.CAMPAIGN_OVERRIDE_VALUES_SET_FOR_NEW_CUSTOMER_ACQUISITION_TARGET_SPECIFIC_OPTION). Os ajustes de lances não são aplicáveis ao segmentar apenas novos clientes.

Suporte ao tipo de campanha de alto valor da vida útil

As substituições de alto valor da vida útil só podem ser definidas para tipos de campanha com suporte (CampaignGoalConfigError.CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE).

Metas incompatíveis

Um erro será gerado se uma campanha tentar aplicar metas de otimização de ciclo de vida do cliente incompatíveis simultaneamente (CampaignGoalConfigError.CANNOT_USE_INCOMPATIBLE_CLO_GOALS). A tabela abaixo descreve combinações de metas mutuamente exclusivas que acionam esse erro:

Recuperar metas de ciclo de vida

Assim como acontece com outros recursos na API Google Ads, use os métodos search ou searchStream de GoogleAdsService para recuperar metas e configurações de ciclo de vida.

A consulta a seguir recupera os detalhes de cada Goal configurado em uma conta da API Google Ads:

SELECT
  goal.goal_id,
  goal.goal_type,
  goal.owner_customer,
  goal.new_customer_acquisition_goal_settings.value_settings.additional_value,
  goal.new_customer_acquisition_goal_settings.value_settings.additional_high_lifetime_value,
  goal.retention_goal_settings.value_settings.additional_value,
  goal.retention_goal_settings.value_settings.additional_high_lifetime_value,
  goal.loyalty_retention_goal_settings.value_settings.value_multiplier
FROM goal

Da mesma forma, a consulta a seguir recupera os detalhes de cada CampaignGoalConfig:

SELECT
  campaign_goal_config.campaign,
  campaign_goal_config.goal,
  campaign_goal_config.goal_type,
  campaign_goal_config.campaign_new_customer_acquisition_settings.target_option,
  campaign_goal_config.campaign_new_customer_acquisition_settings.value_settings_override.additional_value,
  campaign_goal_config.campaign_new_customer_acquisition_settings.value_settings_override.additional_high_lifetime_value,
  campaign_goal_config.campaign_retention_settings.target_option,
  campaign_goal_config.campaign_retention_settings.value_settings_override.additional_value,
  campaign_goal_config.campaign_loyalty_retention_settings.value_settings_override.value_multiplier,
  campaign_goal_config.campaign_loyalty_retention_settings.enable_bid_adjustments_for_loyalty_members,
  campaign_goal_config.campaign_loyalty_retention_settings.show_targeted_loyalty_member_benefits_in_pla
FROM campaign_goal_config