Installationsanleitungen

Meta Pixel und Conversions API einrichten

Wir zeigen, wie Sie das Meta Pixel in Ihre Website einbinden, Standardereignisse definieren, die serverseitige Conversions API einrichten und Ereignisse testen.

Aurora YazılımRedaktionsteam 6 Min. Lesezeit
Meta Pixel und Conversions API einrichten
Wie richtet man das Meta Pixel ein?

Für die Einrichtung des Meta Pixels legen Sie im Meta Events Manager eine neue Web-Datenquelle (das Pixel) an und fügen den Basiscode in den Head-Bereich Ihrer Website oder in den Google Tag Manager ein. Anschließend definieren Sie Standardereignisse wie Kauf oder In den Warenkorb, binden die Conversions API an, um die Messung zu stärken, und überprüfen die Ereignisse im Bildschirm “Test Events”.

Was ist das Meta Pixel, und warum brauchen Sie es?

Das Meta Pixel (früher Facebook-Pixel) ist ein JavaScript-Code, der in Ihre Website eingebunden wird und Meta meldet, welche Aktionen Besucher ausführen. So sehen Sie, welchen Verkauf, welches Formular oder welche Anmeldung Ihre Facebook- und Instagram-Werbung gebracht hat.

Die eigentliche Stärke des Pixels geht über die Messung hinaus. Das Werbesystem von Meta lernt aus Ereignissen wie Käufen und zeigt die Anzeige Personen mit hoher Wahrscheinlichkeit für eine Conversion. Auch benutzerdefinierte Zielgruppen, um Personen erneut anzusprechen, die Ihre Website besucht oder Produkte angesehen haben, werden mit Pixel-Daten aufgebaut.

Die browserbasierte Messung kann einige Ereignisse verpassen – wegen Werbeblockern, Datenschutzeinstellungen des Browsers und Verbindungsabbrüchen. Um diese Lücke zu schließen, wird das Pixel zusammen mit der vom Server gesendeten Conversions API eingesetzt.

Vorbereitung vor der Einrichtung

Legen Sie Pixel und Werbekonto im eigenen Portfolio des Unternehmens an und geben Sie der Agentur nur einen Partnerzugang. So bleiben die gesammelten Messdaten und Zielgruppen auch bei einem Wechsel der Zusammenarbeit im Unternehmen. Das Meta Pixel ersetzt GA4 nicht; für den gemeinsamen Einsatz beider sehen Sie sich auch unsere Anleitung zur Einrichtung von Google Analytics 4 an.

  • Ein unternehmenseigenes Meta Business-Portfolio (Business Manager) und ein Werbekonto
  • Zugriffsrechte auf die Website oder den Tag Manager
  • Eine Liste der Ereignisse, die Sie messen möchten: Produktansicht, In den Warenkorb, Checkout starten, Kauf, Formularversand
  • Die Information, ob Ihr Cookie-Consent-System die Messcodes von der Einwilligung abhängig macht

Pixel erstellen und Basiscode einbinden

Öffnen Sie den Meta Events Manager, wählen Sie im Schritt Datenquellen verbinden die Option “Web” und geben Sie Ihrem Pixel einen Namen. Anschließend wählen Sie die Einrichtungsmethode: den Code von Hand einfügen, eine Partnerintegration nutzen oder über den Google Tag Manager einrichten.

Fügen Sie bei der manuellen Einrichtung den von Meta bereitgestellten Basiscode in den Head-Bereich jeder Seite ein. Der Code sendet bei jedem Laden der Seite das Ereignis PageView. Im folgenden Beispiel muss PIXEL_ID durch Ihre eigene Pixel-ID ersetzt werden; kopieren Sie den Code immer aus dem Events Manager.

html
<!-- Meta Pixel Code -->
<script>
!function(f,b,e,v,n,t,s)
{if(f.fbq)return;n=f.fbq=function(){n.callMethod?
n.callMethod.apply(n,arguments):n.queue.push(arguments)};
if(!f._fbq)f._fbq=n;n.push=n;n.loaded=!0;n.version='2.0';
n.queue=[];t=b.createElement(e);t.async=!0;
t.src=v;s=b.getElementsByTagName(e)[0];
s.parentNode.insertBefore(t,s)}(window, document,'script',
'https://connect.facebook.net/en_US/fbevents.js');
fbq('init', 'PIXEL_ID');
fbq('track', 'PageView');
</script>
<noscript><img height="1" width="1" style="display:none"
src="https://www.facebook.com/tr?id=PIXEL_ID&ev=PageView&noscript=1"
/></noscript>
<!-- End Meta Pixel Code -->

Mit Google Tag Manager

Wenn Sie GTM verwenden, können Sie den Basiscode über ein Tag vom Typ “Benutzerdefiniertes HTML” einfügen und auf allen Seiten ausführen. Ereignisse an Data-Layer-Trigger zu binden, macht die Messung robust gegenüber Designänderungen; Details finden Sie im Beitrag zur Einrichtung des Google Tag Managers.

