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

Implementieren Sie die folgenden API-Methoden, um das Belohnungssystem einzurichten:

• Virtuellen Gegenstand abrufen
• Belohnungsketten des aktuellen Benutzers abrufen
• Abrufen des Wertpunktesaldos des aktuellen Benutzers
• Belohnung für den Schritt beanspruchen
• Aktuellen Clan des Benutzers aktualisieren
• Die Top-10 zur Belohnungskette Beitragsleistenden in den Clan aufnehmen

Definieren Sie den Clan des Nutzers

Wenn Sie Xsolla Site Builder nicht verwenden, werden Sie den Clan des Nutzers in die Benutzerattribute übermitteln müssen, damit die Belohnungskette des Clans korrekt funktioniert.

So weisen Sie ein Attribut mit einem Clan zu einem Nutzer zu: Verwenden Sie die Attributaktualisierungsmethode und übermitteln sie den Array attributes mit dem Clan-Wert im Anfrage-Body.

Beispiel:

 1{
 2  "attributes": [
 3    {
 4      "key": "clan_id",
 5      "value": "beetles"
 6    }
 7  ],
 8  "publisher_id": 123456,
 9  "publisher_project_id": 123456
10}

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

Sie können auch den aktuellen Clan des Nutzers mithilfe der API aktualisieren. Zuerst aktualisieren Sie die Benutzerattribute im Xsolla-Login, anschließend rufen Sie die APIDen Clan des aktuellen Nutzers aktualisieren auf. 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. Die Antwort dieser Methode enthält die Belohnungen, die der Nutzer bereits beansprucht hat.

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

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