Belohnungssystem

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

Belohnungssystem einrichten

Über Kundenportal einrichten

Bevor Sie eine Belohnungskette erstellen, müssen Sie Wertpunkte, Belohnungen sowie Artikel, die die Nutzer und der Clan kaufen können und dafür Wertpunkte erhalten, erstellen.

Navigieren Sie in Ihrem Kundenportal-Projekt zum Menüpunkt Artikelkatalog > Alle Artikel, um Artikel manuell zu erstellen. Ausführliche Informationen zu dieser und anderen Methoden zum Erstellen von Artikeln finden Sie im Abschnitt Artikelkatalog der Dokumentation.

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.

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:
   • Schrittname.
   • Erforderliche Anzahl von Wertpunkten, um die Belohnung zu erhalten.
   • Erforderliche Anzahl von virtuellen Gegenständen für den Schritt.
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 folgenden Optionen für die Anzeige der Kette aus, und klicken Sie danach auf Weiter:
       • Belohnungskette für bestimmte Benutzer anzeigen: Legen Sie die Personalisierungsbedingungen fest. Die Kette wird nur autorisierten Nutzern angezeigt, die die festgelegten Bedingungen erfüllen.
       • Belohnungskette Benutzern anzeigen, die die Bedingungen nicht erfüllen: Die Kette wird nur angezeigt, wenn keine passende Belohnungskette für den Nutzer gefunden wird – beispielsweise wenn der Nutzer nicht autorisiert ist oder seine Attribute zu keinen Bedingungen einer personalisierten Kette passen.

11. Klicken Sie auf Weiter.
12. Legen Sie den Gültigkeitszeitraum der Belohnungskette fest.
13. Sie können den Schalter Zeitlimit festlegen aktivieren und so für die Belohnungskette ein Enddatum und eine Enduhrzeit festlegen.
14. Damit der Fortschritt der Belohnungskette automatisch zurückgesetzt wird, müssen Sie das Kontrollkästchen Nutzerfortschritt nach Ende der Kette zurücksetzen aktivieren.
15. 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.

16. 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

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.

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. 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.
4. Wählen Sie die Option Belohnungssystem aus.
5. Wählen Sie in der Drop-down-Liste die gewünschte Belohnungskette aus.

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

8. 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.