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 Nachrichtenübermittlung verwendet werden.

Voraussetzungen

• Ein Pushwoosh-Konto
• Zugang zu Ihrem Shopify-Admin-Panel
• Pushwoosh Device API Access Token und Anwendungscode
• Ein Shopify-Shop mit verfügbaren Kunden- und Bestelldaten
• Genehmigung der von der App angeforderten Zugriffsbereiche read_orders, write_pixels und read_customer_events, die für Bestell-/Warenkorb-Events, die Verfolgung von Checkout-Schritten und verhaltensbezogene Storefront-Events benötigt werden

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-UserIDs über Shopify-Metafelder zuzuweisen und zu identifizieren

Hinweis

Ansätze zur Kundensynchronisierung in Pushwoosh

Aufgrund technischer Einschränkungen bietet Pushwoosh je nach dem für Benachrichtigungen verwendeten Kommunikationskanal verschiedene Methoden zur Kundensynchronisierung an:

• 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 Admin-Panels von Pushwoosh und Shopify synchronisiert werden.
• Web-Plattformen (Chrome, Firefox, Safari): Geräte/Benutzer werden vom Shopify-Theme-Embed selbst verwaltet.

Wie funktioniert es?

Der Synchronisierungsprozess 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 sowohl für Pushwoosh als auch für die pushwoosh_userid-Eigenschaft zugewiesen.
4. In jedem Fall wird auf beiden Seiten eine userID zugewiesen, um eine konsistente Synchronisierung zu gewährleisten.

• Kundensegmente: Werden für gruppenbasiertes Targeting und Nachrichtenübermittlung verwendet
• Events und Auslöser (z. B. aufgegebene Bestellungen, angewendete Tags): Werden in Shopify Flow verwendet, um die Nachrichtenübermittlung über verschiedene Kanäle zu automatisieren
• Storefront: Wird zur Erfassung von Web-Push-Opt-ins durch eingebettete Skripte verwendet
• Produktfeed: 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- und checkouts/create-Webhooks. Siehe Teil 5: Bestellungen, Warenkörbe und Checkout-Schritte verfolgen.
• Storefront-Browserverhalten: Produktansichten und Aktionen zum Hinzufügen zum Warenkorb, die von demselben Theme-Embed erfasst werden, das auch für Web-Push-Opt-ins verwendet wird.
• Checkout-Schritte: Eingegebene Kontaktinformationen und übermittelte Zahlungsinformationen, erfasst über ein Shopify Web Pixel.

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

Shopify	Pushwoosh
Kunde	UserID
orders/paid Webhook	Event PW_OrderCreated – geteilt mit anderen E-Commerce-Integrationen (z. B. Magento)
checkouts/create Webhook	Event PW_AbandonedCart – dasselbe geteilte Event, wird auch von der Warenkorb-Quelle des Produktblocks verwendet
Produktseitenaufruf	Event PW_ProductViewed

Wie die Integration funktioniert

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

Schlüsselkomponenten der Integration

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

2. Event-gesteuerte Automatisierung über Shopify Flow Pushwoosh bietet Flow-Aktionen, mit denen Sie die Nachrichtenübermittlung (Push, E-Mail, SMS, WhatsApp) basierend auf Shopify-Events automatisieren können, wie zum Beispiel:

   • 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. Manuelle und Echtzeit-Nachrichtenübermittlung Von der Shopify-Kunden- oder Segmentansicht aus können Sie manuell Benachrichtigungen mit den Pushwoosh-Erweiterungen auslösen:

   • Benachrichtigung pro Kunde: Für persönliche Nachfassaktionen oder Tests
   • Benachrichtigung pro 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)
         ↓
UserID → Segmentierung → Ausgelöste oder manuelle Benachrichtigungen

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

Teil 1. Installation

Bei Shopify anmelden

1. Gehen Sie zum 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 Device API Access Token ein, die Sie im Pushwoosh Control Panel → Einstellungen → API-Zugang finden.

