Shopify-Integration

Überblick über die Integration

Pushwoosh lässt sich nahtlos in Shopify integrieren, eine führende E-Commerce-Plattform, die es Unternehmen ermöglicht, Online-Shops zu erstellen, zu verwalten und zu skalieren. Diese Anleitung führt Sie durch die Installation und Konfiguration der Pushwoosh-App in Ihrem Shopify-Shop, die Einrichtung der Benutzeridentifikation und die Verwendung von Benachrichtigungen und Automatisierungstools, um Kunden über Kanäle wie Push, E-Mail, SMS und WhatsApp anzusprechen.

Art der Integration

• Ziel: Shopify sendet Kundendaten an Pushwoosh, wo sie für Targeting und Messaging verwendet werden.

Voraussetzungen

• Ein Pushwoosh-Konto
• Zugriff auf Ihr Shopify-Admin-Panel
• Pushwoosh Device API Access Token und Anwendungscode
• Ein Shopify-Shop mit verfügbaren Kunden- und Bestelldaten
• Genehmigung des read_orders-Zugriffsbereichs für Bestell-/Warenkorb-Events und write_pixels plus read_customer_events für die Verfolgung von Checkout-Schritten

Bereits verbunden? Sie werden gebeten, den Zugriff erneut zu genehmigen

Wenn Sie die Pushwoosh-App verbunden haben, bevor die Bestell-, Warenkorb- und Checkout-Verfolgung existierte, bittet Shopify Sie, die neuen Bereiche beim nächsten Öffnen der App zu genehmigen – dies ist die erwartete Vorgehensweise von Shopify bei der Einführung zusätzlicher Berechtigungen, kein Fehler. Genehmigen Sie sie, um Bestell-, Warenkorb- und Checkout-Events zu erhalten.

Synchronisierte Entitäten

• Kunden: Werden verwendet, um Pushwoosh-User-IDs über Shopify-Metafelder zuzuweisen und zu identifizieren

Hinweis

Ansätze zur Kundensynchronisation in Pushwoosh

Aufgrund technischer Einschränkungen bietet Pushwoosh mehrere Methoden zur Kundensynchronisation an, abhängig vom für Benachrichtigungen verwendeten Kommunikationskanal:

• E-Mail, Web, SMS & WhatsApp: Geräte/Benutzer werden automatisch in der Pushwoosh-Anwendung registriert.
• Mobile & Desktop Apps: Geräte/Benutzer können manuell über die Pushwoosh- und Shopify-Admin-Panels synchronisiert werden.
• Web-Plattformen (Chrome, Firefox, Safari): Geräte/Benutzer werden vom Shopify-Theme-Embed selbst verwaltet.

Wie funktioniert das?

Der Synchronisationsprozess läuft wie folgt ab:

1. Das System versucht, die aktuelle Benutzersitzung abzurufen, um eine E-Mail-Adresse oder Telefonnummer zu erhalten (Identifikatoren, die ohne zusätzliche Konfiguration funktionieren).
2. Bei Erfolg wird die E-Mail-Adresse oder Telefonnummer als userID-Identifikator sowohl für Pushwoosh als auch für die pushwoosh_userid-Eigenschaft in den Kundendaten festgelegt.
3. Wenn dies nicht möglich ist, wird die standardmäßige Pushwoosh SDK userID als Identifikator für Pushwoosh und die pushwoosh_userid-Eigenschaft zugewiesen.
4. In jedem Fall wird auf beiden Seiten eine userID zugewiesen, um eine konsistente Synchronisation zu gewährleisten.

• Kundensegmente: Werden für gruppenbasiertes Targeting und Messaging verwendet
• Events und Auslöser (z. B. aufgegebene Bestellungen, angewendete Tags): Werden in Shopify Flow verwendet, um das Messaging über verschiedene Kanäle zu automatisieren
• Storefront: Wird zur Erfassung von Web-Push-Opt-ins durch eingebettete Skripte verwendet
• Produkt-Feed: Der Storefront-Feed Ihres Shops (products.json) verbindet sich automatisch mit dem Pushwoosh Produktkatalog, wenn Sie die App verbinden, und trennt die Verbindung automatisch, wenn Sie sie deinstallieren.
• Bestellungen und Warenkörbe: Server-zu-Server-Events von Shopifys orders/paid, checkouts/create und checkouts/update Webhooks. Siehe Bestellungen, Warenkörbe und Checkout-Schritte verfolgen.
• Storefront-Browsing-Verhalten: Produktansichten und Aktionen zum Hinzufügen zum Warenkorb, die vom selben Theme-Embed erfasst werden, das für Web-Push-Opt-ins verwendet wird.
• Checkout-Schritte: Eingegebene Kontaktinformationen und übermittelte Zahlungsinformationen, die über ein Shopify Web Pixel erfasst werden.

