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.

Gestire le operazioni di creazione e aggiornamento (solo per la versione 15)

Nella versione 15 dell'API Google Ads, le operazioni supportate nel CustomerLifecycleGoalService e CampaignLifecycleGoalService leggermente diversi dagli altri servizi dell'API Google Ads. Anziché avere un sistema Operazioni create e update, versione 15 CustomerLifecycleGoalOperation: e CampaignLifecycleGoalOperation eseguire solo un'operazione create e tu indichi il tuo intento utilizzando update_mask come segue:

• Per creare un obiettivo del ciclo di vita utilizzando la versione 15, compila create con l'obiettivo, non impostare il relativo resource_name e non impostare il update_mask del operativa.

• Per aggiornare un obiettivo del ciclo di vita utilizzando la versione 15, compila create con l'obiettivo, imposta resource_name dell'obiettivo e imposta update_mask per elencare le campi da aggiornare.

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 Ci possono essere al massimo un CustomerLifecycleGoal per account Google Ads. La Il campo customer_acquisition_goal_value_settings.value definisce da aggiungere alla conversione del primo acquisto di un nuovo cliente. Puoi leggi l'customer_acquisition_goal_value_settings.high_lifetime_value del ma questo campo è immutabile nell'API Google Ads.

Segmentare il 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.

di Gemini Advanced.

Nell'API Google Ads v17 e successive

Utilizza la Da UserListCustomerTypeService a per creare istanze UserListCustomerType. Se avessi già compilato il campo CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists , il tuo account conterrà già i UserListCustomerType di Compute Engine.

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

Un UserListCustomerType può essere assegnato a un solo elenco di utenti, ma all'elenco utenti può essere associata più istanze UserListCustomerType purché non ci siano conflitti tra UserListCustomerType di Compute Engine. Stai tentando di assegnare UserListCustomerType istanze con il le seguenti combinazioni di customer_type_category allo stesso elenco utenti comporterà 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

Nell'API Google Ads v16 e precedenti

Imposta i seguenti campi nel CustomerLifecycleGoal:

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

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

Comportamento delle risorse condivise

È importante ricordare che la versione 16 dell'API Google Ads non sarà ritirata a gennaio 2025 UserListCustomerType e i campi di segmentazione del pubblico attivati CustomerLifecycleGoal sono una risorsa condivisa, vale a dire che la creazione di nuovi UserListCustomerType istanza nella versione 17 e successive comporterà modifiche all'istanza CustomerLifecycleGoal nella versione 16 e precedenti, e viceversa intorno a te.

Ecco come vengono mappati i campi delle due risorse:

Modifica del campo "CustomerLifecycleGoal" nella versione 16	Effetto collaterale di "UserListCustomerType" nella versione 17
lifecycle_goal_customer_definition_settings.existing_user_lists	Crea o rimuove UserListCustomerType istanze. La Il campo user_list contiene la risorsa dell'elenco di utenti associata nome.

Modifica di "UserListCustomerType" nella versione 17	Effetto collaterale sul campo "CustomerLifecycleGoal" nella versione 16
Crea o rimuovi le istanze UserListCustomerType.	I nomi delle singole risorse verranno aggiunti o rimossi dal lifecycle_goal_customer_definition_settings.existing_user_lists
Crea o rimuovi le istanze UserListCustomerType, in cui Il valore di customer_type_category è impostato su HIGH_VALUE_CUSTOMERS	I nomi delle singole risorse verranno aggiunti o rimossi dal lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists

Configura gli obiettivi del ciclo di vita delle campagne

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 sostituire le impostazioni dei valori. dall'obiettivo del cliente principale.

optimization_mode può essere uno dei seguenti valori:

TARGET_ALL_EQUALLY

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

BID_HIGHER_FOR_NEW_CUSTOMERS

La campagna è indirizzata a clienti nuovi ed esistenti, ma offre un'offerta più alta per i clienti che si prevede siano nuovi e che non rientrano in uno dei existing_user_lists.

TARGET_NEW_CUSTOMERS

La campagna si rivolge solo ai 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 altre risorse dell'API Google Ads, utilizza l'search o searchStream metodi di GoogleAdsService per recuperare 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