Plattform-Einrichtung

Allgemein

In ShopiPixel gehst du zu Einstellungen > Tracking und verbindest deine Plattformen. Meta, TikTok, Pinterest, LinkedIn, Google Ads und Microsoft Ads verbindest du per 1-Klick-OAuth und wählst Werbekonto, Pixel und Conversion-Rule anschließend aus Dropdowns aus. GA4, Klaviyo und Custom Webhook richtest du mit den jeweiligen Zugangsdaten (Measurement-ID und API-Secret, API-Key bzw. Webhook-URL) ein.

Alle 10 Plattformen auf einen Blick — wähle links die Plattform und verbinde sie rechts per OAuth oder mit deinen Zugangsdaten.

Meta (Facebook / Instagram)

Du benötigst:

• Meta Business Manager Zugang mit einem vorhandenen Pixel und Werbekonto
• Test Event Code (optional): Zum Testen im Events Manager

So richtest du Meta ein (per 1-Klick-OAuth oder manuell):

1. Schritt 1 — Mit Meta verbinden:
   Klicke in ShopiPixel auf "Mit Meta verbinden" und autorisiere den Zugriff auf dein Meta Business Manager Konto. Alternativ kannst du Meta manuell einrichten — folge dann Schritt 5.
2. Schritt 2 — Werbekonto auswählen:
   Wähle nach der Autorisierung dein Werbekonto aus dem Dropdown-Menü.
3. Schritt 3 — Pixel auswählen:
   Wähle das Pixel, an das die Conversions gesendet werden sollen, aus dem Dropdown.
4. Schritt 4 — Fertig:
   Events werden serverseitig an Meta gesendet und erscheinen in deinem Meta Events Manager. Den Verbindungsstatus siehst du im Dashboard. Optional kannst du in den Einstellungen einen Test Event Code hinterlegen, um Events im Events Manager unter "Events testen" sofort zu sehen.
5. Schritt 5 — Alternativ: manuelle Einrichtung:
   Statt der OAuth-Verbindung kannst du Meta auch manuell einrichten: Trage deine Pixel-ID und einen CAPI-Token aus dem Meta Events Manager ein. Optional kannst du zusätzlich einen Marketing-API-Token hinterlegen, um Ad-Spend-Daten und Audience-Synchronisierung zu nutzen.

Werbekonto und Pixel auswählen: Nach der OAuth-Autorisierung liest ShopiPixel deine verfügbaren Werbekonten und Pixel automatisch aus und bietet sie als Dropdowns an — du musst keine Ad Account ID oder Pixel-ID manuell heraussuchen. Bei manueller Einrichtung trägst du Pixel-ID und CAPI-Token stattdessen direkt ein.

Empfohlene Konfiguration bei Meta:

1. Test Event Code nutzen: Im Events Manager unter Events testen wird ein Test-Code angezeigt. Trage diesen in ShopiPixel ein, um Events sofort im Test-Tab zu sehen. Entferne den Code nach erfolgreichem Test wieder — Events mit Test-Code werden nicht für Kampagnen-Optimierung verwendet.
2. Event Match Quality prüfen: Im ShopiPixel Health-Dashboard siehst du den EMQ-Score pro Plattform. Zusätzlich kannst du im Meta Events Manager unter Übersicht die EMQ pro Event prüfen. Je mehr Nutzerdaten (E-Mail, Telefon, Click-IDs) gesendet werden, desto höher die EMQ. ShopiPixel bewertet einen Wert ab 5,0 als „gut“ und ab 8,0 als „ausgezeichnet“ — strebe einen möglichst hohen Wert an.
3. Browser-Zuordnung: ShopiPixel generiert automatisch eine Meta-kompatible Browser-ID (_sp_fbp). Ist ein Meta Pixel installiert, wird dessen Browser-ID bevorzugt.

So prüfst du, ob Events ankommen:

