Objectifs du cycle de vie

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 sa resource_name ni la update_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 le resource_name de l'objectif, puis définissez le update_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'un CustomerLifecycleGoal.
  • À 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.

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:

  1. lifecycle_goal_customer_definition_settings.existing_user_lists indique les listes d'utilisateurs contenant des clients existants.

  2. 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
Précédent
Objectifs de la campagne