> ## Documentation Index
> Fetch the complete documentation index at: https://storekit.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Meta Pixel und Conversions API

> Richten Sie Conversion-Tracking für Facebook und Instagram in storekit mit einer Meta Pixel- oder Dataset-ID und der Conversions API ein.

Mit Meta-Tracking messen Sie, wie Facebook- und Instagram-Anzeigen zu Besuchen, Checkout-Aktivitäten und Bestellungen in Ihrem storekit-Store beitragen.

Die von storekit empfohlene Einrichtung umfasst:

* Eine Meta Pixel- oder Dataset-ID, um die richtige Datenquelle zu identifizieren
* Browser-Ereignisse für Kundenaktivitäten wie Seitenaufrufe und Checkout
* Die Meta Conversions API (CAPI) für autoritative serverseitige Purchase-Ereignisse, sofern für Ihren Store aktiviert

## Bevor Sie beginnen

Sie benötigen:

* Zugriff auf das Meta Business Portfolio oder die Business Suite Ihrer Organisation
* Die Berechtigung, den Pixel oder das Dataset im Meta Events Manager zu verwalten
* Die URL des storekit-Stores, den Sie messen möchten
* Die Freigabe der Person, die für Ihre Datenschutzhinweise, Cookie-Einwilligung und Werbemessung verantwortlich ist

