# 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](https://www.pushwoosh.com/)
* Zugriff auf Ihr Shopify-Admin-Panel
* Pushwoosh [Device API Access Token](/de/developer/api-reference/api-access-token/#device-api-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
* **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](https://admin.shopify.com/)
2. Wählen Sie Ihren Shop aus dem Dashboard aus
### Die Pushwoosh-App installieren
1. Besuchen Sie die [Pushwoosh App Store-Seite](https://apps.shopify.com/pushwoosh-notifications)
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](/de/developer/api-reference/api-access-token/#device-api-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.
## 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 |
## 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](/de/product/content/push-presets/).
4. Klicken Sie auf **Senden**
### 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**.
### 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
## 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 |