Glossar (Zuordnung von Entitätsnamen, falls sie sich unterscheiden)

Shopify	Pushwoosh
Kunde	User ID
orders/paid Webhook	Event PW_OrderCreated – wird mit anderen E-Commerce-Integrationen geteilt (z. B. Magento)
checkouts/create Webhook	Event PW_AbandonedCart – dasselbe geteilte Event, das auch von der Warenkorb-Quelle des Produktblocks verwendet wird
checkouts/update Webhook	Event PW_AbandonedCartUpdate – wird ausgelöst, wenn der Käufer denselben Checkout weiter bearbeitet und den gespeicherten Warenkorb von PW_AbandonedCart überschreibt
Produktseitenansicht	Event PW_ProductViewed
Zum Warenkorb hinzufügen (ohne Seitenneuladen)	Event PW_AddToCart
Web Pixel checkout_contact_info_submitted	Event PW_CheckoutContactInfo
Web Pixel payment_info_submitted	Event PW_PaymentInfoSubmitted

Wie die Integration funktioniert

Pushwoosh fungiert als Messaging-Ziel für Shopify. Nach der Integration sendet Shopify Kunden- und Verhaltensdaten an Pushwoosh, wo sie Echtzeit-Benachrichtigungen, Kundensegmentierung und personalisiertes Messaging über verschiedene Kanäle ermöglichen.

Schlüsselkomponenten der Integration

1. Kundenidentifikation über Metafelder Jedem Shopify-Kunden wird eine eindeutige User ID zugewiesen, die in einem Metafeld (custom.pushwoosh_userid) gespeichert wird. Diese ID ermöglicht es Pushwoosh, Benutzer über verschiedene Plattformen hinweg konsistent zu erkennen und ihnen Nachrichten zu senden.

2. Event-gesteuerte Automatisierung über Shopify Flow Pushwoosh bietet Flow-Aktionen, mit denen Sie das Messaging (Push, E-Mail, SMS, WhatsApp) basierend auf Shopify-Events automatisieren können, wie z. B.:

   • Neue Bestellung aufgegeben
   • Tag auf Kunden angewendet
   • Warenkorbabbruch

3. Segmentbasiertes Targeting Kundensegmente aus Shopify können verwendet werden, um gruppenspezifische Benachrichtigungen über verschiedene Kanäle zu senden, wie z. B. Werbeaktionen für Erstkäufer oder Reaktivierungskampagnen für inaktive Benutzer.

4. Manuelles und Echtzeit-Messaging Aus der Shopify-Kunden- oder Segmentansicht können Sie manuell Benachrichtigungen mit den Pushwoosh-Erweiterungen auslösen:

   • Benachrichtigung nach Kunde: Für persönliche Nachfassaktionen oder Tests
   • Benachrichtigung nach Segment: Für kampagnenbasierte Nachrichten

Web-Push-Benachrichtigungen über Storefront-Embed

Indem Sie das Pushwoosh-Embed in Ihrem Shopify-Theme aktivieren, können Sie Website-Besucher auffordern, sich für browserbasierte Push-Benachrichtigungen anzumelden – keine mobile App erforderlich.

Überblick über den Datenfluss

Shopify Kunden- & Event-Daten
         ↓
Pushwoosh API (über App)
         ↓
User ID → Segmentierung → Ausgelöste oder manuelle Benachrichtigungen

Diese Integration ermöglicht es Ihnen, zeitnahe, relevante Nachrichten zu liefern, die die Benutzerbindung verbessern, die Konversionen steigern und das Kundenerlebnis verbessern – automatisch oder bei Bedarf.

Teil 1. Installation

Bei Shopify anmelden

1. Gehen Sie zu Shopify Admin
2. Wählen Sie Ihren Shop aus dem Dashboard aus

Hinweis

Diese Anleitung geht davon aus, dass Sie bereits ein Pushwoosh-Konto haben. Falls nicht, erstellen Sie eines

Die Pushwoosh-App installieren

1. Besuchen Sie die Pushwoosh App Store-Seite
2. Klicken Sie auf Installieren
3. Bestätigen Sie die Installation im Shopify-Dialog

Ihre Pushwoosh-App verbinden

Nach der Installation werden Sie zur Pushwoosh-App innerhalb von Shopify weitergeleitet.

1. Klicken Sie auf Verbinden.

2. Geben Sie den Anwendungscode und den API-Schlüssel ein, die Sie im Pushwoosh Control Panel → Einstellungen → API-Zugriff finden. Der API-Schlüssel hier ist Ihr Device API Access Token.

Wenn die Verbindung hergestellt ist, erscheint eine Erfolgsmeldung: “Pushwoosh-App verbunden.”