Über den Admin-Bereich des Systems

Manche Systeme unterstützen es, die Pixel-ID aus dem Panel zu übernehmen und Ereignisse selbst zu senden. Im Shopsystem von Aurora gleicht die Meta-Anbindung den Produktkatalog ab und misst Conversions ohne Doppelzählung; die Codes werden über das Panel hinzugefügt.

Standardereignisse und Parameter

Die von Meta definierten Standardereignis-Namen zu verwenden, sorgt dafür, dass Anzeigenoptimierung und Berichte von selbst funktionieren. Beim Kaufereignis sind Betrag und Währung Pflicht; Produkt-IDs helfen dabei, dass Katalogwerbung das richtige Produkt zeigt.

EreignisWann wird es gesendet?
ViewContentWenn die Detailseite eines Produkts oder einer Leistung geöffnet wird
AddToCartWenn ein Produkt in den Warenkorb gelegt wird
InitiateCheckoutWenn der Zahlungsschritt beginnt
PurchaseWenn die Bestellung abgeschlossen ist
LeadWenn ein Formular oder eine Angebotsanfrage gesendet wird
CompleteRegistrationWenn die Registrierung abgeschlossen ist
javascript
fbq('track', 'AddToCart', {
  content_ids: ['URN-12'],
  content_type: 'product',
  value: 1499.90,
  currency: 'TRY'
});

// Kauf: eventID wird für die Deduplizierung benötigt
fbq('track', 'Purchase', {
  value: 1499.90,
  currency: 'TRY',
  content_ids: ['URN-12'],
  content_type: 'product'
}, { eventID: 'SIP-10045' });

Conversions API einrichten

Die Conversions API sendet Ereignisse nicht vom Browser des Besuchers, sondern direkt von Ihrem Server an Meta. Sie wird von Werbeblockern nicht beeinträchtigt und übermittelt feststehende Daten wie Bestellungen direkt aus der Quelle. Meta empfiehlt für die besten Ergebnisse, Pixel und API gemeinsam zu verwenden.

Erstellen Sie für die Einrichtung im Events Manager auf dem Reiter “Einstellungen” des Pixels ein Zugriffstoken (Access Token). Dieses Token ist ein Passwort: Speichern Sie es nur auf dem Server und legen Sie es niemals im Browser-Code oder in einem öffentlichen Repository ab. Anschließend sendet Ihr Server bei jedem wichtigen Ereignis eine Anfrage an den Events-Endpunkt der Graph API.

Für kleine Websites ohne eigenen Server gibt es auch Optionen mit weniger Code, etwa die Partnerintegrationen von Meta oder das Conversions API Gateway. Bei einem Projekt für ein Landingpage-Design, das den Werbetraffic auffängt, ist es am sichersten, Pixel und API vor dem Livegang der Seite in einer Testumgebung zu verifizieren; so entsteht ab dem ersten Tag der Kampagne kein Datenverlust.

  • event_time ist der Unix-Zeitstempel des Ereignisses (in Sekunden) und muss den Zeitpunkt zeigen, zu dem das Ereignis stattgefunden hat.
  • Personenbezogene Daten wie E-Mail und Telefonnummer werden mit SHA-256 gehasht gesendet; formatieren Sie die Telefonnummer zuvor mit Ländervorwahl und nur als Ziffern.
  • Prüfen Sie die Versionsnummer der Graph API in der Entwicklerdokumentation von Meta; ältere Versionen werden mit der Zeit abgeschaltet.
bashBeispielanfrage (Version und IDs durch Ihre eigenen Werte ersetzen)
curl -X POST "https://graph.facebook.com/v<SURUM>/<PIXEL_ID>/events?access_token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "data": [{
      "event_name": "Purchase",
      "event_time": 1767225600,
      "event_id": "SIP-10045",
      "action_source": "website",
      "event_source_url": "https://ornek.com/tesekkurler/",
      "user_data": {
        "em": ["<SHA256_ILE_KARMALANMIS_EPOSTA>"],
        "client_ip_address": "203.0.113.10",
        "client_user_agent": "Mozilla/5.0 ...",
        "fbp": "fb.1.1767225000000.1234567890"
      },
      "custom_data": { "value": 1499.90, "currency": "TRY" }
    }],
    "test_event_code": "TEST12345"
  }'
bashE-Mail hashen (Kleinbuchstaben, ohne Leerzeichen)
printf '%s' 'ornek@alanadi.com' | sha256sum

Deduplizierung: Warum Ereignisse doppelt gezählt werden

