Belohnungssystem

So funktioniert's

Das Belohnungssystem motiviert die Nutzer dazu, im Shop mit Echtgeld einzukaufen. Bei jedem Kauf erhalten die Nutzer Wertpunkte und durchlaufen dabei eine Belohnungskette. Sind die Nutzer Mitglied eines Clans, fließen ihre Wertpunkte dem gesamten Clan zu.

Belohnungsketten

Sie können individuelle Belohnungsketten und Clan-Belohnungsketten erstellen und Nutzern Belohnungen für gekaufte Artikel gewähren. Im Projekt können mehrere Belohnungsketten beliebigen Typs festgelegt sein. Jede Kette kann bis zu 31 Schritte umfassen. Für jeden Schritt legen Sie die Anzahl der Wertpunkte fest, die zum Erhalt einer Belohnung erforderlich sind.

Sie können auch eine personalisierte Belohnungskette erstellen. Durch die Personalisierung wird die Kette nur einer bestimmten Gruppe angezeigt, die aufgrund ihrer Attribute dazu berechtigt ist. Eine personalisierte Belohnungskette kann sowohl für einen einzelnen Nutzer als auch für einen Clan erstellt werden.

Wertpunkte

Der Fortschritt eines Nutzers in einer Belohnungskette wird durch Wertpunkte bestimmt. Es gibt zwei Arten von Wertpunkten: individuelle und Clan-Wertpunkte – entsprechend den verschiedenen Belohnungskettentypen.

Das Wertpunkteguthaben ist an die Wertpunkte selbst gebunden, nicht an eine bestimmte Belohnungskette. Werden dieselben Wertpunkte in mehreren Belohnungskette verwendet:

• wird das Punkteguthaben auf alle Ketten verteilt, einschließlich neu erstellter Ketten;
• behalten in einer neu erstellten Kette die Nutzer ihre zuvor gesammelten Punkte;
• wird durch das Zurücksetzen der Kette das Punkteguthaben in allen Ketten gelöscht, die sich die bestehenden Wertpunkte teilen. Der Fortschritt (die abgeschlossenen Schritte) wird nur in der angegebenen Kette zurückgesetzt.

Das Clan-Guthaben ergibt sich aus der Summe der Guthaben aller Clan-Mitglieder. Daher wird das Clan-Guthaben nach dem Zurücksetzen ebenfalls auf null gesetzt.

Belohnungen

Bei jedem Schritt in der Belohnungskette, kann ein Nutzer zwischen 1 und 10 Belohnungen erhalten. Ein Clan kann somit zwischen 1 und 10 Belohnungen pro Mitglied und Schritt erhalten.

Sie können die Nutzer mit folgenden Artikelarten belohnen:

• virtuelle Gegenstände
• virtuelle Währung
• virtuelle Währungspakete
• Bundles

Belohnungssystem einrichten

Sie können das Belohnungssystem im Kundenportal oder über die API konfigurieren:

1. Erstellen Sie Wertpunkte. Stellen Sie sicher, dass Ihr Shop Artikel enthält, für die Nutzer beim Kauf Wertpunkte erhalten.
2. Erstellen Sie eine Belohnungskette.

Über Kundenportal einrichten

Um Wertpunkte zu erstellen:

1. Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zum Menüpunkt LiveOps > Belohnungen.
2. Klicken Sie auf Wertpunkte erstellen.

3. Legen Sie die folgenden Parameter fest:
   • Fügen Sie ein Bild hinzu (optional).
   • Vergeben Sie einen Namen.
   • Geben Sie eine eindeutige SKU ein.
   • Wenn Sie Clan-Wertpunkte erstellen möchten, aktivieren Sie die Option Als Clan-Wertpunkte verwenden. Diese Einstellung kann nach der Erstellung der Wertpunkte nicht mehr geändert werden.
   • Weisen Sie die Wertpunkte zu: Wählen Sie die Artikel aus und legen Sie fest, wie viele Wertpunkte Nutzer für den Kauf jedes Artikels erhalten. Sollten in Ihrem Shop noch keine Artikel vorhanden sein, können Sie die aktuellen Einstellungen speichern und später zu diesem Schritt zurückkehren.

4. Klicken Sie bei Bedarf auf Zeile hinzufügen, um weitere Positionen zu ergänzen.
5. Klicken Sie auf Wertpunkte erstellen.

