Utilizza le risorse CustomerLifecycleGoal
e CampaignLifecycleGoal
dell'API Google Ads per configurare gli obiettivi relativi al ciclo di vita del cliente. A partire dalla versione 15, l'API Google Ads supporta gli obiettivi di acquisizione di clienti per acquisire in modo efficiente nuovi clienti 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 dei clienti nell'account cliente di conversione di Google Ads anziché direttamente nell'account Google Ads. Tuttavia, devi comunque impostare gli obiettivi del ciclo di vita delle campagne nel tuo account. Questo metodo è simile a quello per 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 in CustomerLifecycleGoalService
e CampaignLifecycleGoalService
sono leggermente diverse rispetto ad altri servizi dell'API Google Ads. Invece di avere operazioni
create
e update
separate, le versioni v15
CustomerLifecycleGoalOperation
e
CampaignLifecycleGoalOperation
hanno solo un'operazione create
, quindi indichi il tuo intent utilizzando
update_mask
come segue:
Per creare un obiettivo del ciclo di vita utilizzando la versione 15, compila
create
con l'obiettivo, ma non impostarne ilresource_name
e non impostare ilupdate_mask
dell'operazione.Per aggiornare un obiettivo del ciclo di vita utilizzando la versione 15, compila
create
con l'obiettivo, impostaresource_name
dell'obiettivo e impostaupdate_mask
per elencare i 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 una 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 customer_acquisition_goal_value_settings.high_lifetime_value
dell'obiettivo, ma questo campo è immutabile nell'API Google Ads.
Segmentare il pubblico
A partire dalla versione 17 dell'API Google Ads, devi utilizzare la risorsa UserListCustomerType
per segmentare i segmenti di pubblico in base agli obiettivi del ciclo di vita dei clienti. La configurazione dei segmenti di pubblico direttamente nella risorsa CustomerLifecycleGoal
è stata ritirata. Di seguito sono riportati i dettagli:
- Prima della versione 17:
- Aggiungi elenchi di utenti alla raccolta
existing_user_lists
di unCustomerLifecycleGoal
.
- Aggiungi elenchi di utenti alla raccolta
- A partire dalla versione 17:
- Associa ogni elenco di utenti a una o più categorie creando un
UserListCustomerType
per ogni combinazione di elenco di utenti e categoria.
- Associa ogni elenco di utenti a una o più categorie creando un
Nell'API Google Ads v17 e successive
Utilizza UserListCustomerTypeService
per creare istanze UserListCustomerType
.
Se hai già 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 dovrai rimuoverlo e crearne uno nuovo con gli aggiornamenti necessari.
Un UserListCustomerType
può essere assegnato a un solo elenco di utenti, ma a un elenco utenti possono essere associate più istanze UserListCustomerType
, purché non ci siano conflitti tra le istanze UserListCustomerType
. Se provi ad assegnare UserListCustomerType
istanze con le seguenti combinazioni di customer_type_category
allo stesso elenco utenti, verrà visualizzato 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 nella sezione CustomerLifecycleGoal
del tuo account:
lifecycle_goal_customer_definition_settings.existing_user_lists
indica quali elenchi di utenti contengono clienti esistenti.Il campo
lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists
indica quali elenchi di utenti contengono clienti con lifetime value elevato. Puoi 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 del 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:
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. Il campo user_list contiene il nome della risorsa dell'elenco utenti associato.
|
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 da lifecycle_goal_customer_definition_settings.existing_user_lists
|
Crea o rimuovi istanze UserListCustomerType , dove
customer_type_category è impostato su
HIGH_VALUE_CUSTOMERS
|
I nomi delle singole risorse verranno aggiunti o rimossi da 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 una 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 sostituire le impostazioni dei valori dell'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 è la modalità di ottimizzazione predefinita.
BID_HIGHER_FOR_NEW_CUSTOMERS
- La campagna è indirizzata sia ai nuovi clienti sia a quelli esistenti, ma offre un'offerta più alta per i clienti che si prevede siano nuovi e che non fanno parte di
existing_user_lists
. TARGET_NEW_CUSTOMERS
- La campagna si rivolge solo ai nuovi clienti.
Il valore value_settings
è uguale al
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.
Recuperare gli obiettivi del 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.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