Communitygithub.com

ooiyeefei/ccc

Richtet den Meta Pixel (Facebook/Instagram Ads-Tracking) auf einer Website ein und feuert ein Conversion-Event (Lead, CompleteRegistration, Purchase) End-to-End. Führt den Benutzer durch Business Suite / Events Manager, erstellt oder findet die Pixel-/Dataset-ID, installiert den Basiscode, feuert ein Standard-Event und verifiziert es mit dem Meta Pixel Helper, BEVOR Anzeigen geschaltet werden.

Was ist ccc?

Diese Fähigkeit automatisiert die vollständige Einrichtung des Meta Pixels (Facebook/Instagram Ads-Tracking) auf einer Website und das Feuern eines Conversion-Events wie Lead, CompleteRegistration oder Purchase. Sie führt den Benutzer Schritt für Schritt durch den gesamten Prozess: von der Business Suite / Events Manager über die Erstellung oder Identifikation der Pixel-/Dataset-ID, die Installation des Basiscodes, das Feuern eines Standard-Events bis hin zur Verifikation mit dem Meta Pixel Helper. Der Skill ist besonders nützlich, da er zwei häufige Fallstricke vorwegnimmt: die Entscheidung zwischen Pixel und Conversions-API (Meta drängt aggressiv auf die schwerere Lösung) und die Wahl der Datenkategorie (eine falsche Wahl kann die Anzeigenoptimierung einschränken). Er unterstützt die gängigsten Plattformen (Next.js, HTML, WordPress, Shopify, GTM, React) und enthält Referenzdateien für plattformspezifische Installationen, Standard-Events und die Verifikation vor dem Schalten von Anzeigen. Der Skill erkennt, dass Benutzer an verschiedenen Punkten im Einrichtungsprozess einsteigen, und fragt daher zunächst, was bereits vorhanden ist (Facebook-Seite, Business Suite, Pixel-ID), bevor er gezielt einsteigt.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ooiyeefei/ccc/tree/HEAD/skills/meta-pixel-setup

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Vorschau

Aus dem Skill-README

ccc preview

Dokumentation

Meta Pixel Einrichtung

Richte den Meta Pixel ein, der eine echte Conversion auf einer Website trackt und verifiziert, damit die Facebook-/Instagram-Anzeigenoptimierung etwas Wahres zum Lernen hat. Zwei Dinge verwirren die Leute, und dieser Skill geht beides vorweg: die Pixel-vs-Conversions-API-Entscheidung (Metas Assistent pusht aggressiv die schwerere Lösung) und welche Datenkategorie deklariert werden soll (eine falsche Wahl kann deine Anzeigen ausbremsen).

Hinweis zur Benennung: Meta hat "Pixel" in der Benutzeroberfläche in "Dataset" umbenannt. Ein Dataset enthält den Pixel und seine Dataset-ID = Pixel-ID (eine ~15–16-stellige Zahl). Behandle die beiden Wörter als dasselbe.

Starte dort, wo der Benutzer steht

Die Einrichtung ist eine Kette: Facebook-Seite → Business-Portfolio → Events Manager → Pixel/Dataset (ID abrufen) → Basiscode auf der Website → Conversion-Event → Verifikation. Menschen steigen mittendrin ein. Frage zuerst, dann springe ein — erstelle nicht neu, was bereits existiert (ein Unternehmen hat oft schon einen Pixel; verwende ihn wieder, anstatt Daten über zwei zu verteilen).

Frage (passe an das an, was sie gesagt haben):

  1. Hast du bereits eine Facebook-Seite und Meta Business Suite / Business-Portfolio eingerichtet?
  2. Hast du bereits einen Pixel / ein Dataset (im Events Manager)? Wenn ja, wie lautet die Dataset-ID (die ~16-stellige Zahl)? Füge sie ein — das könnte alles sein, was benötigt wird.
  3. Welche eine Conversion zählt (Lead/Wartelisten-Einreichung, Anmeldung, Kauf)? Darauf optimieren die Anzeigen hin.
  4. Der Stack + die Domain der Website (Next.js, reines HTML, WordPress, Shopify) — entscheidet, wie der Code eingefügt wird.

Wenn sie bereits die Dataset-ID und eine Seite haben, springe direkt zu Abschnitt 3 (Installation). Gehe nicht den Weg der Account-Erstellung, den sie bereits erledigt haben, rückwärts.

Entscheidung 1: Nur Pixel oder + Conversions API? (Starte mit nur Pixel)