Wenn Shopify nach Berechtigungen fragt (Bestellungen, Pixel, Kunden-Events), genehmigen Sie diese. Diese Bereiche sind für die Verfolgung in Teil 5 erforderlich. Wenn Sie die App früher verbunden haben, siehe Bereits verbunden? Sie werden gebeten, den Zugriff erneut zu genehmigen.

Automatische Verbindung des Produktkatalogs

Durch das Verbinden der App wird auch der Storefront-Feed Ihres Shops automatisch mit dem Pushwoosh Produktkatalog verbunden. Es ist keine separate Feed-Einrichtung erforderlich. Die Währung Ihres Shops wird gleichzeitig erfasst und aktualisiert sich automatisch, wenn Sie die Währung Ihres Shops später ändern.

Einen Plan abonnieren

1. Klicken Sie auf Abonnement upgraden
2. Es wird ein einzelner nutzungsbasierter Plan angezeigt.
3. Bestätigen Sie die Abrechnung.

Hinweis

Die Abrechnung ist erforderlich, um die Funktionen für die Nachrichtenübermittlung und Segmentierung zu nutzen.

Teil 2. Einrichtung: Kunden-User-ID über Metafelder

Um Benachrichtigungen an identifizierte Benutzer über verschiedene Kanäle (Push, E-Mail, SMS, WhatsApp) zu senden, verwendet Pushwoosh eine eindeutige User ID pro Kunde. Shopify speichert diesen Wert in den Kunden-Metafeldern von Shopify.

1. Gehen Sie zu Einstellungen → Metafelder und Metaobjekte → Kunden

2. Klicken Sie auf Definition hinzufügen und verwenden Sie diese Werte:

Feld	Wert
Namespace und Schlüssel	custom.pushwoosh_userid
Namespace	custom
Typ	Einzeiliger Text
Validierung	Keine
Zugriff auf Kundenkonto	Lesen und Schreiben
Storefront-API-Zugriff	Aktiviert

Stellen Sie den Zugriff auf Kundenkonten und den Storefront-API-Zugriff wie in der obigen Tabelle ein.

Warum das wichtig ist

Dieses Metafeld ist ein persistenter Benutzeridentifikator über mobile/Web-Geräte hinweg für Benachrichtigungen und Segmentierung.

Teil 3. Verwendung von Pushwoosh-Erweiterungen

Pushwoosh enthält Shopify-Erweiterungen für Segment-Targeting, Automatisierung (Flow) und kundenspezifische Benachrichtigungen.

Erweiterung 1. Benachrichtigung nach Kunde senden

Anwendungsfall

Manuelles Senden personalisierter Nachrichten oder Testbenachrichtigungen an einen bestimmten Benutzer.

Schritte

1. Öffnen Sie Kunden → Wählen Sie einen Kunden aus
2. Klicken Sie auf Weitere Aktionen → Benachrichtigung nach Kunde
3. Wählen Sie die Messaging-Plattform (z. B. E-Mail) und ein Inhalts-Preset aus.
4. Klicken Sie auf Senden

Tipp

Verwenden Sie dies für Erinnerungen nach dem Kauf, persönliche Danksagungen oder Reaktivierungsaufforderungen.

Erweiterung 2. Benachrichtigung nach Segment

Anwendungsfall

Zielgruppen von Kunden ansprechen – abgebrochene Warenkörbe, Erstkäufer, Vielkäufer.

Schritte

1. Gehen Sie zu Kunden → Segmente

2. Wählen Sie ein Segment aus → Klicken Sie auf Segment verwenden

3. Wählen Sie Benachrichtigung nach Segment
4. Wählen Sie den gewünschten Kommunikationskanal und das Nachrichten-Preset aus. Klicken Sie auf Senden.

Tipp

Segmente können basierend auf Kaufhistorie, Standort, Aktivität oder Tags erstellt werden.

Erweiterung 3. Pushwoosh in Shopify Flow

Anwendungsfall

Automatisieren Sie das Messaging in Customer Journeys mithilfe von Auslösern wie Bestellungen, Tags oder Verhalten.

Schritte

1. Erstellen Sie einen neuen Flow in Shopify Flow
2. Aktion hinzufügen → Wählen Sie Pushwoosh-Benachrichtigung senden

3. Konfigurieren Sie die Nachricht und dynamische Felder

Zum Beispiel:

• Senden Sie eine Nachricht nach einer Bestellung

• Erinnern Sie den Benutzer, wenn der Warenkorb abgebrochen wird

• Senden Sie einen Reaktivierungs-Push nach 30 Tagen Inaktivität

Teil 4. Web-Push aktivieren (und Storefront-Browsing-Events)

Optional für Web-Push allein. Erforderlich, wenn Sie Produktansichts- und Warenkorb-Events in Teil 5 benötigen.

Aktivieren Sie das Theme-Embed für Browser-Web-Push in Ihrem Storefront:

