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 Kanäle wie Push, E-Mail, SMS und WhatsApp 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 Anwendungscode
• 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 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 Eigenschaft pushwoosh_userid 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 Eigenschaft pushwoosh_userid 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 das Messaging über verschiedene Kanäle zu automatisieren
• Storefront: Wird zur Erfassung von Web-Push-Opt-ins durch eingebettete Skripte verwendet

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

Shopify	Pushwoosh
Kunde	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 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 über verschiedene Plattformen hinweg konsistent zu erkennen und ihnen Nachrichten zu senden.

2. Ereignisgesteuerte Automatisierung über Shopify Flow Pushwoosh bietet Flow-Aktionen, mit denen Sie das Messaging (Push, E-Mail, SMS, WhatsApp) 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 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 Benachrichtigungen manuell 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-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.

Datenflussübersicht

Shopify Kunden- & Ereignisdaten
         ↓
Pushwoosh API (über App)
         ↓
UserID → 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 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 das Device API Access Token ein, die Sie im Pushwoosh Control Panel → Einstellungen → API-Zugriff finden.

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

Einen Plan abonnieren

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

Hinweis

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

Teil 2. Einrichtung: Kunden-UserID über Metafelder

Um Benachrichtigungen an identifizierte Benutzer über verschiedene Kanäle (Push, E-Mail, SMS, WhatsApp) zu senden, verwendet Pushwoosh eine eindeutige UserID 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 ein beständiger Benutzeridentifikator über mobile/Web-Geräte 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 Testen von Benachrichtigungen an einen bestimmten Benutzer.

Schritte

1. Öffnen Sie Kunden → Einen Kunden auswählen
2. Klicken Sie auf Weitere Aktionen → Benachrichtigung nach Kunde
   
3. Wählen Sie die Messaging-Plattform (z. B. E-Mail) und eine Inhaltsvorlage.
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 – Warenkorbabbrecher, 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 nach Segment
4. Wählen Sie den gewünschten Kommunikationskanal und die Nachrichtenvorlage 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 Kunden-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. Konfigurieren Sie Nachricht und dynamische Felder

Zum Beispiel:

• Senden Sie eine Nachricht nach der Bestellung

• Erinnern Sie den Benutzer, wenn der Warenkorb verlassen wird

• Senden Sie einen Reaktivierungs-Push 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 Online-Shop → Themes → Anpassen
   
2. Öffnen Sie App-Einbettungen im 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.

Zusammenfassung der Anwendungsfälle

Szenario	Verwendetes Tool
Personalisierte Nachverfolgung	Benachrichtigung nach Kunde
Erinnerung an Warenkorbabbruch	Shopify Flow + Pushwoosh-Aktion
Segmentbasierte Promotion	Benachrichtigung nach Segment
Willkommensnachricht nach der Anmeldung	Flow + Metafeld-Tracking
Push-Opt-in	Theme-Einbettung + Push-Init-Schalter