Conversions API

Conversions API Gateway – Problembehebung für Fehler und Warnungen

Wenn du feststellst, dass Server-Events fehlen oder die Menge der Server-Events geringer als die der Browser-Events ist, nutze diese Dokumentation, um das Problem zu beheben. Informationen zu Problembehebungs-Tools findest du unter Conversions API Gateway – Problembehebungs-Tools.

Nutze die folgenden Problembehebungsschritte, um das Problem zu identifizieren:

  1. Zu Events Manager navigieren
  2. Website im Browser öffnen
  3. Admin-Benutzungsoberfläche des Conversions API Gateway

Domain ist nicht zum Senden von Events konfiguriert

Das Conversions API Gateway erhält Events von den verbundenen Domains, die du während der Integrationseinrichtung konfigurierst. Wenn die Menge der Server-Events im Vergleich zu den Browser-Events niedriger erscheint, kann dies daran liegen, dass das Pixel auf Domains ausgelöst wird, die noch nicht mit Meta verbunden sind.

Diagnose

  • Melde dich bei Events Manager an.
  • Wähle das entsprechende Event aus.
  • Klicke auf Details anzeigen und wähle Event-Übersicht
  • Wähle im Dropdown-Menü links Domains aus, um die Domains zu finden, in denen die Browser-Events ausgelöst werden.
  • Falls diese Domains fehlen oder von den konfigurierten Domains abweichen, ist zu erwarten, dass die Browser-Events nicht erfasst werden.

Problemlösung

  • Füge weitere Domains zu deiner Conversions API Gateway-Verbindung hinzu, indem du diese Anleitung befolgst.

DNS ist nicht konfiguriert oder die DNS-Zuordnung ist falsch

Das Conversions API Gateway wird auf AWS gehostet. Dort wird ihm bei Erstellung eine IP-Adresse zugewiesen. Du musst dieser IP-Adresse eine Subdomain deiner Domain zuweisen, damit der Conversions API Gateway-Endpunkt vom Browser aus über eine Erstanbieter-Anfrage erreicht werden kann.

Diagnose

  • Führe eine DNS-Abfrage über ein Online-Tool wie https://dnschecker.org/ durch, um zu überprüfen, ob die Conversions API Gateway-Domain auf die richtige IP-Adresse aufgelöst und vollständig propagiert wird. Wenn deine Domain nicht auf eine IP-Adresse aufgelöst wird, befolge die Schritte im Abschnitt „Lösung“.
  • Rufe die IP-Adresse des Conversions API Gateway-Servers von deinem AWS-EC2-Dashboard ab oder erfrage diese Informationen beim Ansprechpartner deiner Cloud-Infrastruktur.
  • Wenn die beiden IP-Adressen unterschiedlich sind, befolge die Schritte im Abschnitt „Lösung“.

Problemlösung

  • Kontaktiere eine*n Administrator*in deines Domainregistrars.
  • Aktualisiere den DNS-Eintrag bei deinem Domainregistrar mit der IP-Adresse deines Conversions API Gateway-Servers (die im AWS-EC2-Dashboard angezeigt wird).
    • Richte einen DNS A-Eintrag ein, der deine Conversions API Gateway-Subdomain auf die während der Einrichtung generierte Server-IP-Adresse verweist.

Zertifikat wurde nie ausgestellt

Wenn für das Conversions API Gateway selbst lange Zeit nach der korrekten DNS-Konfiguration kein Zertifikat von Let’s Encrypt ausgestellt wurde, heißt das, dass deine Domain so beliebt ist, dass sich Let’s Encrypt geweigert hat, eines auszustellen.

Problemlösung

  • Unter Umständen ist es sinnvoll, einen AWS Load Balancer (ALB) vor der Conversions API Gateway-Instanz zu platzieren und mit diesem das Zertifikat zu hosten, das du besitzt.

Zertifikat wurde ausgestellt, ist aber abgelaufen

Dies geschieht, wenn du Port 80 nach der erfolgreichen Installation des Conversions API Gateway geschlossen hast oder alte Versionen ausführst.

Problemlösung

  • Öffne Port 80 und führe ein Upgrade des Conversions API Gateway auf die neueste Version durch.

Gateway-Benutzungsoberfläche kann nicht aufgerufen werden

Dies geschieht, wenn du Port 80 nach der erfolgreichen Installation des Conversions API Gateway geschlossen hast oder alte Versionen ausführst.

Problemlösung

  • Vergewissere dich, dass die IP-Adresse für die Conversions API Gateway-Instanz mit der DNS-Konfiguration übereinstimmt. Wenn nicht, siehe DNS ist nicht konfiguriert oder die DNS-Zuordnung ist falsch.
  • Falls der Server nicht reagiert, kann dies an einem vorübergehenden Netzwerkfehler liegen und durch einen Neustart der Instanz behoben werden. Es kann ein paar Minuten dauern, bis das Conversions API Gateway startet. Warte daher ca. 10 Minuten, bevor du dich erneut anmeldest.

Gateway erfordert Upgrade der Version

Es kann den Anschein haben, dass das Conversions API Gateway mit Versionen vor v1.0.8 keine Events mehr an Meta gesendet hat. Wir schlagen vor, ein Upgrade auf mindestens v1.0.8 durchzuführen, um im größtmöglichen Umfang von der Konfiguration zu profitieren. Der Events-Flow wird wieder aufgenommen und es wird sichergestellt, dass künftig automatische Updates durchgeführt werden.

Diagnose

  • So prüfst du die aktuelle Version des Conversions API Gateway:
    • Öffne die Admin-Benutzungsoberfläche des Conversions API Gateway:
https://<Conversions API Gateway Endpoint>/hub
  • Prüfe die aktuelle Version des Conversions API Gateway-Servers:
    • Menü links > Einstellungen > Updates

Problemlösung

Gehe folgendermaßen vor, um ein Upgrade für das Conversions API Gateway durchzuführen:

Problembehebung mit EKS-Protokollen

Wenn du Probleme beim Installieren der EKS-Version des Conversions API Gateway für ein einzelnes Konto oder der Version für mehrere Konten hast, nutze zur Behebung des Problems die Protokolle.

Das EKS-Installationsprotokoll ist in AWS Cloudwatch unter dem Gruppennamen „ConversionsAPIGateway/cloud-init-output.log“ verfügbar. Du kannst darin nach Fehlermeldungen suchen. Häufige Fehler sind das Überschreiten der AWS-Ressourcenbegrenzung und ein Mangel an AWS-Berechtigungen.



DNS-Datensatz mit CAA-Typ weist nicht amazonaws.com aufnehmen

Wenn der DNS-Datensatz, dessen Einrichtung das Conversions API Gateway fordert, über ein angemessenes TLS-Zertifikat verfügt oder nicht über einen CAA-Datensatz verfügt, kannst du diesen Abschnitt ignorieren.

Wenndu über einen CAA-Datensatz für die Domäne verfügst, stelle sicher, dass du amazonaws.com als Wert für den CAA-Datensatz angibst, wenn du die AWS EKS-Version des Conversions API Gateway (für Einzelkonten) oder die Conversions API Gateway-Version 1.10.* oder höher für mehrere Konten installiert hast, die AWS Certificate Manager für die Domänenerstellung verwendet. Ein Beispiel für den CAA-Datensatz wäre:

0 issue "amazonaws.com"

Wenn du die Conversions API Gateway-Version 1.9.* oder niedriger für mehrere Konten installiert hast, stelle sicher, dass du letsencrypt.org als Wert für den CAA-Datensatz angibst. Ein Beispiel wäre:

0 issue "letsencrypt.org"

Siehe auch