1. Gehen Sie zu Online-Shop → Themes → Anpassen
2. Öffnen Sie App-Embeds aus dem linken Menü
3. Schalten Sie Push Init Embed EIN

Hinweis

Jetzt kann Ihr Shop Benutzer auffordern, sich direkt vom Storefront aus für Web-Push anzumelden. Wenn Sie diesen Schalter überspringen, erhalten Sie auch keine Storefront-Browsing-Events in Teil 5. Bezahlte Bestell- und Checkout-Events kommen auch ohne ihn an.

Teil 5. Bestellungen, Warenkörbe und Checkout-Schritte verfolgen

Nachdem Sie die App verbunden und die von Shopify angeforderten Berechtigungen für die Bestell-, Warenkorb- und Checkout-Verfolgung (read_orders, write_pixels, read_customer_events) genehmigt haben, beginnen Bestell-, Checkout- und Checkout-Schritt-Events ohne einen separaten Pushwoosh-Tracking-Bildschirm anzukommen. Siehe Voraussetzungen und Teil 1 für den Genehmigungsschritt. Das Storefront-Browsing (Produktansichten und Hinzufügen zum Warenkorb) erfordert ebenfalls Push Init Embed EIN.

Die Verfolgung umfasst drei unabhängige Event-Gruppen. Jede benötigt unterschiedlichen Zugriff, sodass das Ausschalten einer Gruppe die anderen nicht pausiert:

• Bezahlte Bestellung und Checkout: kommen von Shopify, auch wenn das Theme-Embed ausgeschaltet ist
• Storefront-Browsing (Produktansichten und Hinzufügen zum Warenkorb): benötigen das Theme-Embed EIN
• Checkout-Schritte: benötigen die Checkout-Tracking-Berechtigungen von Shopify aus Teil 1 (write_pixels und read_customer_events), die separat von der Bestell-Tracking-Berechtigung (read_orders) oben genehmigt werden

Bevor Sie die App verbinden, prüfen Sie, wie Pushwoosh Geld- und Datumsattributtypen behandelt für PW_OrderCreated und PW_AbandonedCart. Ein falscher Typ, der gesendet wird, bevor Sie ihn bemerken, kann nicht rückwirkend korrigiert werden.

Bezahlte Bestell- und Checkout-Events

Verwenden Sie diese für Post-Purchase-Messaging (PW_OrderCreated), Journeys oder Segmente für abgebrochene Checkouts (PW_AbandonedCart / PW_AbandonedCartUpdate) und die Zuordnung von Kaufkonversionen. Sie kommen von Shopify, auch wenn der Käufer das Browser-Tracking blockiert:

Erfordert, dass die App verbunden und read_orders genehmigt ist

Kein zusätzlicher Schalter darüber hinaus: Verbinden Sie die App in Teil 1 und genehmigen Sie die Bestell-Tracking-Berechtigung von Shopify (read_orders). Im Gegensatz zum Storefront-Browsing hängen diese Events nicht davon ab, ob das Theme-Embed eingeschaltet ist.

Event-Name in Pushwoosh	Wann es ausgelöst wird
PW_OrderCreated	Eine Bestellung wird bezahlt
PW_AbandonedCart	Ein Käufer beginnt den Checkout
PW_AbandonedCartUpdate	Der Käufer fügt Artikel während eines bestehenden Checkouts hinzu, entfernt sie oder ändert sie

Diese entsprechen den Bestell- und Checkout-Benachrichtigungen, die Shopify automatisch an Pushwoosh sendet (die orders/paid, checkouts/create und checkouts/update Webhooks, die unter Synchronisierte Entitäten aufgeführt sind).

Shopifys eigene Flow-Bedingung, der checkouts/create-Webhook, und die Warenkorb-Quelle des Produktblocks sind drei verschiedene Dinge, die alle als Warenkorbabbruch bezeichnet werden. Wählen Sie diejenige aus, die zu dem passt, was Sie erstellen, indem Sie die folgende Tabelle verwenden.

Was Sie erstellen möchten	Was zu verwenden ist
Erinnerung aus Shopify Flow (Shopifys eigene Warenkorbabbruch-Bedingung)	Shopify Flow + Pushwoosh-Benachrichtigung senden-Aktion. Nicht die PW_AbandonedCart-Event-Namen.
Erinnerung oder Segment in Pushwoosh vom gestarteten Checkout oder geänderten Warenkorb	Customer Journey oder Segment auf PW_AbandonedCart / PW_AbandonedCartUpdate
Die Warenkorbartikel des Käufers in einer E-Mail anzeigen	Produktblock Warenkorb-Quelle (verwendet das PW_AbandonedCartID-Tag zum Sendezeitpunkt). Unabhängig davon, welcher Auslöser die Journey gestartet hat.

