Questions fréquentes

Existe-t-il des restrictions concernant les contenus que je peux importer ?

Voici quelques restrictions à prendre en compte :

  • Les requêtes batchinsert et batchupdate individuelles sont limitées à 1 000 conversions.
  • Le code temporel d'une conversion ne peut pas remonter à plus de 28 jours avant l'envoi.
  • Vous ne pouvez envoyer des conversions qu'à une configuration Floodlight à laquelle votre profil utilisateur Campaign Manager 360 a accès.
Dois-je utiliser Campaign Manager 360 ou Search Ads 360 pour importer des conversions ?

Consultez le Centre d'aide Search Ads 360 pour obtenir une comparaison détaillée des fonctionnalités proposées par les deux produits.

Que se passe-t-il si j'insère la même conversion dans Campaign Manager 360 et Search Ads 360 ?

Si vous insérez la même conversion dans Campaign Manager 360 et Search Ads 360, les entrées ne seront pas dédupliquées. Dans ce cas, utilisez des activités Floodlight distinctes.

Quelle API dois-je utiliser pour importer des conversions hors connexion ?

Nous vous recommandons d'utiliser l'API Data Manager pour bénéficier d'une meilleure expérience de développement et accéder à des fonctionnalités supplémentaires.

Qu'est-ce qu'une valeur ordinale et comment est-elle utilisée ?

Les valeurs ordinales contrôlent la façon dont les conversions en double sont traitées. Si plusieurs conversions sont insérées avec la même activité Floodlight, le même ID de configuration Floodlight, le même identifiant utilisateur et le même code temporel de conversion, l'ordinal est utilisé pour déterminer si :

  • Les conversions sont dédupliquées et une seule est conservée. Cela se produit si toutes les conversions ont la même valeur ordinale.
  • Les conversions sont traitées individuellement et sont toutes conservées. Cela se produit si toutes les conversions ont une valeur ordinale différente.

Les valeurs elles-mêmes n'ont pas besoin d'être significatives. En général, l'utilisation d'une valeur fixe (telle que 1) pour toutes les conversions permet la déduplication. Si vous utilisez une valeur aléatoire ou unique pour chaque conversion, elle sera désactivée.

Comment dois-je gérer les erreurs dans la réponse de l'API et quelles erreurs dois-je réessayer ?

batchinsert et batchupdate traitent les conversions de manière optimale : une requête par lot peut renvoyer une réponse HTTP 200 OK alors que des conversions individuelles du lot échouent. Vérifiez toujours hasFailures dans la réponse et inspectez la liste errors[] sur chaque objet ConversionStatus :

  • INTERNAL (Réessayer) : une erreur temporaire s'est produite dans les systèmes de Google lors du traitement de la conversion. La conversion n'a pas été insérée ni mise à jour. Réessayez d'importer les conversions ayant échoué en utilisant un intervalle exponentiel entre les tentatives (par exemple, en commençant après quelques minutes et en réessayant sur plusieurs heures), en conservant exactement les mêmes valeurs pour ordinal, timestampMicros, floodlightActivityId et l'identifiant de l'utilisateur ou du clic.
  • NOT_FOUND (Réessayer avec un délai) : l'identifiant (gclid, dclid, matchId ou mobileDeviceId) ou la conversion existante en cours de modification n'a pas encore été trouvé. Étant donné que le traitement et l'indexation des clics en ligne, des balises Floodlight et des conversions peuvent prendre une à deux heures, relancez régulièrement les conversions NOT_FOUND (par exemple, toutes les une à trois heures, pendant six heures maximum). Si l'erreur NOT_FOUND persiste après six heures, consultez les sections suivantes pour connaître les causes courantes par type d'identifiant.
  • INVALID_ARGUMENT et PERMISSION_DENIED (ne pas réessayer) : les données de conversion ne sont pas valides (par exemple, un code temporel de conversion datant de plus de 28 jours ou un champ incorrect) ou votre profil utilisateur ne dispose pas des autorisations nécessaires pour la configuration Floodlight cible. Ne relancez pas ces conversions sans résoudre le problème sous-jacent.

Si l'intégralité de la requête HTTP échoue avec une erreur du serveur 5xx ou une erreur de quota/limite de débit 429, relancez la requête en utilisant un intervalle exponentiel entre les tentatives.

