Ajustements des conversions

Utilisez la méthode IngestEvents pour ajuster les conversions Google Ads précédemment enregistrées. Dans l'API Data Manager, un ajustement peut reformuler une valeur de conversion ou compléter les données utilisateur.

Si vous migrez depuis l'API Google Ads, consultez Migrer depuis l'API Google Ads pour comparer la façon dont les ajustements sont gérés dans chaque API.

Types de conversions compatibles

Vous pouvez ajuster les types de conversions Google Ads suivants :

• Conversions multisources : conversions enregistrées par la balise Google de votre site Web pour une action de conversion WEBSITE.
• Conversions hors connexion et suivi avancé des conversions pour les prospects : Événements hors connexion précédemment importés pour une action de conversion UPLOAD_CLICKS.

Remarque : Les ajustements des conversions de vente en magasin ne sont pas acceptés.

Fonctionnement des ajustements

Pour une même action de conversion, Google Ads met en correspondance les événements à l'aide de transactionId :

• Si l'transactionId correspond à une conversion existante pour la même action de conversion, l'API Data Manager traite la requête comme un ajustement de conversion.
• Si l'élément transactionId ne correspond pas à une conversion existante, Google Ads crée une nouvelle conversion. Consultez Événements sans correspondance.

Envoyer un ajustement

Pour ajuster une conversion existante, envoyez une requête IngestEvents incluant les éléments suivants :

• Le même transactionId que l'événement d'origine.
• La même destination et la même action de conversion que l'événement d'origine.
• Les valeurs mises à jour pour les champs que vous souhaitez ajuster.
• Tous les champs requis pour un événement, y compris au moins un identifiant, tel que adIdentifiers ou userData. Consultez les exigences concernant les événements et les identifiants pour les conversions hors connexion ou les conversions multisources.

Important : L'API Data Manager valide chaque événement lorsqu'elle reçoit la requête, avant de rechercher un transactionId correspondant. Un ajustement doit respecter les mêmes exigences de champ et d'identifiant qu'un nouvel événement. Si ce n'est pas le cas, la requête échoue et renvoie une erreur telle que NO_IDENTIFIERS_PROVIDED.

Nous vous recommandons d'envoyer les mêmes identifiants que ceux que vous avez envoyés ou capturés avec l'événement d'origine. Si le transactionId ne correspond pas à une conversion existante, Google Ads utilise ces identifiants pour attribuer la nouvelle conversion.

Vous n'avez pas besoin de spécifier un type d'ajustement. L'API Data Manager déduit comment traiter la requête en fonction de transactionId et des champs que vous fournissez.

Pour en savoir plus sur l'envoi de requêtes d'ingestion, consultez les guides sur l'envoi d'événements pour les conversions hors connexion ou les conversions multisources.

Champs pris en charge

Le tableau suivant indique comment Google Ads applique chaque champ lorsqu'un événement correspond à une conversion existante :

Champ	Comportement
conversionValue, currency	Écrasé. La nouvelle valeur remplace la valeur enregistrée.
userData	Complétées si l'événement d'origine ne contenait pas de données utilisateur, sinon ignorées.
Tous les autres champs, tels que adIdentifiers.gclid	Non mis à jour. Google Ads conserve les valeurs enregistrées avec l'événement d'origine. Les champs obligatoires doivent toujours être présents.

Valeurs de conversion

Envoyez un nouveau conversionValue et un nouveau currency pour reformuler la valeur d'une conversion enregistrée. La nouvelle valeur remplace la valeur précédemment enregistrée dans les rapports et les enchères, sans incrémenter le nombre de conversions.

Remarque : Les modifications de la valeur sont désactivées pendant la période d'essai initiale de 14 jours pour les conversions multisources. La valeur de la balise ne sera pas écrasée dans les rapports Google Ads tant que la période d'essai ne sera pas terminée.

Données utilisateur

Voici comment Google Ads traite les userData, comme une adresse e-mail ou un numéro de téléphone :

• Complétée si manquante : si l'événement d'origine a été enregistré sans données utilisateur, l'ajustement associe les données utilisateur pour améliorer l'attribution.

  Remarque : Pour des performances optimales, nous vous recommandons d'importer les données hors connexion supplémentaires dans les 24 heures suivant l'événement d'origine.

• Ignorées si présentes : si la balise Google ou une importation précédente ont déjà capturé des données utilisateur, les nouvelles données utilisateur sont ignorées. Les données utilisateur existantes ne sont ni écrasées, ni complétées.

Autres champs

Les identifiants et les métadonnées autres que la valeur de conversion, la devise et les données utilisateur, comme adIdentifiers.gclid, ne peuvent pas être mis à jour pour les événements mis en correspondance. Google Ads conserve les valeurs enregistrées avec l'événement d'origine.

Vous devez toujours inclure tous les champs obligatoires, comme au moins un identifiant. L'API Data Manager les valide pour chaque événement.

Événements non mis en correspondance

Si l'transactionId ne correspond pas à un événement existant, la demande est traitée comme une importation de nouvelle conversion au lieu d'un ajustement.

Google Ads tente d'attribuer la nouvelle conversion à un clic sur une annonce à l'aide des identifiants que vous avez fournis, comme adIdentifiers.gclid ou userData.

Remarque : Pendant la période d'essai initiale de 14 jours pour les conversions multisources, les nouvelles conversions apparaissent dans les rapports, mais ne sont pas utilisées pour les enchères. À la fin de la période d'essai, elles deviendront automatiquement enchérissables.