Um die Einstellungen für einen bestimmten Wertpunkt zu ändern, müssen Sie in der entsprechenden Zeile auf Bearbeiten klicken.

So erstellen Sie eine Belohnungskette:

1. Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zum Menüpunkt LiveOps > Belohnungen.
2. Klicken Sie auf Belohnung erstellen.

3. Wählen Sie den Typ der Neuen Belohnungskette — individuelle Belohnungskette oder Belohnungskette des Clans.
4. Legen Sie die folgenden Parameter. Bei individuellen Belohnungsketten:
   • Vergeben Sie einen Namen für die Belohnungskette.
   • Geben Sie eine Beschreibung ein.
   • Wählen Sie in der Drop-Down-Liste Wertpunkte aus.

Wenn Sie die Belohnungskette des Clans wählen:
1. Wählen Sie in der Drop-Down-Liste Clan-Typ, wählen Sie einen Typ eines Clans.
2. Richten Sie die Parameter der Belohnungskette des Clans ein:
   1. Legen Sie den Namen der Belohnungskette fest.
   2. Geben Sie eine Beschreibung ein.
   3. Legen Sie einen Titel für den Popup-Header der Belohnungskette fest.
   4. Legen Sie den Text für den Popup-Hinweis fest (was die Nutzer tun müssen, um Belohnungen für Ihren Clan zu verdienen).
   5. Fügen Sie ein Bild hinzu (optional).
   6. Wählen Sie in der Drop-Down-Liste Wertpunkte aus.

5. Klicken Sie auf Weiter.
6. Klicken Sie auf Neuen Schritt hinzufügen.
7. Legen Sie die folgenden Parameter fest und klicken Sie auf Speichern:
   • Schrittname.
   • Erforderliche Anzahl von Wertpunkten, um die Belohnung zu erhalten.
   • Erforderliche Anzahl von virtuellen Gegenständen für den
8. Klicken Sie auf Speichern.

9. Ergänzen Sie die erforderliche Anzahl von Schritten, und klicken Sie auf Weiter.
10. So personalisieren Sie die Belohnungskette:

1. Aktivieren Sie den Schalter Personalisierte Belohnungskette.
2. Wählen Sie eine der Optionen für die Kettenanzeige aus:
   • Belohnungskette bestimmten Nutzern anzeigen: Legen Sie die Personalisierungsbedingungen fest. In diesem Fall wird die Kette nur autorisierten Nutzern angezeigt, die die festgelegten Bedingungen erfüllen.
   • Belohnungskette Nutzern anzeigen, die die Bedingungen nicht erfüllen: Bei einer solchen Kette müssen Sie keine Personalisierungsbedingungen festlegen. Die Kette wird sowohl nicht autorisierten Nutzern angezeigt als auch in Fällen, in denen für den autorisierten Nutzer keine passende Belohnungskette gefunden wurde.
3. Klicken Sie auf Weiter.

11. Legen Sie den Gültigkeitszeitraum der Belohnungskette fest: Zeitzone, Start- und Enddatum. Um eine Belohnungskette ohne Enddatum zu erstellen, müssen Sie das Kontrollkästchen Kein Enddatum aktivieren.

Hinweis

Klicken Sie auf +, um einen weiteren Gültigkeitszeitraum hinzuzufügen. Wenn für eine Belohnungskette mehrere Gültigkeitszeiträume festgelegt sind, muss jeder davon ein Enddatum haben. Die Belohnungskette endet nach Verstreichen der letzten Sekunde der angegebenen Minute. Wenn beispielsweise als Enduhrzeit 12:00 Uhr festgelegt ist, läuft die Belohnungskette bis 12:00:59 Uhr.

12. Damit der Fortschritt der Belohnungskette automatisch zurückgesetzt wird, müssen Sie das Kontrollkästchen Nutzerfortschritt nach Ende der Kette zurücksetzen aktivieren.
13. Wenn Sie möchten, dass die Belohnungskette zu einem bestimmten Zeitpunkt zurückgesetzt wird, müssen Sie den Schalter Belohnungskette regelmäßig neu starten aktivieren und den Modus festlegen.

14. Klicken Sie auf Erstellen.

1. Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zum Menüpunkt LiveOps > Belohnungen.
2. Klicken Sie in der Zeile der gewünschten Kette auf •••, und wählen Sie dann Aktivieren aus der Dropdown-Liste aus.

Über die API einrichten