1. Öffne den Meta Events Manager > Events testen
2. Trage deinen Test Event Code in ShopiPixel ein (optional, beschleunigt die Prüfung)
3. Führe eine Aktion in deinem Shop durch (z.B. Produkt ansehen, in den Warenkorb legen)
4. Events sollten innerhalb von 1-2 Minuten im Tab "Events testen" erscheinen
5. Prüfe die Event Match Quality (EMQ) im Health-Dashboard — sie sollte pro Plattform möglichst hoch sein (ab 5,0 gut, ab 8,0 ausgezeichnet)

Google Analytics 4

Du benötigst:

• Measurement ID: Beginnt mit "G-" (z.B. G-XXXXXXXXXX)
• API Secret: Measurement Protocol API Secret

So findest du die Werte:

1. Öffne Google Analytics
2. Gehe zu Admin > Datenstreams
3. Wähle deinen Web-Stream
4. Die Measurement ID steht oben
5. Scrolle zu Measurement Protocol API Secrets
6. Erstelle ein neues Secret und kopiere den Wert

Pflicht-Konfiguration bei GA4:

1. Measurement Protocol aktivieren: In GA4 unter Admin > Datenstreams > Measurement Protocol API Secrets muss mindestens ein API Secret existieren. Ohne aktives Secret werden Server-Events nicht angenommen.
2. Session-Zuordnung: ShopiPixel generiert automatisch eine GA4-kompatible Session-ID (_sp_ga4_sid). Ist ein Google Tag (gtag.js) installiert, wird dessen Session-ID bevorzugt.

So prüfst du, ob Events ankommen:

1. Öffne Google Analytics > Berichte > Echtzeit
2. Führe eine Aktion in deinem Shop durch
3. Events sollten innerhalb von wenigen Sekunden im Echtzeit-Report erscheinen
4. Prüfe auch die DebugView unter Admin > DebugView für detaillierte Event-Daten

TikTok Events API

Du benötigst:

• TikTok Ads Manager Zugang mit einem vorhandenen Web-Pixel und Werbekonto
• Admin- oder Operator-Rechte für das Werbekonto

So richtest du TikTok ein (per 1-Klick-OAuth oder manuell):

1. Schritt 1 — Mit TikTok verbinden:
   Klicke in ShopiPixel auf "Mit TikTok verbinden" und autorisiere den Zugriff auf dein TikTok Business Center. Alternativ kannst du TikTok manuell einrichten — folge dann dem letzten Schritt.
2. Schritt 2 — Werbekonto auswählen:
   Wähle nach der Autorisierung dein Werbekonto aus dem Dropdown-Menü.
3. Schritt 3 — Pixel auswählen:
   Wähle das Web-Pixel, an das die Conversions gesendet werden sollen, aus dem Dropdown.
4. Schritt 4 — Fertig:
   Events werden serverseitig an TikTok gesendet und erscheinen in deinem TikTok Events Manager.
5. Alternativ — manuelle Einrichtung:
   Statt der OAuth-Verbindung kannst du TikTok auch manuell einrichten: Trage deine Pixel-ID und einen Events-API-Zugriffstoken aus dem TikTok Events Manager ein (Events Manager > dein Pixel > Einstellungen > Generate Access Token). Werbeausgaben-Import und Zielgruppen-Synchronisierung sind nur über die OAuth-Verbindung verfügbar.

Werbekonto und Pixel auswählen: Nach der OAuth-Autorisierung liest ShopiPixel deine verfügbaren Werbekonten und Web-Pixel automatisch aus und bietet sie als Dropdowns an — du musst keine Advertiser-ID oder Pixel-ID manuell heraussuchen. Bei manueller Einrichtung trägst du Pixel-ID und Events-API-Zugriffstoken stattdessen direkt ein.

Pflicht-Konfiguration bei TikTok:

1. Web-Pixel vorhanden: Im TikTok Events Manager muss ein Web-Pixel existieren, das du nach dem Verbinden aus dem Dropdown auswählen kannst. Lege bei Bedarf vorab eines an.
2. Berechtigungen: Du benötigst Admin- oder Operator-Rechte für das Werbekonto, damit die Autorisierung die Pixel-Liste laden kann.

