API Conversions

Gateway API Conversions - Résolution des erreurs et des avertissements

Si vous remarquez qu’il manque des évènements de serveur ou que leur volume est inférieur à celui des évènements de navigateur, utilisez cette documentation pour résoudre le problème. Pour plus d’informations sur les outils de dépannage, consultez Gateway API Conversions - Outils de dépannage.

Suivez les étapes de dépannage ci-dessous pour identifier le problème :

  1. Accès au Gestionnaire d’évènements
  2. Ouverture du site web dans le navigateur
  3. UI d’administration du gateway API Conversions

Le domaine n’est pas configuré pour l’envoi d’évènements

Le gateway API Conversions reçoit des évènements des domaines connectés configurés pendant la configuration d’intégration. Si le volume des évènements de serveur semble inférieur à celui des évènements de navigateur, le pixel se déclenche peut-être sur des domaines qui ne sont pas encore connectés à Meta.

Diagnostics

  • Connectez-vous au Gestionnaire d’évènements.
  • Sélectionnez l’évènement qui convient.
  • Cliquez sur Voir les détails et sélectionnez Aperçu de l’évènement.
  • Dans le menu déroulant à gauche, sélectionnez Domaines pour trouver les domaines à partir desquels les évènements de navigateur sont déclenchés.
  • Si ces domaines sont absents ou différents de ceux configurés, il est probable que les évènements de navigateur ne seront pas capturés.

Résolution

  • Ajoutez les domaines requis à votre connexion au gateway API Conversions en suivant ce guide.

DNS n’est pas configuré ou le mappage DNS est incorrect

Le gateway API Conversions est hébergé sur AWS, qui lui affecte une adresse IP lors de sa création. Vous devez mapper un sous-domaine de votre domaine avec cette adresse IP pour permettre la communication avec le point de terminaison du gateway API Conversions depuis le navigateur via un appel de requête interne.

Diagnostics

  • Utilisez un vérificateur DNS en ligne, comme https://dnschecker.org/, pour vous assurer que le domaine du gateway API Conversions est bien défini sur la bonne adresse IP et qu’il est entièrement propagé. Si le domaine n’est défini sur aucune adresse IP, consultez la section Résolution pour connaître la suite de la procédure.
  • Obtenez votre adresse IP de serveur de gateway API Conversions à partir du tableau de bord AWS EC2 ou demandez cette information à votre point de contact pour l’infrastructure cloud.
  • Si les deux adresses IP diffèrent, consultez la section Résolution pour connaître la suite de la procédure.

Résolution

  • Collaborez avec un·e admin sur le registre de nom de domaine.
  • Mettez à jour l’enregistrement DNS dans votre registre de nom de domaine avec l’adresse IP du serveur de votre gateway API Conversions (celle qui figure sur le tableau de bord AWS EC2).
    • Paramétrez un enregistrement DNS A qui mappe le sous-domaine de votre gateway API Conversions à l’adresse IP du serveur générée pendant la configuration.

Le certificat n’a jamais été émis

Si le gateway API Conversions n’a jamais obtenu de certificat émis par Let’s Encrypt, alors que le DNS est correctement configuré depuis un certain temps, cela signifie que votre domaine est tellement populaire que Let’s Encrypt a refusé d’en émettre un.

Résolution

  • Envisagez de placer un équilibreur de charge AWS devant l’instance du gateway API Conversions et à l’utiliser pour héberger le certificat que vous détenez.

Le certificat a été émis, mais a expiré

Ce problème survient si vous avez fermé le port 80 après l’installation du gateway API Conversions ou si vous utilisez d’anciennes versions.

Résolution

  • Ouvrez le port 80 et mettez à jour le gateway API Conversions vers la dernière version.

L’UI du gateway n’est pas accessible

Ce problème survient si vous avez fermé le port 80 après l’installation du gateway API Conversions ou si vous utilisez d’anciennes versions.

Résolution

  • Vérifiez que l’adresse IP de l’instance du gateway API Conversions correspond à la configuration DNS. Dans le cas contraire, consultez DNS n’est pas configuré ou le mappage DNS est incorrect.
  • Si le serveur ne répond pas, cela peut être dû à une erreur réseau temporaire et peut être résolu en redémarrant l’instance. Le gateway API Conversions peut prendre quelques minutes pour démarrer ; attendez environ 10 minutes pour vous reconnecter.

Le gateway nécessite une mise à jour de version

Vous pouvez constater que les instances du gateway API Conversions antérieures à la version 1.0.8 arrêtent d’envoyer des évènements à Meta. Pour maximiser les avantages de la configuration, nous vous suggérons d’effectuer une mise à jour vers la version 1.0.8 ou ultérieure. Cette opération permet la reprise du flux d’évènements et garantit que les mises à jour seront effectuées automatiquement à l’avenir.

Diagnostics

  • Pour connaître la version actuelle du gateway API Conversions :
    • Ouvrez l’UI d’administration de votre gateway API Conversions :
https://<Conversions API Gateway Endpoint>/hub
  • Vérifiez la version actuelle du serveur de votre gateway API Conversions :
    • Menu de gauche > Paramètres > Mises à jour

Résolution

Pour mettre à jour le gateway API Conversions, procédez comme suit :

Résolution des problèmes avec les journaux EKS

Si vous rencontrez des problèmes lors de l’installation du gateway API Conversions pour la version EKS à compte unique ou la version à plusieurs comptes, vous pouvez consulter les journaux pour les résoudre.

Le journal d’installation EKS est disponible dans AWS Cloudwatch sous le nom de groupe « ConversionsAPIGateway/cloud-init-output.log ». Vous pouvez y rechercher d’éventuels messages d’erreur. Les erreurs fréquentes sont par exemple le dépassement des limites des ressources AWS et l’absence d’autorisations AWS.



L’enregistrement DNS de type CAA n’est pas configuré pour amazonaws.com

Si l’enregistrement DNS qui doit être configuré par le gateway API Conversions dispose d’un certificat TLS approprié ou ne contient pas d’enregistrement CAA, vous pouvez ignorer cette section.

Si le domaine contient un enregistrement CAA, veillez à définir la valeur amazonaws.com pour l’enregistrement CAA si vous avez installé la version AWS EKS du gateway API Conversions (pour un compte unique) ou la version 1.10.* ou ultérieure du gateway API Conversions (pour plusieurs comptes) qui utilise le gestionnaire de certificats d’AWS pour créer les domaines. Voici un exemple d’enregistrement CAA :

0 issue "amazonaws.com"

Si vous avez installé la version 1.9.* ou antérieure du gateway API Conversions pour plusieurs comptes, veillez à définir la valeur letsencrypt.org pour l’enregistrement CAA. Voici un exemple :

0 issue "letsencrypt.org"

Voir aussi