Wie sich diese Events verhalten. checkouts/create bedeutet nur, dass ein Checkout gestartet wurde. Shopify hat noch nicht entschieden, dass er abgebrochen ist, und es wurde auch noch keine Bestellung bestätigt.

Während der Käufer den Checkout bearbeitet, wird PW_AbandonedCartUpdate erneut für denselben Checkout ausgelöst und überschreibt den von PW_AbandonedCart gespeicherten Warenkorb. Erinnerungs-E-Mails, die die Warenkorb-Quelle verwenden, übernehmen die neuesten Artikel zum Sendezeitpunkt. Sie benötigen keinen zweiten Journey-Auslöser, nur um den Warenkorb zu aktualisieren.

PW_AbandonedCart und PW_AbandonedCartUpdate setzen das PW_AbandonedCartID-Tag auf dem Käufer, das von der Warenkorb-Quelle zum Sendezeitpunkt gelesen wird. PW_OrderCreated löscht es sofort, sodass ein Käufer, der bereits ausgecheckt hat, den Block überspringt, anstatt eine Erinnerung für einen Warenkorb zu erhalten, den er nicht mehr hat. Siehe Was passiert, wenn Sie PW_OrderCreated senden für das genaue Löschverhalten.

Ein Käufer, der den Checkout zweimal startet, tritt nur dann erneut in die Journey ein, wenn Sie es erlauben

Standardmäßig tritt jemand, der sich bereits in einer Customer Journey befindet, nicht erneut ein. Ein zweites checkouts/create vom selben Käufer, während seine erste Warenkorbabbruch-Journey noch läuft, wird also ignoriert und nicht neu gestartet. Aktivieren Sie Wiedereintritt erlauben am Auslöser, wenn Sie möchten, dass jeder neue Checkout seine Erinnerungszeit zurücksetzt. Siehe Steuern, ob Benutzer die Kampagne erneut betreten können.

Attribute von Bestell- und Checkout-Events

PW_OrderCreated und PW_AbandonedCart enthalten:

Attribut	Beschreibung
orderId	Die Bestell- oder Checkout-Kennung
email	Die E-Mail-Adresse des Käufers
totalPrice	Der Gesamtbetrag der Bestellung oder des Warenkorbs
shippingAmount	Die Versandkosten
taxAmount	Der Steuerbetrag
discountAmount	Der Rabattbetrag
currency	Der Währungscode
items	Die Positionen des Warenkorbs
customerId	Nur für registrierte Kunden, nicht bei Gast-Checkouts vorhanden
orderUrl	Die Bestellstatusseite für PW_OrderCreated oder die Wiederherstellungs-URL des abgebrochenen Checkouts für PW_AbandonedCart und PW_AbandonedCartUpdate. Verwenden Sie sie, um einen “Kauf abschließen”-Link oder -Button zu erstellen.
createdDate	Wann die Bestellung oder der Checkout erstellt wurde
abandonedDate	Nur PW_AbandonedCart und PW_AbandonedCartUpdate. Wann der Warenkorb zuletzt berührt wurde, nicht wann er zuerst erstellt wurde

Stellen Sie sicher, dass die Attributtypen für Geld und Datum korrekt sind

Pushwoosh leitet den Typ jedes Attributs aus dem ersten Event ab, das es sieht, und diese Ableitung ist für Geld- und Datumsfelder wie totalPrice, shippingAmount, taxAmount, discountAmount und createdDate/abandonedDate oben unzuverlässig. Ein ganzzahliger Preis wie 129 wird als Integer abgeleitet, was dann 129.90 bei jedem späteren Event auf 129 kürzt.

Haben Sie die App noch nicht verbunden? Deklarieren Sie PW_AbandonedCart und PW_OrderCreated mit den korrekten Typen, bevor Sie dies tun, indem Sie die Tabelle in Erstellen Sie die Events in Ihrem Control Panel verwenden. Überspringen Sie den Schritt Senden Sie die Events von Ihrem Backend in dieser Anleitung. Die Shopify-Integration sendet sie bereits für Sie.

Bereits verbunden? Überprüfen Sie die Typen jetzt: Gehen Sie zu Audience → Events im Control Panel, öffnen Sie PW_AbandonedCart und PW_OrderCreated und vergleichen Sie jedes Attribut mit derselben Tabelle. Die Korrektur eines falschen Typs dort korrigiert ihn für die Zukunft, aber jeder Wert, der bereits unter dem falschen Typ gesendet wurde, ist für immer verloren.

Gast-Checkouts können immer noch Bestell- und Warenkorb-Events senden, aber ohne eine registrierte Kunden-ID im Event.