So prüfst du, ob Events ankommen:

1. Öffne den TikTok Events Manager > dein Pixel > Test Events
2. Führe eine Aktion in deinem Shop durch
3. Test Events erscheinen innerhalb weniger Minuten im Test-Tab. Im regulären Overview kann es bis zu 24 Stunden dauern
4. Prüfe den Event-Status — er sollte "Active" sein. PageView-Events erscheinen nur im Overview, nicht im Test-Tab

Google Ads

Du benötigst:

• Google Ads Account mit Zugriff auf mindestens einen Ads-Account
• Conversion Action (z.B. "Kauf") in Google Ads angelegt

Einrichtung Schritt für Schritt:

1. Schritt 1 — Mit Google Ads verbinden:
   Klicke in ShopiPixel auf "Mit Google Ads verbinden" und autorisiere den Zugriff auf dein Google Ads Konto.
2. Schritt 2 — Account auswählen:
   Wähle deinen Google Ads Account aus dem Dropdown-Menü.
3. Schritt 3 — Conversion Action auswählen:
   Wähle die Conversion Action (z.B. "Kauf") aus dem Dropdown. Falls du noch keine hast, erstelle eine in Google Ads unter Zielvorhaben → Neue Conversion-Aktion.
4. Schritt 4 — Erweiterte Conversions aktivieren:
   In Google Ads: Zielvorhaben → Einstellungen → Erweiterte Conversions aktivieren mit der Methode "Google Ads API" (nicht "Google Tag").
5. Schritt 5 — Erweiterte Conversions für Leads aktivieren:
   Aktiviere zusätzlich "Erweiterte Conversions für Leads" im gleichen Einstellungsbereich. Dies verbessert die Attribution bei Käufen ohne direkten Ad-Klick.
6. Schritt 6 — Fertig:
   Google Ads zeigt Conversions mit ca. 24 Stunden Verzögerung. Purchase-Events werden automatisch gesendet. Optional kannst du unter Einstellungen weitere Conversion Actions für AddToCart, InitiateCheckout und PageView konfigurieren.

Customer ID finden: Die 10-stellige Customer ID (ohne Bindestriche) steht oben rechts im Google Ads Interface. Format: 1234567890 (nicht xxx-xxx-xxxx).

Pflicht-Konfiguration bei Google Ads:

1. Erweiterte Conversions (Enhanced Conversions for Web): In Google Ads: Zielvorhaben → Einstellungen → Erweiterte Conversions aktivieren. Als Methode "Google Ads API" auswählen (nicht "Google Tag"). Dann die Google Data Processing Terms akzeptieren. Ohne die Methode "Google Ads API" werden per API gesendete Events nicht verarbeitet.
2. Erweiterte Conversions für Leads: Im gleichen Einstellungsbereich "Erweiterte Conversions für Leads" aktivieren. Dies ermöglicht Google, Conversions auch ohne direkten Ad-Klick zuzuordnen — z.B. wenn ein Nutzer über eine Anzeige auf die Website kommt, aber erst später kauft.
3. Consent Mode (EU/EWR): Wenn du in der EU/EWR Werbung schaltest, muss Consent Mode v2 konfiguriert sein. ShopiPixel sendet den Consent-Status automatisch mit, wenn dieser in deinem Cookie-Banner konfiguriert ist.

So prüfst du, ob Events ankommen:

1. Öffne Google Ads → Zielvorhaben → Conversions → Zusammenfassung
2. Wähle deine Conversion-Aktion (z.B. ShopiPixel Purchase)
3. Unter Diagnose siehst du eingehende Events und mögliche Fehler
4. Es kann bis zu 24 Stunden dauern, bis erste Conversions angezeigt werden
5. ShopiPixel sendet standardmäßig Purchase-Events an Google Ads. Optional können AddToCart, InitiateCheckout und PageView als Secondary Conversions konfiguriert werden — dafür eigene Conversion Actions im Google Ads Konto anlegen und deren IDs in den ShopiPixel-Einstellungen eintragen

