Facebook Pixel & Conversions API einrichten: Anleitung

Viele sehen den Meta Pixel nur als Messwerkzeug. Tatsächlich ist er der Datenstrom, mit dem der Algorithmus lernt, wer Ihre Kunden sind. Ein sauberer Pixel plus Conversions API (CAPI) senkt die Kosten pro Ergebnis und signalisiert Meta, dass hinter der Domain ein echtes Unternehmen steht. Ein schlampiges Setup bewirkt das Gegenteil.

Diese Anleitung zeigt Schritt für Schritt, wo Sie den Code einbauen und wie Sie prüfen, dass alles läuft. Sie funktioniert für eigene Konten genauso wie für ein Facebook Agenturkonto, das Sie über uns nutzen.

Warum Tracking-Qualität auch die Kontoqualität beeinflusst

Metas Systeme bewerten das Gesamtbild eines Werbetreibenden. Wer regelmäßig hochwertige Conversion-Events von einer verifizierten Domain sendet, wirkt wie ein reales Unternehmen mit realen Kunden. Wer Traffic auf eine Domain ohne oder mit fehlerhaften Events schickt, wirkt riskanter.

Dazu kommen die Kosten: Bessere Daten bedeuten bessere Optimierung und damit einen niedrigeren CPA. Bei unseren Kunden senkt der Wechsel von „nur Pixel" auf „Pixel plus sauber deduplizierte CAPI" den CPA im Schnitt um 10–25 %.

Pixel oder Conversions API: der Unterschied

Sie brauchen beides: Der Pixel erfasst, was im Browser möglich ist, die CAPI sendet dieselben Events vom Server, damit nichts verloren geht.

Schritt 1: Domain verifizieren

Öffnen Sie in den Business-Einstellungen Brand Safety → Domains und fügen Sie Ihre Domain hinzu. Verifizieren Sie per DNS-TXT-Eintrag (empfohlen) oder Meta-Tag. Das belegt, dass die Domain Ihnen gehört, und ist für die Konfiguration von Web-Events nötig.

Nutzen Sie einen gemieteten Business Manager, verifizieren Sie die Domain in dem BM, dem der Pixel gehört, am besten in Ihrem eigenen.

Schritt 2: Pixel einbauen – je nach System an der richtigen Stelle

Der Basiscode ist überall gleich, nur der Einbauort ändert sich. Die Pixel-ID finden Sie im Events Manager → Datenquellen → Ihr Pixel.

Eigene Website oder statisches HTML

Fügen Sie den Code in die Vorlage ein, die alle Seiten gemeinsam nutzen, direkt vor dem schließenden Head-Tag. Ersetzen Sie YOUR_PIXEL_ID durch Ihre ID.

<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', 'YOUR_PIXEL_ID');
fbq('track', 'PageView');
</script>

WordPress

Nutzen Sie das offizielle Plugin Meta for WordPress (Facebook for WordPress). Verbinden Sie Ihr Meta-Konto, wählen Sie den Pixel und aktivieren Sie die Conversions API. Wenn Sie Code von Hand einfügen, gehört er in den Header, nicht in den Footer, damit PageView feuert, bevor der Besucher geht.

Shopify und WooCommerce

Installieren Sie den Vertriebskanal Facebook & Instagram (Shopify) oder Facebook for WooCommerce. Wählen Sie Ihren Pixel, stellen Sie die Datenfreigabe auf Maximum und prüfen Sie, dass E-Mail und Telefonnummer mitgesendet werden. Purchase, AddToCart und ViewContent laufen dann über Browser und CAPI.

Next.js, React und andere Single-Page-Apps

Laden Sie den Basiscode einmal im Root-Layout und feuern Sie bei jedem Routenwechsel PageView. Conversion-Events senden Sie aus der Komponente, die die Aktion ausführt, etwa dem Formular-Handler.

// after the form is saved successfully
const eventId = crypto.randomUUID();
fbq('track', 'Lead', { content_name: 'contact-form' }, { eventID: eventId });
await fetch('/api/lead', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ ...formData, eventId }),
});