PW_AbandonedCartUpdate trägt dieselben Attribute. Wenn Ihr Konto auch die Magento-Integration verbunden hat, werden deren Bestellungen und abgebrochene Warenkörbe an dieselben Event-Namen gesendet, sodass ein auf PW_OrderCreated / PW_AbandonedCart aufgebautes Segment oder eine Journey beide Shops erfasst und die obigen Attributtypen für beide gelten. Magento hat kein Äquivalent zu PW_AbandonedCartUpdate, da es keine laufenden Checkout-Bearbeitungen verfolgt.

items insbesondere kommt von Shopify mit nur wenigen ausgefüllten Feldern an.

Warenkorbartikel werden aus Ihrem Produktkatalog angereichert

Die items, die Shopify bei PW_AbandonedCart und PW_AbandonedCartUpdate sendet, enthalten nur productId, name, sku, quantity und price. Pushwoosh füllt alles andere, was diesem Artikel noch fehlt, wie description, imageUrl, productUrl, category und andere Katalogfelder, aus dem passenden Produkt in Ihrem verbundenen Produktkatalog (siehe Automatische Verbindung des Produktkatalogs), wann immer eine productId übereinstimmt. Dafür muss nichts extra gesendet werden. Ein Produkt, das im Katalog fehlt, wird einfach mit den von Shopify gesendeten Feldern angezeigt.

Storefront-Browsing-Events

Verwenden Sie diese für Segmente oder Journeys bei abgebrochenem Browsing und für E-Mail-Empfehlungsstrategien, die Produktansichten benötigen (z. B. Basierend auf dem, was sie angesehen haben). Siehe Wie man Produktempfehlungen in E-Mails einrichtet.

Erfordert Push Init Embed EIN

Schalten Sie Push Init Embed EIN in Teil 4. Dasselbe Theme-Embed wie für Web-Push. Dem Theme muss nichts weiter hinzugefügt werden.

Wenn das Embed ausgeschaltet ist oder ein Käufer sein Skript blockiert, verlieren Sie nur Produktansichten und Hinzufügungen zum Warenkorb. PW_OrderCreated und PW_AbandonedCart kommen weiterhin von Shopify.

Beide Events werden vom selben Theme-Embed erfasst. Dem Theme muss nichts weiter hinzugefügt werden, sobald Push Init Embed EIN ist:

• PW_ProductViewed: Der Käufer öffnet eine Produktseite.
• PW_AddToCart: Der Käufer fügt einen Artikel zum Warenkorb hinzu, ohne die Seite neu zu laden, was die meisten Shopify-Themes so machen.

Zwei Dinge, die Sie überprüfen sollten, bevor Sie auf diesen Events aufbauen

• PW_ProductViewed zählt jeden Seitenaufruf ohne Filterung. Neuladungen, wiederholte Ansichten im selben Besuch und sogar Bot-Traffic zählen genauso wie eine echte Produktansicht. Eine auf diesem Event basierende Empfehlungsstrategie erbt dieses Rauschen.
• PW_AddToCart wird nur ausgelöst, wenn der Zum Warenkorb hinzufügen-Button Ihres Shops die Seite nicht neu lädt. Testen Sie dies selbst: Klicken Sie in Ihrem Shop auf Zum Warenkorb hinzufügen und beobachten Sie, was passiert. Aktualisiert sich nur der Warenkorbzähler oder wird die ganze Seite neu geladen? Die meisten Shopify-Themes machen das erste und aktualisieren den Zähler ohne Neuladen (eine Hintergrundanfrage an /cart/add). Wenn Ihr Theme stattdessen die Seite neu lädt, wird PW_AddToCart niemals ausgelöst, aber PW_ProductViewed und die Bestell-/Checkout-Events funktionieren trotzdem einwandfrei.

Attribute von Storefront-Browsing-Events

Beide Events enthalten:

Attribut	Beschreibung
items	Das angesehene oder hinzugefügte Produkt(e), jeweils mit productId, name, sku, quantity, price
totalPrice	Der kombinierte Preis von items
productUrl	Die Seite, auf der sich der Käufer befand
currency	Nur wenn der Storefront es preisgibt

Eine Nachricht, die totalPrice anzeigt, benötigt einen Fallback für den Fall, dass currency fehlt, da die Zahl allein nicht sagt, in welcher Währung sie ist.

Keines der beiden Events trägt email oder customerId als Attribut. Der Käufer wird auf die gleiche Weise identifiziert, wie es der Rest des Theme-Embeds tut, durch die SDK-Sitzung, die mit der Metafeld-User-ID verknüpft ist (siehe Teil 2), nicht durch die Event-Payload.

Die items von PW_ProductViewed und PW_AddToCart tragen dieselben Felder, die Shopify vor der Anreicherung sendet: productId, name, sku, quantity, price. Pushwoosh füllt den Rest der Katalogfelder für diese beiden Events nicht aus, wie es bei den items von PW_AbandonedCart der Fall ist (siehe Warenkorbartikel werden aus Ihrem Produktkatalog angereichert oben).

