Trouvez la prochaine étape si des événements sont manquants, si des requêtes échouent ou si les rapports de conversion diffèrent.

Aperçu

Utilisez ce guide si des événements manquent, si des requêtes échouent ou si les données du Gestionnaire de publicités diffèrent de celles de vos registres commerciaux. Commencez par un achat effectué, un prospect transmis ou une autre action. Notez ce qui s’est passé et quand, puis choisissez la question pertinente ci-dessous.

Un événement enregistre une action, comme un achat. Le Pixel envoie les événements depuis le navigateur d’un visiteur; l’API Conversions (CAPI) les envoie depuis votre serveur. Le Gestionnaire de publicités recueille ces événements dans une source de données. L’attribution détermine à quelle publicité l’action est attribuée. Une fenêtre d’attribution définit le délai après une interaction publicitaire pendant lequel une action peut être admissible.

FAQ

1. Par où commencer?

Déterminez l’action à mesurer, ce qui l’envoie, ainsi que le compte publicitaire et l’identifiant du Pixel utilisés. Votre configuration peut utiliser le Pixel, l’API CAPI, une intégration partenaire ou une combinaison de ces éléments. L’API CAPI nécessite un identifiant de Pixel même si vous n’avez pas installé le Pixel dans le navigateur.

Pour une première configuration, consultez : Mesure des conversions et Suivi des conversions. Votre développeur peut utiliser les guides sur le Pixel, l’API CAPI et les événements pris en charge. Conservez les requêtes et les clés CAPI sur votre serveur.

Si un partenaire gère votre intégration, utilisez le guide de configuration d’un partenaire de mesure ou le guide de configuration d’un partenaire de mesure mobile. Pour une connexion à HubSpot, consultez : Configurer Publicités ChatGPT dans HubSpot.

Pour une configuration existante, vérifiez chaque étape :

L’action a-t-elle envoyé une requête d’événement?
La requête a-t-elle renvoyé une erreur ou a-t-elle été acceptée?
Pouvez-vous confirmer que la bonne source de données a reçu l’événement?
L’événement a-t-il été attribué à une publicité dans le rapport de campagne?

2. Mon Pixel est installé. Pourquoi ne vois-je pas d’achats ou de prospects?

Le Pixel peut se charger sans envoyer l’événement d’achat ou de prospect dont vous avez besoin. Demandez à votre développeur de vérifier une action effectuée :

Vérifiez le nom de l’événement, l’identifiant du Pixel et la page ou la fonction de rappel qui l’envoie. Une page vue n’est pas un achat effectué.
Confirmez que le Pixel s’initialise avant d’envoyer l’événement, y compris lorsqu’un gestionnaire de balises le charge.
Vérifiez la console du navigateur et la requête réseau. Le message « déclenchée » d’un gestionnaire de balises ne confirme pas à lui seul l’envoi de l’événement. Le mode de débogage du Pixel peut vous aider.
Vérifiez si les choix de consentement, le blocage par le navigateur ou la politique de sécurité de votre site ont empêché la requête.
Vérifiez les pages nécessitant une connexion, le processus de paiement, les sites de réservation, les redirections et les formulaires intégrés. Un Pixel fonctionnel sur la page de destination ne confirme pas le suivi ailleurs.

Si aucune requête n’a été envoyée, corrigez d’abord cette étape. Attendre les rapports ne résoudra rien. Utilisez le guide de dépannage du Pixel avant d’ajouter une autre intégration.

3. Que faire si un événement est rejeté, dépasse le délai d’attente ou renvoie une erreur de serveur?

Conservez le code de réponse, l’erreur exacte, l’heure de la requête et l’identifiant de l’événement. Demandez à votre développeur de vérifier le format de l’événement, l’identifiant du Pixel et la clé. Les requêtes d’événements CAPI utilisent une clé de l’API Conversions du même compte publicitaire. Les requêtes de configuration, de gestion et de production de rapports utilisent une clé distincte de l’API Annonceur. N’envoyez pas de clés API à l’assistance.