Nouvelles tentatives sécurisées et déduplication : lorsque vous relancez une conversion qui a échoué avec INTERNAL ou NOT_FOUND (ou après un délai avant expiration HTTP 5xx dont le résultat est inconnu), envoyez toujours exactement les mêmes ordinal et timestampMicros. Si une conversion a déjà été enregistrée, Campaign Manager 360 la déduplique automatiquement en fonction du ordinal, de l'identifiant utilisateur, de l'activité Floodlight et de la date de conversion.

Que signifie l'échec d'une importation mobileDeviceId en raison d'une erreur NOT_FOUND ?

Les causes les plus courantes de cette erreur sont les suivantes :

  • Le mobileDeviceId n'est pas valide.
  • mobileDeviceId est inconnu de Search Ads 360. Cela signifie que l'appareil n'a pas encore reçu d'annonce de Campaign Manager 360.
Que signifie l'échec d'une importation gclid en raison d'une erreur NOT_FOUND ?

Les causes les plus courantes de cette erreur sont les suivantes :

  • Le gclid n'est pas valide.
  • Le gclid n'est pas associé à une campagne Search Ads 360 ni à un élément de campagne YouTube Display & Video 360. Cela peut se produire si le gclid a été collecté à partir d'une redirection de clic Google Ads qui n'est pas passée par Search Ads 360 (par exemple, des clics sur des extensions de lieu) ou à partir d'une redirection de clic sur une annonce YouTube non associée à un élément de campagne YouTube Display & Video 360.
  • Le clic associé à l'événement gclid s'est produit il y a trop longtemps. Les conversions ne peuvent être insérées que pour les clics datant de 60 jours maximum.
  • Le clic associé à l'gclid s'est produit trop récemment. Nous vous recommandons de retarder d'une heure l'importation des conversions basées sur le gclid afin de vous assurer que le gclid est traité et disponible pour la mise en correspondance.
Que signifie l'échec d'une importation dclid en raison d'une erreur NOT_FOUND ?

Les causes les plus courantes de cette erreur sont les suivantes :

  • Le dclid n'est pas valide.
  • Le clic associé à dclid s'est produit il y a trop longtemps. Les conversions ne peuvent être insérées que pour les clics datant de 60 jours maximum.
  • Le clic associé à l'dclid s'est produit trop récemment. Nous vous recommandons de retarder d'une heure l'importation des conversions basées sur le dclid afin de vous assurer que le dclid est traité et disponible pour la mise en correspondance.
Que signifie l'échec d'une importation matchId en raison d'une erreur NOT_FOUND ?

Les causes les plus courantes de cette erreur sont les suivantes :

  • Le matchId est inconnu de Campaign Manager 360. Cela peut se produire si le matchId a été collecté à partir d'un appel Floodlight qui n'a pas été correctement transmis à Campaign Manager 360 (assurez-vous que vos appels Floodlight fonctionnent correctement, y compris le paramètre de balise matchId).
  • L'appel Floodlight associé à l'matchId ne contenait pas de cookie. L'appel Floodlight doit contenir un cookie / identifiant pour que Campaign Manager 360 puisse stocker correctement le matchId (par exemple, l'utilisateur peut avoir bloqué les cookies ou s'être désinscrit).
  • L'appel Floodlight associé à l'élément matchId est trop ancien. Les importations de conversions hors connexion doivent être effectuées dans les 60 jours suivant l'appel Floodlight contenant le matchId.
  • L'appel Floodlight associé à l'élément matchId est trop récent. Nous vous recommandons de retarder de deux heures l'importation des conversions basées sur le matchId pour vous assurer que le matchId est traité et disponible pour la mise en correspondance.
Les conversions hors connexion dont le code temporel est antérieur à la création de l'activité Floodlight sont-elles incluses dans les rapports ?

L'importation de conversions hors connexion dont le code temporel est antérieur à la création de l'activité Floodlight peut être enregistrée en tant qu'impressions Floodlight et en tant que conversions attribuées/non attribuées, jusqu'à 28 jours avant l'envoi. Toutefois, ce comportement n'est pas garanti et ne doit pas être considéré comme acquis. La bonne pratique consiste à créer des activités Floodlight avant le code temporel le plus ancien d'une conversion hors connexion.

Quel consentement est nécessaire pour utiliser l'insertion des conversions hors connexion pour créer une liste d'audience ?

En plus du consentement pour les données utilisateur des annonces, le champ nonPersonalizedAd doit être explicitement défini sur false pour permettre la création de listes d'audience.