Eine Empfehlungsstrategie, die vollständige Produktdetails benötigt, wie Basierend auf dem, was sie angesehen haben, sucht diese aus Ihrem Produktkatalog nach productId, wenn die Nachricht gerendert wird. Siehe Wie man Produktempfehlungen in E-Mails einrichtet für die Anforderungen jeder Strategie.

Checkout-Schritt-Events

Verwenden Sie diese, um zu sehen, wo Personen vor dem Kauf abbrechen, und um Personen anzusprechen, die den Checkout begonnen, aber keine bezahlte Bestellung erreicht haben.

Erfordert pixelbezogene App-Berechtigungen

Genehmigen Sie die Checkout-Tracking-Berechtigungen, die Shopify beim Verbinden der App anfordert (write_pixels und read_customer_events). Siehe Teil 1 für diesen Schritt. Kein Theme-Embed-Schritt. Shopify meldet diese Meilensteine automatisch, sobald diese Berechtigungen genehmigt sind (technisch gesehen über Shopifys Web Pixel).

• PW_CheckoutContactInfo: Der Käufer hat seine Kontaktinformationen eingegeben.
• PW_PaymentInfoSubmitted: Der Käufer hat seine Zahlungsdetails übermittelt.

Ein abgeschlossener Verkauf ist PW_OrderCreated aus dem obigen Abschnitt, nicht diese beiden Events.

PW_AbandonedCart sagt Ihnen nur, dass ein Checkout begonnen hat. Diese beiden Events markieren zwei spätere Punkte im selben Checkout, in dieser Reihenfolge: zuerst Kontaktinformationen, dann Zahlungsdetails. Ein Käufer, der PW_PaymentInfoSubmitted erreicht und nie ein folgendes PW_OrderCreated erhalten hat, ist weiter gekommen als einer, der nur PW_AbandonedCart ausgelöst hat, sodass eine auf dieser Stufe aufgebaute Nachricht eine blockierte Zahlung gezielt ansprechen kann, anstatt einer generischen Warenkorberinnerung.

Attribute von Checkout-Schritt-Events

Beide Events enthalten:

Attribut	Beschreibung
items	Die Positionen des Checkouts, jeweils mit productId, name, sku, quantity, price
orderId	Das Checkout-Token oder die Shopify-Bestell-ID, sobald der Checkout eine hat
totalPrice	Der Checkout-Gesamtbetrag
email	Nur wenn der Checkout eine hat. Ein telefonbasierter Checkout (keine E-Mail eingegeben) sendet das Event ohne sie.
currency	Nur wenn der Checkout eine hat

Überprüfen, ob es funktioniert

Führen Sie die entsprechende Aktion im Shop durch und bestätigen Sie dann, dass der Event-Name in Pushwoosh angezeigt wird. Das Event selbst wird in Echtzeit verarbeitet, aber die beiden Orte, an denen Sie es überprüfen würden, reagieren unterschiedlich auf einen Namen, den Pushwoosh noch nicht gesehen hat:

• Im Event-Dropdown, wenn Sie ein Segment nach Events erstellen, erscheint ein neuer Name sofort.
• Im Event-Dropdown, wenn Sie einen Customer Journey-Auslöser hinzufügen, kann es bis zu 10 Minuten dauern, bis ein neuer Name angezeigt wird (dieses Dropdown wird zwischengespeichert). Wenn Sie ihn noch nicht sehen, warten Sie, anstatt anzunehmen, dass die Integration defekt ist.

Testaktion	Event
Eine Testbestellung bezahlen	PW_OrderCreated
Einen Checkout starten	PW_AbandonedCart
Artikel in diesem Checkout ändern	PW_AbandonedCartUpdate
Eine Produktseite öffnen (Push Init Embed EIN)	PW_ProductViewed
Einen Artikel zum Warenkorb hinzufügen	PW_AddToCart
Kontaktinformationen beim Checkout eingeben	PW_CheckoutContactInfo
Zahlungsinformationen beim Checkout übermitteln	PW_PaymentInfoSubmitted

Die Events verwenden

Nachdem Sie wissen, welches Event Sie benötigen, verwenden Sie es an zwei Stellen:

• Als Auslöser oder Segmentbedingung: Wählen Sie es im Event-Dropdown aus, wenn Sie ein Segment nach Events erstellen oder einen Customer Journey-Auslöser hinzufügen.
• Im Nachrichtentext: Aktivieren Sie im Nachrichtenschritt Nachricht mit Event-Attributen personalisieren und wählen Sie das Attribut aus (z. B. den Bestellgesamtbetrag von PW_OrderCreated). Sie können das Attribut auch mit einem Liquid-Platzhalter einfügen. Siehe Dynamische Inhalte und Liquid-Vorlagen in Journeys.

