Im Onlineshop wurde eine Bestellung aufgegeben, aber Meta kann sie nicht sehen. Manchmal sieht Meta sie auch doppelt. Das Team optimiert Kampagnen dann anhand von Zahlen, denen es nicht vertraut, und der erste Gedanke lautet: Implementieren wir CAPI, wird es alles lösen.
Die Conversions API kann die Messung genauer machen, weil sie bestimmte Marketingereignisse vom Server, CRM oder der Plattform direkt an die Systeme von Meta sendet. Sie kann jedoch keine Daten wiederherstellen, die das Unternehmen nie erzeugt, und falsch benannte Conversions nicht korrigieren. Zuerst benötigen Sie einen Messplan. Erst danach folgt die Datenübertragung.
CAPI ersetzt weder den Pixel noch die Einwilligung
Meta beschreibt die Conversions API als eine direktere Verbindung zwischen den Marketingdaten eines Unternehmens und seinen Systemen zur Messung und Optimierung von Anzeigen. Für Webereignisse empfiehlt Meta, CAPI gemeinsam mit dem Meta Pixel zu betrachten. Browser- und serverseitige Wege können sich ergänzen.
Das bedeutet nicht, dass der Server alles senden darf, was der Browser nicht gesendet hat. Meta erklärt ausdrücklich, dass CAPI nicht dazu gedacht ist, Datenschutzregeln, europäische Vorschriften oder Plattformbeschränkungen zu umgehen. Behandeln Sie Einwilligung und Rechtmäßigkeit der Verarbeitung entsprechend den konkreten Daten, der Region und der rechtlichen Bewertung. Eine gehashte E-Mail bleibt von einer Person abgeleitete Information und ist kein Schutzschirm.
Entscheiden Sie zuerst, welche Ereignisse geschäftlichen Wert haben
Für einen Onlineshop ist es normalerweise sinnvoll, den Weg von der Produktansicht über Warenkorb und Checkout bis zum Kauf zu verfolgen. Bei einer Website zur Leadgenerierung kann ein abgeschicktes Formular oder ein qualifizierter Lead wichtiger sein. Ich würde nicht jeden Klick als Conversion senden, nur weil es möglich ist.
Notieren Sie für jedes Ereignis:
- was genau in der realen Welt geschehen muss,
- ob es sich um das zentrale Geschäftsergebnis oder lediglich um ein Diagnosesignal handelt,
- welches System als Quelle der Wahrheit dient,
- welche eindeutige Kennung Sie verwenden,
- welche Parameter Werbung und Reporting benötigen,
- unter welchen Bedingungen Sie die Daten senden dürfen.
Bei einem Kauf ist die Quelle der Wahrheit oft die bestätigte Bestellung im Onlineshop oder Backend, nicht bloß das Öffnen der Dankesseite. Bei einem Lead kann das Formular das erste Signal sein, doch nur das CRM bestätigt die Qualität des Kontakts.
Die Deduplizierung entscheidet, ob doppelte Messung hilft
Wenn Sie dasselbe Ereignis sowohl über den Pixel als auch über den Server senden, muss Meta es als ein Ereignis erkennen. Dafür sind derselbe Ereignisname und dieselbe event_id auf beiden Wegen erforderlich.
Bei einem Kauf kann eine stabile Bestell-ID eine geeignete Grundlage sein. Bei einem Ereignis ohne eigene Geschäfts-ID erstellen Sie beim Ausführen der Aktion eine eindeutige Kennung und geben sie an Browser- und Serverebene weiter. Eine auf jeder Seite separat erzeugte zufällige Kennung hilft nicht – die Werte stimmen nicht überein.
Deduplizierung ist kein Detail für Entwickler. Wenn sie fehlschlägt, erhalten Kampagnen möglicherweise ein doppeltes Signal und das Reporting beginnt zu lügen.
Vier Implementierungswege verursachen unterschiedliche Kosten
Ein Partner oder eine Funktion der E-Commerce-Plattform
Für einen typischen Onlineshop ist dies oft die erste Wahl. Die Plattform pflegt die Integration kontinuierlich, und das Unternehmen muss keinen API-Code selbst verantworten. Prüfen Sie dennoch, welche Ereignisse gesendet werden, ob Deduplizierung und Einwilligung verarbeitet werden und ob Sie die Parameter einsehen können.
Ein Managed Service oder Gateway
Ein Anbieter übernimmt einen Teil der Infrastruktur und Aktualisierungen. Sie bezahlen für Betrieb und Abhängigkeit, reduzieren aber den eigenen technischen Wartungsaufwand. Das ist sinnvoll, wenn der Dienst Ihren Stack unterstützt und Sie klaren Zugang zu Diagnosen haben.
Serverseitiger Google Tag Manager
Ein Server-Container kann mehrere Marketingdatenübertragungen vereinheitlichen und dem Unternehmen mehr Kontrolle geben. Gleichzeitig entstehen Hosting, Vorlagen, Berechtigungen und ein weiterer Ort, der getestet werden muss. Ich würde ihn nicht nur wegen eines schönen Architekturdiagramms wählen.
Eine individuelle direkte Integration
Sie bietet die größte Flexibilität und bringt zugleich die größte Verantwortung mit sich. Sie benötigen eine sichere Token-Verwaltung, Eingabevalidierung, Protokollierung ohne das Offenlegen sensibler Daten, Fehlerbehandlung, API-Versionsverwaltung und jemanden, der die Integration pflegt.
Der ursprüngliche Artikel enthielt ein kurzes PHP-Skript und einen öffentlich zugänglichen Endpunkt. Eine solche Lösung empfehle ich inzwischen nicht mehr als allgemeine Anleitung. Sie enthielt eine alte API-Version und zu viele Sicherheits- und Betriebsannahmen. Code, der heute nach dem Kopieren funktioniert, kann morgen unbemerkt Ereignisse verwerfen. Arbeiten Sie bei einer direkten Integration mit der aktuellen Dokumentation von Meta und entwickeln Sie regulär, statt Marketingtexte per Copy-and-paste umzusetzen.
Die Ereignisqualität ist wichtiger als die Anzahl der Parameter
Ein serverseitiges Ereignis benötigt typischerweise einen Namen, einen Zeitpunkt, eine Aktionsquelle und je nach Quelle eine URL oder einen anderen Kontext. Ergänzen Sie bei einem Geschäftsereignis den relevanten Wert, die Währung, Artikel und eine stabile ID. Senden Sie Nutzerkennungen nur, wenn sie korrekt normalisiert sind, das erforderliche Format haben und Sie zu ihrer Verwendung berechtigt sind.
Mehr Kennungen können das Matching verbessern, aber „je mehr, desto besser“ gilt nicht ohne Einschränkungen. Senden Sie keine leeren, erfundenen oder veralteten Werte. Erstellen Sie erst recht keinen Fingerabdruck, um die Entscheidung des Nutzers zu umgehen.
Der Test muss die gesamte Customer Journey abdecken
- Starten Sie den Testmodus im Meta Events Manager.
- Durchlaufen Sie ein realistisches Szenario vom Aufruf der Website bis zur Bestellung oder zum Lead.
- Überprüfen Sie browser- und serverseitige Ereignisse, ihre Parameter und übereinstimmenden IDs.
- Prüfen Sie, ob Meta das Paar dedupliziert und keinen Diagnosefehler anzeigt.
- Vergleichen Sie Wert, Währung und ID mit Backend oder CRM.
- Testen Sie entsprechend Ihrer Lösung sowohl die Erteilung als auch die Ablehnung der Einwilligung.
- Überwachen Sie nach der Bereitstellung Diagnosen und Ausfälle über einen längeren Zeitraum, nicht nur einen einzelnen erfolgreichen Test.
Test Events bestätigt, dass die technische Nachricht angekommen ist. Es bestätigt nicht, dass Sie die richtige Conversion ausgewählt haben oder dass die Integration rechtmäßig ist.
CAPI und GA4 sind zwei verschiedene Ebenen
CAPI sendet Ereignisse zur Messung und Anzeigenoptimierung an Meta. GA4 analysiert Website und App über verschiedene Quellen hinweg. Die Zahlen können sich aufgrund von Attribution, Einwilligung, Identität und Verarbeitung unterscheiden. Ich versuche nicht, sie zu einer absolut identischen Zahl zu zwingen; zuerst prüfe ich, ob jedes System technisch korrekte Daten erhält und ob wir sie für die richtige Entscheidung verwenden.
Wenn Sie einen gemeinsamen Überblick über Kosten und Website-Ergebnisse benötigen, lesen Sie auch die Verbindung von Meta Ads mit GA4. Der Google-Tag-Manager-Leitfaden behandelt die Tag-Implementierung selbst, und der Leitfaden zu GA4 erklärt die Bedeutung der Ereignisse.
Wann ich CAPI noch nicht implementieren würde
Wenn das Unternehmen seine Conversions nicht definiert hat, nicht weiß, welche Bestellung gültig ist, oder seinen aktuellen Pixel nicht pflegen kann, wird ein serverseitiger Weg das Chaos vergrößern. Beheben Sie zuerst die Quelldaten und den Messplan. CAPI ist sinnvoll, wenn Sie wissen, welches Signal Sie übermitteln möchten, warum Meta es benötigt und wer die Integration verantwortet.
Wenn Sie die kleinste sinnvolle Lösung für Ihren Onlineshop oder Ihre Website zur Leadgenerierung auswählen möchten, senden Sie mir über Kontakt die Plattform, die aktuelle Messkonfiguration und das Ereignis, das für Ihr Unternehmen am wichtigsten ist.