Belohnungssystem

Begriffserläuterung

So funktioniert's

Mit dem Belohnungssystem können Sie die Nutzer dazu anregen, im Shop mit echter Währung einzukaufen. Wenn Nutzer einem Clan angehören, tragen ihre Einkäufe zu Wertpunkten für den gesamten Clan bei.

Sie können individuelle Belohnungsketten und Belohnungsketten für Clans erstellen und Nutzern Belohnungen für gekaufte Artikel gewähren. Das Spiel kann mehrere Belohnungsketten beliebigen Typs enthalten. Jede Kette kann bis zu 31 Schritte umfassen. Für jeden Schritt legen Sie die Anzahl der Wertpunkte fest, die zum Abschluss des Schrittes erforderlich sind.

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

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

Um sicherzustellen, dass das Belohnungssystem korrekt funktioniert, muss die Benutzerauthentifizierung konfiguriert werden. Für nicht authentifizierte Nutzer werden sowohl individuelle Belohnungsketten als auch Belohnungsketten des Clans ohne Fortschritt angezeigt. Authentifizierte Nutzer, die nicht Mitglied eines Clans sind, sehen nur ihre individuelle Belohnungskette. Belohnungsketten des Clans werden als nicht verfügbar angezeigt.

Ablauf für den Nutzer

1. Der Nutzer navigiert zur Website.
2. Der Nutzer sieht den Artikelkatalog, das Belohnungssystem und die Anzahl der für jeden Artikel verfügbaren Wertpunkte.
3. Der Nutzer meldet sich an.
4. Der Nutzer kann nun seinen aktuellen Fortschritt im Belohnungssystem sehen.
5. Der Nutzer tätigt einen Kauf und schreitet in der Belohnungskette voran.

Wie komme ich dazu

Beim Einrichten eines Belohnungssystems ist Folgendes festzulegen:

• Start- und Enddatum des Belohnungssystems

• ein Bild, Beschreibung, SKUs und Namen der Wertpunkte, die einen Fortschritt in der individuellen Belohnungskette und der Belohnungskette des Clans ermöglichen
• die Anzahl von Wertpunkten
• Artikel in der Belohnungskette

Siehe folgendes Beispiel.

Belohnungskette:

Beschreibung	Beispiel
Name	Scherbe
Erläuternder Text	Sammle die Scherben, um dir die Belohnungen zu sichern.
SKU	BeispielSKU003
Bild oder zugehörige URL

Implementieren Sie Folgendes:

• Anzeige der Belohnungssystem-Elemente im Store:
  • wie viele Wertpunkte für den Kauf von Artikeln im Katalog vergeben werden
  • Wertpunkte
  • Schritte
  • Belohnungsketten
  • wie viele Wertpunkte der autorisierte Nutzer besitzt
  • Belohnungen
• Senden der Daten des Clans des Benutzers an Xsolla Login

Über Kundenportal einrichten

Bevor Sie eine Belohnungskette erstellen, müssen Sie Wertpunkte, Belohnungen und Artikel, die Nutzer und der Clan kaufen und damit Wertpunkte verdienen können, erstellen.

Wertpunkte erstellen

Um Wertpunkte zu erstellen:

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

3. Legen Sie folgende Parameter fest:
   • Fügen Sie ein Bild hinzu (optional).
   • Geben Sie eine eindeutige SKU für die Wertpunkte ein.
   • Geben Sie an, ob die Wertpunkte für einen Clan verwendet werden sollen
   • Geben Sie einen Namen für die Wertpunkte an.

4. Klicken Sie auf Weiter.
5. Wählen Sie die SKU des virtuellen Gegenstands und legen Sie die Anzahl der Wertpunkte fest, die der Nutzer pro Kauf erhalten wird.
6. Klicken Sie auf +, um die erforderliche Anzahl der Artikel hinzuzufügen.
7. Klicken Sie auf Speichern.

Die erstellten Wertpunkte werden oberhalb der Belohnungsketten angezeigt. Clan-Wertpunkte sind entsprechend gekennzeichnet. Um die Einstellungen für einen bestimmten Wertpunkt zu ändern, klicken Sie auf Bearbeiten in der entsprechenden Zeile.

Belohnungskette erstellen

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. Wenn Sie eine individuelle Belohnungskette wählen:
   1. Legen Sie den Namen der Belohnungskette fest.
   2. Geben Sie eine Beschreibung ein.
   3. 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:
   1. Schrittname.
   2. Erforderliche Anzahl von Wertpunkten, um die Belohnung zu erhalten.
   3. Erforderliche Anzahl von virtuellen Gegenständen für den
8. Klicken Sie auf Weiter.