Für bezahlte Bestellungen können Sie PW_OrderCreated auch als Konversions-Event zuordnen, sodass Shopify-Käufe die RFM-Segmentierung, die Journey-Attribution und die Produktblock-Statistiken speisen.

Beispielkampagnen

Jede wird an einem anderen Punkt im Pfad des Käufers ausgelöst, sodass sie unterschiedliche Zielgruppen erreichen: Wie weit jemand gekommen ist, bevor er abgebrochen hat, oder ob er den Checkout überhaupt erreicht hat, entscheidet, welche zutrifft.

• Erinnerung an abgebrochenen Warenkorb. Erfasst jeden Käufer, der den Checkout begonnen hat, egal wie weit er gekommen ist: die breiteste Zielgruppe hier. Erstellen Sie es als Customer Journey: Auslöser bei PW_AbandonedCart, warten Sie auf PW_OrderCreated und senden Sie dann eine E-Mail mit einem Warenkorb-Quellen-Block an alle, die noch nicht bezahlt haben. Siehe Wie man eine Kampagne für abgebrochene Warenkörbe einrichtet für die vollständige Einrichtung.
• Nachverfolgung für blockierte Checkouts. Erfasst nur Käufer, die es bis zur Eingabe der Kontaktinformationen geschafft, aber nie bezahlt haben, ein engerer Teil der obigen Zielgruppe. Segmentieren Sie nach PW_CheckoutContactInfo und schließen Sie dann alle aus, die auch PW_PaymentInfoSubmitted oder PW_OrderCreated haben.
• Wiederherstellung für eine blockierte Zahlung. Erfasst Käufer, die die Zahlung erreicht, aber die Bestellung nie abgeschlossen haben, weiter als die obige Nachverfolgung und schließt sich gegenseitig aus. Segmentieren Sie nach PW_PaymentInfoSubmitted und schließen Sie dann alle aus, die auch PW_OrderCreated haben.
• Browse-Empfehlungs-E-Mail. Erfasst Käufer, die sich Produkte angesehen, aber nie den Checkout begonnen haben, eine andere Zielgruppe als die obigen Erinnerungen. Verwenden Sie PW_ProductViewed mit der Strategie Basierend auf dem, was sie angesehen haben des Produktblocks. Siehe Wie man Produktempfehlungen in E-Mails einrichtet.

Teil 6. Datenkonformität

Shopify verlangt von jeder öffentlichen App, auf seine obligatorischen DSGVO/CCPA-Webhooks zu reagieren. Pushwoosh handhabt sie wie folgt:

• customers/redact: Wenn ein Käufer den Shop bittet, seine Daten zu löschen, löscht Pushwoosh die entsprechenden Pushwoosh-Datensätze anhand der von Shopify gesendeten Identifikatoren – E-Mail, Telefon und Shopify-Kunden-ID.
• customers/data_request: Wenn ein Käufer eine Kopie seiner Daten anfordert, sendet Pushwoosh eine Benachrichtigung an den internen Kanal des Supports, und eine Person bearbeitet die Anfrage manuell. Shopify verlangt von Apps, auf diese innerhalb von 30 Tagen zu reagieren.
• shop/redact: Shopify sendet dies 48 Stunden, nachdem ein Shop die App deinstalliert hat, und bittet um die Löschung der Daten des Shops. Pushwoosh führt dieselbe Löschung erneut aus, die die Deinstallation selbst auslöst, löscht alle verbleibenden Sitzungen und löscht den Integrationsdatensatz des Shops (einschließlich Geräte-API-Schlüssel, Anwendungscode und Abrechnungs-IDs). Dies dient als Sicherheitsnetz für den Fall, dass die Deinstallation beim ersten Mal nicht vollständig aufgeräumt hat.

Zusammenfassung der Anwendungsfälle

Als Nächstes verwenden Sie die obigen Event-Namen in Journeys, Segmenten oder der Konversionszuordnung. Beispiele:

Szenario	Verwendetes Werkzeug
Personalisierte Nachverfolgung	Benachrichtigung nach Kunde
Erinnerung an abgebrochenen Warenkorb	Shopify Flow + Pushwoosh-Aktion oder Journey/Segment auf PW_AbandonedCart / PW_AbandonedCartUpdate (siehe Teil 5)
Segmentbasierte Promotion	Benachrichtigung nach Segment
Willkommensnachricht nach der Anmeldung	Flow + Metafeld-Tracking
Push-Opt-in	Theme-Embed + Push-Init-Schalter
Umsatzattribution und RFM-Segmentierung	Bestell-/Checkout-Events, die Konversions-Events zugeordnet sind
Analyse von Checkout-Abbrüchen	PW_CheckoutContactInfo / PW_PaymentInfoSubmitted-Events
Segmente für abgebrochenes Browsing oder Warenkörbe	Storefront-Produktansichts- / Warenkorb-Events