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 clienti per acquisire nuovi clienti in modo efficiente tramite le campagne sulla rete di ricerca, Shopping e Performance Max di Google Ads.

Se il tuo account Google Ads utilizza il monitoraggio delle conversioni su più account, devi configurare gli obiettivi basati sul ciclo di vita dei clienti nell'account di conversione di 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 procedura è simile a quella che utilizzi 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 basato sul ciclo di vita creando o aggiornando un CustomerLifecycleGoal. Può esistere al massimo un CustomerLifecycleGoal per account Google Ads. Il campo customer_acquisition_goal_value_settings.value definisce l'aggiustamento del valore aggiuntivo da assegnare alla conversione del primo acquisto di un nuovo cliente. Il campo customer_acquisition_goal_value_settings.high_lifetime_value definisce il valore di conversione incrementale per i nuovi clienti di alto valore. Se impostato, il valore del ciclo di vita elevato deve essere maggiore del valore.

Segmentare i segmenti di pubblico

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

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

Il 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 a condizione che non ci siano conflitti tra le istanze UserListCustomerType. Se provi ad assegnare istanze UserListCustomerType con le seguenti combinazioni di customer_type_category allo stesso elenco utenti verrà generato un errore UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES:

Configurare gli obiettivi basati sul ciclo di vita della campagna

A livello di campagna, puoi configurare le impostazioni dell'obiettivo di acquisizione di clienti creando o aggiornando un CampaignLifecycleGoal. Può esistere al massimo un CampaignLifecycleGoal per campagna per l'acquisizione di clienti. Tieni presente che gli altri tipi di obiettivi, ad esempio gli obiettivi di fidelizzazione, vengono configurati separatamente.

Il campo customer_acquisition_goal_settings di un obiettivo a livello di campagna ti consente di impostare la modalità di ottimizzazione della campagna, nonché di sostituire le impostazioni del valore dell'obiettivo cliente principale.

optimization_mode può avere uno dei seguenti valori:

TARGET_ALL_EQUALLY

La campagna ha come target nuovi clienti ed esistenti in egual misura. Questa è la modalità di ottimizzazione predefinita.

BID_HIGHER_FOR_NEW_CUSTOMERS

La campagna ha come target sia nuovi clienti sia clienti esistenti, ma fa un'offerta più alta per i clienti che si prevede siano nuovi e non siano inclusi in uno degli existing_user_lists.

TARGET_NEW_CUSTOMERS

La campagna ha come target solo i nuovi clienti.

Le value_settings sono le stesse di 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 avere una campagna Performance Max e un elenco utenti Customer Match.

Per creare un obiettivo di fidelizzazione, devi prima inizializzare il GoalService ed emettere una richiesta utilizzando il mutate_goals metodo 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 avrà come target tutti gli utenti negli elenchi utenti Customer Match.

È possibile sostituire questo obiettivo con le impostazioni a livello di campagna utilizzando un CampaignGoalConfig. Una volta che hai un obiettivo a livello di account, utilizza il relativo resource_name per creare un CampaignGoalConfig utilizzando il mutate_campaign_goal_configs metodo in 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]
    )

The campaign_retention_settings.target_option avrà come valore predefinito TARGET_ALL se non è impostato. L'opzione per impostare TARGET_SPECIFIC è disponibile solo per gli utenti nella lista consentita appropriata.

Recuperare gli obiettivi basati sul ciclo di vita

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

La query seguente 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

Allo stesso modo, 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