Belohnungskette erstellen

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:

1. Öffnen Sie Ihr Projekt im Kundenportal und gehen Sie zum Abschnitt LiveOps > Canvas.

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:

1. Öffnen Sie Ihr Projekt im Kundenportal und gehen Sie zum Abschnitt LiveOps > Canvas.
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.

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:

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