Stape
Suche
Kostenlos ausprobieren

Facebook Konvertierung API Fehler und wie man sie behebt

Aktualisiert
18. Dez. 2024
Veröffentlicht
7. Sep. 2021
Auch erhältlich

Die Einrichtung der Facebook-Konvertierung-API kann verwirrend sein. Aber nachdem Sie das FB-Tracking auf den Server verlagert haben und hoffen, dass alles in Ordnung ist, könnten Sie sich am nächsten Tag in Ihre Ereignisverwaltung einloggen und rote und gelbe Warnungen für die vom Server gesendeten Ereignisse sehen.

Ich bin bei der Einrichtung von FB CAPI für Kunden schon oft mit diesem Problem konfrontiert worden. Deshalb habe ich beschlossen, einen Artikel mit einigen hilfreichen Tipps zu verfassen. In diesem Blogbeitrag beschreibe ich die häufigsten Fehler und Warnungen der Facebook-Konvertierung-API. Außerdem geben wir Tipps, wie man sie beheben kann.

So überprüfen Sie, ob Facebook-Pixel- oder Conversion-API-Fehler vorhanden sind

Das Facebook Events Testing Tool ist ein leistungsstarkes neues Tool, mit dem Sie Probleme mit Ihren FB-Pixeln oder Server-Events debuggen und beheben können. Falls Fehler auftreten, werden diese auf der Registerkarte "Diagnose" in der Symbolleiste angezeigt, damit Sie sie genauer überprüfen können.

Rot markierte Fehler erfordern in der Regel eine schnelle Reaktion und sollten sofort behoben werden. Bei den gelben Fehlern handelt es sich um unkritische Warnungen, auf die Sie achten und die Sie eventuell überprüfen sollten.

Facebook erlaubt es, Probleme als gelöst zu markieren oder sie zu ignorieren. Wenn Sie einen Fehler als behoben markieren und dieser Fehler erneut auftritt, wird er von Facebook in 3 Tagen erneut angezeigt. Im Vergleich dazu werden die ignorierten Probleme in den Bereich "Ignoriert" verschoben und bleiben dort.

Wenn Sie Probleme mit Ihrem FB-Tracking beheben, sollten Sie sie als gelöst markieren. Auf diese Weise werden Sie Facebook darüber informieren, dass die Probleme behoben wurden, und Sie werden von der Plattform hören, wenn diese Probleme erneut auftreten.

Was sind die häufigsten Facebook-Pixel- und Conversion-API-Fehler und wie können sie behoben werden?

1. Neue Domänen, die Daten senden

new domains sending data 

Sie können alle Domänen sehen, die Daten an Ihr Facebook-Pixel senden. Wenn FB Traffic von einer neuen Subdomäne bemerkt, sendet die Plattform Ihnen diese Warnung. Sie können die Domänen auf eine weiße oder schwarze Liste setzen. Mit Hilfe dieser Funktion können Sie den Verkehr von Ihren Testseiten oder technischen URLs blockieren.

Höchstwahrscheinlich werden Sie auch den Verkehr von gtm-msr.appspot.com sehen. Es kann passieren, wenn Sie einen Debugging-/Veröffentlichungs-Container ausführen oder Benutzer mit deaktivierten Js auf Ihre Website kommen (einige Bots).

Um die Domänenlisten zu erstellen, öffnen Sie das Ereignis-Tool im Business Manager -> Klicken Sie auf Einstellungen -> Blättern Sie nach unten zu Verkehrsberechtigungen.

create allow block list in Facebook

2. Event, bei dem einige Deduplizierungsparameter fehlen

event missing some deduplication parameters

Meiner Erfahrung nach ist das der zweithäufigste Facebook-CAPI-Fehler. Dieser Fehler bedeutet, dass Sie keine Deduplizierungsschlüssel für Ihre Server-Events senden. Facebook benötigt diese Parameter für die Event-Deduplizierung: Event-Name und Event-ID.

event deduplication parameters

Die Chancen stehen gut, dass Sie die Namen der Events bereits senden. Angenommen, Sie sehen dieses Problem, weil die Event-ID ungültig ist. Prüfen Sie, ob Sie eine Event-ID für Facebook-Pixel und Facebook-Conversion-API senden. Diese Ereignis-ID sollte für das Browser- und das Server-Event identisch sein. In diesem Fall sieht FB denselben Event-Namen und dieselbe Event-ID und startet die Deduplizierung.

Senden Sie z. B. für die PageView-Events dieselbe Event-ID und denselben Event-Namen vom Facebook-Pixel und der FB CAPI.

Um die Event-ID zu testen, öffnen Sie das Facebook Event-Testing-Tool. Wenn alles korrekt ist, sollten Sie etwas ähnliches wie auf dem Screenshot sehen. Auf diese Weise zeigt FB, dass es PageView-Events sowohl vom Browser als auch vom Server aufgezeichnet hat. Diese Ereignisse hatten die gleiche Event-ID. Sie haben also Browser-Ereignisse verarbeitet und Server-Ereignisse dedupliziert.