Pinterest

Du benötigst:

• Pinterest Business Account mit einem vorhandenen Werbekonto

So richtest du Pinterest ein (per 1-Klick-OAuth oder manuell):

1. Schritt 1 — Mit Pinterest verbinden:
   Klicke in ShopiPixel auf "Mit Pinterest verbinden" und autorisiere den Zugriff auf dein Pinterest Business Account.
2. Schritt 2 — Werbekonto auswählen:
   Wähle nach der Autorisierung dein Werbekonto aus dem Dropdown-Menü.
3. Alternativ — manuelle Einrichtung:
   Trage Werbekonto-ID und Conversion-Zugriffstoken aus dem Pinterest Ads Manager ein (Conversions > API einrichten / Set up API). Werbeausgaben-Import und Zielgruppen-Synchronisierung sind nur über die OAuth-Verbindung verfügbar.
4. Schritt 3 — Fertig:
   Events werden serverseitig an die Pinterest Conversions API gesendet und erscheinen in deinem Pinterest Ads Manager.

Werbekonto auswählen: Nach der OAuth-Autorisierung liest ShopiPixel deine verfügbaren Werbekonten automatisch aus und bietet sie als Dropdown an — du musst keine Ad Account ID manuell heraussuchen. Bei manueller Einrichtung trägst du Werbekonto-ID und Conversion-Zugriffstoken stattdessen direkt ein. Ein Pinterest Tag (Browser-Pixel) ist optional, die CAPI funktioniert auch standalone.

Empfohlene Konfiguration bei Pinterest:

1. Werbekonto vorhanden: Dein Pinterest Business Account muss mindestens ein Werbekonto haben, das du nach dem Verbinden aus dem Dropdown auswählen kannst.
2. Test-Events prüfen: Ergebnisse erscheinen im Pinterest Ads Manager unter Conversions > Events Overview.

So prüfst du, ob Events ankommen:

1. Öffne den Pinterest Ads Manager > Conversions > Events Overview
2. Unter Event-Verlauf siehst du eingehende Events
3. Events erscheinen zeitnah im Events Overview. Campaign Reports können bis zu 24 Stunden verzögert sein

Snapchat

Du benötigst:

• Snapchat Ads Konto mit einem vorhandenen Pixel
• CAPI Long-Lived Token aus dem Snapchat Ads Manager

So findest du die Werte:

1. Öffne den Snapchat Ads Manager unter ads.snapchat.com
2. Gehe zu Business Details → Conversions API-Token und generiere einen Long-Lived Token
3. In ShopiPixel: Gehe zu Einstellungen → Snapchat, Abschnitt Conversion-Tracking
4. Gib Pixel-ID und CAPI Token ein und aktiviere die Plattform

Pixel ID finden: Die Snap Pixel ID steht im Snapchat Ads Manager unter Assets > Pixels in der Detailansicht des Pixels.

Hinweise zur Einrichtung:

1. CAPI Token: Der Long-Lived Token läuft nicht ab und muss nur einmal eingegeben werden.

So prüfst du, ob Events ankommen:

1. Öffne den Snapchat Ads Manager > Events Manager
2. Wähle dein Pixel und prüfe die Event-Übersicht
3. Der Event-Count sollte innerhalb von 30-60 Minuten nicht mehr Null sein
4. Nutze die Validate/Stats API für detaillierte Diagnostik

LinkedIn

Du benötigst:

• LinkedIn Campaign Manager Zugang mit einer LinkedIn-Unternehmensseite
• Conversion Rule vom Typ "Conversions API" (Direct API)

So richtest du LinkedIn ein (per 1-Klick-OAuth oder manuell):