Metas Einrichtungsassistent zeigt "Conversions API und Meta Pixel (Empfohlen)" mit einer glänzenden Statistik. Nimm es nicht reflexartig. Hier ist der ehrliche Kompromiss:

  • Meta Pixel (Browser) — ein Code-Snippet auf der Website sendet Ereignisse vom Browser des Besuchers. Einfach, kein Backend, funktioniert heute. Das ist alles, was du zum Starten brauchst.
  • Conversions API (CAPI) — dein Server sendet Ereignisse direkt an Meta. Es ist Server-zu-Server, "Entwicklerunterstützung erforderlich", und um wirklich zu helfen, benötigt es PII der Kunden (E-Mail, Telefon, IP), die zur Zuordnung an Meta gesendet werden. Das ist mehr Aufbau und eine größere Datenschutz-/Compliance-Oberfläche (GDPR/PDPA/CCPA).

Also: Starte mit dem Browser-Pixel. Füge CAPI später hinzu, nur wenn der Signalverlust des Browsers (Ad-Blocker, iOS ATT) dich messbar schädigt und du die PII-/Einwilligungsfrage geklärt hast. Behandle CAPI als Optimierung nach dem Start, nicht als Einrichtungsschritt. Lies references/conversions-api.de.md, bevor du es jemals anschließt — es existiert, um dich davor zu bewahren, versehentlich persönliche Daten an Meta zu senden.

Entscheidung 2: Die Dataset-"Kategorie" — lass sie leer, es sei denn, sie passt eindeutig

Beim Erstellen des Datasets fragt Meta, "gegebenenfalls zutreffende Kategorien auszuwählen." Das ist eine Falle für Finanz-/Gesundheits-/sensible Produkte. Der Dialog warnt: "Abhängig von der Kategorie und dem Standort kann die Datenweitergabe eingeschränkt oder blockiert werden." Kategorien wie "Finanzdienstleistung", "Wirtschaftliche Verwundbarkeit", "Persönliche Notlage", "Nationalität" lösen die eingeschränkte Datenverarbeitung von Meta aus und können deine Anzeigenoptimierung drosseln oder blockieren.

Regel: Wähle eine Kategorie nur, wenn sie dich genau und unvermeidlich beschreibt und du verstehst, dass sie Daten einschränkt. Ein Budget-/Produktivitäts-/SaaS-Tool ist Software, keine "Finanzdienstleistung" (diese Kategorie ist für Kreditgeber, Kreditauskünfte, Verbraucherfinanzen). Im Zweifelsfall lasse Kategorien leer (es ist optional) — leer bedeutet keine Einschränkung, was ein normaler Wartelisten-/Anmeldetest möchte.

1. Pixel/Dataset erstellen oder finden (ID abrufen)

Im Events Manager:

  1. Linke Seitenleiste → Daten verbinden (grünes +) → Web → Meta Pixel → Verbinden. (Oder wenn ein Dataset existiert, klicke darauf — die ID steht direkt unter dem Namen.)
  2. Benenne es nach dem Unternehmen (z. B. "Acme Web"). Für die Kategorie siehe Entscheidung 2 (normalerweise leer lassen).
  3. Kopiere die Dataset-ID — die ~16-stellige Zahl unter dem Namen. Auch später immer sichtbar unter Events Manager → Datasets.
  4. Wenn ein Assistent "Website einrichten / verbinden" startet, der Conversions-API vs. nur Pixel anbietet — du kannst ihn schließen/überspringen. Du brauchst nur die ID; der Code wird von Hand eingefügt (§3). Wenn du fortfährst, wähle Nur Meta Pixel (Entscheidung 1).

2. (Optional) Vorhandenen Pixel wiederverwenden

Ein Pixel ist keine harte Reporting-Wand wie eine GA4-Property. Ein Pixel kann eine ganze Domain abdecken — die Haupt-App und eine /warteliste-Landingpage. Unterscheide Trichter durch das Ereignis + benutzerdefinierte Parameter (z. B. content_name: 'warteliste'), nicht durch einen zweiten Pixel. Wenn das Unternehmen bereits einen hat, verwende seine ID wieder.

3. Basiscode installieren

Füge ihn in <head> auf jeder Seite ein und ersetze YOUR_PIXEL_ID. Er feuert PageView automatisch. (Kopiere dein genaues Snippet aus dem Events Manager — es hat die ID vorausgefüllt — oder verwende diese kanonische Form.)

