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 nuovi clienti per acquisire nuovi clienti in modo efficiente 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 del cliente nell'account conversioni 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 operazione è simile a quella che esegui 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 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. customer_acquisition_goal_value_settings.high_lifetime_value
definisce il valore di conversione incrementale per i nuovi clienti di alto valore. Il valore
del ciclo di vita elevato deve essere maggiore del valore, se impostato.
Segmentare i segmenti di pubblico
Devi utilizzare la risorsa
UserListCustomerType
per segmentare
i segmenti di pubblico per gli obiettivi del ciclo di vita del cliente. Devi associare ogni elenco di utenti
a una o più categorie creando un UserListCustomerType
per ogni
combinazione di elenco di utenti e categoria.
Utilizza
UserListCustomerTypeService
per
creare istanze UserListCustomerType
.
Se in precedenza hai 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 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 purché non vi siano conflitti tra le istanze UserListCustomerType
. Se tenti di assegnare UserListCustomerType
istanze con le seguenti combinazioni di customer_type_category
allo stesso elenco utenti, si verificherà 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 |
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
. 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 ignorare le impostazioni dei valori
dell'obiettivo cliente principale.
optimization_mode
può avere 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 ha come target sia i nuovi clienti sia quelli esistenti, ma fa offerte più alte per i clienti che si prevede siano nuovi e non rientrino in uno dei
existing_user_lists
. TARGET_NEW_CUSTOMERS
- La campagna ha come target solo i nuovi clienti.
I value_settings
sono gli stessi dei
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 una campagna Performance Max e un elenco di utenti Customer Match.
Per creare un obiettivo di fidelizzazione, devi prima inizializzare
GoalService ed emettere una richiesta utilizzando il
metodo mutate_goals
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 verrà indirizzato a tutti gli utenti negli elenchi di utenti Customer Match.
È possibile ignorare questo obiettivo con le impostazioni a livello di campagna utilizzando un
CampaignGoalConfig
. Una volta impostato un obiettivo a livello di account, utilizza resource_name
per creare un CampaignGoalConfig
utilizzando il metodo mutate_campaign_goal_configs
su 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 allowlisted.
#
# 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]
)
Se non impostato, il valore predefinito di
campaign_retention_settings.target_option
sarà TARGET_ALL
. L'opzione per impostare TARGET_SPECIFIC
è disponibile solo per gli utenti nella lista consentita.
Recupera gli obiettivi basati sul 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.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
Analogamente, 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