1. Schritt 1 — Mit LinkedIn verbinden:
   Klicke in ShopiPixel auf "Mit LinkedIn verbinden" und autorisiere den Zugriff auf dein LinkedIn Campaign Manager Konto. Alternativ kannst du LinkedIn manuell einrichten — folge dann dem letzten Schritt.
2. Schritt 2 — Organisation auswählen:
   Wähle nach der Autorisierung deine Organisation (Werbekonto) aus dem Dropdown-Menü.
3. Schritt 3 — Conversion-Rule auswählen:
   Wähle die Conversion-Rule aus dem Dropdown. Falls du noch keine hast, erstelle eine im Campaign Manager unter Measurement > Conversion Tracking vom Typ Conversions API (Direct API).
4. Schritt 4 — Fertig:
   Events werden serverseitig an LinkedIn gesendet und erscheinen im Campaign Manager unter Conversions.
5. Alternativ — manuelle Einrichtung:
   Statt der OAuth-Verbindung kannst du LinkedIn auch manuell einrichten: Trage deine Conversion-Rule-ID und einen Direct-API-Zugriffstoken aus dem Campaign Manager ein (Data > Signals Manager > Direct API > Generate access token). Werbeausgaben-Import ist nur über die OAuth-Verbindung verfügbar.

Organisation und Conversion-Rule auswählen: Nach der OAuth-Autorisierung liest ShopiPixel deine verfügbaren Organisationen und Conversion-Rules automatisch aus und bietet sie als Dropdowns an — du musst keine Organization ID oder Conversion Rule ID manuell heraussuchen. Bei manueller Einrichtung trägst du Conversion-Rule-ID und Direct-API-Zugriffstoken stattdessen direkt ein.

Pflicht-Konfiguration bei LinkedIn:

1. Conversion-Regel erstellen: Unter Measurement > Conversion Tracking eine neue Conversion erstellen. Wähle Conversions API > Direct API als Typ.
2. Conversion-Methode prüfen: Die Conversion Rule muss den Typ CONVERSIONS_API haben. Nur Regeln dieses Typs können Events über die API empfangen und im Dropdown ausgewählt werden.

So prüfst du, ob Events ankommen:

1. Öffne den LinkedIn Campaign Manager > Measurement > Conversion Tracking
2. Wähle deine Conversion-Regel und prüfe den Status ("Active", "Unverified" oder "Low Match Rate")
3. API-Antwort 201 Created bestätigt, dass LinkedIn den Event akzeptiert hat
4. Es kann bis zu 24-48 Stunden dauern, bis Conversions in Campaign Reports erscheinen

Microsoft Ads

Du benötigst:

• Microsoft Ads Konto mit einem vorhandenen UET Tag
• Zugang zu ads.microsoft.com — Anmeldung erfolgt per OAuth, keine manuellen Tokens nötig

So richtest du Microsoft Ads ein:

1. Schritt 1: UET Tag prüfen. Öffne ads.microsoft.com und gehe zu Conversions → UET Tags. Falls noch kein UET Tag existiert, lege einen an (Name: frei wählbar, z.B. „Shopify Store“).
2. Schritt 2: Mit Microsoft verbinden. In ShopiPixel: Einstellungen → Microsoft Ads → Button „Mit Microsoft verbinden“ klicken. Der OAuth-Flow öffnet sich in einem neuen Fenster.
3. Schritt 3: Anmelden & Berechtigung erteilen. Melde dich mit deinem Microsoft-Ads-Konto an und bestätige die angeforderten Berechtigungen (Lesen/Schreiben für Conversions und Kampagnen-Reporting).
4. Schritt 4: Customer, Account, UET Tag auswählen. Nach dem OAuth-Rücksprung erscheinen drei Dropdowns. Wähle deinen Customer, das Account und dein UET Tag.
5. Schritt 5: Conversion Goal wird automatisch angelegt. ShopiPixel prüft, ob bereits ein Offline Conversion Goal namens „ShopiPixel Purchase“ existiert. Falls nicht, wird es angelegt (30-Tage Attribution Window).
6. Schritt 6: Goal-Propagation abwarten. Microsoft benötigt rund zwei Stunden, bis das Goal aktiv Events annimmt. Währenddessen zeigt ShopiPixel „Setup läuft…“.

