Plentymarkets 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.
Schau dir nach erfolgreicher Einrichtung deines Plugins die Weiteren
Erläuterungen sowie die Best
Practices an, damit du die Funktionalitäten vollumfassend verstehst
Loyalista Plugin installieren und bereitstellen
Suche im plentyMarketplace nach Loyalista und kaufe das kostenlose Plugin.
Anschließend kannst du das Plugin in deinem PlentyONE System, deinem aktuellen Plugin-Set hinzufügen, indem du unter Plugins >> Plugin-Set-Übersicht auf das Plugin-Set klickst, welches du bearbeiten möchtest. Klicke anschließend in der linken Menü-Auswahl auf Plugin hinzufügen und wähle Loyalista aus der Liste. Nun kannst du mit einem Klick auf Installieren das Loyalista Plugin installieren. Nach erfolgreicher Installation wird wieder das Plugin-Set angezeigt. Aktiviere das Loyalista Plugin mit dem Schieberegler und wähle Plugin-Set bereitstellen.
Weitere Informationen zum Installieren und Bereitstellen von Plugins erhältst du im PlentyONE Handbuch.
Plugin-Verbindung einrichten
Klicke auf das Loyalista Plugin innerhalb des Plugin-Sets, in welches du Loyalista installiert
und bereitgestellt hast. Die Plugin-Verbindungseinstellungen öffnen sich (Bild 1). Treffe die Einstellungen
gemäß Tabelle 1. Klicke anschließend auf speichern .
Einstellungen | Erläuterungen |
| Plenty ID | Füge
deine Plenty ID ein. |
Benutzer ID | Logge
dich auf der Loyalista Website ein. Die Benutzer ID findest du im linken Hauptmenü
unter Integrationen. |
Benutzer
Hash | Logge
dich auf der Loyalista Website ein. Den Benutzer Hash findest du im linken Hauptmenü
unter Integrationen. |
Benutzer Secret / API
Access Token | Logge
dich auf der Loyalista Website ein. Den Benutzer Secret findest du im linken Hauptmenü
unter Integrationen. |
Plugin-Inhalt bearbeiten
Öffne die Loyalista Einstellungen für den Inhalt, indem du innerhalb des Plugins auf Inhalt klickst (Bild
2). Du findest hier bereits vorgefertigte Texte und Einstellungen, welche an bestimmten Stellen innerhalb
der Widgets in deinem plentyShop angezeigt werden. Die vorgefertigten Texte und Einstellungen sind lediglich
Vorschläge und sollen dir den Einstieg mit Loyalista vereinfachen. Selbstverständlich kannst du diese auch
individuell anpassen. Jeweils ein Feld ist für den deutschen und ein Feld für den englischen Text. Die Texte können
beliebig angepasst werden, klicke nach dem Anpassen auf speichern .
Die Tabellen 2 bis 5 erläutern dir, welche Texte in welchem Widget angezeigt werden:
Widget Inhalt (Allgemein)
In Tabelle 2 findest du alle verfügbaren Einstellungen und deren Beschreibung für den Bereich 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)
In Tabelle 3 findest du alle verfügbaren Einstellungen und deren Beschreibung für den Bereich 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)
In Tabelle 4 findest du alle verfügbaren Einstellungen und deren Beschreibung für den Bereich 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 (Produkt Widget)
In Tabelle 5 findest du alle verfügbaren Einstellungen und deren Beschreibung für den Bereich Widget Inhalt (Produkt 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]. |
Innerhalb der Inhaltsfelder können bestimmte Template-Variablen verwendet werden. Template-Variablen sind Platzhalter, welche vom Plugin automatisch durch bestimmte Begriffe bzw. Werte ersetzt werden. In Tabelle 6 findest du eine Auflistung der zur Verfügung stehenden Template-Variablen.
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. |
Bonusprogramm Einstellungen anpassen
Öffne die Loyalista Einstellungen für das Bonusprogramm durch Klicken auf Einstellungen innerhalb des Plugins
(Bild 3). Hier kannst du dein Bonusprogramm weiter individualisieren, indem du die Einstellungen gemäß Tabelle 7 triffst. Wenn du deine Einstellungen eingegeben hast, dann klicke auf speichern :
Einstellung | Erläuterung |
Umsatz pro
Punkt | Gebe den
Umsatz in der Standard-Währung ein, welcher ein Kunde
generieren muss um einen Punkt zu erhalten. |
Wert eines
Punktes | Gebe den
Wert in der Standard-Währung ein, den ein Punkt
besitzt. |
Sperrzeit der
Punkte | Gebe die
Zeit in Tagen ein, welche vergehen muss, bis Punkte nach
Abschluss des Kaufes eingelöst werden können. Sollen Punkte keine Sperrzeit
besitzen, gebe den Wert 0 ein. |
Haltbarkeit der
Punkte | Gebe die
Zeit in Tagen ein, in der Punkte nach Ablauf der Sperrzeit
einlösbar sind. Ist dieses Feld leer, so haben Punkte kein
Ablaufdatum. |
Punkte für
Anmeldung Bonusprogramm | Gebe die
Anzahl an Punkten ein, welche Kunden erhalten, wenn sie sich
für dein Bonusprogramm anmelden. |
Basis Punkte pro
Auftrag | Gebe die
Anzahl an Punkten ein, welche Kunden erhalten, wenn sie einen
Kauf bei dir tätigen (wird zu den Punkten gem. Umsatz addiert). |
Extra Punkte für
Kategorie | Gebe die
Anzahl an Punkten ein, welche Kunden erhalten, wenn sie einen
Artikel eines Produktes aus einer Kategorie mit Extra Punkten
erwerben. |
| Kategorie IDs mit Extra Punkten (kommasepariert) | Gebe die
PlentyONE Varianten IDs an (kommasepariert, falls mehr als
eine ID eingegeben wird) für dessen enthaltene Produkte Extra Punkte gewährt
werden. |
Extra Punkte für
Varianten | Gebe die
Anzahl an Punkten ein, welche Kunden erhalten, wenn sie einen
Artikel eines Produktes mit Extra Punkten erwerben. |
Varianten IDs
(kommasepariert) | Gebe die
PlentyONE Varianten IDs an (kommasepariert, falls mehr als
eine ID eingegeben wird) für dessen enthaltene Produkte Extra Punkte gewährt
werden. |
Checkbox Partielles
einlösen erlauben? | Wenn
aktiviert, erscheint die Radio-Box für partielles Einlösen im
Checkout-Widget und Benutzer haben die Möglichkeit die Anzahl an Punkten zum
Einlösen selbst zu wählen. |
Geburtstagspunkte | Gebe die
Anzahl an Punkten ein, welche Kunden für ihren Geburtstag erhalten. |
Schwellenwert für
verfallende Punkte | Gebe den
Zeitraum in Tagen ein, ab wann Kunden ein Warnhinweis für verfallende Punkte in ihrem
Kundenkonto angezeigt bekommen sollen. Standardwert ist 30 Tage. |
Kampagnen ID für
Gutscheine | Gebe hier
die ID der Aktionsgutschein-Kampagne aus PlentyONE an (siehe Abschnitt Gutscheine). Diese Kampagne wird vom Plugin genutzt, um bei einer
Einlösung von Punkten automatisiert Gutschein-Codes in PlentyONE zu erstellen. |
Gutscheine
Die Rabatte bei Punkte-Einlösungen werden durch Gutscheine realisiert. Damit das Plugin automatisiert Gutschein-Codes in PlentyONE erstellen kann (und bei Nicht-Einlösung auch wieder löschen kann), muss eine entsprechende Gutschein-Kampagne eingerichtet werden. Diese Kampagne dient als Vorlage für alle Gutscheine, die Kunden durch das Einlösen von Punkten erhalten. Gehe dazu in PlentyONE zu Aufträge >> Gutscheine und erstelle eine neue Kampagne. Nimm anschließend im Tab Einstellungen die Konfiguration gemäß Tabelle 8 vor. Weitere Informationen zum Einrichten von Gutschein-Kampagnen findest du im PlentyONE Handbuch.
Einstellung | Empfohlener Wert |
Name | Beliebig, z.B. Loyalista Gutscheine |
Beschreibung | Beliebig |
Konzept | Mehrere
Codes, Eine einzige Einlösung |
Nutzung | Nur
Einzelbestellung |
Mindestbestellwert | 0,00 |
Startdatum | Heutiges Datum |
Enddatum | Leer
lassen |
Code-Gültigkeit in
Wochen | Leer
lassen |
Gutscheintyp | Gutschein |
Gutscheinart | Aktionsgutschein |
Code-Länge | 16
Zeichen |
Rabattart | Festbetrag |
Rabattwert | 1,00 |
Widgets über ShopBuilder platzieren
Die Widgets werden über den ShopBuilder deines plentyShops eingerichtet. Mit Hilfe des ShopBuilders hast du die
Möglichkeit, die drei Loyalista-Widgets (Mein Konto, Artikel und Kasse) an beliebigen Stellen in deinem Shop zu
platzieren. "Beliebig" bedeutet hierbei, dass du innerhalb der entsprechenden Seite (Mein Konto, Artikelansicht oder
Checkout) frei wählen kannst, wo das Widget erscheinen soll. Bitte beachte, dass die Widgets logischerweise auf den
jeweils passenden Seiten platziert werden müssen, um korrekt zu funktionieren.
MyAccount Widget
Information/Aktion | Beschreibung |
Einlösbare
Punkte | Zeigt
die Anzahl der Punkte an, die aktuell für Einlösungen zur Verfügung
stehen. |
Gesperrte
Punkte | Zeigt
Punkte an, die noch nicht einlösbar sind (z.B. aufgrund der Widerrufsfrist von
Bestellungen). |
Punkte verfallen in den
nächsten X Tagen | Informiert darüber, wie viele Punkte innerhalb des
konfigurierten Zeitraums (z.B. 30 Tage) verfallen werden. |
Geburtsdatum
hinterlegen | Ermöglicht es dem Kunden, sein Geburtsdatum anzugeben, um
jährliche Bonuspunkte zu erhalten. |
Zusammenführen zweier
Konten | Erlaubt
es, Punkte von einem Gastkonto oder einem Zweitkonto auf das aktuelle Konto zu
übertragen. |
Teilnahme am
Bonusprogramm beenden | Bietet
die Option, die Teilnahme am Treueprogramm zu kündigen. |
Product Widget
Checkout Widget
Weitere Informationen zur Funktionsweise der Widgets bzw. des Bonusprogramms findest du in unserer Anleitung Weitere Informationen und zum arbeiten mit dem ShopBuilder erhältst du im PlentyONE Handbuch alle Informationen die du benötigst.
Ereignisaktionen erstellen
Das Exportieren der Bestellungen und Gutschriften nach Loyalista erfolgt über Ereignisaktionen in PlentyONE.
Bestellungen und Gutschriften müssen nach Loyalista exportiert werden, damit die Punkte korrekt gutgeschrieben bzw.
abgezogen werden können. Soll es verschiedene Auslöser für den Export eines Auftrages geben, so kannst du beliebig
viele Ereignisaktionen dafür erstellen. Selbst wenn sich Ereignisaktionen überschneiden und Aufträge somit mehrfach
exportiert werden, berücksichtigt Loyalista dies und doppelte Aufträge werden verworfen. Klicke in deinem
PlentyONE System auf Einrichtung >> Aufträge >> Ereignisse. Über
das +-Symbol fügst du eine Ereignisaktion hinzu (Bild 10).
Tabelle 10 gibt dir ein Beispiel für eine Ereignisaktion für Bestellungen und Tabelle 11 gibt dir ein Beispiel für eine Ereignisaktion für Gutschriften:
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 |
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 |
Weitere Informationen zum Erstellen von Ereignisaktionen erhältst du im PlentyONE Handbuch.
Related Articles
Aufträge/Gutschriften manuell nach Loyalista senden
Aufträge und Gutschriften sollten generell über die entsprechenden Ereignisaktionen nach Loyalista gesendet werden. Weitere Informationen dazu findest du in unserer Anleitung zur Einrichtung des PlentyONE Plugins. Das Plugin bietet dir allerdings ...Weitere Erläuterungen
In diesem Artikel erhältst du einige wichtige Erläuterungen zu Loyalista, dem PlentyONE Plugin und den dort enthaltenen Widgets. Du solltest das Plugin installiert und eingerichtet haben, bevor du dich mit diesem Artikel beschäftigst. Allgemeines ...Gutschrift Erstellen
Loyalista verarbeitet Gutschriften wie Aufträge, jedoch werden (vereinfacht beschrieben) die Vorzeichen umgekehrt. Dies bedeutet, dass Punkte-Gutschriften wieder abgezogen und Punkte-Einlösungen wieder gutgeschrieben werden. Dazu müssen Gutschriften ...