Shopify einrichten

Integrationsübersicht

Pushwoosh lässt sich nahtlos mit Shopify integrieren, einer führenden E-Commerce-Plattform, mit der Unternehmen Online-Shops erstellen, verwalten und skalieren können. Diese Anleitung führt Sie durch die Installation und Konfiguration der Pushwoosh-App in Ihrem Shopify-Shop, die Einrichtung der Benutzeridentifikation sowie die Nutzung von Benachrichtigungen und Automatisierungstools, um Kunden über Kanäle wie Push, E-Mail, SMS und WhatsApp zu erreichen.

Integrationstyp

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

Voraussetzungen

• Ein Pushwoosh-Konto
• Zugriff auf Ihr Shopify-Admin-Panel
• Pushwoosh Geräte-API-Token und Application Code
• Ein Shopify-Shop mit verfügbaren Kunden- und Bestelldaten
• Genehmigung des Zugriffsbereichs read_orders für Bestell-/Warenkorb-Events sowie write_pixels und read_customer_events für die Nachverfolgung der Checkout-Schritte

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

Wenn Sie die Pushwoosh-App verbunden haben, bevor es die Nachverfolgung von Bestellungen, Warenkörben und Checkouts gab, bittet Shopify Sie beim nächsten Öffnen der App, die neuen Bereiche zu genehmigen — so führt Shopify erweiterte Berechtigungen ein, das ist kein Fehler. Genehmigen Sie sie, um Bestell-, Warenkorb- und Checkout-Events zu erhalten.

Synchronisierte Entitäten

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

Hinweis

Ansätze zur Kundensynchronisierung in Pushwoosh

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

• E-Mail, Web, SMS & WhatsApp: Geräte/Benutzer werden automatisch in der Pushwoosh-App 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 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 Eigenschaft pushwoosh_userid in den Kundendaten festgelegt.
3. Ist dies nicht möglich, wird die Standard-userID des Pushwoosh SDK als Identifikator für Pushwoosh und die Eigenschaft pushwoosh_userid zugewiesen.
4. In jedem Fall wird auf beiden Seiten eine userID zugewiesen, was eine konsistente Synchronisierung gewährleistet.

• Kundensegmente: Werden für gruppenbasiertes Targeting und Nachrichtenversand verwendet
• Events und Trigger (z. B. aufgegebene Bestellungen, angewendete Tags): Werden in Shopify Flow verwendet, um den Nachrichtenversand über Kanäle hinweg zu automatisieren
• Storefront: Wird verwendet, um Web-Push-Anmeldungen über eingebettete Skripte zu erfassen
• Produkt-Feed: Der Storefront-Feed Ihres Shops (products.json) verbindet sich automatisch mit dem Pushwoosh-Produktkatalog, sobald Sie die App verbinden, und trennt sich automatisch, wenn Sie sie deinstallieren.
• Bestellungen und Warenkörbe: Server-zu-Server-Events aus den Shopify-Webhooks orders/paid, checkouts/create und checkouts/update. Siehe Shopify-Events und -Kampagnen.
• Storefront-Browsing-Verhalten: Produktansichten und Warenkorb-Aktionen, erfasst durch dasselbe Theme-Embed, das auch für Web-Push-Anmeldungen verwendet wird.
• Checkout-Schritte: Eingegebene Kontaktdaten und übermittelte Zahlungsdaten, erfasst über ein Shopify Web Pixel.

Glossar (Zuordnung der Entitätsnamen, falls sie unterschiedlich sind)