event deduplication Facebook testing tool

Es kann aber auch eine andere Situation eintreten, in der Browser- und Serverereignisse zufällig ausgelöst werden. In diesem Fall überprüfen Sie die FB-Event-ID. Höchstwahrscheinlich sind die Event-IDs nicht identisch. Apropos, Sie können unsere benutzerdefinierte Variable für den Webcontainer verwenden, um die Facebook-Ereignis-ID einzurichten

create facebook test ID google tag manager

3. Server sendet ungültige Match Key Parameter für PageView Event

server sending invalid match key

Hier möchte Facebook Sie darauf hinweisen, dass die Werte, die Sie vom Server senden, nicht eindeutig oder nicht korrekt formatiert sind. Zum Beispiel können Sie eine Benutzer-IP senden, die Symbole und nicht nur Zahlen enthält. Oder vielleicht haben Sie einfach die falsche Variable ausgewählt, z. B. eine Telefonnummer in das E-Mail-Feld eingegeben.

Um zu überprüfen, was falsch ist, öffnen Sie den Vorschaumodus des Google Tag Manager-Servers und des Web-Containers (natürlich nur, wenn Sie GTM zur Einrichtung der Facebook Conversion API verwendet haben). Sie sollten sehen, welche Benutzerparameter an Facebook gesendet wurden und ob sie korrekt formatiert wurden. Testen Sie das Event, klicken Sie auf das Tag im Debug-Modus und wählen Sie Werte aus.

send user data to Facebook

Dieser Fehler kann auch bedeuten, dass Sie vergessen haben, einen Parameter anzugeben, oder dass er falsch formatiert ist.

Zum Beispiel hatte ich einen Klient, der dem Benutzer auf der Grundlage der IP-Adresse den Landkreis und die Stadt mitteilen wollte. Facebook erwartet, dass es die tatsächlichen Adressdaten der Nutzer sieht, die sie auf der Website eingeben, und nicht die, die Sie automatisch aus der IP extrahiert haben. Bei dieser Einrichtung wurde auch eine Fehlermeldung über ungültige Schlüsselparameter gesendet.

Oder vielleicht haben Sie versucht, zu schummeln und denselben Benutzernamen für alle Veranstaltungen zu verwenden, um die Qualität zu erhöhen.

4. Potenziell verletzende persönliche Daten, die an Facebook gesendet werden

potential violating personal data sent to Facebook

Dieser Fehler bezieht sich in der Regel auf die Browser-Ereignisse und bedeutet, dass Facebook Benutzerdaten in der URL erkannt hat. Einige CMS und andere Tools wie Calendly oder PayPal senden Benutzerdaten in der URL, nachdem sie sich registriert oder einen Kauf getätigt haben.

Dieser Fehler ist schwer zu beheben, und das ist eine Aufgabe für Ihre Entwickler. Sie sollten die URL-Abfrageparameter verbessern und alle Benutzerinformationen aus der URL entfernen.

5. Steigern Sie die Qualität der Eventspiele

event match quality Facebook

Für jedes Server-Event, das Sie an FB senden, gibt es eine Bewertung für die Qualität des Events. Dieser Wert hängt von der Anzahl der Nutzerdaten ab, die Sie an FB senden.

Wenn Sie eine benutzerdefinierte Subdomäne für Ihren Tagging-Server verwenden, werden nur User IP, Browser-ID, _fbp und _fbc an die FB CAPI gesendet. Wenn Sie nur diese Benutzerparameter übermitteln, liegt die Trefferqualität bei etwa 4 von 10.

Es ist ziemlich wichtig, so viele Parameter wie möglich zu senden. FB verwendet diese Daten, um Nutzer auf Ihrer Website mit denen in ihrer Datenbank abzugleichen. Versuchen Sie, alle Benutzerparameter zu senden, die Sie haben.  Natürlich sollten Sie zunächst die auf Ihrer Website angegebenen Datenschutzbestimmungen prüfen. Aber technisch ist es gut, mehr Parameter zu senden. Das bedeutet, dass die Zielgruppen- und Konversionsdaten genauer sind, dass die Facebook-Algorithmen über spezifischere Daten über Ihre Nutzer verfügen und dass die Kampagnen besser funktionieren.

Wie können Sie die Qualitätsbewertung für das Event Match verbessern? Die Antwort ist einfach: Sie müssen mehr Nutzerdaten übermitteln. Doch die Umsetzung bleibt ein komplizierter Prozess. Das funktioniert folgendermaßen: Ich prüfe zunächst, ob die Datenschicht auf Ihrer Website implementiert ist und ob sie alle Benutzerdaten enthält. Wenn sich der Benutzer beispielsweise bei Ihrer Website anmelden kann, müssen Sie prüfen, ob die Benutzerdaten an die Datenschicht gesendet werden, wenn die Benutzer angemeldet sind.

