Cette page a été traduite par l'API Cloud Translation.

Objectifs du cycle de vie

Utilisez les ressources CustomerLifecycleGoal et CampaignLifecycleGoal de l'API Google Ads pour configurer des objectifs liés au cycle de vie des clients. L'API Google Ads est compatible avec les objectifs d'acquisition de clients pour 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 des clients dans le compte de conversions Google Ads au lieu de le faire directement dans votre compte Google Ads. Vous devez toutefois définir des objectifs de cycle de vie de la campagne dans votre compte. Cela ressemble à la façon dont vous gérez les autres objectifs lorsque vous utilisez le suivi des conversions multicomptes.

Configurer des objectifs de cycle de vie client

Au niveau du client, configurez un objectif de cycle de vie en créant ou en mettant à jour un CustomerLifecycleGoal. Vous ne pouvez pas avoir plus d'un 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 devez utiliser la ressource UserListCustomerType pour segmenter vos audiences pour les objectifs de cycle de vie client. La configuration des audiences directement sur la ressource CustomerLifecycleGoal est obsolète. Voici les informations détaillées :

Avant la version 17 :
- Ajoutez des listes d'utilisateurs à la collection existing_user_lists d'un CustomerLifecycleGoal.
À partir de la version 17 :
- 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.

Dans la version 17 de l'API Google Ads et les 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.

UserListCustomerTypeService n'est compatible qu'avec les opérations create et remove. Par conséquent, si vous souhaitez mettre à jour un UserListCustomerType existant, vous devez le supprimer, puis en créer un autre avec les mises à jour nécessaires.

Un UserListCustomerType ne peut être attribué qu'à une seule liste d'utilisateurs, mais une liste d'utilisateurs peut avoir plusieurs instances UserListCustomerType associées tant qu'il n'y a pas de conflit 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 s'affiche:

`customer_type_category` depuis la mise en ligne	`customer_type_category` secondaire
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

Définissez les champs suivants sur le CustomerLifecycleGoal de votre compte:

lifecycle_goal_customer_definition_settings.existing_user_lists indique quelles listes d'utilisateurs contiennent des clients existants.
Le champ lifecycle_goal_customer_definition_settings.high_lifetime_value_user_lists indique les listes d'utilisateurs contenant des clients à forte valeur vie. Vous pouvez lire ce champ, mais il est immuable dans l'API Google Ads.

Comportement des ressources partagées

Tant que la version 16 de l'API Google Ads ne sera pas abandonnée en janvier 2025, il est important de se rappeler que UserListCustomerType et les champs de segmentation d'audience sur CustomerLifecycleGoal sont une ressource partagée. Cela signifie que la création d'instances UserListCustomerType dans la version 17 et les versions ultérieures entraînera des modifications de votre instance CustomerLifecycleGoal dans la version 16 et les versions antérieures, et inversement.

Voici comment les champs des deux ressources sont mappés:

Modifier le champ "CustomerLifecycleGoal" dans la version 16	Effet secondaire sur "UserListCustomerType" dans la version 17
`lifecycle_goal_customer_definition_settings.existing_user_lists`	Crée ou supprime des instances `UserListCustomerType`. Le champ `user_list` contient le nom de la ressource de liste d'utilisateurs associée.

Modification de "UserListCustomerType" dans la version 17	Effet secondaire sur le champ "CustomerLifecycleGoal" dans la version 16
Créer ou supprimer des instances `UserListCustomerType`	Les 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`	Les 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 de la campagne

Au niveau de la campagne, configurez un objectif de cycle de vie en créant ou en mettant à jour un CampaignLifecycleGoal. Il ne peut y avoir qu'un seul CampaignLifecycleGoal par campagne.

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, ainsi que de remplacer les paramètres de valeur de l'objectif client parent.

optimization_mode peut être l'une des valeurs suivantes:

TARGET_ALL_EQUALLY: La campagne cible les clients nouveaux et existants de la même manière. 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 qui sont susceptibles d'être nouveaux et qui ne figurent dans aucun des existing_user_lists.
TARGET_NEW_CUSTOMERS: La campagne ne cible que les nouveaux clients.

Les value_settings sont identiques aux customer_acquisition_goal_value_settings de 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 de cycle de vie.

La requête suivante récupère les détails de chaque CustomerLifecycleGoal dans 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

Objectifs de la campagne