Shopify	Pushwoosh
Customer	User ID
orders/paid-Webhook	Event PW_OrderCreated — gemeinsam mit anderen E-Commerce-Integrationen genutzt (z. B. Magento)
checkouts/create-Webhook	Event PW_AbandonedCart — dasselbe gemeinsame Event, auch von der Cart-Quelle des Products-Blocks verwendet
checkouts/update-Webhook	Event PW_AbandonedCartUpdate — wird ausgelöst, während der Käufer denselben Checkout weiter bearbeitet, und überschreibt den aus PW_AbandonedCart gespeicherten Warenkorb
Produktseitenaufruf	Event PW_ProductViewed
In den Warenkorb legen (ohne Seiten-Reload)	Event PW_AddToCart
Web Pixel checkout_contact_info_submitted	Event PW_CheckoutContactInfo
Web Pixel payment_info_submitted	Event PW_PaymentInfoSubmitted

So funktioniert die Integration

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

Schlüsselkomponenten der Integration

1. Kundenidentifikation über Metafelder Jedem Shopify-Kunden wird eine eindeutige Benutzer-ID zugewiesen, die in einem Metafeld (custom.pushwoosh_userid) gespeichert wird. Diese ID ermöglicht es Pushwoosh, Benutzer plattformübergreifend konsistent zu erkennen und zu erreichen.

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

   • Neue Bestellung aufgegeben
   • Tag auf Kunde angewendet
   • Warenkorbabbruch

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

4. Manueller Nachrichtenversand in Echtzeit Aus der Shopify-Kunden- oder Segmentansicht können Sie mit den Pushwoosh-Erweiterungen manuell Benachrichtigungen auslösen:

   • Notification by Customer: Für persönliche Follow-ups oder Tests
   • Notification by Segment: Für kampagnenbasierte Nachrichten

Web-Push-Benachrichtigungen über das Storefront-Embed

Indem Sie das Pushwoosh-Embed in Ihrem Shopify-Theme aktivieren, können Sie Website-Besucher dazu auffordern, browserbasierte Push-Benachrichtigungen zu abonnieren — ganz ohne mobile App.

Übersicht des Datenflusses

Shopify-Kunden- und -Ereignisdaten
         ↓
Pushwoosh-API (über die App)
         ↓
Benutzer-ID → Segmentierung → Getriggerte oder manuelle Benachrichtigungen

Diese Integration ermöglicht es Ihnen, zeitnahe, relevante Nachrichten zu versenden, die die Nutzerbindung verbessern, Conversions steigern und das Kundenerlebnis verbessern — automatisch oder auf Abruf.

Teil 1. Installation

Bei Shopify anmelden

1. Gehen Sie zu Shopify Admin
2. Wählen Sie Ihren Shop im 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 Install
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 Connect.

2. Geben Sie den Application Code und den API Key ein, den Sie im Pushwoosh Control Panel → Settings → API Access finden. Der API Key hier ist Ihr Geräte-API-Token.

Nach dem Verbinden erscheint eine Erfolgsmeldung: „Pushwoosh app connected.“

Wenn Shopify nach Berechtigungen fragt (Bestellungen, Pixel, Kundenereignisse), genehmigen Sie diese. Diese Bereiche sind für die Nachverfolgung von Shopify-Events und -Kampagnen erforderlich. Wenn Sie die App bereits früher verbunden haben, siehe Bereits verbunden? Sie werden gebeten, den Zugriff erneut zu genehmigen.

Automatische Produktkatalog-Verbindung

Das Verbinden der App verbindet auch automatisch den Storefront-Feed Ihres Shops mit dem Pushwoosh-Produktkatalog. Eine separate Feed-Einrichtung ist nicht 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 Upgrade Subscription
2. Es wird ein einziger nutzungsbasierter Plan angezeigt.
3. Bestätigen Sie die Abrechnung.

Hinweis

Für die Nutzung von Nachrichtenzustellungs- und Segmentierungsfunktionen ist eine Abrechnung erforderlich.

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

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

1. Gehen Sie zu Settings → Metafields and metaobjects → Customers

2. Klicken Sie auf Add definition und verwenden Sie diese Werte:

Feld	Wert
Namespace and key	custom.pushwoosh_userid
Namespace	custom
Type	Single line text
Validation	None
Customer Account Access	Read and Write
Storefront API Access	Enabled

