PlentyONE Plugin Einrichtung
In nur wenigen Schritten erklären wir dir, wie du die PlentyONE-Integration von Loyalista installierst und einrichtest. Die Integration erlaubt es dir, die Loyalista-Funktionalitäten in deinen plentyShop einzubinden und somit deine Kunden langfristig an dich zu binden.
Wir empfehlen dir, nach erfolgreicher Einrichtung deines Plugins auch unsere Weiteren Erläuterungen sowie die Best Practices anzusehen.
Loyalista-Plugin installieren und bereitstellen
Klicke in deinem PlentyONE-System auf Plugins >> plentyMarketplace. Suche nach dem Plugin Loyalista und erwerbe bzw. installiere es kostenlos. Weitere Informationen zur Installation von Plugins findest du im PlentyONE-Handbuch.
Sobald das Plugin installiert ist, verknüpfst du es mit deinem gewünschten Plugin-Set und stellst es bereit.
Plugin-Verbindung einrichten
Die Verbindung zwischen PlentyONE und Loyalista wird per OAuth2 über den PlentyONE-Assistenten eingerichtet:
- Navigiere in deinem PlentyONE-System zu Einrichtung >> Assistenten >> Plugins.
- Wähle das Plugin-Set aus, in welchem das Loyalista-Plugin installiert und bereitgestellt ist.
- Wähle dort das Loyalista Integration Plugin aus (Bild 1). Der Assistent öffnet sich.
- Klicke im Assistenten auf MIT LOYALISTA VERBINDEN (Bild 2). Du wirst zur Autorisierung weitergeleitet. Logge dich, falls noch nicht geschehen, in dein Loyalista-Konto ein und bestätige die Verknüpfung.
- Nach erfolgreicher Verbindung erscheint eine Bestätigungsmeldung und du wirst automatisch zurück in den Assistenten geleitet.
- Schließe den Assistenten ab, um die Einrichtung der Verbindung abzuschließen.
Plugin-Inhalt bearbeiten
Öffne die Loyalista-Inhaltseinstellungen, indem du im Plugin auf Inhalt klickst (Bild 3). Hier findest du vorgefertigte Texte und Konfigurationen, die an verschiedenen Stellen in den Widgets deines plentyShops angezeigt werden. Du kannst alle Texte individuell anpassen. Klicke nach jeder Änderung auf Speichern 
.
Tabelle 1, Tabelle 2, Tabelle 3 und Tabelle 4 erläutern die jeweiligen Texte und Widgets:
Widget-Inhalt (Allgemein)
| Feld | Erläuterung |
|---|---|
| Name der Punkte | Geben Sie hier den Namen für Ihre Punkte ein (z. B. Punkte, Herzen, Taler). |
| Randbreite aller Widgets | Geben Sie hier die Breite des Rahmens in Pixel (px) ein (Standard ist 1). Wenn das Feld leergelassen wird, wird das CSS der Seite bzw. des Themes verwendet. Wenn ein Wert eingetragen wird, wird das CSS der Seite bzw. des Themes überschrieben. |
| Randfarbe aller Widgets | Geben Sie hier die Farbe des Rahmens als Hexadezimaler Farbcode ein (z. B. #000000). Wenn das Feld leergelassen wird, wird das CSS der Seite bzw. des Themes verwendet. Wenn ein Wert eingetragen wird, wird das CSS der Seite bzw. des Themes überschrieben. |
Widget-Inhalt (Checkout-Widget)
| Feld | Erläuterung |
|---|---|
| Überschrift | Geben Sie hier die Überschrift für das Checkout/Warenkorb-Widget ein. |
| Texthinweis für unregistrierte Benutzer | Geben Sie hier den Text ein, welcher nicht eingeloggten Benutzern angezeigt wird. Verfügbare Variable: [points_for_signup]. |
| Texthinweis für registrierte Benutzer | Geben Sie hier den Text ein, welcher eingeloggten Benutzern angezeigt wird. Verfügbare Variable: [account_balance]. |
| Texthinweis für kein Einlösen der Punkte | Geben Sie hier den Text ein, der angezeigt wird, wenn keine Punkte zum Einlösen ausgewählt wurden. |
| Texthinweis für vollständiges Einlösen der Punkte | Geben Sie hier den Text ein, der angezeigt wird, wenn alle verfügbaren Punkte zum Einlösen ausgewählt wurden. |
| Texthinweis für teilweises Einlösen der Punkte | Geben Sie hier den Text ein, der angezeigt wird, wenn nur ein Teil der Punkte zum Einlösen ausgewählt wurde. Verfügbare Variable: [redeemed_points]. |
Widget-Inhalt (MyAccount-Widget)
| Feld | Erläuterung |
|---|---|
| Überschrift | Geben Sie hier die Überschrift für das MyAccount-Widget ein. |
| Texthinweis für unregistrierte Benutzer | Geben Sie hier den Text ein, welcher nicht eingeloggten Benutzern angezeigt wird. Verfügbare Variable: [points_for_signup]. |
| Texthinweis für das beenden der Teilnahme | Geben Sie hier den Text ein, der unter dem Button zum Beenden der Teilnahme angezeigt wird. |
| Texthinweis zu einlösbaren Punkten | Geben Sie hier den Text ein, welcher für die einlösbaren Punkte angezeigt wird. Verfügbare Variable: [account_balance]. |
| Texthinweis für gesperrte Punkte | Geben Sie hier den Text ein, welcher für die aktuell gesperrten Punkte angezeigt wird. Verfügbare Variable: [locked_balance]. |
| Texthinweis zu ablaufenden Punkten | Geben Sie hier den Text ein, welcher für die bald ablaufenden Punkte angezeigt wird. Verfügbare Variable: [expiring_points], [expiry_date]. |
| Texthinweis zum Zusammenführen von Konten | Geben Sie hier den Text ein, welcher Benutzern angezeigt wird, wenn die Möglichkeit besteht, Konten zusammenzuführen. |
| Texthinweis zu Punkten für Geburtstag | Geben Sie hier den Text ein, welcher als Hinweis für die Punkte zum Geburtstag angezeigt wird. Verfügbare Variable: [points_for_birthday]. |
Widget-Inhalt (Product-Widget)
| Feld | Erläuterung |
|---|---|
| Überschrift | Geben Sie hier die Überschrift für das Produkt-Widget ein. |
| Texthinweis für unregistrierte Benutzer | Geben Sie hier den Text ein, welcher unregistrierten Benutzern die Punkte für dieses Produkt anzeigt. Verfügbare Variable: [points_per_product]. |
| Texthinweis für registrierte Benutzer | Geben Sie hier den Text ein, welcher registrierten Benutzern die Punkte für dieses Produkt anzeigt. Verfügbare Variable: [points_per_product]. |
| Texthinweis für Extra-Punkte für registrierte Benutzer | Geben Sie hier den Text ein, welcher den Benutzern die Extra-Punkte für dieses Produkt anzeigt, falls in Loyalista welche für das Produkt oder die Kategorie definiert wurden. Verfügbare Variable: [extra_points]. |
Bonusprogramm-Einstellungen anpassen
Klicke im Plugin auf Einstellungen (Bild 4). Hier kannst du dein Bonusprogramm gezielt konfigurieren, indem du Einstellungen gemäß Tabelle 5 vornimmst. Bestätige deine Eingaben mit einem Klick auf Speichern .
| Template-Variable | Erläuterungen |
|---|---|
| [points_label] | Gibt den Name der Punkte aus. |
| [points_for_signup] | Gibt die Anzahl an Punkten aus, welche Benutzer für die Anmeldung am Bonusprogramm erhalten. |
| [number_of_points_shopping_cart] | Gibt die Anzahl an Punkten aus, welche im Falle eines Kaufabschlusses für den aktuellen Warenkorb gutgeschrieben werden. |
| [account_balance] | Gibt die Anzahl der einlösbaren Punkte aus. |
| [value_of_account_balance] | Gibt den Wert in € der einlösbaren Punkte aus. |
| [date_of_expiry] | Gibt aktuell den Wert 30 aus. Dies ist der Zeitraum in Tagen, welcher bei der Template-Variable [amount_of_points] zugrunde gelegt wird |
| [amount_of_points] | Gibt die Anzahl an Punkten aus, welche in den nächsten [date_of_expiry] Tagen verfallen. |
| [number_of_points] | Gibt die Anzahl an Standard-Punkten aus, welche für einen Artikel des aktuellen Produktes gutgeschrieben werden. |
| [points_for_product] | Gibt die Anzahl an Standard-Punkten aus, welche für einen Artikel des aktuellen Produktes gutgeschrieben werden. |
| [number_of_extra_points] | Gibt die Anzahl an Extra-Punkten aus, welche für einen Artikel des aktuellen Produktes gutgeschrieben werden. |
| [points_for_birthday] | Gibt die Anzahl an Punkten aus, welche Benutzer für ihren Geburtstag erhalten. |
| [total_number_of_redeemable_points] | Gibt die Anzahl der aktuell einlösbaren Punkte aus. |
| [total_number_of_locked_points] | Gibt die Anzahl der aktuell gesperrten Punkte aus. |
Gutscheine einrichten
Damit Kunden Punkte im Checkout einlösen können, benötigt PlentyONE eine passende Gutschein-Konfiguration. Richte hierfür unter Aufträge >> Gutscheine eine entsprechende Gutschein-Aktion ein. Ausführliche Informationen findest du im PlentyONE-Handbuch zu Gutscheinen.
Widgets über den ShopBuilder platzieren
Über den PlentyONE ShopBuilder bindest du die drei Loyalista-Widgets an den gewünschten Positionen deines Webshops ein. Weitere Informationen zum ShopBuilder findest du im PlentyONE ShopBuilder-Handbuch.
MyAccount-Widget
Wähle im ShopBuilder die Kategorie deiner Mein-Konto-Seite (Bild 5). Öffne die aktive Seite im Editor (Bild 6). Ziehe das Widget Loyalista – MyAccount Widget an die gewünschte Stelle und speichere deine Auswahl .
Product-Widget
Das Product-Widget zeigt auf der Artikeldetailseite die Anzahl der sammelbaren Punkte an. Platziere das Widget analog zum MyAccount-Widget auf deiner Artikelansicht im ShopBuilder (Bild 7 und Bild 8).
Checkout-Widget
Das Checkout-Widget ermöglicht Kunden das Einlösen gesammelter Punkte direkt im Bestellvorgang. Platziere das Widget auf deiner Bestellabschluss-Seite (Bild 9 und Bild 10).
Ereignisaktionen einrichten
Um Aufträge und Gutschriften automatisch an Loyalista zu übermitteln, richtest du in PlentyONE Ereignisaktionen ein. Navigiere zu Einrichtung >> Aufträge >> Ereignisse und füge über das Plus-Symbol eine neue Aktion hinzu (Bild 11). Ausführliche Hinweise zu Ereignissen findest du im PlentyONE-Handbuch zu Ereignisaktionen.
Tabelle 6 zeigt beispielhaft die Konfiguration für Aufträge:
| Einstellung | Wert |
|---|---|
| Aktiv | Aktivieren |
| Name | Gebe der Ereignisaktion einen eindeutigen Namen |
| Ereignis | Zahlung >> Vollständig |
| Filter | Auftrag >> Auftragstyp >> Auftrag |
| Filter | Auftrag >> Herkunft >> Mandant (Shop) |
| Aktion | Plugins >> Loyalista: Auftrag an Loyalista senden |
Tabelle 7 zeigt beispielhaft die Konfiguration für Gutschriften:
| Einstellung | Wert |
|---|---|
| Aktiv | Aktivieren |
| Name | Gebe der Ereignisaktion einen eindeutigen Namen |
| Ereignis | Auftragsanlage >> Neue Gutschrift |
| Filter | Auftrag >> Auftragstyp >> Gutschrift |
| Filter | Auftrag >> Herkunft >> Mandant (Shop) |
| Aktion | Plugins >> Loyalista: Gutschrift an Loyalista senden |