Google Tag Manager

Legen Sie ein Custom-HTML-Tag mit dem Basiscode an, lösen Sie es bei Alle Seiten aus und fügen Sie pro Event (Lead, Purchase) ein weiteres Tag mit passendem Trigger hinzu. Prüfen Sie im Vorschau-Modus, dass jedes Tag nur einmal feuert. Installieren Sie denselben Pixel nie gleichzeitig über GTM und im Code, sonst wird jedes Event doppelt gezählt.

Die wichtigsten Standard-Events: ViewContent auf Produktseiten, AddToCart beim Warenkorb, InitiateCheckout zu Beginn der Kasse, Purchase auf der Danke-Seite mit Wert und Währung, Lead beim Absenden eines Formulars. Verwenden Sie Standardnamen, benutzerdefinierte Events lassen sich schwerer optimieren.

Schritt 3: Dieselben Events über die Conversions API senden

Ihr Server schickt das Event mit einem Zugriffstoken aus dem Events Manager an die Graph API. Das Token erzeugen Sie unter Events Manager → Einstellungen → Conversions API. Bewahren Sie es in einer Umgebungsvariable auf, niemals im Frontend-Code.

import crypto from 'node:crypto';

const sha256 = (v) =>
  crypto.createHash('sha256').update(String(v).trim().toLowerCase()).digest('hex');

export async function sendLead({ email, phone, eventId, url, ip, userAgent, fbp, fbc }) {
  const body = {
    data: [{
      event_name: 'Lead',
      event_time: Math.floor(Date.now() / 1000),
      event_id: eventId,            // same value the browser sent
      action_source: 'website',
      event_source_url: url,
      user_data: {
        em: [sha256(email)],
        ph: [sha256(phone.replace(/\D/g, ''))],
        client_ip_address: ip,       // not hashed
        client_user_agent: userAgent, // not hashed
        fbp, fbc,                    // not hashed
      },
    }],
    // test_event_code: 'TEST12345', // only while testing
  };
  const res = await fetch(
    `https://graph.facebook.com/v21.0/${process.env.PIXEL_ID}/events?access_token=${process.env.CAPI_TOKEN}`,
    { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body) }
  );
  return res.json();
}

Wichtig sind event_name, event_time (Unix-Sekunden), eine identische event_id wie im Browser, action_source „website", die Seiten-URL und user_data.

Persönliche Daten korrekt hashen

E-Mail, Telefon, Vor- und Nachname, Ort und externe ID müssen normalisiert und mit SHA-256 gehasht werden: E-Mail ohne Leerzeichen und in Kleinbuchstaben, Telefonnummer nur Ziffern inklusive Ländervorwahl, Namen in Kleinbuchstaben ohne Satzzeichen. IP-Adresse, User-Agent sowie fbp und fbc werden nicht gehasht. Lesen Sie außerdem die fbclid aus der Landingpage-URL aus und speichern Sie sie in einem Cookie. Daraus entsteht der fbc-Wert, mit dem Meta den Lead dem genauen Anzeigenklick zuordnet.

Schritt 4: Browser- und Server-Events deduplizieren

Senden Pixel und CAPI beide ein Lead-Event, zählt Meta es doppelt, außer Sie deduplizieren. Die Regel: gleicher event_name und gleiche event_id aus beiden Quellen. Erzeugen Sie die ID im Browser beim Absenden, übergeben Sie sie dem Pixel als eventID und senden Sie sie mit den Formulardaten an den Server, der sie in der CAPI-Anfrage wiederverwendet. Im Events Manager erscheint dann „Dedupliziert".

Schritt 5: Event Match Quality verbessern

Die Event Match Quality (EMQ) zeigt, wie gut Meta Ihre Events echten Personen zuordnen kann. Senden Sie mehr Kennungen pro Server-Event: gehashte E-Mail (größter Effekt), gehashte Telefonnummer, fbp und fbc, IP-Adresse und User-Agent sowie eine gehashte externe ID. Viele Kunden steigen innerhalb einer Woche von EMQ 4–6 auf über 8. Für iOS-Traffic ordnen Sie Ihre Conversion-Events in der Aggregated Event Measurement nach Priorität und setzen Ihr wichtigstes Event (Lead oder Purchase) nach oben.

