Utilisez les ressources CustomerLifecycleGoal
et CampaignLifecycleGoal
de l'API Google Ads pour configurer les objectifs liés au cycle de vie des clients. Depuis la version 15, l'API Google Ads prend en charge les objectifs d'acquisition de clients permettant d'acquérir efficacement de nouveaux clients via vos campagnes Google Ads sur le Réseau de Recherche et Performance Max.
Si votre compte Google Ads utilise le suivi des conversions multicomptes, vous devez configurer les objectifs de cycle de vie client dans le compte client de conversion Google Ads plutôt que directement dans votre compte Google Ads. Toutefois, vous devez toujours définir les objectifs de cycle de vie des campagnes dans votre compte. Cette démarche est semblable à la gestion des 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 compatibles avec CustomerLifecycleGoalService
et CampaignLifecycleGoalService
diffèrent légèrement des autres services de l'API Google Ads. Au lieu d'avoir des opérations create
et update
distinctes, CustomerLifecycleGoalOperation
et CampaignLifecycleGoalOperation
v15 n'ont qu'une opération create
, et vous indiquez votre intent à l'aide de update_mask
comme suit:
Pour créer un objectif de cycle de vie à l'aide de la version v15, renseignez
create
avec l'objectif, mais ne définissez pas saresource_name
ni laupdate_mask
de l'opération.Pour mettre à jour un objectif de cycle de vie à l'aide de la version v15, renseignez l'objectif dans
create
, définissez leresource_name
de l'objectif, puis définissez leupdate_mask
pour répertorier 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 un CustomerLifecycleGoal
. Il ne peut y avoir qu'un seul CustomerLifecycleGoal
par compte Google Ads. Le champ customer_acquisition_goal_value_settings.value
définit l'ajustement de valeur supplémentaire à ajouter à la première conversion d'achat d'un nouveau client. Vous pouvez lire le customer_acquisition_goal_value_settings.high_lifetime_value
de l'objectif, mais ce champ est immuable dans l'API Google Ads.
Segmenter vos audiences
À partir de la version 17 de l'API Google Ads, vous devrez utiliser la ressource UserListCustomerType
pour segmenter vos audiences en fonction des objectifs de cycle de vie des clients. La configuration des audiences directement sur la ressource CustomerLifecycleGoal
est obsolète. Voici les informations détaillées :
- Dans les versions antérieures à la version 17 :
- Ajoutez des listes d'utilisateurs à la collection
existing_user_lists
d'unCustomerLifecycleGoal
.
- Ajoutez des listes d'utilisateurs à la collection
- À partir de la version 17 :
- Associez chaque liste d'utilisateurs à une ou plusieurs catégories en créant un
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 un
Dans l'API Google Ads v17 et versions ultérieures
Utilisez UserListCustomerTypeService
pour créer des instances UserListCustomerType
.
Si vous avez déjà renseigné le champ CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings.existing_user_lists
, votre compte contient déjà des instances UserListCustomerType
associées.
Le UserListCustomerTypeService
n'accepte que les opérations create
et remove
. Par conséquent, si vous souhaitez mettre à jour un élément UserListCustomerType
existant, vous devez le supprimer, puis en créer un autre avec les mises à jour nécessaires.
Un élément UserListCustomerType
ne peut être attribué qu'à une seule liste d'utilisateurs, mais une liste d'utilisateurs peut être associée à plusieurs instances UserListCustomerType
, tant qu'il n'y a pas de conflits entre les instances UserListCustomerType
. Si vous essayez d'attribuer des instances UserListCustomerType
avec les combinaisons de customer_type_category
suivantes à la même liste d'utilisateurs, une erreur UserListCustomerTypeError.CONFLICTING_CUSTOMER_TYPES
sera renvoyée:
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
Définissez les champs suivants dans le fichier CustomerLifecycleGoal
de votre compte:
lifecycle_goal_customer_definition_settings.existing_user_lists
indique les listes d'utilisateurs contenant des clients existants.Le champ
lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists
indique les listes d'utilisateurs contenant des clients à fort potentiel. Vous pouvez lire ce champ, mais il ne peut pas être modifié dans l'API Google Ads.
Comportement des ressources partagées
Jusqu'à l'arrêt de l'API Google Ads v16 en janvier 2025, gardez à l'esprit que UserListCustomerType
et les champs de segmentation de l'audience dans CustomerLifecycleGoal
sont une ressource partagée. Par conséquent, la création d'instances UserListCustomerType
dans les versions 17 et ultérieures entraînera des modifications de votre instance CustomerLifecycleGoal
dans les versions v16 et antérieures, et inversement.
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. Le champ user_list contient le nom de la ressource associée de la liste d'utilisateurs.
|
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éer ou supprimer des instances UserListCustomerType , où 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
. Une campagne CampaignLifecycleGoal
maximum est autorisée.
Le champ customer_acquisition_goal_settings
d'un objectif au niveau de la campagne vous permet de définir le mode d'optimisation de la campagne et de remplacer les paramètres de valeur 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 du mode d'optimisation par défaut.
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 et qui ne font pas partie des
existing_user_lists
. TARGET_NEW_CUSTOMERS
- La campagne ne cible que les nouveaux clients.
Les value_settings
sont les mêmes que les customer_acquisition_goal_value_settings
pour 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 les méthodes search
ou searchStream
de GoogleAdsService
pour récupérer les objectifs du cycle de vie.
La requête suivante récupère les détails de chaque CustomerLifecycleGoal
d'un 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