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 clienti
per acquisire nuovi clienti in modo efficiente
tramite le campagne sulla rete di ricerca, Shopping e Performance
Max di Google Ads.
Se il tuo account Google Ads utilizza il monitoraggio delle conversioni su più account, devi configurare gli obiettivi basati sul ciclo di vita dei clienti nell'account di conversione di 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 procedura è simile a quella che utilizzi 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 basato sul ciclo di vita creando o aggiornando un
CustomerLifecycleGoal. Può esistere al massimo un CustomerLifecycleGoal per account Google Ads. Il campo customer_acquisition_goal_value_settings.value definisce l'aggiustamento del valore aggiuntivo da assegnare alla conversione del primo acquisto di un nuovo cliente. Il campo customer_acquisition_goal_value_settings.high_lifetime_value definisce il valore di conversione incrementale per i nuovi clienti di alto valore. Se impostato, il valore del ciclo di vita elevato deve essere maggiore del valore.
Segmentare i segmenti di pubblico
Devi utilizzare la
UserListCustomerType risorsa per segmentare
i segmenti di pubblico per gli obiettivi basati sul ciclo di vita dei clienti. Devi associare ogni elenco utenti
a una o più categorie creando un UserListCustomerType per ogni
combinazione di elenco utenti e categoria.
Utilizza
UserListCustomerTypeService per
creare UserListCustomerType istanze.
Se in precedenza hai compilato il campo CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists, ora ritirato, il tuo account conterrà già le istanze UserListCustomerType correlate.
Il 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 a condizione che non ci siano conflitti tra le istanze UserListCustomerType. Se provi ad assegnare istanze UserListCustomerType con le
seguenti combinazioni di customer_type_category allo stesso elenco utenti
verrà generato un errore UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES:
Prima customer_type_category |
Seconda customer_type_category |
|---|---|
| PURCHASERS | CONVERTED_LEADS |
| PURCHASERS | QUALIFIED_LEADS |
| PURCHASERS | CART_ABANDONERS |
| CONVERTED_LEADS | QUALIFIED_LEADS |
| DISENGAGED_CUSTOMERS | CONVERTED_LEADS |
| DISENGAGED_CUSTOMERS | QUALIFIED_LEADS |
| DISENGAGED_CUSTOMERS | CART_ABANDONERS |
| LOYALTY_TIER_X_MEMBERS | LOYALTY_TIER_Y_MEMBERS |
Configurare gli obiettivi basati sul ciclo di vita della campagna
A livello di campagna, puoi configurare le impostazioni dell'obiettivo di acquisizione di clienti
creando o aggiornando un
CampaignLifecycleGoal. Può esistere al massimo un CampaignLifecycleGoal per campagna per l'acquisizione di clienti.
Tieni presente che gli altri tipi di obiettivi, ad esempio gli obiettivi di fidelizzazione, vengono configurati separatamente.
Il campo customer_acquisition_goal_settings di un obiettivo a livello di campagna ti consente di impostare la modalità di ottimizzazione della campagna, nonché di sostituire le impostazioni del valore dell'obiettivo cliente principale.
optimization_mode può avere uno dei seguenti valori:
TARGET_ALL_EQUALLY- La campagna ha come target nuovi clienti ed esistenti in egual misura. Questa è la modalità di ottimizzazione predefinita.
BID_HIGHER_FOR_NEW_CUSTOMERS- La campagna ha come target sia nuovi clienti sia clienti esistenti, ma fa un'offerta più alta per i clienti che si prevede siano nuovi e non siano inclusi in uno degli
existing_user_lists. TARGET_NEW_CUSTOMERS- La campagna ha come target solo i nuovi clienti.
Le value_settings sono le stesse di
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 avere una campagna Performance Max e un elenco utenti Customer Match.
Per creare un obiettivo di fidelizzazione, devi prima inizializzare il
GoalService ed emettere una richiesta utilizzando il
mutate_goals metodo 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 avrà come target tutti gli utenti negli elenchi utenti Customer Match.
È possibile sostituire questo obiettivo con le impostazioni a livello di campagna utilizzando un
CampaignGoalConfig. Una volta che hai un
obiettivo a livello di account, utilizza il relativo resource_name per creare un CampaignGoalConfig
utilizzando il
mutate_campaign_goal_configs
metodo in
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 on the appropriate
# allowlist.
#
# 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]
)
The
campaign_retention_settings.target_option
avrà come valore predefinito TARGET_ALL se non è impostato. L'opzione per impostare TARGET_SPECIFIC è disponibile solo per gli utenti nella lista consentita appropriata.
Recuperare gli obiettivi basati sul ciclo di vita
Come per le altre risorse dell'API Google Ads, utilizza i search o i searchStream
metodi di GoogleAdsService per recuperare gli
obiettivi basati sul ciclo di vita.
La query seguente 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
Allo stesso modo, 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