Datenschutz und Einwilligung in der EU

Für Nutzer im EWR gilt: Der Pixel setzt Cookies und übermittelt personenbezogene Daten an Meta. In der Praxis brauchen Sie deshalb ein Cookie-Banner mit Einwilligung vor dem Laden des Pixels. Technisch lösen Sie das, indem der Basiscode erst nach Zustimmung ausgeführt wird, etwa über einen Consent-Trigger im Tag Manager oder über die Consent-Funktion von fbq. Die CAPI sollte ebenfalls nur Daten von Nutzern senden, die zugestimmt haben. Dies ist keine Rechtsberatung: Lassen Sie Banner, Datenschutzerklärung und Datenübermittlung von einer fachkundigen Person prüfen.

Was Sie nicht senden sollten

• Sensible Kategorien wie Gesundheitszustand oder Finanzlage in URLs, Event-Parametern oder Inhaltsnamen.
• Ungehashte persönliche Daten in irgendeinem Parameter, auch nicht in URL-Parametern. Eine Danke-Seite wie /danke?email=max@beispiel.de gibt die E-Mail automatisch an den Pixel weiter.
• Events von Seiten, die Ihnen nicht gehören.

Test vor dem ersten Euro Budget

1. Öffnen Sie Events Manager → Test-Events, geben Sie Ihre URL ein und lösen Sie eine Test-Conversion aus.
2. Das Lead-Event muss zweimal erscheinen, als Browser und als Server, zusammengeführt zu einer Zeile mit „Dedupliziert".
3. Prüfen Sie in der Übersicht, dass die Event Match Quality für Lead mindestens 6,0 beträgt.
4. Installieren Sie die Chrome-Erweiterung Meta Pixel Helper. Ein grünes Symbol mit genau einem PageView pro Seite bedeutet, dass der Basiscode einmal feuert.
5. Entfernen Sie den test_event_code vor dem Livegang, damit echte Events nicht als Tests gelten.
6. Schauen Sie nach 24 Stunden in die Diagnose auf Warnungen zu fehlenden Parametern, doppelten Events oder nicht verifizierter Domain.

Häufige Probleme und Lösungen

Pixel mit einem gemieteten Agenturkonto nutzen

Wenn Sie ein Werbekonto über uns nutzen, bleibt der Pixel in Ihrem Business Manager und wird mit dem Agenturkonto geteilt. Daten, Zielgruppen und Lernphase gehören weiter Ihnen. Muss das Konto je ersetzt werden, teilen Sie den Pixel mit dem neuen Konto und die Kampagnen starten mit voller Historie. Die Pixel-Einrichtung ist deshalb in unseren Tarifen Growth und Scale enthalten, siehe Leistungen und Preise. Kombinieren Sie sauberes Tracking mit einem schrittweisen Budgetaufbau, und die Lernphase endet deutlich schneller.

Checkliste

• Domain im BM verifiziert, dem der Pixel gehört
• Basiscode auf allen Seiten, PageView bei Routenwechsel
• Standard-Events bei den wichtigen Aktionen
• CAPI sendet dieselben Events mit identischer event_id
• E-Mail und Telefon mit SHA-256 gehasht
• EMQ von 6 oder mehr beim wichtigsten Event
• Einwilligung vor dem Pixel eingeholt (EU)
• Keine sensiblen Daten in URLs oder Parametern

Weiterlesen: Warum Ihr Facebook Werbekonto immer wieder gesperrt wird und Facebook Werbekonto mieten: Kosten und Risiken.

Sie möchten es nicht selbst einrichten? HD Agency installiert den Pixel, verifiziert Ihre Domain und richtet die deduplizierte Conversions API ein. Schreiben Sie uns auf Telegram oder WhatsApp, Antwort in etwa 5 Minuten. Mehr dazu in den Branchenlösungen.