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.

Werden dieselben Wertpunkte in mehreren Belohnungskette verwendet:

• wird das Punkteguthaben auf alle Ketten verteilt, auch auf die neu erstellten 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.
• Die Wertpunkte wird nicht unmittelbar nach Ablauf des Kettenzeitraums zurückgesetzt. Die Zurücksetzung erfolgt stattdessen viermal pro Stunde: um XX:00, XX:15, XX:30 und XX:45 Uhr. Wenn eine Kette beispielsweise um 12:03 Uhr endet, erfolgt die Zurücksetzung um 12:15 Uhr.
  Zwischen Ketten, die dieselben Wertpunkte verwenden, sollten mindestens 15 Minuten liegen – andernfalls bleibt keine Zeit, das Guthaben zurückzusetzen, und die Nutzer beginnen die neue Kette mit ihrem vorherigen Guthaben. Wenn Sie den Fortschritt sofort zurücksetzen möchten, verwenden Sie den API-Aufruf Belohnungskette zurücksetzen.

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

Um Wertpunkte zu erstellen:

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:

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.

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:

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 einrichten

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 einrichten

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

Funktionsweise

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.

Beispiel einer Belohnungskette mit Wertpunkten, die pro Kauf verdient werden:

Glossar

Voraussetzungen

Stellen Sie sicher, dass Ihr Shop Artikel enthält, die Nutzer kaufen können, um Wertpunkte zu verdienen.

Bevor Sie eine Clan-Belohnungskette erstellen, richten Sie Benutzerclans ein.

Wertpunkte erstellen

Um Wertpunkte zu erstellen:

2. Klicken Sie im Bereich der Wertpunkteliste auf das +-Symbol.

3. Wählen Sie einen Wertpunkttyp — Individuelle Wertpunkte oder Clan-Wertpunkte. Der Wertpunkttyp wird beim Erstellen festgelegt und kann danach nicht mehr geändert werden.

4. Bild hinzufügen (optional).

5. Namen eingeben.

6. Geben Sie eine eindeutige Wertpunkt-SKU ein.

7. Klicken Sie auf Weiter.

8. Wertpunkte zuweisen:

   1. Klicken Sie auf Betroffenes Element hinzufügen.

   2. Wählen Sie die Artikel aus und geben Sie an, wie viele Wertpunkte Nutzer für den Kauf jedes Artikels erhalten.

   3. Klicken Sie auf Auswählen.

   Wenn Ihr Shop noch keine Artikel enthält, können Sie die aktuellen Einstellungen speichern und später zu diesem Schritt zurückkehren.

9. Klicken Sie auf Weiter.

10. Überprüfen Sie die Wertpunkteinstellungen.

11. Klicken Sie auf Erstellen.

Belohnungskette erstellen

Um eine Belohnungskette zu erstellen:

2. Fahren Sie mit der Erstellung von Belohnungen auf eine der folgenden Arten fort:
   1. Klicken Sie in der Symbolleiste auf das +-Symbol und wählen Sie Belohnungskette.
   2. Klicken Sie im Bereich der Belohnungskettenliste auf das +-Symbol.
   3. Öffnen Sie das Kontextmenü irgendwo auf der Leinwand und wählen Sie Belohnungskette.

3. Wählen Sie einen Kettentyp — Individuelle Belohnungskette oder Clan-Belohnungskette. Der Belohnungskettentyp wird beim Erstellen festgelegt und kann danach nicht mehr geändert werden.

4. Geben Sie die grundlegenden Kettenparameter an:

   1. Wenn Sie eine individuelle Belohnungskette wählen:
   2. Geben Sie den Namen der Belohnungskette an.
   3. Geben Sie eine Beschreibung ein.
   4. Wenn Sie eine Clan-Belohnungskette wählen:
      1. Wählen Sie in der Clan-Typ Drop-down-Liste einen Clantyp aus.
      2. Geben Sie den Namen der Belohnungskette an.
      3. Geben Sie eine Beschreibung ein.
      4. Geben Sie einen Titel für den Popup-Header der Belohnungskette an.
      5. Geben Sie den Tooltip-Text an (was Nutzer tun müssen, um Belohnungen für ihren Clan zu verdienen).
      6. Fügen Sie ein Belohnungspopup-Bild hinzu (optional).

5. Klicken Sie auf Weiter.

6. Richten Sie Wertpunkte ein — neue Wertpunkte erstellen oder aus bestehenden auswählen.

7. Klicken Sie auf Weiter.

8. Fügen Sie für jeden Schritt der Kette eine Belohnung hinzu. Um eine Belohnung für einen einzelnen Schritt hinzuzufügen:

   1. Klicken Sie auf Neuen Schritt hinzufügen.

   2. Wählen Sie die Artikel aus, die Nutzer als Belohnung für diesen Schritt erhalten, und geben Sie die Menge für jeden Artikel an.

   3. Klicken Sie auf Artikel hinzufügen.

