Ajustements des conversions

Utilisez la méthode IngestEvents pour ajuster les conversions Google Ads enregistrées précédemment. 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 Mettre à niveau l'API Google Ads pour comparer la façon dont les ajustements sont gérés dans chaque API.

Types de conversions acceptés

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 ventes 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 le 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 le transactionId ne correspond à aucune conversion existante, Google Ads en crée une nouvelle. Consultez Événements non associés.

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 nouvelles valeurs des champs que vous souhaitez ajuster.

Vous n'avez pas besoin de spécifier un type d'ajustement. L'API Data Manager déduit la manière de 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 Envoyer des événements.

Champs pris en charge

Le tableau suivant liste les champs que vous pouvez ajuster et la façon dont les modifications sont appliquées :

Champ	Comportement
conversionValue, currency	Écrasé. La nouvelle valeur remplace la valeur enregistrée.
userData	Complété si l'événement d'origine ne comportait aucune donnée utilisateur, sinon ignoré.
Tous les autres champs, tels que adIdentifiers.gclid	Ignoré

Valeurs de conversion

Envoyez un nouveau conversionValue et currency pour redéclarer la valeur d'une conversion enregistrée. La nouvelle valeur remplace celle enregistrée précédemment 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 remplacé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 gère les userData, comme une adresse e-mail ou un numéro de téléphone :

• Données ajoutées si elles manquent : si l'événement d'origine a été enregistré sans données utilisateur, l'ajustement ajoute 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 elles sont présentes : si la balise Google ou un import précédent ont déjà capturé des données utilisateur, les nouvelles données utilisateur sont ignorées. Les données utilisateur existantes ne sont pas écrasées ni ajouté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 associés. Google Ads ignore ces champs et conserve les valeurs enregistrées avec l'événement d'origine.

Événements non associés

Si le transactionId ne correspond à aucun événement existant, la demande est traitée comme un import 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.