Sie können die Methoden aus der Untergruppe Verwaltung der Methodengruppe Belohnungsketten und Wertpunkte nutzen, um das Belohnungssystem zu verwalten.

Belohnungssystem anzeigen

Anzeige über Site Builder

Damit das Belohnungssystem korrekt funktioniert, muss die Benutzerauthentifizierung konfiguriert sein. Nicht autorisierten Nutzern werden sowohl individuelle als auch Clan-Belohnungsketten ohne Fortschritt angezeigt.

Autorisierten Nutzern, die keinem Clan angehören, werden nur individuelle Belohnungsketten angezeigt. Clan-Belohnungsketten werden als nicht verfügbar angezeigt.

So zeigen Sie Belohnungsketten auf Ihrer Website an:

1. Navigieren Sie im Kundenportal zum Menüpunkt Storefronts > Websites.
2. Wählen Sie die gewünschte Website aus, und klicken Sie auf Site Builder öffnen.
3. Wenn Ihre Website mehrere Seiten umfasst, wählen Sie die gewünschte Seite aus:
   1. Klicken Sie oben im Editor auf den Titel der aktuellen Seite.
   2. Wählen Sie die gewünschte Seite aus der Drop-down-Liste aus.
4. Wählen Sie im Hauptfenster des Baukastens eine Stelle, an der Sie einen neuen Block hinzufügen möchten, und klicken Sie auf Block hinzufügen.
5. Wählen Sie die Option Belohnungssystem aus.

6. Wählen Sie in der Drop-down-Liste die gewünschte Belohnungskette aus.

7. Passen Sie die Schaltflächen- und Textfarben an (optional).
8. Um eine Vorschau der Kette anzuzeigen, klicken Sie in der oberen rechten Ecke des Site Builders auf Vorschau.

9. Veröffentlichen Sie Ihre Website, um die Änderungen anzuwenden:
   1. Klicken Sie in der oberen rechten Ecke des Site Builders auf Veröffentlichen.
   2. Aktivieren Sie die Kontrollkästchen neben den Seiten, die Sie veröffentlichen wollen.
   3. Klicken Sie Veröffentlichen.

Einzelheiten zu Wertpunkten in Site Builder anzeigen

Sie können mehrere Belohnungsketten innerhalb eines einzelnen Blocks auswählen und festlegen, wie sie dargestellt werden - entweder untereinander oder in Registerkarten. Sie können die Erscheinung jeder Belohnungskette einzeln anpassen.

Artikelkarten zeigen Wertpunkte nur für jene Belohnungsketten angezeigt, die zur Website hinzugefügt wurden. Beim Kauf von Artikeln erhalten Clan-Mitglieder jedoch Wertpunkte für alle aktiven Belohnungsketten, unabhängig davon, ob diese auf der Website angezeigt werden.

Beispiel:

Es gibt zwei Konfigurationen für Belohnungsketen: eine individuelle Belohnungskette und eine Belohnungskette des Clans. Die individuelle Kette verfügt über einen Wertpunkt namens Crystal und die Clan-Kette verfügt über einen Wertpunkt namens Magic Bubble.

Im Artikelkatalog befindet sich ein Artikel namens Sword mit zugewiesenen Wertpunkten. Wenn ein Clan-Mitglied diesen Artikel kauft, erhält er 20 Crystals und 40 Magic Bubbles.

Wenn Sie den Store-Block im Builder hinzufügen und den Typ und die Artikelgruppe auswählen, die den Artikel Sword enthalten:

1. Wenn keine Belohnungskette zur Website hinzugefügt wurde, wird der Artikel Sword keine Wertpunkte anzeigen.
2. Wenn nur eine individuelle Belohnungskette hinzugefügt wurde und aktiv ist, wird der Artikel Sword nur 20 Crystals anzeigen.
3. Wenn nur eine Belohnungskette des Clans hinzugefügt wurde und aktiv ist, wird der Artikel Sword nur 40 Magic Bubbles anzeigen.
4. Wurde sowohl die individuelle Belohnungskette als auch die Belohnungskette des Clans hinzugefügt und beide sind aktiv, wird der Artikel Sword sowohl 20 Crystals als auch 40 Magic Bubbles anzeigen.

Bei Clan-Mitgliedern wird 40 Magic Bubbles als aktiver Wert angezeigt.

Bei Benutzern ohne Clan wird 40 Magic Bubbles als gesperrter Wert angezeigt.