Wird derselbe Kauf sowohl vom Pixel als auch von der API gesendet, muss Meta erkennen, dass es sich um ein einziges Ereignis handelt. Dieser Vorgang heißt Deduplizierung (Deduplication) und beruht auf zwei Bedingungen: Ereignisname und Ereignis-ID müssen in beiden Quellen exakt übereinstimmen.

Achten Sie darauf, dass in den obigen Beispielen im Feld eventID auf der Browserseite und im Feld event_id auf der Serverseite dieselbe Bestellnummer steht. Wird diese Übereinstimmung nicht hergestellt, erscheinen die Verkäufe in den Berichten doppelt, und das Werbesystem lernt mit falschen Daten.

Dass die Deduplizierung funktioniert, sehen Sie im Events Manager in den Ereignisdetails: Dasselbe Ereignis wird sowohl mit Browser- als auch mit Serverquelle empfangen und als dedupliziert aufgeführt. Ein kleiner Zeitunterschied zwischen den beiden Quellen ist unproblematisch.

Ereignisse testen und überprüfen

Der Reiter Test Events im Events Manager zeigt Ereignisse in Echtzeit. Um Browser-Ereignisse zu sehen, geben Sie die Adresse Ihrer Website ein und führen im geöffneten Fenster eine Aktion aus; für Server-Ereignisse fügen Sie den auf dem Bildschirm angezeigten Testcode in das Feld test_event_code Ihrer Anfrage ein und entfernen dieses Feld beim Livegang.

Auch die Browser-Erweiterung Meta Pixel Helper zeigt, welches Ereignis auf welcher Seite mit welchen Parametern ausgelöst wird. Werfen Sie einige Tage nach der Einrichtung einen Blick auf den Wert für die Qualität der Ereigniszuordnung im Events Manager; ist er niedrig, müssen Sie den Server-Ereignissen eventuell mehr gehashte Kundendaten hinzufügen.

ProblemMögliche Ursache und Lösung
Ereignis erscheint nichtPixel-ID ist falsch oder der Code wurde nicht veröffentlicht; mit dem Pixel Helper prüfen.
Verkäufe doppeltevent_id stimmt nicht überein oder das Pixel wird zweimal geladen.
API-Anfrage liefert einen FehlerToken ungültig, Version veraltet oder event_time zu alt; lesen Sie die Fehlermeldung in der Antwort.
Betrag falschvalue wird als Text statt als Zahl gesendet oder currency fehlt.

Datenschutz und Einwilligung

Pixel und Conversions API verarbeiten personenbezogene Daten. Werbemesscodes dürfen erst nach der Einwilligung des Besuchers ausgeführt werden, die gesendeten Daten müssen in Ihrer Datenschutzerklärung erläutert und nur die nötigen Angaben weitergegeben werden. In sensiblen Kategorien wie Gesundheit gelten zudem zusätzliche Einschränkungen von Meta.

Dieser Beitrag gibt allgemeine Hinweise. Prüfen Sie für Ihren Cookie-Consent-Ablauf, Ihre Datenschutzerklärung und die Datenübermittlung ins Ausland die aktuelle Rechtslage (KVKK, das türkische Datenschutzgesetz, bzw. DSGVO) und sprechen Sie mit Ihrer Rechtsberatung. Wenn Sie wissen möchten, anhand welcher Kennzahlen Sie die Werbeleistung lesen, ist unser Beitrag zu den Social-Media-Kennzahlen ein guter Einstieg.

Häufig gestellte Fragen

01Sind Facebook-Pixel und Meta Pixel dasselbe?

Ja. Nachdem sich die Muttergesellschaft von Facebook in Meta umbenannt hatte, wurde auch das Werkzeug Meta Pixel genannt. Dasselbe Pixel dient zur Messung von Facebook- wie Instagram-Werbung.

02Reicht das Pixel ohne Conversions API?

Das Pixel funktioniert allein, doch durch browserbedingte Datenverluste erscheinen manche Conversions nicht in den Berichten. Je größer das Werbebudget und je direkter der Verkauf über die Website erfolgt, desto deutlicher steigert die zusätzliche API die Zuverlässigkeit der Messung.

03Braucht man für das Tracking von Instagram-Werbung eine separate Einrichtung?

Nein. Instagram-Werbung wird über dasselbe Werbekonto und dasselbe Pixel gemessen. Wählen Sie in der Anzeigengruppe einfach das richtige Pixel und das zu optimierende Ereignis aus.

Wenn Pixel und Conversions API zusammen mit Deduplizierungsregeln eingerichtet sind, messen Sie zuverlässig, was Ihr Werbebudget bringt. Für den Aufbau der Messinfrastruktur und die Steuerung der Kampagnen mit diesen Daten sehen Sie sich unseren Service Online-Marketing an, für Inhalte und Werbung auf Instagram und Facebook unsere Social-Media-Lösungen. Bei der Interpretation der Berichte unterstützt Sie außerdem unsere Leistung SEO und Analyse.