Obiettivi del ciclo di vita

Utilizza i CustomerLifecycleGoal e CampaignLifecycleGoal delle risorse API Google Ads per configurare gli obiettivi relativi al ciclo di vita del cliente. A partire dalla versione 15, L'API Google Ads supporta l'acquisizione di clienti in modo efficiente Acquisire nuovi clienti tramite le campagne sulla rete di ricerca e Performance Max di Google Ads campagne.

Se il tuo account Google Ads utilizza il monitoraggio delle conversioni su più account, Devi configurare gli obiettivi del ciclo di vita dei clienti nella documentazione di Google Ads cliente anziché direttamente nell'account Google Ads. Dovresti comunque impostare gli obiettivi del ciclo di vita delle campagne nel tuo account. Si tratta di un processo simile Gestire altri obiettivi quando utilizzi il monitoraggio delle conversioni su più account.

Configura gli obiettivi del 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. Puoi leggere il valore customer_acquisition_goal_value_settings.high_lifetime_value dell'obiettivo, ma questo campo è immutabile nell'API Google Ads.

Segmenta i tuoi segmenti di pubblico

A partire dalla versione 17 dell'API Google Ads, devi utilizzare la classe UserListCustomerType risorsa da segmentare i tuoi segmenti di pubblico per gli obiettivi del ciclo di vita dei clienti. La configurazione dei segmenti di pubblico viene eseguita direttamente la risorsa CustomerLifecycleGoal è ritirato. Di seguito sono riportati i dettagli:

• Prima della versione 17:
  • Aggiungi elenchi di utenti alla raccolta existing_user_lists di un CustomerLifecycleGoal.
• A partire dalla versione 17:
  • Associa ogni elenco utenti a una o più categorie creando un UserListCustomerType per ogni combinazione di elenco di utenti e categoria.

Nell'API Google Ads 17 e versioni successive

Utilizza la Da UserListCustomerTypeService a per creare istanze UserListCustomerType. Se hai già compilato il campo CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists, il tuo account conterrà già istanze UserListCustomerType correlate.

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

Un UserListCustomerType può essere assegnato a un solo elenco di utenti, ma un elenco di utenti può avere più istanze UserListCustomerType associate a condizione che non vi siano conflitti tra le istanze UserListCustomerType. Stai tentando di assegnare UserListCustomerType istanze con le seguenti combinazioni di customer_type_category allo stesso elenco utenti comporterà un Errore UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES:

Nell'API Google Ads versione 16

Imposta i seguenti campi su CustomerLifecycleGoal del tuo account:

1. lifecycle_goal_customer_definition_settings.existing_user_lists indica quali elenchi di utenti contengono clienti esistenti.

2. Il campo lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists indica quali elenchi di utenti contengono clienti con un lifetime value elevato. Tu può leggere questo campo, ma è immutabile nell'API Google Ads.

Comportamento delle risorse condivise

Fino al ritiro della versione 16 dell'API Google Ads a gennaio 2025, è importante ricordare che UserListCustomerType e i campi di segmentazione dei segmenti di pubblico su CustomerLifecycleGoal sono una risorsa condivisa, il che significa che la creazione di nuove istanze UserListCustomerType nella versione 17 e successive comporterà modifiche all'istanza CustomerLifecycleGoal nella versione 16 e precedenti e viceversa.

Ecco come vengono mappati i campi delle due risorse:

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. Ci possono essere 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 sostituire le impostazioni del valore dell'obiettivo cliente principale.

optimization_mode può essere uno dei seguenti valori:

TARGET_ALL_EQUALLY

La campagna ha come target sia i clienti nuovi sia quelli esistenti. Questa è la modalità di ottimizzazione predefinita.

BID_HIGHER_FOR_NEW_CUSTOMERS

La campagna ha come target sia i clienti nuovi sia quelli esistenti, ma fa offerte più elevate per i clienti che si prevede siano nuovi e non rientrano in uno dei gruppiexisting_user_lists.

TARGET_NEW_CUSTOMERS

La campagna ha come target solo i nuovi clienti.

value_settings corrispondono al customer_acquisition_goal_value_settings sull'obiettivo a livello di cliente. Utilizza questi impostazioni a livello di campagna per sostituire i valori di una campagna specifica.

Recuperare gli obiettivi del ciclo di vita

Come per le 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.lifecycle_goal_customer_definition_settings.existing_user_lists,
  customer_lifecycle_goal.lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists,
  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 seguente query 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