Wenn die Datenschicht nicht implementiert ist, sollten Sie Ihren Entwicklern die Aufgabe übertragen, sie einzurichten. 

Danach stellen Sie sicher, dass Sie alle Benutzerparameter vom Web an den Server-Container übergeben.

Eine weitere Möglichkeit, die Spielqualität zu verbessern, ist eine neue Funktion des Data Tag. Wir haben die Möglichkeit hinzugefügt, Benutzerdaten zu speichern. Wenn der Benutzer beispielsweise ein Kontaktformular auf der Website ausgefüllt hat, können Sie das Data-Tag verwenden, um Benutzerdaten im lokalen Speicher zu speichern und sie dann auf anderen Seiten zu verwenden. Mehr über diese Funktion können Sie hier lesen.

6. Gleiche Event-ID für viele Event-Instanzen erhalten

Wenn Sie Facebook-Events sowohl vom Browser als auch vom Server aus verfolgen, verlangt Facebook, dass Sie für jedes Event eine eindeutige Event-ID senden. Für die übereinstimmenden Events sollte der Name des Facebook-Pixel-Events genau dem Namen des Server-Events entsprechen. Dasselbe gilt für die Event-ID, die Ereignisse des FB-Pixels sollten mit den Ereignissen des FB-Servers übereinstimmen. Das ist die Zeit, in der die Deduplizierung stattfindet.

Dieser Fehler tritt auf, wenn Sie die gleiche Event-ID für viele Ereignisse senden. Ein Beispiel, ein Nutzer ist auf der Produktseite gelandet. Das bedeutet, dass auf dieser Seite zwei Ereignisse ausgelöst werden sollten: PageView und ViewContent. Sie sollten für jedes Ereignis eine eindeutige Event-ID senden. Das bedeutet, dass FB-Events und EventIDs wie folgt aussehen sollten:

FB browser: PageView, eventID: ‘69’

FB server: PageView, eventID: '69'

FB browser: ViewContent, eventID: '79'

FB server: ViewContent, eventID: '79'

Auch wenn diese Ereignisse auf derselben Seite ausgelöst werden und möglicherweise denselben Auslöser im Web- und Server-Container von Google Tag Manager verwenden, sollten Sie für beide eine eindeutige Event-ID senden.

Dieselbe Event-ID, die für viele Event-Instanzen empfangen wird, tritt auf, wenn Sie diese Situation haben:

FB browser: PageView, eventID: ‘69’

FB server: PageView, eventID: '69'

FB browser: ViewContent, eventID: '69'

FB server: ViewContent, eventID: '69'

In diesem Beispiel wird die eventID 69 sowohl für PageView- als auch für ViewContent-Events gesendet. Aber Facebook erwartet, dass für diese beiden Ereignisse eine eindeutige EventID angezeigt wird.

Lösung: Fügen Sie die Facebook-Test-ID hinzu, öffnen Sie den Vorschaumodus der Web- und Server-Container und testen Sie die Einrichtung. Nachdem Sie herausgefunden haben, wann dieser Fehler auftritt, können wir mehr tun, um das Problem zu beheben.

Wir haben eine benutzerdefinierte Variable erstellt, die eine eindeutige Event-ID erzeugt. Ich schlage vor, diese Variable zu verwenden, um die FB-Ereignisdeduplizierung einzurichten. Sie können dieser Variablen einen Ereignisnamen hinzufügen, um sicherzustellen, dass die Event-ID eindeutig ist, wie im folgenden Screenshot zu sehen. In diesem Fall ist die eventID eindeutig, da sie aus event_name_eventID besteht, auch wenn Ihre Ereignisse denselben Auslöser verwenden. Mehr über die Facebook-Ereignisdeduplizierung erfahren Sie in diesem Artikel. 

Schlussfolgerung

Die Einrichtung der Facebook-Konvertierung-API mag kompliziert und manchmal auch verwirrend erscheinen. Aber es ist die Zeit und die Mühe wert. Nachdem Sie all die harte Arbeit erledigt haben, um das FB-Tracking auf den Server zu verlagern, wird sich die Qualität des Trackings und der Zielgruppe verbessern.

Es kann jedoch zu Problemen kommen, wenn bei diesem neuen Integrationsprozess Fehler auftreten. Einfach ausgedrückt, können Sie im Eventmanager rote und gelbe Warnungen sehen.

Die gute Nachricht ist, dass die meisten dieser Probleme gar nicht so kompliziert sind, wie es scheint, und auch nicht teuer zu beheben. Ich hoffe, dass dieser Artikel Ihnen helfen wird, mit den häufigsten Fehlern und Warnungen der Facebook-Konvertierung-API umzugehen.

Probieren Sie Stape für alles rund um Server-seitigejetzt!