<!-- 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', 'YOUR_PIXEL_ID');
fbq('track', 'PageView');
</script>
<noscript><img height="1" width="1" style="display:none"
  src="https://www.facebook.com/tr?id=YOUR_PIXEL_ID&ev=PageView&noscript=1"/></noscript>
<!-- End Meta Pixel Code -->

Füge keinen integrity/SRI-Hash hinzu — fbevents.js ist ein versionierter Loader, den Meta direkt aktualisiert und für den es keinen stabilen Hash veröffentlicht; SRI wird ihn brechen. Plattformspezifische Installation (Next.js next/script, WordPress, Shopify, GTM) ist in references/install-by-platform.de.md.

4. Das Conversion-Event bei der Aktion feuern

Verwende ein Standard-Event, damit Metas Optimierung und Reporting es erkennen — Lead (Warteliste/Kontakt), CompleteRegistration (Anmeldung), Purchase (Verkauf). Vollständige Liste + wann verwenden: references/standard-events.de.md. Feuere es erst, nachdem die Aktion wirklich erfolgreich war, niemals bei einem abgefangenen Fehler.

<script>
form.addEventListener('submit', async function (e) {
  e.preventDefault();
  try {
    await saveTheLead(/* ... */);          // 1. ZUERST speichern — der echte Erfolg
    if (window.fbq) fbq('track', 'Lead', { // 2. erst dann zählen (Schutz für Blocker)
      content_name: 'warteliste',           // segmentierbare, NICHT-PII-Parameter
      value_bucket: 'high'
    });
    window.location.href = '/danke';
  } catch (err) {
    showError('Etwas ist schiefgelaufen, bitte versuche es erneut.');  // kein Event, kein falscher Erfolg
  }
});
</script>

PII-Regel — keine persönlichen Daten durch den Browser-Pixel senden

Gib niemals E-Mail, Telefon, Namen oder Adresse als Ereignisparameter weiter. Sende Kategorien/Buckets (content_name, eine Wertspanne, eine Persona) — genug zum Segmentieren, nicht zum Identifizieren. (Der eine Ort, an dem Meta tatsächlich gehashte PII verwendet, ist das Advanced Matching von CAPI, das eine bewusste, eingewilligte, serverseitige Wahl ist — siehe references/conversions-api.de.md, nicht etwas, das man in Browser-Events einstreut.)

5. VOR dem Geldausgeben verifizieren — das Tor

Führe eine echte Conversion auf der Live-/Vorschau-Seite durch, bestätige dann:

  • Installiere die Meta Pixel Helper Chrome-Erweiterung. Lade die Seite → sie zeigt den Pixel + PageView. Sende das Formular ab → sie zeigt das Lead-Event mit deinen Parametern.
  • Oder Events Manager → dein Dataset → Ereignisse testen, gib die Seiten-URL ein und beobachte, wie Ereignisse live eintreffen.
  • Nur bei Erfolg feuern: Verursache einen Fehler und bestätige, dass das Event NICHT feuert.

Erst wenn du sehen kannst, dass die Conversion korrekt feuert, sollte Anzeigenbudget live gehen. Eine falsch verdrahtete Conversion bringt Meta dazu, auf die falschen Personen zu optimieren, und du kannst es nicht vom Dashboard aus erkennen. Vollständige Checkliste: references/verify-checklist.de.md.

"Kannst du das für mich einrichten?"

Die Account-/Seiten-/Business-Suite-/Pixel-Erstellung benötigt den eigenen Meta-Login des Benutzers — kann nicht in seinem Namen erledigt werden; das ist eine kurze UI-Führung (dieser Skill leitet sie). Die Dataset-ID zu bekommen, ist die eine Aufgabe des Benutzers. Der Assistent kann den Basiscode + das Event in die Website schreiben, sobald die ID vorhanden ist. Teile es so auf — und lenke sie gemäß den beiden obigen Entscheidungen vom CAPI-Assistenten und sensiblen Kategorien ab.

Referenzdateien

  • references/install-by-platform.de.md — Basiscode-Installation für Next.js, HTML, WordPress, Shopify, GTM.
  • references/standard-events.de.md — Meta Standard-Ereignisnamen + Parameter für häufige Conversions.
  • references/conversions-api.de.md — Was CAPI ist, wann es sich lohnt, und die PII-/Einwilligungs-Schutzmaßnahmen BEVO du es anschließt.
  • references/verify-checklist.de.md — Das Pre-Spend-Verifikations-Tor (Pixel Helper, Ereignisse testen, häufige Fehler).

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Verwandte Skills