Utiliser les CustomerLifecycleGoal
et
CampaignLifecycleGoal
ressources du
API Google Ads pour configurer des objectifs liés au cycle de vie des clients. Depuis la v15, les
L'API Google Ads permet d'acquérir des clients
des objectifs pour optimiser
l'acquisition de nouveaux clients via vos campagnes Google Ads sur le Réseau de Recherche et Performance Max
campagnes.
Si vous utilisez le suivi des conversions multicomptes dans votre compte Google Ads, devez configurer les objectifs de cycle de vie des clients dans la conversion Google Ads client plutôt que directement dans votre compte Google Ads. Vous devez quand même définir du cycle de vie des campagnes dans votre compte. Ceci est similaire à la façon dont vous gérer d'autres objectifs lorsque vous utilisez le suivi des conversions multicomptes.
Gérer les opérations de création et de mise à jour (v15 uniquement)
Dans l'API Google Ads v15, les opérations disponibles dans les
CustomerLifecycleGoalService
et
CampaignLifecycleGoalService
sont légèrement différents des autres services de l'API Google Ads. Au lieu d'avoir des fichiers
Opérations create
et update
(v15)
CustomerLifecycleGoalOperation
et
CampaignLifecycleGoalOperation
n'ont qu'une opération create
, et vous indiquez votre intent à l'aide de la méthode
update_mask
comme suit:
Pour créer un objectif de cycle de vie à l'aide de la version 15, renseignez
create
avec l'objectif, mais ne définissez pasresource_name
niupdate_mask
opération.Pour mettre à jour un objectif de cycle de vie à l'aide de la version 15, renseignez
create
avec l'objectif, définissezresource_name
de l'objectif et définissezupdate_mask
pour répertorier les les champs que vous souhaitez mettre à jour.
Configurer les objectifs de cycle de vie des clients
Au niveau du client, configurez un objectif de cycle de vie en créant ou en mettant à jour
CustomerLifecycleGoal
Il peut y avoir à
un CustomerLifecycleGoal
maximum par compte Google Ads. La
Le champ customer_acquisition_goal_value_settings.value
définit les champs supplémentaires
pour l'ajouter à la première conversion d'achat d'un nouveau client. Vous pouvez
lire les customer_acquisition_goal_value_settings.high_lifetime_value
des
mais ce champ ne peut pas être modifié dans l'API Google Ads.
Segmenter vos audiences
À partir de la version 17 de l'API Google Ads, vous devez utiliser les
UserListCustomerType
ressource à segmenter
vos audiences pour les objectifs
de cycle de vie des clients. Configurer les audiences directement sur
la ressource CustomerLifecycleGoal
est
obsolète. Voici les informations détaillées :
- Avant la version 17:
<ph type="x-smartling-placeholder">
- </ph>
- Ajouter des listes d'utilisateurs à la collection
existing_user_lists
d'unCustomerLifecycleGoal
- Ajouter des listes d'utilisateurs à la collection
- À partir de la version 17:
<ph type="x-smartling-placeholder">
- </ph>
- Associez chaque liste d'utilisateurs à une ou plusieurs catégories en créant une
UserListCustomerType
pour chaque combinaison de liste d'utilisateurs et de catégorie.
- Associez chaque liste d'utilisateurs à une ou plusieurs catégories en créant une
Dans l'API Google Ads v17 et versions ultérieures
Utilisez les
UserListCustomerTypeService
jusqu'à
créer des instances UserListCustomerType
.
Si vous avez déjà renseigné le champ
CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists
, votre compte contiendra déjà des UserListCustomerType
Compute Engine.
UserListCustomerTypeService
n'accepte que create
et remove
.
Opérations. Par conséquent, si vous souhaitez mettre à jour un UserListCustomerType
existant, vous devez
vous devez la supprimer, puis en créer
une autre avec les mises à jour nécessaires.
Un UserListCustomerType
ne peut être attribué qu'à une seule liste d'utilisateurs, mais
La liste d'utilisateurs peut être associée à plusieurs instances UserListCustomerType
tant qu'il n'y a pas de conflits entre UserListCustomerType
Compute Engine. Essayer d'attribuer à UserListCustomerType
instances le rôle
les combinaisons suivantes
customer_type_category
à la même liste d'utilisateurs entraîne un
Erreur UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES
:
customer_type_category depuis la mise en ligne |
Deuxième customer_type_category |
---|---|
ACHETEURS | CONVERTED_LEADS |
ACHETEURS | QUALIFIED_LEADS |
ACHETEURS | CART_ABANDONERS |
CONVERTED_LEADS | QUALIFIED_LEADS |
DISENGAGED_CUSTOMERS | CONVERTED_LEADS |
DISENGAGED_CUSTOMERS | QUALIFIED_LEADS |
DISENGAGED_CUSTOMERS | CART_ABANDONERS |
Dans l'API Google Ads v16 et versions antérieures
Configurez les champs suivants dans le fichier
CustomerLifecycleGoal
:
lifecycle_goal_customer_definition_settings.existing_user_lists
indique les listes d'utilisateurs qui contiennent des clients existants.La
lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists
indique quelles listes d'utilisateurs contiennent des clients à fort potentiel. Toi peuvent lire ce champ, mais il ne peut pas être modifié dans l'API Google Ads.
Comportement des ressources partagées
Avant l'arrêt de la version 16 de l'API Google Ads en janvier 2025, gardez à l'esprit que
UserListCustomerType
et les champs de segmentation de l'audience
Les CustomerLifecycleGoal
sont des ressources partagées, ce qui signifie que la création
Les instances UserListCustomerType
v17 et ultérieures entraîneront des modifications
à votre instance CustomerLifecycleGoal
version 16 ou antérieure, et inversement.
autour de vous.
Voici comment les champs des deux ressources sont mappés:
Modification du champ "CustomerLifecycleGoal" dans la v16 | Effet secondaire sur "UserListCustomerType" dans la version v17 |
---|---|
lifecycle_goal_customer_definition_settings.existing_user_lists
|
Crée ou supprime UserListCustomerType instances. La
Le champ user_list contient la ressource de liste d'utilisateurs associée
son nom.
|
Modification de "UserListCustomerType" dans la version v17 | Effet secondaire sur le champ "CustomerLifecycleGoal" dans la version v16 |
---|---|
Créez ou supprimez UserListCustomerType instances.
|
Des noms de ressources individuels seront ajoutés ou supprimés de
lifecycle_goal_customer_definition_settings.existing_user_lists
|
Créez ou supprimez des instances UserListCustomerType , où le
customer_type_category est défini sur
HIGH_VALUE_CUSTOMERS
|
Des noms de ressources individuels seront ajoutés ou supprimés de
lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists
|
Configurer les objectifs de cycle de vie des campagnes
Au niveau de la campagne, configurez un objectif de cycle de vie en créant ou en mettant à jour un
CampaignLifecycleGoal
Il peut y avoir à
(un CampaignLifecycleGoal
maximum par campagne).
Le champ customer_acquisition_goal_settings
d'un objectif au niveau de la campagne vous permet
définir le mode d'optimisation de la campagne et remplacer les paramètres des valeurs
de l'objectif "client parent".
optimization_mode
peut avoir l'une des valeurs suivantes:
TARGET_ALL_EQUALLY
- La campagne cible à parts égales les clients nouveaux et existants. Il s'agit de l'option par défaut le mode d'optimisation.
BID_HIGHER_FOR_NEW_CUSTOMERS
- La campagne cible à la fois les clients nouveaux et existants, mais définit des enchères plus élevées pour
les clients susceptibles d'être nouveaux, selon les prédictions, qui ne font pas partie des
existing_user_lists
TARGET_NEW_CUSTOMERS
- La campagne ne cible que les nouveaux clients.
Les éléments value_settings
sont identiques aux
customer_acquisition_goal_value_settings
sur l'objectif au niveau du client. Utilisez ces
paramètres au niveau de la campagne pour remplacer les valeurs d'une campagne spécifique.
Récupérer les objectifs de cycle de vie
Comme pour les autres ressources de l'API Google Ads, utilisez search
ou searchStream
.
de GoogleAdsService
pour récupérer
de leur cycle de vie.
La requête suivante récupère les détails de chaque CustomerLifecycleGoal
dans une
Compte 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
De même, la requête suivante récupère les détails de chaque
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