Shopify-Integration

Integrationsübersicht

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 Mobilgeräte und das Web anzusprechen.

Integrationstyp

• 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 Application Code
• Ein Shopify-Shop mit verfügbaren Kunden- und Bestelldaten

Synchronisierte Entitäten

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

Hinweis

Ansätze zur Kundensynchronisation in Pushwoosh

Aufgrund technischer Einschränkungen bietet Pushwoosh mehrere Methoden zur Kundensynchronisation, 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 Admin-Panels von Pushwoosh und Shopify synchronisiert werden.
• Web-Plattformen (Chrome, Firefox, Safari): Geräte/Benutzer werden von der Shopify-Theme-Erweiterung selbst verwaltet.

Wie funktioniert es?

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 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 Synchronisation zu gewährleisten.

• Kundensegmente: Werden für gruppenbasiertes Targeting und Messaging verwendet
• Ereignisse und Auslöser (z. B. aufgegebene Bestellungen, angewendete Tags): Werden in Shopify Flow verwendet, um Push-Nachrichten zu automatisieren
• Storefront: Wird zur Erfassung von Web-Push-Opt-ins durch eingebettete Skripte verwendet

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

Shopify	Pushwoosh
Customer	UserID

Wie die Integration funktioniert

Pushwoosh fungiert als Messaging-Ziel für Shopify. Nach der Integration sendet Shopify Kunden- und Verhaltensdaten an Pushwoosh, wo diese Echtzeit-Benachrichtigungen, Kundensegmentierung und personalisiertes Messaging über Web und Mobilgeräte 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 ist. Diese ID ermöglicht es Pushwoosh, Benutzer plattformübergreifend konsistent zu erkennen und ihnen Nachrichten zu senden.

2. Ereignisgesteuerte Automatisierung über Shopify Flow Pushwoosh bietet Flow-Aktionen, mit denen Sie Push-Benachrichtigungen basierend auf Shopify-Ereignissen 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 Push-Benachrichtigungen 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 Benachrichtigungen manuell über die Pushwoosh-Erweiterungen auslösen:

   • Benachrichtigung pro Kunde: Für persönliche Nachverfolgungen oder Tests
   • Benachrichtigung pro Segment: Für kampagnenbasierte Nachrichten

Web-Push-Benachrichtigungen über Storefront-Einbettung

Indem Sie die Pushwoosh-Einbettung 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- & Ereignisdaten
         ↓
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 setzt voraus, 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 Application Code 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.“

Einen Plan abonnieren

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

Hinweis

Die Abrechnung ist erforderlich, um die Funktionen für Push-Zustellung und Segmentierung zu nutzen.

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

Um mobile Push-Benachrichtigungen an identifizierte Benutzer 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
Namensraum und Schlüssel	custom.pushwoosh_userid
Namensraum	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 Mobil-/Webgerä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

Personalisierte Nachrichten manuell senden oder Testbenachrichtigungen an einen bestimmten Benutzer senden.

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 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 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 → 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 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-Benachrichtigungen

3. Nachricht und dynamische Felder konfigurieren

Zum Beispiel:

• Eine Nachricht senden, nachdem eine Bestellung aufgegeben wurde

• Benutzer erinnern, wenn der Warenkorb verlassen wird

• Reaktivierungs-Push nach 30 Tagen Inaktivität senden

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.

Zusammenfassung der Anwendungsfälle

Szenario	Verwendetes Tool
Personalisierte Nachverfolgung	Notification by Customer
Erinnerung an verlassenen Warenkorb	Shopify Flow + Pushwoosh action
Segmentbasierte Werbeaktion	Notification by Segment
Willkommensnachricht nach der Anmeldung	Flow + Metafield tracking
Push-Opt-in	Theme Embed + Push Init Toggle