Vorwort
Wir freuen uns, dass Sie sich für unser Plugin Push Notifications (OneSignal) entschieden haben.
Das Plugin bietet Ihnen die Möglichkeit, Push Notifications basierend auf dem kostenlosen Service von OneSignal in Ihren Shop zu integrieren und dies unabhängig voneinander für jeden Haupt- oder Subshop mit eigenständiger Domain.
Sprachshops mit virtueller URL bieten Push Notifications über die Domain des Hauptshops. Die Spracheinstellung des Shops wird OneSignal als Tag zur Verfügung gestellt, so dass eine Segmentierung der Benutzer nach Spracheinstellung möglich ist.
Eine detaillierte Plugin Konfiguration ermöglich es Ihnen, Design und Texte von Anmeldeglocke und Dialogen für jeden Shop explizit anzupassen.
Wir hoffen, dass wir mit diesem Plugin zur Optimierung Ihrer Arbeitsprozesse beitragen können und freuen uns über Ihr Feedback.
Sollten Sie Vorschläge zur Optimierung des Plugins haben oder individuelle Anpassungen wünschen, zögern Sie nicht, uns zu kontaktieren.
Schreiben Sie dazu bitte eine E-Mail an plugin@synergy-networks.de!
Inhaltsverzeichnis
Systemvoraussetzungen
Bitte beachten Sie, dass die OneSignal Implementierung unseres Plugins die vollständige Unterstützung des HTTPS-Protokolls durch Ihren Shop voraussetzt!
Installation und Update
Die Installation des Plugins erfolgt über den Plugin-Manager im Shopware-Backend.
öffnen Sie den Plugin-Manager in Ihrem Shopware-Backend
installieren bzw. updaten Sie das Plugin
falls nicht bereits geschehen, aktivieren Sie das Plugin
leeren Sie den Backend Cache (Einstellungen > Cache/Performance) und laden Sie das Backend neu
OneSignal Account
Zum Verwalten und Versenden der Push Notifications wird der kostenlose Push Notification Service von OneSignal verwendet. Erstellen Sie dazu bitte unter nachfolgender URL einen Account bei OneSignal:
https://onesignal.com
Anmelden
Klicken Sie in der Navigation der Seite auf LOG IN und nutzen Sie eine, der im Dialog aufgeführten Optionen zur Erstellung Ihres OneSignal Accounts.
OneSignal App erstellen
Nach der Anmeldung bei OneSignal wird Ihnen ein Dialog angezeigt, um Sie durch die ersten Schritte der Einrichtung zu führen.
Wählen Sie auf der letzten Seite des Dialogs „Add a new App". Geben Sie einen Namen für ihre neue OneSignal App ein. Eine OneSignal App verwaltet Push Notifications für jeweils eine Domain (Dies entspricht einem Haupt- oder Subshop). Idealerweise verwenden Sie hier die Domain des betreffenden Shops, z.B. mein-shop.de oder mein-shop.en.
Select Platform:
Wählen Sie die Einstellung „Website Push" und im nächsten Schritt „Google Chrome & Mozilla Firefox" aus. Die Plattform „Apple Safari" kann in diesem Schritt nicht gleichzeitig konfiguriert werden. Fügen Sie diese Plattform bitte später hinzu.
Configure Platform:
Geben Sie in diesem Schritt die URL des Shops ein, für den Sie die OneSignal App einrichten. Zusätzlich lässt sich die URL für ein eigenes Benachrichtigungs-Icon angeben. Bitte beachten Sie bei der Einrichtung, dass wir Ihnen an dieser Stelle dringend empfehlen, Ihre Seite auf https umzustellenden, falls dies nicht bereits geschehen ist.
Select SDK:
Wählen Sie bitte die Option „Website Push".
Install SDK:
Hier steht Ihnen jetzt die App ID der neu erstellten OneSignal App zur Verfügung. Verwenden Sie die App ID nun für die Konfiguration des Plugins im Shopware Backend.
Sie können den Setup-Dialog in OneSignal geöffnet lassen, oder über das Kreuz-Icon schließen. In beiden Fällen haben Sie die App erstellt. Haben Sie die Konfiguration des Plugins abgeschlossen, besuchen Sie das Frontend Ihres Shops und melden sich über die Anmeldeglocke für Push Notifications an. Dieser Vorgang schließt das Setup Ihrer OneSignal App automatisch ab. Ist der Setup-Dialog Ihrer OneSignal App noch geöffnet, können Sie Ihre Anmeldung jetzt über den Button „Check Subscribed Users" prüfen.
Configure Apple Safari Platform:
Öffnen Sie die App-Übersicht über „All Apps" im Side-Menü. Durch Klick auf den App-Namen in der Kartenansicht gelangen Sie zum Dashboard Ihrer App. Wählen Sie nun „App Settings" im Side-Menü. Unter „Website Push Platforms" können Sie Apple Safari konfigurieren.
Bei der Konfiguration wird lediglich die Eingabe Ihrer Shop-URL und unter „Site Name" der Namen aus Ihrer Plugin Konfiguration benötigt.
Grundsätzlich können Sie Ihre OneSignal Apps immer über das Side-Menü unter dem Punkt „All Apps" verwalten. Hier lassen sich Apps anlegen, löschen oder bearbeiten.
Verfügbare Shopware Tags
Zusätzlich zu den von OneSignal angebotenen allgemeinen Tags, stellt das Plugin weitere Tags zur Verfügung, die Sie im OneSignal Dashboard verwenden können, um Segmente zu
erstellen. Diese Segmente verwenden Tag-Filter um Benutzergruppen zu definieren, denen sie Push Notifications senden können.
Tags | Filterwerte |
user_id |
|
user_type | Kürzel der Kundengruppe |
salutation | mr, ms |
firstname |
|
lastname |
|
realname | Vorname Nachname |
birthdate | yyyy-MM-dd (Bsp: 1965-05-02) |
gender | mr, ms, company (Rechnungsadresse) |
postcode | Postleitzahl der Rechnungsadresse |
region | Ort (Rechnungsadresse) |
birthyear | yyyy |
user_type_firstlogin | yyyyMMdd (Bsp: 20161105) |
user_type_lastlogindate | yyyyMMdd |
user_type_lastlogintime | hhmmss (Bsp: 163422) |
user_type_newsletter | 0, 1 |
user_type_shop | Name des Shops |
Plugin konfigurieren
Die Plugin-Konfiguration ist spezifisch für jeden Shop und untergliedert sich in mehrere Abschnitte. Im Folgenden werden die Einstellungen der einzelnen Abschnitte näher erklärt.
Verbindungsdaten
In diesem Abschnitt wird die Verbindung zum OneSignal Notification Service konfiguriert. Tragen Sie hier die App ID ein, die Ihnen beim Erstellen der OneSignal App für diese Domain ausgegeben wurde, weiterhin Namen und Kurznamen Ihrer Seite bzw. Ihres Unternehmens.
Der API Schlüssel ist für spätere Updates vorgesehen und muss aktuell nicht zwingend hinterlegt werden.
Bitte beachten Sie, dass bei der Konfiguration eines Sprachshops (Shop mit virtueller URL wie
z.B. https://mein-shop.de/en) die Konfiguration der Verbindungsdaten mit dem Hauptshop identisch sein muss!
Anmeldeglocke Einstellungen
Die Einstellungen für die Anmeldeglocke sind selbsterklärend. Die Eingabe der Werte für die Abstände sind in CSS-konformen Größen möglich (px, %, em usw.). Abstand links bzw. rechts wird nur beachtet, wenn die Anmeldeglocke auch links bzw. rechts positioniert ist.
Anmeldeglocke Texte
Die Texte für die Anmeldeglocke sind bereits mit Standardwerten vorbelegt. Sie können diese Texte Ihren Bedürfnissen entsprechend anpassen und sollten dies für anderssprachige Subshops auch unbedingt tun.
Anmeldeglocke Farben
Um die Anmeldeglocke an das Design Ihres Shops anzupassen, können Sie alle relevanten Farbwerte der Anmeldeglocke selbst spezifizieren. Sie können Farben in Form von Hex-Werten, RGB-Angaben oder als String eingeben.
Willkommensnachricht Texte
Hier konfigurieren Sie Titel und Nachricht der ersten Push Notification, die der Kunde erhält, nachdem er sich für die Push Notifications angemeldet hat.
Changelog
Version 3.0.2
Optimiert für einen besseren PageSpeed Score
Version 3.0.1
Worker URLs zu OneSignal behoben
Version 3.0.0
Shopware 5.5 Kompatibilität
Version 2.0.1
Shopware 5.2 Kompatibilität
Version 2.0.0
Shopware 5.4 Kompatibilität
Version 1.0.2
Ausgabe der Steuerinformationen im Warenkorb gefixt
Version 1.0.1
Auslesen der Benutzerinformationen gefixt
Version 1.0.0
Initiale Veröffentlichung