Belohnungsketten über API-Aufrufe anzeigen

1. Implementieren Sie auf der Benutzeroberfläche Ihrer Anwendung die Elemente für die Anzeige der Belohnungskettenschritte.
2. Implementieren Sie die Logik für die Arbeit mit Ketten mithilfe der folgenden clientseitigen API-Aufrufe aus der Gruppe Belohnungsketten und Wertpunkte:

3. Stellen Sie sicher, dass die Artikel dem Nutzer ordnungsgemäß gewährt werden.

Clan des Nutzers einrichten

Wenn Sie Site Builder nicht verwenden, müssen Sie den Clan des Nutzers in Xsolla Login übermitteln, damit die Belohnungskette des Clans korrekt funktioniert. Gehen Sie dazu wie folgt vor:

1. Richten Sie das Attributschema in Xsolla Login ein.

 1{
 2	"$schema": "https://json-schema.org/draft/2020-12/schema",
 3	"additionalProperties": false,
 4	"description": "JSON Schema example for user attributes. Not the actual schema.",
 5	"properties": {
 6
 7		"clan_id": {
 8			"description": "name of clan",
 9			"type": "string"
10		},
11		"custom-id": {
12			"description": "custom-id of a user.",
13			"type": "number"
14		},
15		"had_ban": {
16			"description": "Whether the user was banned.",
17			"type": "boolean"
18		},
19		"last_purchase": {
20			"description": "Date of user's last purchase.",
21			"type": "string"
22		},
23	},
24	"required": [],
25	"title": "Example",
26	"type": "object"
27}

2. Verwenden Sie die Methoden der Attributaktualisierung und übermitteln Sie das Array attributes mitsamt dem Clan-Wert clan_id im Anfragerumpf, um das Attribut clan_id hinzuzufügen oder zu aktualisieren.

 1{
 2  "user": {
 3    "id": "1234567890",
 4    "picture": "https://example.com",
 5    "name": "test-name"
 6  },
 7  "attributes": [
 8    {
 9     "key": "clan_id",
10     "value": "beetles"
11    }
12  ]
13}

Wenn Sie eingerichtet haben, dass Nutzer über Xsolla Login autorisiert werden, müssen Sie den API-Aufruf Den Clan des aktuellen Nutzers aktualisieren aufrufen, um den Clan des Nutzers zu aktualisieren. Wenn die Attribute einen neuen Clan enthalten, erhält der Nutzer alle nicht beanspruchten Belohnungen aus der Belohnungskette des vorherigen Clans, und seine Clan-Zugehörigkeit wird aktualisiert. Wenn der Nutzer zuvor Mitglied eines Clans war, aber nicht mehr ist, wird seine Clan-Mitgliedschaft widerrufen. In der Antwort der Methode sind die Belohnungen enthalten, die der Nutzer bereits beansprucht hat.

Einzelheiten für Web Shop anzeigen

Implementieren Sie nach der Konfiguration des Attributschemas die Übermittlung der Clan-Daten des Nutzers.

Bei der Authentifizierung über die Benutzer-ID übermitteln Sie den Clan des Benutzers in der Antwort zum Webhook Webhook für die Benutzervalidierung im Web Shop während der Autorisierung:

• Um die clan_id hinzuzufügen oder zu aktualisieren, übermitteln Sie einen Array von attributes-Objekten mit dem clan_id-Attribut-Schlüssel.

Beispiel einer Webhook-Antwort:

 1{
 2  "user": {
 3    "id": "1234567890",
 4    "picture": "https://example.com",
 5    "name": "test-name"
 6  },
 7  "attributes": [
 8    {
 9     "key": "clan_id",
10     "value": "beetles"
11    }
12  ]
13}

• Wenn der Benutzer den Clan verlassen hat und keinem neuen beigetreten ist, müssen Sie den Wert der clan_id ins Feld removing_keys übermitteln.

Beispiel einer Webhook-Antwort:

 1{
 2  "user": {
 3    "id": "1234567890",
 4    "picture": "https://example.com",
 5    "name": "test-name"
 6  },
 7  "removing_keys": [
 8    {
 9      "key": "clan_id"
10    }
11  ]
12}

Einzelheiten über API anzeigen

Sie können die aktuellen Attributwerte direkt während der Benutzerautorisierung übermitteln, wenn Sie die API Über selbst definierte ID authentifizieren verwenden.