9. Geben Sie in der Liste der Schritte die erforderliche Anzahl von Wertpunkten an, um die Belohnung zu beanspruchen. Die Wertpunkte, die jedem nachfolgenden Schritt zugewiesen werden, müssen höher sein als die des vorherigen. Das maximale Limit beträgt 100 000 Wertpunkte pro Schritt.

10. Um die Reihenfolge der Belohnungen in der Kette zu ändern, ziehen Sie die Zeile mit dem ☰-Symbol an die gewünschte Position (optional).

11. Nachdem Sie Belohnungen für jeden Schritt hinzugefügt haben, klicken Sie auf Weiter.

12. Legen Sie den Gültigkeitszeitraum der Belohnungskette fest: eine Zeitzone, ein Startdatum und ein Enddatum. Wenn Sie das Ende des Gültigkeitszeitraums nicht angeben möchten, aktivieren Sie das Kontrollkästchen Kein Enddatum.

Hinweis

Um einen weiteren Gültigkeitszeitraum für die Belohnungskette hinzuzufügen, klicken Sie auf Zeitraum hinzufügen. Wenn eine Kette mehrere Gültigkeitszeiträume hat, muss jeder ein Enddatum haben. Die Kette endet in der letzten Sekunde der angegebenen Minute. Wenn beispielsweise eine Endzeit auf 12:00 Uhr festgelegt ist, läuft die Kette bis 12:00:59 Uhr.

Wenn Sie die gleichen Wertpunkte für mehrere Belohnungsketten verwenden, lassen Sie mindestens 15 Minuten zwischen dem Ende eines Kettenzeitraums und dem Beginn des nächsten. Wertpunkte und Schrittfortschritt werden durch einen Hintergrundjob zurückgesetzt, der jede Stunde um :00, :15, :30 und :45 läuft (nicht genau zum Ende des Zeitraums). Wenn der nächste Zeitraum früher beginnt als einer dieser Zeiten, könnten Nutzer noch ihr vorheriges Guthaben haben. Wenn Sie den Schrittfortschritt sofort zurücksetzen möchten, rufen Sie die Reset-Belohnungskette API-Methode auf.

13. Um den Fortschritt in der Belohnungskette automatisch zurückzusetzen, aktivieren Sie den Wertpunkte zurücksetzen Schalter.

14. Wenn Sie möchten, dass die Belohnungskette zu einem bestimmten Zeitpunkt erneuert wird, aktivieren Sie den Belohnungskette erneuerbar machen Schalter und geben Sie den Aktualisierungszeitplan an.

15. Wenn Sie die Belohnungskette personalisieren möchten:

    1. Aktivieren Sie den Personalisierte Belohnungskette Schalter.

    2. Wählen Sie eine der Kettenanzeigeoptionen:

       • An berechtigte Nutzer anzeigen — in diesem Fall wird die Kette nur autorisierten Nutzern angezeigt, die die angegebenen Bedingungen erfüllen.

       • An nicht berechtigte Nutzer anzeigen — für eine solche Kette müssen Sie die Personalisierungsbedingungen nicht angeben — sie wird standardmäßig angewendet. Das bedeutet, dass sie nicht autorisierten Nutzern angezeigt wird, sowie in Fällen, in denen keine passende personalisierte Belohnungskette für den autorisierten Nutzer gefunden wird.

    3. Wenn Sie die Option An berechtigte Nutzer anzeigen auswählen, geben Sie die Bedingung an:

       1. Geben Sie den Benutzereigenschaftstyp an — Zeichenfolge, Zahl oder Datum.

       2. Wählen Sie die Benutzereigenschaft aus der Drop-down-Liste aus.

       3. Wählen Sie den Vergleichsoperator.

       4. Geben Sie den Wert der Benutzereigenschaft an.

    4. Um weitere Bedingungen hinzuzufügen, klicken Sie auf Bedingung hinzufügen und füllen Sie die angezeigten Felder aus (optional).

16. Klicken Sie auf Weiter.

17. Überprüfen Sie die Kette.

18. Um die Kette sofort zu aktivieren (optional), aktivieren Sie den Im aktiven Status erstellen Schalter.

19. Klicken Sie auf Erstellen.

20. Um die erstellte Belohnungskette zur Website hinzuzufügen (optional):

    1. Öffnen Sie die Website im Builder, indem Sie auf Öffnen oder Im Site Builder öffnen im Banner im Bearbeitungsformular klicken.
    2. Befolgen Sie die Anweisungen im Abschnitt Anzeige des Belohnungssystems.

Hinweis

Aktive Ketten können nicht bearbeitet werden. Um die Einstellungen einer Werbeaktion zu ändern, deaktivieren Sie sie zuerst.

Sie können die Kette auf folgende Weise aktivieren oder deaktivieren:

• Von der Belohnungskartenkarte
• Von der Belohnungskettenliste
• Während der Bearbeitung der Kette

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:

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 einrichten

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 einrichten

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