Dans les lots CAPI, un seul événement non valide peut faire échouer tout le lot.

L’API CAPI exige l’horodatage d’origine de l’action au format Unix, en millisecondes. L’événement doit dater des 7 derniers jours et ne pas être situé plus de 10 minutes dans le futur. Cette limite d’envoi est distincte de la fenêtre d’attribution. Ne modifiez pas l’horodatage d’un ancien événement pour le faire accepter.

Un délai d’attente dépassé ou une erreur de serveur peut laisser planer un doute sur la réception de l’événement. Vérifiez la requête d’origine et toute trace de réception. Si vous renvoyez la même action, conservez son identifiant d’événement et son horodatage d’origine. Un nouvel identifiant pourrait la faire passer pour une autre action.

Examinez rapidement tout rejet ou échec persistant d’une requête. Le délai estimé de 24 à 48 heures pour les rapports ne s’applique pas à ces erreurs. Pour les exigences relatives aux requêtes, consultez : API Conversions.

4. Je vois que l’événement a été accepté. Pourquoi ne figure-t-il pas dans le rapport?

L’acceptation ne signifie pas qu’un événement a été attribué à une publicité. Vérifiez ce que la réponse confirme et si la requête utilisait la bonne source de données. Dans l’API CAPI, validate_only défini sur true vérifie les événements sans les enregistrer.

Pour un nouvel événement, votre développeur peut consulter les événements récents, lorsque cette option est disponible. Cela affiche un échantillon récent, et non un historique complet ou un résultat d’attribution.

Si vous ne pouvez pas vérifier la réception, contactez l’assistance avec la réponse d’origine et un exemple d’événement. Indiquez les vérifications effectuées; vous n’avez pas à trouver la cause au préalable.

Si la réception est confirmée, passez à la question 5. Ne renvoyez pas l’événement avec de nouveaux identifiants simplement parce que le rapport de campagne n’a pas changé.

Les conversions attribuées peuvent prendre environ 24 à 48 heures à apparaître, et les totaux récents peuvent changer pendant le traitement. Cela ne garantit pas que chaque événement accepté apparaîtra et ne confirme pas sa réception. Consultez : Mesurer les résultats.

5. Les événements sont reçus. Pourquoi la campagne affiche-t-elle toujours zéro conversion?

Avant de modifier l’intégration, vérifiez :

La source de données prévue est-elle connectée au bon compte?
L’événement envoyé correspond-il au paramètre de conversion de la campagne? Pour les événements personnalisés, vérifiez le type personnalisé et le nom exact de l’événement. Un libellé d’affichage identique ne suffit pas.
La bonne conversion était-elle associée à la campagne avant l’activité que vous vérifiez?
L’action a-t-elle suivi un clic ou un affichage publicitaire admissible selon les paramètres d’attribution?
Consultez-vous la bonne campagne, la bonne colonne d’événement, les bonnes dates et la bonne base temporelle de rapport?

Les renseignements de correspondance aident à relier un événement à une publicité, mais ne garantissent pas son attribution. Conservez la véritable référence de clic OpenAI, oppref, tout au long de la visite et incluez-la dans les événements côté serveur lorsqu’elle est disponible. N’inventez jamais de référence et n’utilisez pas celle d’un autre visiteur.

Vérifiez séparément les événements côté navigateur et côté serveur. Une référence ou un champ client accessible au Pixel peut manquer dans l’événement côté serveur.

L’objectif sélectionné d’une campagne optimisée pour les conversions ne peut pas être modifié après sa création. Pour utiliser un autre objectif, créez une nouvelle campagne. Les événements personnalisés ne peuvent pas servir d’objectifs d’optimisation. Consultez : Campagnes optimisées pour les conversions.

Après avoir corrigé une incompatibilité de configuration, vérifiez les nouvelles activités admissibles. Ne présumez pas que la modification corrige les rapports antérieurs. Pour les règles de correspondance, consultez : Mesure des conversions.

6. Pourquoi les données du Gestionnaire de publicités, de notre outil d’analyse et de notre CRM diffèrent-elles?

