Obiettivi del ciclo di vita

Utilizza le risorse CustomerLifecycleGoal e CampaignLifecycleGoal dell'API Google Ads per configurare gli obiettivi relativi al ciclo di vita del cliente. L'API Google Ads supporta gli obiettivi di acquisizione di nuovi clienti per acquisire nuovi clienti in modo efficiente tramite le campagne Google Ads sulla rete di ricerca e Performance Max.

Se il tuo account Google Ads utilizza il monitoraggio delle conversioni su più account, devi configurare gli obiettivi del ciclo di vita del cliente nell'account conversioni Google Ads anziché direttamente nel tuo account Google Ads. Tuttavia, devi comunque impostare gli obiettivi basati sul ciclo di vita della campagna nel tuo account. Questa operazione è simile a quella che esegui per gestire altri obiettivi quando utilizzi il monitoraggio delle conversioni su più account.

Configurare gli obiettivi basati sul ciclo di vita dei clienti

A livello di cliente, configura un obiettivo del ciclo di vita creando o aggiornando un CustomerLifecycleGoal. Può esserci al massimo un CustomerLifecycleGoal per account Google Ads. Il campo customer_acquisition_goal_value_settings.value definisce l'aggiustamento del valore aggiuntivo da aggiungere alla conversione del primo acquisto di un nuovo cliente. customer_acquisition_goal_value_settings.high_lifetime_value definisce il valore di conversione incrementale per i nuovi clienti di alto valore. Il valore del ciclo di vita elevato deve essere maggiore del valore, se impostato.

Segmentare i segmenti di pubblico

Devi utilizzare la risorsa UserListCustomerType per segmentare i segmenti di pubblico per gli obiettivi del ciclo di vita del cliente. Devi associare ogni elenco di utenti a una o più categorie creando un UserListCustomerType per ogni combinazione di elenco di utenti e categoria.

Utilizza UserListCustomerTypeService per creare istanze UserListCustomerType. Se in precedenza hai compilato il campo CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists, il tuo account conterrà già le istanze UserListCustomerType correlate.

UserListCustomerTypeService supporta solo le operazioni create e remove, quindi se vuoi aggiornare un UserListCustomerType esistente devi rimuoverlo e poi crearne uno nuovo con gli aggiornamenti necessari.

Un UserListCustomerType può essere assegnato a un solo elenco utenti, ma un elenco utenti può avere più istanze UserListCustomerType associate purché non vi siano conflitti tra le istanze UserListCustomerType. Se tenti di assegnare UserListCustomerType istanze con le seguenti combinazioni di customer_type_category allo stesso elenco utenti, si verificherà un errore UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES:

customer_type_category dalla pubblicazione Secondo customer_type_category
ACQUIRENTI CONVERTED_LEADS
ACQUIRENTI QUALIFIED_LEADS
ACQUIRENTI CART_ABANDONERS
CONVERTED_LEADS QUALIFIED_LEADS
DISENGAGED_CUSTOMERS CONVERTED_LEADS
DISENGAGED_CUSTOMERS QUALIFIED_LEADS
DISENGAGED_CUSTOMERS CART_ABANDONERS

Configurare gli obiettivi del ciclo di vita della campagna

A livello di campagna, configura un obiettivo del ciclo di vita creando o aggiornando un CampaignLifecycleGoal. Può esserci al massimo un CampaignLifecycleGoal per campagna.

Il campo customer_acquisition_goal_settings di un obiettivo a livello di campagna ti consente di impostare la modalità di ottimizzazione della campagna e di ignorare le impostazioni dei valori dell'obiettivo cliente principale.

optimization_mode può avere uno dei seguenti valori:

TARGET_ALL_EQUALLY
La campagna ha come target i clienti nuovi ed esistenti in egual misura. Questa è la modalità di ottimizzazione predefinita.
BID_HIGHER_FOR_NEW_CUSTOMERS
La campagna ha come target sia i nuovi clienti sia quelli esistenti, ma fa offerte più alte per i clienti che si prevede siano nuovi e non rientrino in uno dei existing_user_lists.
TARGET_NEW_CUSTOMERS
La campagna ha come target solo i nuovi clienti.

I value_settings sono gli stessi dei customer_acquisition_goal_value_settings nell'obiettivo a livello di cliente. Utilizza queste impostazioni a livello di campagna per sostituire i valori di una campagna specifica.

Obiettivi di fidelizzazione

Gli obiettivi di fidelizzazione sono progettati per fidelizzare i clienti e aumentare il lifetime value (LTV) all'interno della tua attività. Offrono più modalità nelle campagne Performance Max, consentendoti di scegliere come target segmenti specifici di clienti esistenti.

Prima di creare un obiettivo di fidelizzazione, devi soddisfare i prerequisiti descritti in Informazioni sull'obiettivo di fidelizzazione. Ciò include una campagna Performance Max e un elenco di utenti Customer Match.

Per creare un obiettivo di fidelizzazione, devi prima inizializzare GoalService ed emettere una richiesta utilizzando il metodo mutate_goals per creare un nuovo obiettivo.

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]
    )

In questo modo verrà creato un nuovo obiettivo di fidelizzazione a livello di account per l'account cliente specificato, che verrà applicato a tutte le sue campagne. Per impostazione predefinita, questo obiettivo verrà indirizzato a tutti gli utenti negli elenchi di utenti Customer Match.

È possibile ignorare questo obiettivo con le impostazioni a livello di campagna utilizzando un CampaignGoalConfig. Una volta impostato un obiettivo a livello di account, utilizza resource_name per creare un CampaignGoalConfig utilizzando il metodo mutate_campaign_goal_configs su 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 allowlisted.
    #
    # 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]
    )

Se non impostato, il valore predefinito di campaign_retention_settings.target_option sarà TARGET_ALL. L'opzione per impostare TARGET_SPECIFIC è disponibile solo per gli utenti nella lista consentita.

Recupera gli obiettivi basati sul ciclo di vita

Come per altre risorse dell'API Google Ads, utilizza i metodi search o searchStream di GoogleAdsService per recuperare gli obiettivi del ciclo di vita.

La seguente query recupera i dettagli di ogni CustomerLifecycleGoal in un account 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

Analogamente, la query seguente recupera i dettagli di ogni 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