Magento-Integration

Hilfe von Entwicklern benötigt

Sie benötigen Hilfe von Ihrem Entwicklungsteam, um die Integration einzurichten. Bitte teilen Sie diese Anleitung mit ihnen.

Integrationsübersicht

Magento 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 und Ihr App-Code

• Composer 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

Hinweis

Um die Pushwoosh-Integration zu installieren, stellen Sie sicher, dass Sie Composer installiert haben.

1. Führen Sie den folgenden Composer-Befehl im Stammverzeichnis Ihres Magento-Projekts aus:

composer require pushwoosh/magento2-integration

2. Sobald das Paket installiert ist, führen Sie das Magento-Setup aus, um das Modul zu installieren:

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
• App-Code: Geben Sie den Pushwoosh-App-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 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 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 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

Ü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 in Ihrem Pushwoosh-Dashboard und finden Sie den Kunden.

Wenn der Kunde im User Explorer erscheint, bedeutet dies, dass die Synchronisierung erfolgreich war.