Plattform-Einrichtung

Allgemein

Für jede Plattform benötigst du bestimmte API-Credentials (Tokens, Pixel-IDs, etc.). Diese findest du im jeweiligen Werbe-Manager. In ShopiPixel gehst du zu Einstellungen > Tracking und gibst die Credentials ein.

Alle 10 Plattformen auf einen Blick — wähle links die Plattform und trage rechts deine Credentials ein.

Meta (Facebook / Instagram)

Du benötigst:

• Pixel ID: Die ID deines Meta Pixels
• Conversions API Access Token: Ein Server-Token für die CAPI
• Test Event Code (optional): Zum Testen im Events Manager

So findest du die Werte:

1. Öffne den Meta Events Manager
2. Wähle dein Pixel aus
3. Die Pixel ID steht oben auf der Seite
4. Gehe zu Einstellungen > Conversions API
5. Klicke auf "Access Token generieren"
6. Kopiere den Token und füge ihn in ShopiPixel ein

Ad Account ID finden: Die Ad Account ID beginnt mit act_ und steht im Meta Business Manager unter Unternehmenseinstellungen > Konten > Werbekonten. Format: act_123456789.

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. Ziel: mindestens 6.0, optimal über 8.0.
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 über 6.0 liegen

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:

• Pixel ID: Deine TikTok Pixel ID (alphanumerisch, ca. 20 Zeichen)
• Access Token: Events API Access Token

So findest du die Werte:

1. Öffne den TikTok Ads Manager
2. Gehe zu Assets > Events > Web Events
3. Wähle dein Pixel (oder erstelle ein neues Web-Pixel)
4. Die Pixel ID steht oben auf der Seite
5. Gehe zu Einstellungen und generiere einen Access Token

Pixel ID finden: Die Pixel ID ist alphanumerisch (ca. 20 Zeichen) und steht im TikTok Ads Manager unter Assets > Events > Web Events oben auf der Pixel-Seite.

Pflicht-Konfiguration bei TikTok:

1. Web-Pixel erstellen: Im TikTok Events Manager muss ein Web-Pixel vorhanden sein. Wähle bei der Erstellung "Manually install pixel code" und aktiviere den "Developer Mode" für die Events API.
2. Access Token generieren: Unter den Pixel-Einstellungen (Settings) einen Access Token generieren. Du benötigst Admin- oder Operator-Rechte für den Ad Account.

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:

• Ad Account ID: Deine Pinterest Ads Konto-ID
• Access Token: Pinterest API Access Token

So findest du die Werte:

1. Öffne den Pinterest Ads Manager
2. Die Ad Account ID steht in der URL oder unter Ads > Übersicht > Kontonummer
3. Gehe zu Conversions > Conversions API
4. Generiere einen Access Token (benötigt Pinterest Business Account)

Ad Account ID finden: Die numerische Account-ID steht im Pinterest Ads Manager in der URL oder unter Ads > Übersicht neben dem Kontonamen.

Empfohlene Konfiguration bei Pinterest:

1. Conversions API einrichten: Unter Conversions > Conversions API > Set Up API den Token generieren. Ein Pinterest Tag (Browser-Pixel) ist optional — die CAPI funktioniert auch standalone.
2. Test-Events prüfen: Nutze den API-Parameter test=true für Testaufrufe. Ergebnisse erscheinen unter Conversions > Test Events.

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 Events Manager und wähle dein Pixel
3. Unter Conversions API: Generiere einen Long-Lived Token
4. In ShopiPixel: Gehe zu Einstellungen → Snapchat
5. 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:

• Organization ID: Die ID deiner LinkedIn-Unternehmensseite (aus der URL deiner Company Page)
• Conversion Rule ID: Die ID der Conversion-Regel
• Access Token: LinkedIn CAPI Access Token

So findest du die Werte:

1. Öffne den LinkedIn Campaign Manager
2. Organization ID: Gehe zu deiner Unternehmensseite — die ID steht in der URL (linkedin.com/company/12345678/)
3. Conversion Rule ID: Unter Measurement > Conversion Tracking > Conversion-Regel wählen — die ID steht in der URL (z.B. /conversions/15588877)
4. Access Token: Im Campaign Manager auf Data > Signals Manager > Direct API > Generate access token klicken. Der Token läuft nicht ab — einmal kopieren und sicher speichern

Organization ID finden: Die numerische Organization ID steht in der URL deiner LinkedIn-Unternehmensseite: linkedin.com/company/12345678/. Die Conversion Rule ID findest du unter Measurement > Conversion Tracking in der URL der Conversion-Regel.

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.

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
• CAPI Access Token aus den Microsoft Ads Einstellungen

So findest du die Werte:

1. Öffne Microsoft Ads unter ads.microsoft.com
2. Gehe zu Conversions → UET Tags und wähle deinen Tag
3. Klicke auf "Use Conversions API" und kopiere den generierten Token
4. In ShopiPixel: Gehe zu Einstellungen → Microsoft Ads
5. Gib die UET Tag-ID und den CAPI Access Token ein
6. Aktiviere die Plattform und speichere

UET Tag ID finden: Die numerische Tag ID steht im Microsoft Advertising unter Conversions > UET Tags neben dem Tag-Namen.

Hinweise zur Einrichtung:

1. CAPI Token: Der Token wird im Microsoft Ads UI unter dem UET Tag generiert. Er läuft nicht ab und muss nur einmal eingegeben werden.

So prüfst du, ob Events ankommen:

1. Öffne Microsoft Advertising > Tools > UET Tag
2. Prüfe den Tag-Status — er sollte "Tag aktiv" zeigen
3. Alternativ: Nutze den UET Tag Helper (Chrome-Extension) für Echtzeit-Debugging

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