Wenn die Verbindung hergestellt ist, erscheint eine Erfolgsmeldung: „Pushwoosh app connected.“

Automatische Verbindung des Produktkatalogs

Durch das Verbinden der App wird auch der Storefront-Feed Ihres Shops automatisch mit dem Pushwoosh Produktkatalog verbunden – eine separate Feed-Einrichtung ist nicht erforderlich. Die Währung Ihres Shops wird gleichzeitig erfasst und automatisch aktualisiert, 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 zur Nachrichtenübermittlung und Segmentierung nutzen zu können.

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

Warum das wichtig ist

Dieses Metafeld ist eine persistente Benutzerkennung ü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 pro Kunde senden

Anwendungsfall

Manuelles Senden personalisierter Nachrichten oder Testen von Benachrichtigungen an einen bestimmten Benutzer.

Schritte

1. Öffnen Sie Kunden → Wählen Sie einen Kunden aus
2. Klicken Sie auf Weitere Aktionen → Benachrichtigung pro Kunde
   
3. Wählen Sie die Nachrichtenplattform (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 pro Segment

Anwendungsfall

Zielgruppen von Kunden ansprechen – verlassene 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 pro 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 die Nachrichtenübermittlung 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-Benachrichtigungen

3. Nachricht und dynamische Felder konfigurieren

Zum Beispiel:

• Senden Sie eine Nachricht nach der Bestellung

• Erinnern Sie den Benutzer, wenn der Warenkorb verlassen wird

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

Teil 4. Web-Push aktivieren (optional, aber empfohlen)

Um browserbasierte Web-Push-Benachrichtigungen in Ihrem Storefront zu unterstützen, gehen Sie wie folgt vor:

1. Gehen Sie zu Onlineshop → Themes → Anpassen
   
2. Öffnen Sie App-Einbettungen im linken Menü
3. Schalten Sie Push Init Embed EIN

Hinweis

Jetzt kann Ihr Shop Benutzer direkt vom Storefront aus auffordern, sich für Web-Push anzumelden.

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

Sobald Sie die Bereiche read_orders, write_pixels und read_customer_events genehmigen (siehe Voraussetzungen), beginnt Pushwoosh, drei Arten von Commerce-Events von Ihrem Shop zu empfangen. Sie stammen aus verschiedenen Quellen und stoppen unabhängig voneinander – behandeln Sie sie nicht als einen einzigen Feed.

Serverseitige Bestell- und Warenkorb-Events

Shopify sendet Bestellung bezahlt (orders/paid Webhook, Event PW_OrderCreated) und Checkout erstellt (checkouts/create Webhook, Event PW_AbandonedCart) Events direkt von Server zu Server an Pushwoosh. Beide werden mit anderen E-Commerce-Integrationen geteilt – Magento verwendet dieselben beiden Event-Namen. Wie andere eingehende Webhook-Events (Stripe funktioniert auf die gleiche Weise) erscheinen sie im Event-Dropdown, wenn Sie ein Segment erstellen oder einen Customer Journey-Auslöser einrichten, und Sie können beide als Quelle für Konversions-Events zuordnen, um Shopify-Umsätze in die RFM-Segmentierung, die Journey-Attribution und die Produktblock-Statistiken zu integrieren, die Sie in E-Mails senden.

Da diese von Shopifys Server und nicht vom Browser des Käufers stammen, kommen sie auch bei Käufern an, die Tracker blockieren oder einen Werbeblocker verwenden.

Warenkorbabbruch bedeutet hier drei verschiedene Dinge

• Der Warenkorbabbruch-Auslöser in Shopify Flow (siehe Event-gesteuerte Automatisierung über Shopify Flow) ist eine native Shopify-Bedingung, die nichts mit Pushwoosh-Events zu tun hat.
• Der obige checkouts/create-Webhook 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.
• Die Warenkorb-Quelle des Produktblocks liest den Warenkorb des Empfängers über das PW_AbandonedCartID-Tag, unabhängig von diesen Events.

Wählen Sie die Option, die zu dem passt, was Sie tatsächlich erstellen, nicht den Namen, der am nächsten klingt.

Storefront-Browser-Events

Produktansichten (Event PW_ProductViewed) und Aktionen zum Hinzufügen zum Warenkorb werden von demselben Theme-Embed erfasst, das Sie bereits für Web-Push-Opt-ins installiert haben – es muss nichts Neues zu Ihrem Theme hinzugefügt werden, aber das Embed muss EINgeschaltet sein (siehe Web-Push aktivieren), damit diese Events ankommen. Wenn Sie diesen Schalter übersprungen haben, erhalten Sie weder Web-Push-Opt-ins noch Storefront-Events.

Storefront-Events erfordern ein aktiviertes Theme-Embed

Produktansichten und Events zum Hinzufügen zum Warenkorb stammen aus dem Browser des Käufers. Wenn ein Käufer das Skript des Embeds blockiert oder Sie das Theme-Embed ausgeschaltet lassen, erhalten Sie diese beiden Events nicht mehr – aber Bestellung bezahlt und Checkout erstellt kommen weiterhin an, da diese von Shopifys Server stammen. Gehen Sie nicht davon aus, dass ein deaktiviertes Theme-Embed auch die Bestellverfolgung pausiert.

PW_ProductViewed hat keine Deduplizierung

PW_ProductViewed wird bei jedem Laden einer Produktseite ausgelöst – einschließlich wiederholter Besuche in derselben Sitzung, Seitenneuladungen und Bot- oder Crawler-Verkehr. Es gibt keine Deduplizierung oder Drosselung. Da Strategien wie Basierend auf dem, was sie angesehen haben auf diesem Event aufbauen, fließt auch lauter Traffic in diese Empfehlungen ein.

Checkout-Schritt-Events

Ein Shopify Web Pixel meldet zwei Checkout-Meilensteine, während der Käufer das Checkout-Formular ausfüllt:

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

Der abgeschlossene Kauf ist nicht Teil dieses Pixels

Das Web Pixel verfolgt absichtlich nicht den abgeschlossenen Kauf – das ist das serverseitige Bestellung bezahlt-Event oben. Verwenden Sie die Web-Pixel-Events, um zu sehen, wo Käufer während des Checkouts abbrechen, und das Bestell-Event, um zu wissen, dass ein Verkauf tatsächlich stattgefunden hat.

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 Anfragen innerhalb von 30 Tagen zu antworten.
• shop/redact: Shopify sendet dies 48 Stunden, nachdem ein Shop die App deinstalliert hat, und bittet um die Löschung der Shop-Daten. Pushwoosh hat absichtlich keinen separaten Handler dafür – die Deinstallation löscht bereits den gesamten Integrationsdatensatz des Shops (einschließlich Geräte-API-Schlüssel, Anwendungscode und Abrechnungs-IDs), sodass für diesen Webhook bei seiner Ankunft nichts mehr zu löschen übrig ist.

Zusammenfassung der Anwendungsfälle

Szenario	Verwendetes Werkzeug
Personalisierte Nachverfolgung	Benachrichtigung pro Kunde
Erinnerung an Warenkorbabbruch	Shopify Flow + Pushwoosh-Aktion
Segmentbasierte Promotion	Benachrichtigung pro Segment
Willkommensnachricht nach der Anmeldung	Flow + Metafeld-Tracking
Push-Opt-in	Theme-Embed + Push-Init-Schalter
Umsatzzuordnung und RFM-Segmentierung	Bestell-/Checkout-Events, die Konversions-Events zugeordnet sind
Analyse von Checkout-Abbrüchen	PW_CheckoutContactInfo / PW_PaymentInfoSubmitted Events
Segmente für Browser- oder Warenkorbabbrüche	Storefront-Produktansicht / In-den-Warenkorb-Events