Legen Sie Customer accounts access und Storefront API access wie in der obigen Tabelle fest.

Warum das wichtig ist

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

Teil 3. Pushwoosh-Erweiterungen verwenden

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

Erweiterung 1. Send notification by customer

Anwendungsfall

Manuell personalisierte Nachrichten oder Testbenachrichtigungen an einen bestimmten Benutzer senden.

Schritte

1. Öffnen Sie Customers → Kunde auswählen
2. Klicken Sie auf More actions → Notification by customer
   
3. Wählen Sie die Nachrichtenplattform (z. B. E-Mail) und ein Content-Preset.
4. Klicken Sie auf Send

Tipp

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

Erweiterung 2. Notification by segment

Anwendungsfall

Gruppen von Kunden ansprechen — abgebrochene Warenkörbe, Erstkäufer, Vielkäufer.

Schritte

1. Gehen Sie zu Customers → Segments

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

3. Wählen Sie Notification by Segment
4. Wählen Sie den gewünschten Kommunikationskanal und das Nachrichten-Preset aus. Klicken Sie auf Send.

Tipp

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

Erweiterung 3. Pushwoosh in Shopify Flow

Anwendungsfall

Nachrichtenversand in Customer Journeys mit Triggern wie Bestellungen, Tags oder Verhalten automatisieren.

Schritte

1. Erstellen Sie einen neuen Flow in Shopify Flow
2. Aktion hinzufügen → Wählen Sie Pushwoosh send notification

3. Konfigurieren Sie Nachricht und dynamische Felder

Zum Beispiel:

• Eine Nachricht nach Bestellaufgabe senden

• Den Benutzer bei Warenkorbabbruch erinnern

• Nach 30 Tagen Inaktivität einen Reaktivierungs-Push senden

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

Optional für Web Push allein. Erforderlich, wenn Sie Produktansichts- und In-den-Warenkorb-Events für Shopify-Events und -Kampagnen benötigen.

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

1. Gehen Sie zu Online Store → Themes → Customize
   
2. Öffnen Sie App Embeds im linken Menü
3. Schalten Sie Push Init Embed auf ON

Hinweis

Jetzt kann Ihr Shop Benutzer direkt vom Storefront aus zur Anmeldung für Web Push auffordern. Wenn Sie diesen Schalter überspringen, erhalten Sie auch keine Storefront-Browsing-Events in Shopify-Events und -Kampagnen. Bestellzahlungs- und Checkout-Events kommen auch ohne ihn weiterhin an.

Datenschutz-Compliance

Shopify verlangt von jeder öffentlichen App, auf ihre obligatorischen GDPR/CCPA-Webhooks zu reagieren. Pushwoosh behandelt diese 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, dass Apps innerhalb von 30 Tagen darauf reagieren.
• shop/redact: Shopify sendet dies 48 Stunden, nachdem ein Shop die App deinstalliert hat, und bittet um Löschung der Shop-Daten. Pushwoosh führt dieselbe Löschung erneut aus, die die Deinstallation selbst auslöst, bereinigt verbleibende 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 nicht vollständig bereinigt hat.

Zusammenfassung der Anwendungsfälle

Nach der Einrichtung gängige Wege, um von Shopify aus Nachrichten zu senden:

Szenario	Verwendetes Tool
Personalisiertes Follow-up	Notification by Customer
Segmentbasierte Promotion	Notification by Segment
Willkommensnachricht nach Registrierung	Flow + Metafeld-Tracking
Erinnerung bei Warenkorbabbruch	Shopify Flow + Pushwoosh-Aktion
Push-Anmeldung	Theme-Embed + Push-Init-Schalter

Für Journeys und Segmente zu Bestell-, Warenkorb-, Checkout- und Storefront-Events siehe Shopify-Events und -Kampagnen.