Meta zeigt Website-Ereignisquellen zunehmend als **Datasets** im Events Manager an. Ein mit einem Pixel verknüpftes Dataset kann dieselbe ID verwenden. Meta beschreibt die Beziehung in [About datasets in Meta Events Manager](https://www.facebook.com/business/help/750785952855662).

## Benötigen Sie eine Meta-App?

Für eine manuelle storekit-Einrichtung müssen Sie in der Regel keine eigene Meta-App erstellen.

Meta empfiehlt, das Access-Token über den Events Manager zu generieren. Der von Meta dokumentierte Ablauf **Manage Integrations** erstellt die erforderliche Conversions-API-App und den System-User ohne App Review. Eine eigene App wird in der Regel nur benötigt, wenn eine Organisation ein eigenes OAuth-basiertes Onboarding aufbaut oder viele Werbetreibende programmatisch verwaltet.

Lesen Sie vor dem Anlegen von Zugangsdaten Metas aktuelle [Conversions API getting started guide](https://developers.facebook.com/docs/marketing-api/conversions-api/get-started/), da Meta Bezeichnungen oder Berechtigungsanforderungen ändern kann.

## 1. Meta-Datenquelle auswählen oder erstellen

Wählen Sie im [Meta Events Manager](https://www.facebook.com/events_manager2) den Pixel oder das Dataset aus, das Ereignisse aus diesem Store empfangen soll.

Verwenden Sie dieselbe Datenquelle für Browser- und Server-Ereignisse. Getrennte Datenquellen für denselben Storefront erschweren die Attribution und Deduplizierung.

Notieren Sie sich die Pixel- oder Dataset-ID. Verwechseln Sie diese nicht mit einer Werbekonto-ID, einer Business-Portfolio-ID oder einer Meta-App-ID.

## 2. Die ID zu storekit hinzufügen

Die Meta Pixel-Integration wird pro Store separat konfiguriert.

**1. Meta Pixel-Integration öffnen**

Gehen Sie im storekit-Dashboard zu **Stores** → Ihr Store → **Settings** → **Integrations** → **Meta Pixel**.

**2. Datenquellen-ID eingeben**

Geben Sie die ID unter **Meta Pixel ID** ein.

**3. Einstellung speichern**

Klicken Sie auf **Save**.

Wiederholen Sie diese Schritte für jeden Store, der Ereignisse an dieselbe oder eine andere Meta-Datenquelle senden soll.

## 3. Ein Access-Token für die Conversions API erzeugen

Öffnen Sie in Ihrem Meta Business-Konto den Events Manager und wählen Sie den Pixel oder das Dataset aus. Öffnen Sie dann **Settings**, suchen Sie **Conversions API**, und wählen Sie unter **Set up manually** die Option **Generate access token**.

Meta weist darauf hin, dass die Token-Option nur für Nutzer mit ausreichenden Business-Berechtigungen sichtbar ist. Fehlt die Option, bitten Sie einen Meta Business-Administrator, den Schritt auszuführen oder Ihnen die erforderlichen Berechtigungen zu erteilen.

Kehren Sie zur storekit-Integration **Meta Pixel** zurück, geben Sie das Token unter **Conversions API access token** ein und klicken Sie auf **Save**. Das serverseitige Tracking ist aktiviert, sobald sowohl die Pixel-ID als auch das Access-Token gespeichert sind.

> [!WARNING]
>
> Behandeln Sie das Access-Token wie ein Passwort. Fügen Sie es ausschließlich in **Conversions API access token** ein. Verwenden Sie es nicht in einem Support-Ticket, einem geteilten Dokument, einem Analytics-Tag, im Browser-Code, auf Screenshots oder in Chat-Nachrichten.

## 4. Verstehen, welche Ereignisse gesendet werden

Die aktuelle Einrichtung kann Folgendes umfassen:

| Übertragung | Ereignisse | Hinweise |
| - | - | - |
| Browser Meta Pixel | `PageView`, `AddToCart`, `InitiateCheckout`, `Purchase` | Aktiviert durch die Einstellung **Meta Pixel ID** |
| Conversions API | `Purchase` | Aktiviert, wenn sowohl **Meta Pixel ID** als auch **Conversions API access token** gespeichert sind |

Serverseitige Purchase-Werte stammen aus der abgeschlossenen storekit-Bestellung und nicht aus vom Browser übermittelten Werten. Kundenkennungen können vor der Übertragung normalisiert und mit SHA-256 gehasht werden; Website-Kontext wie IP-Adresse, Browser-User-Agent und Quell-URL können zur Unterstützung von Matching und Attribution ebenfalls gesendet werden.

## 5. Testen, bevor Sie Kampagnen starten

### Browser-Ereignisse prüfen

1. Installieren Sie die Browsererweiterung **Meta Pixel Helper** von Meta
2. Öffnen Sie den storekit-Store
3. Rufen Sie ein Menü auf, legen Sie einen Artikel in den Warenkorb und starten Sie den Checkout
4. Bestätigen Sie, dass die erwarteten Ereignisse die vorgesehene Pixel- oder Dataset-ID verwenden

### Server-Ereignisse prüfen

Metas Werkzeug **Test Events** verlangt, dass ein temporärer `test_event_code` in die Server-Anfrage aufgenommen wird. Bitten Sie den storekit-Support, diesen Test zu koordinieren; für den Code gibt es kein Feld im Dashboard.

Öffnen Sie in Ihrem Meta Business-Konto den Events Manager, wählen Sie den Pixel oder das Dataset aus und öffnen Sie dann **Test Events**.

1. Übermitteln Sie den generierten Test-Code über den mit dem storekit-Support vereinbarten sicheren Weg
2. Geben Sie eine Testbestellung auf
3. Bestätigen Sie, dass Meta einen serverseitigen `Purchase` empfängt

Entfernen Sie den Test-Code nach der Überprüfung. Meta weist darauf hin, dass Test Events dennoch für die Anzeigenmessung verwendet werden können — führen Sie daher einen echten, kontrollierten Test durch, statt wiederholt Produktionsbestellungen mit einem Test-Code zu senden.

Sie können auch nach einer echten Bestellung im Events Manager unter **Overview** prüfen, ob Produktionsereignisse eintreffen.

## Doppelte Purchase-Ereignisse vermeiden

Doppelte Purchase-Ereignisse können den ausgewiesenen Umsatz und die Kampagnenleistung künstlich erhöhen.

* Fügen Sie kein zweites Meta `Purchase`-Tag über Google Tag Manager hinzu
* Installieren Sie kein weiteres Meta Pixel-Plugin auf demselben Store
* Verwenden Sie denselben Pixel bzw. dasselbe Dataset für Browser- und Server-Übertragung
* Stimmen Sie den Rollout von Browser zu Server mit dem storekit-Support ab

Meta dedupliziert übereinstimmende Browser- und Server-Ereignisse nur, wenn sie denselben Ereignisnamen und dieselbe Ereignis-ID tragen. Zeigt der Events Manager statt eines deduplizierten Ereignisses separate Browser- und Server-Purchase-Ereignisse an, halten Sie Kampagnenentscheidungen auf Basis dieser Werte an und wenden Sie sich an den storekit-Support.

## Datenschutz und Einwilligung

Die serverseitige Übertragung entbindet Sie nicht von Ihren Datenschutzpflichten und ersetzt keine Cookie- und Einwilligungskontrollen.

Bevor Sie Meta-Tracking aktivieren:

* Bestätigen Sie die Rechtsgrundlage für die Werbemessung in jeder Region, in der Sie tätig sind
* Aktualisieren Sie Ihre Datenschutz- und Cookie-Hinweise, sodass sie Meta und die serverseitige Conversion-Messung beschreiben
* Stellen Sie sicher, dass Ihre Consent-Konfiguration den Empfehlungen Ihres Rechts- oder Datenschutzteams entspricht
* Übertragen Sie keine Daten, die Ihre Organisation nicht zur Werbenutzung freigegeben hat
* Beachten Sie die Business Tools Terms und die Datenverarbeitungsanforderungen von Meta

## Empfohlener Rollout

1. Konfigurieren Sie zunächst einen nicht-kritischen Store
2. Überprüfen Sie die Pixel- oder Dataset-ID
3. Prüfen Sie die Browser-Ereignisse, bevor Sie die Server-Übertragung aktivieren
4. Geben Sie das Conversions API-Access-Token ein und speichern Sie die Integration
5. Führen Sie eine kontrollierte Testbestellung durch
6. Bestätigen Sie, dass genau ein Purchase gezählt wird, ohne doppelten Umsatz
7. Vergleichen Sie storekit-Bestellungen über mehrere Tage mit dem Meta-Reporting
8. Rollen Sie die Einrichtung auf die übrigen Stores aus

## Fehlerbehebung

### Die Option für das Access-Token fehlt

Möglicherweise verfügen Sie nicht über ausreichende Meta Business-Berechtigungen. Bitten Sie einen Administrator, Ihren Zugriff auf den Pixel oder das Dataset zu prüfen, und folgen Sie Metas aktueller Getting-Started-Anleitung.

### Es erscheint kein Server-Purchase

Bestätigen Sie, dass:

* Sowohl **Meta Pixel ID** als auch **Conversions API access token** gespeichert sind
* Die Pixel- oder Dataset-ID mit der ausgewählten Meta-Datenquelle übereinstimmt
* Die Testbestellung erfolgreich abgeschlossen wurde
* Der Events Manager den erwarteten Zeitraum und die richtige Datenquelle anzeigt

### Der Umsatz ist höher als in storekit

Suchen Sie nach doppelten Browser- und Server-Purchase-Ereignissen, nach eigenen GTM Purchase-Tags, einem weiteren Pixel-Plugin oder derselben mehrfach übermittelten Testbestellung.

### Ereignisse haben eine geringe Match-Qualität

Führen Sie den Test mit realistischen Kundendaten durch, prüfen Sie, ob der Storefront einen normalen Browser-User-Agent und eine Quell-URL liefert, und sehen Sie sich Metas Diagnose auf fehlende Parameter an.

## Verwandte Themen

> **[Google Tag Manager](/docs/de/guides/integrations/marketing/google-tag-manager)**
>
> GTM getrennt von Meta-Tracking konfigurieren

> **[Kundendaten](/docs/de/guides/marketing/customer-data)**
>
> Verstehen, welche Kundeninformationen in storekit gespeichert werden


## Related topics

- [Google Tag Manager](/docs/de/guides/integrations/marketing/google-tag-manager.md)
- [Event-Tracking](/docs/de/privacy-security/event-tracking.md)
- [API & Webhooks](/docs/de/guides/integrations/api-webhooks.md)
- [Produktfotografie](/docs/de/guides/menu-engineering/product-photography.md)
- [Menüprodukte, Modifier und Tags anlegen und konfigurieren](/docs/de/guides/menu/products.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.