Ereignisreferenz

Converlay erfasst automatisch 10 Storefront-Events über Shopifys Web Pixels API. Kein manuelles Event-Setup erforderlich — alle Events werden automatisch ausgelöst, wenn ein Besucher mit Ihrem Shop interagiert.

Automatisch erfasste Events

Event	Auslöser	Wichtige Daten
`page_view`	Jeder Seitenaufruf	URL, Referrer, UTMs
`view_item`	Produktseite aufgerufen	Produkt-ID, Name, Preis, Variante
`view_item_list`	Kollektion / Suchergebnisse aufgerufen	Artikellisten-ID, Artikel
`add_to_cart`	Artikel in den Warenkorb gelegt	Produkt-ID, Menge, Preis
`remove_from_cart`	Artikel aus dem Warenkorb entfernt	Produkt-ID, Menge
`search`	Suche durchgeführt	Suchbegriff
`begin_checkout`	Checkout gestartet	Warenkorbwert, Artikel
`add_payment_info`	Zahlungsinformationen eingegeben	Zahlungsmethode
`add_shipping_info`	Versandinformationen eingegeben	Versandmethode
`purchase`	Bestellung abgeschlossen	Transaktions-ID, Wert, Artikel, Benutzerdaten

Event-Payload-Struktur

Jedes an den Converlay-Erfassungsendpunkt gesendete Event folgt dieser Struktur. Hier ein Beispiel für ein purchase-Event:

purchase event payload

{
  "event_id": "evt_abc123",
  "event_name": "purchase",
  "shop_domain": "my-store.myshopify.com",
  "page_url": "https://my-store.com/thank-you",
  "client_id": "clid_...",
  "session_id": "sid_...",
  "fbp": "fb.1.1700000000000.1234567890",
  "gclid": "CjwKCAiA...",
  "consent_data": {
    "analytics": true,
    "marketing": true,
    "ad_user_data": true,
    "ad_personalization": true
  },
  "ecommerce": {
    "transaction_id": "5678",
    "value": 129.99,
    "currency": "USD",
    "items": [
      {
        "item_id": "gid://shopify/ProductVariant/123",
        "item_name": "Classic Tee",
        "price": 29.99,
        "quantity": 2
      }
    ]
  },
  "user_data": {
    "email": "sha256:abc...",
    "phone": "sha256:def..."
  }
}

Umgang mit PII

Benutzerdaten (E-Mail, Telefon, Adresse) werden auf dem Server mit SHA-256 gehasht, bevor sie an Werbeplattformen weitergeleitet werden. Rohe PII werden weder gespeichert noch weitergegeben. Vor dem Hashing wird eine länderspezifische Normalisierung angewendet.

Event-Anreicherung

Vor der Weiterleitung wird jedes Event angereichert mit:

Click ID-Verknüpfung — gclid, fbclid, ttclid werden sitzungsübergreifend gespeichert
Facebook-Parameter — _fbp und _fbc werden für das Meta CAPI-Matching generiert
Session-Kontext — rollendes 30-Minuten-Session-Fenster mit persistenter Client ID
Einwilligungssignale — Google Consent Mode v2-Signale, zugeordnet von Shopifys Customer Privacy API
Event-Deduplizierung — eindeutige event_id verhindert Doppelzählung aus Pixel- und Webhook-Quellen

Zurück← Ziele verbinden WeiterEinwilligung & Datenschutz →