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

Objectifs du cycle de vie

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 pas resource_name ni update_mask opération.
Pour mettre à jour un objectif de cycle de vie à l'aide de la version 15, renseignez create avec l'objectif, définissez resource_name de l'objectif et définissez update_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">
- Ajouter des listes d'utilisateurs à la collection existing_user_lists d'un CustomerLifecycleGoal
À partir de la version 17: <ph type="x-smartling-placeholder">
- 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 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

Objectifs de la campagne