# Magento-Integration
## Integrationsübersicht
[Magento](https://business.adobe.com/products/commerce.html) ist eine führende E-Commerce-Plattform, die Unternehmen bei der Verwaltung von Produkten, Kunden und Bestellungen in großem Umfang unterstützt. Durch die Integration von Magento mit Pushwoosh können Sie Kunden, Bestellungen und abgebrochene Warenkörbe automatisch synchronisieren, um Echtzeit-Nachrichten, gezielte Segmentierung und kanalübergreifende Marketing-Automatisierung zu ermöglichen. So können Sie Benutzer direkt aus Ihrer Shop-Aktivität heraus ansprechen und die Konversionen steigern.
### Integrationstyp
**Ziel**: Diese Integration überträgt Daten von Ihrem Magento-Shop an Pushwoosh.
### Voraussetzungen
Bevor Sie fortfahren, stellen Sie Folgendes sicher:
* Zugriff auf das Magento Admin-Panel
* Ein gültiges Pushwoosh-Konto
* Ihr Pushwoosh [API-Zugriffstoken](/de/developer/api-reference/api-access-token/) und Ihr [App-Code](/de/developer/api-reference/api-identifiers/#application-code)
* [Composer](https://getcomposer.org/) ist auf Ihrem Magento-Server installiert
* Die Systemanforderungen sind erfüllt:
* PHP 7.4 / 8.x
* Magento 2.3 / 2.4
* Elasticsearch 7
* RabbitMQ
### Glossar
Zuordnung der Entitätsnamen, falls sie sich unterscheiden:
| Magento | Pushwoosh |
| :---- | :---- |
| Kunde | Benutzer |
### Liste der synchronisierten Entitäten:
* Kunden
* Bestellungen
* Abgebrochene Warenkörbe
### Anwendungsfälle
* Senden Sie Push-Benachrichtigungen basierend auf Ereignissen zur Erstellung von Bestellungen und zum Abbruch von Warenkörben.
* Segmentieren Sie Kunden nach Attributen (z. B. Standort, Geburtstag) und senden Sie gezielte Kampagnen.
* Senden Sie browserbasierte Werbebenachrichtigungen.
## Einrichtung der Integration
### Installation
1. Führen Sie den folgenden Composer-Befehl im Stammverzeichnis Ihres Magento-Projekts aus:
```shell
composer require pushwoosh/magento2-integration
```
2. Sobald das Paket installiert ist, führen Sie das Magento-Setup aus, um das Modul zu installieren:
```shell
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:clean
```
### Konfiguration nach der Installation
Nach Abschluss der Installation:
1. Melden Sie sich im Magento Admin-Panel an.
2. Navigieren Sie zu **Stores > Configuration > Pushwoosh > Configuration**.
#### Allgemeine Einstellungen
Konfigurieren Sie im Abschnitt **Allgemein** die folgenden Felder:
* **Status**: Setzen Sie dies auf `Aktivieren`, um die Integration zu aktivieren.
* **API-URL**: Geben Sie den Pushwoosh-API-Endpunkt ein: `https://api.pushwoosh.com/`
* **API-Schlüssel**: Fügen Sie Ihren Pushwoosh-API-Schlüssel ein, der zur Authentifizierung von Anfragen erforderlich ist. [Erfahren Sie mehr über den Pushwoosh-API-Zugriffsschlüssel](/de/developer/api-reference/api-access-token/)
* **App-Code**: Geben Sie den [Pushwoosh-App-Code](/de/developer/api-reference/api-identifiers/#application-code) ein, der Ihrer mobilen oder Web-Anwendung entspricht.
Nachfolgend finden Sie die Konfigurationsoptionen für die Synchronisierung von Kunden, Bestellungen und abgebrochenen Warenkörben.
#### Konfiguration der Bestellungs-Synchronisierung
Definieren Sie, wie Bestelldaten zwischen Ihrem Magento-Shop und Pushwoosh synchronisiert werden.
Füllen Sie die folgenden Felder aus:
| | |
|-------------|-----------------|
| **Bestellungs-Synchronisierung aktivieren** | Setzen Sie dies auf **Ja**, um die automatische Synchronisierung von Bestellungen zu aktivieren. Wenn aktiviert, folgt der Prozess dem definierten Cron-Zeitplan. Setzen Sie dies auf **Nein**, um die automatische Synchronisierung zu deaktivieren. |
| **Cron-Einstellungen** | Nur verfügbar, wenn die Bestellungs-Synchronisierung aktiviert ist. Definieren Sie, wann der Cron-Job ausgeführt werden soll, indem Sie die folgenden Felder verwenden: `Minute`, `Stunde`, `Tag`, `Monat`, `Wochentag`. **Cron** ist ein zeitbasierter Planer, der verwendet wird, um Aufgaben automatisch in bestimmten Intervallen auszuführen. |
| **Anzahl der zu synchronisierenden Bestellungen** | Geben Sie an, wie viele Bestellungen bei jeder Synchronisierungsausführung verarbeitet werden sollen. |
| **Bestellungen in Echtzeit synchronisieren** | Setzen Sie dies auf **Ja**, um Bestellungen sofort nach der Platzierung zu synchronisieren. |
Hier können Sie auch den Status der Bestellungs-Synchronisierung sehen:
* **Gesamtzahl der Bestellungen**: Zeigt die Gesamtzahl der für die Synchronisierung bewerteten Bestellungen an.
* **Synchronisierte Bestellungen**: Anzahl der erfolgreich mit Pushwoosh synchronisierten Bestellungen.
* **Nicht synchronisierte Bestellungen**: Bestellungen, die noch nicht synchronisiert wurden.
* **Fehlgeschlagene synchronisierte Bestellungen**: Bestellungen, bei denen Synchronisierungsversuche fehlgeschlagen sind.
#### Konfiguration der Synchronisierung von abgebrochenen Warenkörben
Konfigurieren Sie die Synchronisierung von Daten zu abgebrochenen Warenkörben zwischen Ihrem Magento-Shop und Pushwoosh.
Füllen Sie die folgenden Felder aus:
| | |
|-------------|-----------------|
| **Synchronisierung abgebrochener Warenkörbe** | Setzen Sie dies auf **Ja**, um die automatische Synchronisierung von Daten zu abgebrochenen Warenkörben zu aktivieren. Wenn aktiviert, läuft die Synchronisierung gemäß dem definierten Cron-Zeitplan. |
| **Konfiguration des Cron-Zeitplans** | Definieren Sie, wann die Synchronisierung ausgeführt werden soll, indem Sie die folgenden Felder verwenden: `Minute`, `Stunde`, `Tag`, `Monat`, `Wochentag`. **Cron** ist ein zeitbasierter Job-Scheduler, der Aufgaben automatisch in bestimmten Intervallen ausführt. |
| **Anzahl der abgebrochenen Warenkörbe** | Geben Sie an, wie viele abgebrochene Warenkörbe bei jeder Synchronisierungsausführung verarbeitet werden. |
| **Minimale Inaktivitätszeit** | Legen Sie die minimale Inaktivitätszeit (in Minuten) fest, nach der ein Warenkorb als abgebrochen gilt. Zum Beispiel bedeutet `60`, dass Warenkörbe, die mindestens 60 Minuten inaktiv sind, für die Synchronisierung in Frage kommen. |
Hier können Sie auch Echtzeit-Metriken zur Synchronisierungsaktivität sehen:
* **Gesamtzahl der abgebrochenen Warenkörbe**: Gesamtzahl der als abgebrochen identifizierten Warenkörbe.
* **Synchronisierte abgebrochene Warenkörbe**: Anzahl der erfolgreich mit Pushwoosh synchronisierten Warenkörbe.
* **Nicht synchronisierte abgebrochene Warenkörbe**: Anzahl der Warenkörbe, die noch nicht synchronisiert wurden.
* **Fehlgeschlagene synchronisierte Warenkörbe**: Anzahl der Warenkörbe, bei denen die Synchronisierung fehlgeschlagen ist.
#### Konfiguration der Kunden-Synchronisierung
Konfigurieren Sie die Synchronisierung von Kundendaten von Ihrem Magento-Shop zu Pushwoosh, um die Segmentierung von Zielgruppen und personalisierte Nachrichten basierend auf Kundenattributen zu ermöglichen.
Füllen Sie die folgenden Felder aus:
| | |
|-------------|-----------------|
| **Kunden-Synchronisierung** | Setzen Sie dies auf **Ja**, um die Synchronisierung aller bestehenden und neuen Kundendatensätze zu aktivieren. Die Synchronisierung folgt dem definierten Cron-Zeitplan und verwendet die angegebenen Attributzuordnungen. |
| **Konfiguration des Cron-Zeitplans** | Definieren Sie, wann die Synchronisierung ausgeführt werden soll, indem Sie die folgenden Felder verwenden: `Minute`, `Stunde`, `Tag`, `Monat`, `Wochentag`. **Cron** ist ein zeitbasierter Job-Scheduler, der Aufgaben automatisch in bestimmten Intervallen ausführt. |
| **Zuordnung von benutzerdefinierten Kundenfeldern** | Ordnen Sie Magento-Kundenattribute den benutzerdefinierten Feldern von Pushwoosh zu, um eine genaue Datenübertragung zu gewährleisten. Beispiele: `Geburtsdatum → Geburtstag`, `Vorname → firstName` |
| **Anzahl der Kunden** | Legen Sie die maximale Anzahl der pro Cron-Lauf zu synchronisierenden Kunden fest. |
Hier können Sie auch Synchronisierungsstatistiken sehen:
* **Gesamtzahl der Kunden**: Gesamtzahl der für die Synchronisierung identifizierten Kundendatensätze.
* **Synchronisierte Kunden**: Anzahl der erfolgreich mit Pushwoosh synchronisierten Kunden.
* **Nicht synchronisierte Kunden**: Kunden, deren Synchronisierung aussteht.
* **Fehlgeschlagene synchronisierte Kunden**: Kunden, die aufgrund von Fehlern nicht synchronisiert werden konnten.
#### Konfiguration für Web-Benachrichtigungen
Setzen Sie dies auf `Ja`, um Web-Push-Benachrichtigungen für Ihre Shop-Besucher zu aktivieren. Setzen Sie dies auf `Nein`, um diese Funktionalität zu deaktivieren.
Wenn aktiviert, kann Ihr Magento-Shop Echtzeit-Nachrichten an Benutzer über deren Browser senden. Benachrichtigungen können für Werbeangebote, Bestellstatus-Updates, Erinnerungen an abgebrochene Warenkörbe und andere Marketingkommunikationen verwendet werden.
#### Konfiguration speichern
Sobald alle erforderlichen Felder ausgefüllt sind, klicken Sie auf die Schaltfläche **Konfiguration speichern** in der oberen rechten Ecke. Leeren Sie den Magento-Cache, wenn Sie dazu aufgefordert werden, um die Änderungen zu übernehmen.
## Manuelle Synchronisierungsoptionen
#### Ausgewählte Kunden mit Pushwoosh synchronisieren
Wenn Sie es vorziehen, nicht alle Kunden automatisch zu synchronisieren, können Sie einzelne oder ausgewählte Kunden manuell synchronisieren.
1. Navigieren Sie im Magento Admin-Panel zu **Customers > All Customers**.
2. Suchen und wählen Sie den/die Kunden aus, den/die Sie synchronisieren möchten.
3. Wählen Sie aus dem Dropdown-Menü **Aktionen** über der Kundenliste **Mit Pushwoosh synchronisieren**.
Sobald die Synchronisierung abgeschlossen ist, erscheinen die Kundendaten im Bereich [User Explorer](/de/product/audience-data-and-segmentation/user-explorer/) Ihres Pushwoosh-Kontos, wobei alle relevanten Informationen von Magento übertragen wurden.
#### Ausgewählte Bestellungen mit Pushwoosh synchronisieren
Wenn Sie es vorziehen, nicht alle Bestellungen automatisch zu synchronisieren, können Sie bestimmte Bestellungen manuell synchronisieren. Dazu:
1. Navigieren Sie im Magento Admin-Panel zu **Sales > Orders**.
2. Wählen Sie eine oder mehrere Bestellungen aus der Liste aus.
3. Wählen Sie aus dem Dropdown-Menü **Aktionen** die Option **Mit Pushwoosh synchronisieren**.
Nach der Synchronisierung erscheint die Bestellung im Bereich „Ereignisse“ des Benutzerprofils im Pushwoosh [User Explorer](/de/product/audience-data-and-segmentation/user-explorer/) als ein `PW_OrderCreated`- oder `PW_OrderUpdated`-Ereignis (wenn sich der Bestellstatus geändert hat), einschließlich detaillierter Bestellinformationen.
#### Ausgewählte abgebrochene Warenkörbe synchronisieren
Um ausgewählte abgebrochene Warenkörbe manuell zu synchronisieren:
1. Gehen Sie im Magento Admin-Panel zum Bereich **Abgebrochene Warenkörbe**.
2. Wählen Sie den Warenkorb aus, den Sie synchronisieren möchten.
3. Wählen Sie aus dem Dropdown-Menü **Aktionen** die Option **Mit Pushwoosh synchronisieren**.
**Hinweis:** Stellen Sie sicher, dass Sie die erforderliche Inaktivitätszeit in den Einstellungen für die **Synchronisierung abgebrochener Warenkörbe** konfiguriert haben, um festzulegen, wann ein Warenkorb als abgebrochen gilt.
Nach der Synchronisierung erscheinen die Daten des abgebrochenen Warenkorbs im Bereich **Ereignisse** des Benutzerprofils im Pushwoosh [User Explorer](/de/product/audience-data-and-segmentation/user-explorer/) als ein `PW_AbandonedCart`-Ereignis mit detaillierten Informationen.
Zusätzlich werden zwei Tags im Benutzerprofil gesetzt:
* **Datum des abgebrochenen Warenkorbs** → `PW_AbandonedCartDate`
* **ID des abgebrochenen Warenkorbs** → `PW_AbandonedCartID`
Diese Tags können verwendet werden, um Erinnerungen an abgebrochene Warenkörbe mithilfe von verbundenen Inhalten in Ihren E-Mail-Vorlagen zu senden. [Erfahren Sie mehr](/de/product/personalization/liquid-templates/#connected-content)
### Überprüfen, ob die Integration funktioniert
Um zu bestätigen, dass die Integration korrekt funktioniert:
1. Erstellen Sie einen Testkunden in Magento.
2. Synchronisieren Sie den Kunden manuell mit Pushwoosh.
3. Öffnen Sie den [User Explorer](/de/product/audience-data-and-segmentation/user-explorer/) in Ihrem Pushwoosh-Dashboard und finden Sie den Kunden.
Wenn der Kunde im [User Explorer](/de/product/audience-data-and-segmentation/user-explorer/) erscheint, bedeutet dies, dass die Synchronisierung erfolgreich war.