Hinweis zu UET Tag und Goal: Du musst das UET Tag nur einmalig in ads.microsoft.com erstellen. Das Conversion Goal legt ShopiPixel beim Onboarding automatisch an — du musst hier nichts manuell konfigurieren.

Wie funktioniert das Tracking?

1. UET JavaScript Tag: Lädt im Storefront-Browser über den Shopify Web Pixel, erfasst PageView, ViewContent, AddToCart, InitiateCheckout und setzt das MUID-Cookie für Remarketing.
2. Offline Conversions API: Purchase-Events werden serverseitig aus Shopify-Webhooks gesendet — inklusive msclkid und Enhanced Conversions (SHA256-gehashte Email und Phone).
3. Token-Management: OAuth Refresh Token bleibt unbegrenzt gültig, solange Microsoft nicht widerrufen wird. Access Tokens erneuert ShopiPixel automatisch.

So prüfst du, ob Events ankommen:

1. UET Tag-Status: Öffne ads.microsoft.com > Tools > UET Tag und prüfe den Status — er sollte „Tag aktiv“ zeigen.
2. UET Tag Helper: Nutze den UET Tag Helper (Chrome-Extension) für Echtzeit-Debugging der Browser-Events.
3. Offline Conversions: Purchase-Events erscheinen unter Conversions → Goals in ads.microsoft.com innerhalb weniger Minuten nach einem Kauf (nach Ablauf der 2h-Goal-Propagation).
4. Troubleshooting: Bei Fehler REAUTHORIZATION_REQUIRED oder REFRESH_TOKEN_INVALID in ShopiPixel-Einstellungen auf „Erneut verbinden“ klicken — OAuth läuft neu durch.

Klaviyo

Du benötigst:

• Public API Key (Site ID): Dein Klaviyo Public API Key (6-stellig, alphanumerisch)
• Private API Key: Dein Klaviyo Private API Key

So findest du die Werte:

1. Öffne Klaviyo > Settings > API Keys
2. Der Public API Key steht oben auf der Seite (auch als "Site ID" bezeichnet)
3. Unter Private API Keys erstelle einen neuen Key oder verwende einen bestehenden
4. Der Private Key benötigt mindestens die Berechtigung Events: Write. Für vollen Funktionsumfang empfiehlt sich "Full Access"

So prüfst du, ob Events ankommen:

1. Öffne Klaviyo > Analytics > Metrics
2. Suche nach den Metriken "Placed Order", "Added to Cart" etc.
3. Alternativ: Öffne ein Profil und prüfe den Activity Feed
4. Events sollten innerhalb von 1-2 Minuten erscheinen

Custom Webhooks

Du benötigst:

• Webhook URL: Die Ziel-URL deines Endpoints (HTTPS empfohlen)
• Secret Key (optional): Für HMAC-Signierung der Requests
• Event Filter (optional): Komma-getrennte Liste der Events (z.B. "Purchase,AddToCart")

So richtest du Custom Webhooks ein

1. Erstelle einen HTTPS-Endpoint auf deinem Server, der POST-Requests entgegennimmt
2. Gehe in ShopiPixel zu Einstellungen → Tracking und wähle Custom Webhook
3. Gib die Webhook-URL ein (muss HTTPS sein)
4. Optional: Hinterlege einen Secret Key für HMAC-Signaturprüfung
5. Optional: Konfiguriere den Event-Filter um nur bestimmte Events zu empfangen

So prüfst du, ob Events ankommen:

1. Prüfe in deinem Zielsystem, ob HTTP-Requests ankommen
2. ShopiPixel sendet Events als HTTP POST mit JSON-Body
3. Eine erfolgreiche Zustellung erfordert eine HTTP 200 Antwort
4. Bei Fehlern siehst du den Status im ShopiPixel Dashboard unter Event-Queue