Comparez les mêmes actions et règles de production de rapports. Votre CRM peut compter chaque achat; un rapport publicitaire compte les achats attribués à la plateforme concernée. Différentes plateformes peuvent attribuer un même achat différemment.

Dans le Gestionnaire de publicités, Conversions combine les conversions après clic et les conversions après affichage admissibles lorsque la fenêtre de rapport après affichage est de 1 jour. Avec une fenêtre après affichage de 0 jour, seules les conversions après clic sont comptées. Utilisez le même paramètre pour comparer les rapports.

Par exemple, une personne clique sur une publicité, revient directement plus tard et effectue un achat. Un outil peut classer la visite comme « Directe », tandis qu’un autre l’attribue à la publicité précédente. Cette différence seule ne signifie pas que l’achat a été compté deux fois.

Si les libellés de source de trafic diffèrent, vérifiez l’URL de destination et les paramètres de suivi utilisés lors de cette visite. Les paramètres actuels de la campagne peuvent différer de ceux utilisés auparavant.

Comparez :

Le compte, la campagne, le type d’événement, les filtres et le niveau de rapport.
La plage de dates, le fuseau horaire et si les dates correspondent à l’interaction publicitaire ou à la conversion elle-même.
Les paramètres après clic et après affichage, ainsi que la mesure ou la colonne exacte sélectionnée.
Les retards de traitement récents, la gestion des doublons, le consentement et les renseignements de correspondance disponibles.
Les conversions modélisées, lorsqu’elles sont disponibles, qui peuvent différer des transactions enregistrées directement.
Pour les valeurs : la devise, les unités et si la comparaison porte sur la commande entière ou sur les articles individuels.

Pour les revenus, comparez les taxes, la livraison, les rabais et les frais. Vérifiez que les copies côté navigateur et côté serveur envoient la même valeur de commande. Ventes liées aux commandes créées et ROAS des commandes créées comptent uniquement les événements order_created attribués.

L’activité GA4 importée comprend les événements de toutes les sources de trafic de la propriété sélectionnée. Ces totaux ne sont pas des conversions attribuées à la campagne. Consultez : Connecter Google Analytics 4 au Gestionnaire de publicités d’OpenAI.

Pour les comparaisons par API, notez le point de terminaison et définissez explicitement les options de rapport. Un paramètre omis peut ne pas correspondre à celui du Gestionnaire de publicités. Les rapports peuvent aussi inclure des événements différents : certains couvrent les objectifs de campagne, mais pas les autres actions suivies. L’absence d’un événement dans un rapport ne prouve pas qu’il n’a jamais été reçu.

Utilisez les mêmes paramètres pour une comparaison CSV et conservez les exportations non modifiées. Consultez Mesurer les résultats pour les vues du Gestionnaire de publicités et Rapports pour les options de l’API.

7. L’utilisation du Pixel et de l’API CAPI fera-t-elle compter un achat deux fois?

Pour éviter de compter deux fois la même action, utilisez le même identifiant de Pixel, le même nom d’événement et le même identifiant d’événement dans ses copies côté navigateur et côté serveur. Le champ d’identifiant d’événement est id dans l’API CAPI et event_id dans le Pixel. Utilisez aussi le même nom d’événement personnalisé des deux côtés.

Conservez le même identifiant lorsque vous renvoyez une action; utilisez un nouvel identifiant pour chaque action différente. Vérifiez la présence de balises en double, de chargements de page ou de rappels répétés, et d’intégrations partenaires qui envoient peut-être déjà l’événement.

Ne renvoyez pas de doublon pour modifier la valeur ou les renseignements de correspondance de l’événement d’origine. Vérifiez le comportement décrit dans la documentation avant de tenter une correction. Consultez : Déduplication des événements côté navigateur et côté serveur.

8. Nous utilisons Shopify. Avons-nous besoin d’une autre intégration?

Vérifiez votre connexion Shopify avant d’ajouter une autre intégration. Confirmez le compte publicitaire et le Pixel connectés, puis vérifiez quels événements l’application envoie pour votre boutique.

