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 Nachrichtenübermittlung 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 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 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 Eigenschaft pushwoosh_userid in den Kundendaten festgelegt.
3. Ist dies nicht möglich, wird die standardmäßige Pushwoosh SDK userID als Identifikator sowohl für Pushwoosh als auch für 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 Nachrichtenübermittlung 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
Kunde	UserID

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 Web und Mobilgeräte ermöglichen.

Hauptkomponenten 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. 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. Manuelle und Echtzeit-Nachrichtenübermittlung Aus der Shopify-Kunden- oder Segmentansicht können Sie Benachrichtigungen manuell über die 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-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 ü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 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. Wenn 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. Ein einziger nutzungsbasierter Plan wird angezeigt.
3. Bestätigen Sie die Abrechnung.

Hinweis

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

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

Um mobile Push-Benachrichtigungen an identifizierte Benutzer zu senden, verwendet Pushwoosh eine eindeutige Benutzer-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
Kundenkonto-Zugriff	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 Testbenachrichtigungen 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 eine Inhaltsvorlage 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 – abgebrochene 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 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 die Nachrichtenübermittlung 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 abgebrochen 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 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-Einbettung + Push-Init-Schalter