9. So personalisieren Sie eine Belohnungskette:

   1. Aktivieren Sie den Schalter Personalisierte Belohnungskette.
   2. Wählen Sie eine der Anzeigeoptionen für Ketten und klicken Sie Weiter:
      • Belohnungskette bestimmten Benutzern anzeigen. Wenn diese Option aktiviert ist, wird die Kette nur für autorisierte Benutzer angezeigt, die die angegebenen Bedingungen erfüllen.
      • Belohnungskette Benutzern anzeigen, die die Bedingungen nicht erfüllen. Wenn diese Option aktiviert ist, wird die Kette nur angezeigt, wenn keine passende Belohnungskette für den Benutzer gefunden wird - zum Beispiel, wenn der Benutzer nicht autorisiert ist oder seine Attribute keiner personalisierten Kette entsprechen.
   3. Wenn Sie ausgewählt haben, dass die Kette für bestimmte Benutzer angezeigt werden soll:
      1. Klicken Sie Bedingung hinzufügen und richten Sie die Personalisierungsbedingungen ein:
         • Benutzeratribut ist eine Charakteristik des Benutzers, so wie Land oder Alter. Attribute werden im Bereich Login konfiguriert.
         • Attributtyp definiert das Format des Attributwerts: String, Zahl oder Datum.
         • Der Vergleichsoperator bestimmt, wie der Benutzerattributwert mit der bestimmten Bedingung verglichen wird - zum Beispiel, ist gleich, größer als, kleiner als oder enthält.
         • Attributwert ist der bestimmte Wert, der für den Vergleich verwendet wird. Wenn zum Beispiel das Benutzerattribut „Alter“ ist, der Attributtyp „Zahl“, der Vergleichsoperator „größer als“ und der Attributwert „18“ ist, wird die Kette nur Benutzern über 18 angezeigt.
      2. Um eine weitere Personalisierungsbedingung hinzuzufügen, klicken Sie auf Bedingung hinzufügen.
   4. Klicken Sie Weiter.

10. Erstellen Sie die erforderliche Anzahl von Schritten und klicken Sie Speichern.

11. Klicken Sie auf Weiter.
12. Legen Sie den Gültigkeitszeitraum der Belohnungskette fest.
13. Wenn Sie möchten, dass die Belohnungskette zu einem bestimmten Zeitpunkt erneuert wird, schalten Sie die Option Belohnungskette erneuern auf Ein und legen Sie den Aktualisierungsmodus fest.

14. Klicken Sie auf Speichern.

1. Im Belohnungskatalog wählen Sie die Belohnungskette.
2. Klicken Sie auf •••, und wählen Sie aus der Drop-down-Liste die Option Aktivieren aus.

Belohnungssystem-Block einrichten

So fügen Sie einen Belohnungssystem-Block zu einer Seite im Site Builder:

1. Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zum Menüpunkt Storefronts > Websites.
2. Klicken Sie bei der gewünschten Website auf Site Builder öffnen.

3. Klicken Sie in der Seitenvorlage auf Block hinzufügen.
4. Wählen Sie die Option Belohnungssystem aus der Liste der Blöcke aus.

5. Wählen Sie in der Drop-Down-Liste eine in Shop Builder konfigurierte Belohnungskette.

6. Passen Sie die Schaltflächen- und Textfarben an (optional).
7. Klicken Sie oben rechts im Baukasten auf Vorschau, um Ihr Belohnungssystem zu prüfen. Klicken Sie auf Veröffentlichen, um die Website zu veröffentlichen.

Über API-Aufrufe einrichten

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

1. Erstellen Sie Wertpunkte, die über die API Wertpunkte erstellen Zugang zu Belohnungen gewähren.
2. Weisen Sie Wertpunkte bestimmten Artikeln über die API Wertpunkte für Artikel festlegen zu - Nutzer erhalten diese Punkte, nachdem Sie Artikel gekauft haben.

3. Erstellen Sie ein Belohnungssystem mithilfe der API Belohnungskette erstellen. Um eine personalisierte Belohnungskette zu erstellen, übermitteln Sie die Anzeigebedingung in den Array attribute_conditions.

   Sie können selbst festlegen, ob eine personalisierte Belohnungskette einem Nutzer angezeigt wird, der in der Bedingung keine Attribute definiert hat. Dazu übermitteln Sie true im Parameter can_be_missing.

   Sie könne auch eine Belohnungskette definieren, die einem Nutzer angezeigt wird, wenn keine passende personalisierte Kette gefunden wurde. Dazu übermitteln Sie false im Parameter is_always_visible.

4. Aktivieren Sie das Belohnungssystem über die API Belohnungskette umschalten.

Sie können das Belohnungssystem auch modifizieren, deaktivieren oder löschen und die Wertpunkte von den Artikeln entfernen.

Möglichkeiten der Anzeige des Belohnungssystems in der Store-Benutzeroberfläche

Möglichkeiten der Anzeige von Wertpunkten

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.

Festlegung des Clans des Benutzers

Xsolla erstellt keine Clans und speichert keine Informationen über die Clan-Mitglieder. Sie müssen das Clan-System auf Ihrer Seite implementieren und Clan-bezogene Daten über Benutzerattribute übergeben.

So stellen Sie das korrekte Senden und die Bearbeitung der Daten des Clans sicher:

1. Richten Sie das Attributschema in Login ein. Fügen Sie das Attribut clan_id hinzu.

Beispiel eines Attributsschemas in Login:

 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. Implementieren Sie die Daten des Clans des Benutzers:

• 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    "key": "clan_id"
 9  ]
10}

• Wenn die Website eine Autorisierung über Xsolla-Login nutzt, verwenden Sie die API Aktuellen Clan des Benutzers aktualisieren, um den Clan des Benutzers zu aktualisieren.