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 relativoresource_name
e non impostare ilupdate_mask
del operativa.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 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 unCustomerLifecycleGoal
.
- Aggiungi elenchi di utenti alla raccolta
- 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.
- Associa ogni elenco utenti a una o più categorie creando un
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
:
lifecycle_goal_customer_definition_settings.existing_user_lists
indica quali elenchi di utenti contengono clienti esistenti.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