Si vous utilisez aussi des balises personnalisées, du code de paiement ou un outil d’envoi côté serveur, vérifiez s’ils envoient les mêmes événements. Les configurations Shopify peuvent utiliser différentes combinaisons de suivi côté navigateur et côté serveur. Consultez : Configurer Publicités ChatGPT pour Shopify.

9. Comment gérer le consentement et les tests?

N’envoyez que les données que vous êtes autorisé à partager et respectez les choix de consentement des visiteurs. Votre développeur doit suivre les directives de l’intégration sur le consentement et les données de correspondance prises en charge, y compris les exigences de normalisation et de hachage. Ne retirez pas les contrôles de consentement pour augmenter les conversions déclarées ou améliorer un score.

Le consentement à la mesure et opt_out ont des fonctions différentes. L’option opt_out concerne la personnalisation; elle n’arrête pas toutes les requêtes de mesure. Demandez à votre développeur de vérifier la gestion du consentement dans les intégrations côté navigateur et côté serveur.

Notez l’heure, le nom et l’identifiant d’une action de test. Vérifiez si elle a été envoyée, validée et reçue. Un test d’implémentation réussi ne prouve pas qu’une publicité est admissible à l’attribution.

L’option validate_only de l’API CAPI vérifie les événements sans les enregistrer. Le mode de débogage du Pixel consigne l’activité, mais n’exclut pas les événements de test des rapports. Identifiez les tests dans vos registres et n’inventez pas d’achats ni ne modifiez les horodatages des événements pour forcer un résultat.

10. Un score de qualité des événements faible ou indisponible signifie-t-il que le suivi ne fonctionne pas?

Pas à lui seul. La qualité des événements évalue les renseignements reçus d’une source de données. Elle n’indique pas combien de conversions ont été attribuées à une publicité. Un score faible ou indisponible ne permet pas, à lui seul, de déterminer si le suivi fonctionne.

Vérifiez que les actions réelles récentes sont correctement enregistrées, puis examinez l’avertissement. N’envoyez pas d’événements supplémentaires ni d’identifiants inventés pour augmenter le score. Pour les vérifications et les délais d’actualisation, consultez : Comprendre et améliorer la qualité des événements.

11. Quels renseignements dois-je fournir à l’assistance?

Dites-nous ce que vous attendiez, ce qui s’est passé, quand le problème a commencé et ce que vous avez vérifié. Fournissez les éléments de cette liste dont vous disposez :

L’identifiant du compte publicitaire, l’identifiant du Pixel ou la source de données, ainsi que les identifiants des campagnes et publicités touchées.
Le type d’intégration et le nom exact de l’événement, y compris tout nom d’événement personnalisé.
Un ou deux exemples d’identifiants d’événements existants et d’horodatages d’actions, avec le fuseau horaire.
En cas d’échec de requête ou de réception incertaine : le code de réponse, l’erreur exacte, l’heure de la requête, tout identifiant de requête ou CF-Ray renvoyé, ainsi qu’une charge utile ou un extrait de journal expurgé.
En cas d’écarts entre les rapports : la plage de dates, la base temporelle des rapports, les paramètres d’attribution, les colonnes sélectionnées, une exportation CSV et une comparaison portant sur le même périmètre.
Des captures d’écran pertinentes et toute modification récente de la configuration, y compris un processus de paiement distinct ou une intégration partenaire.

Dites-nous si vous avez confirmé l’envoi, l’acceptation ou la réception de l’événement, ou si vous avez seulement consulté le rapport. Vous pouvez demander de l’aide même si vous ne pouvez pas effectuer ces vérifications.

Retirez des pièces jointes les clés API, les en-têtes d’autorisation, les mots de passe, les témoins et les renseignements non nécessaires sur les clients. Signalez rapidement toute erreur ou tout arrêt soudain d’une intégration qui fonctionnait auparavant. N’attendez pas la fin du délai de production des rapports.

Dépannage du suivi des conversions pour Publicités ChatGPT