Personalisierung

So funktioniert's

Die Personalisierung ermöglicht es Ihnen, die Bedingungen für die Anzeige des Artikelkatalogs festzulegen und Werbeaktionen nur bestimmten autorisierten Benutzern zugänglich zu machen.

Folgendes ist damit möglich:

• Artikel und Werbeaktionen anbieten, die für bestimmte Nutzer besonders relevant sind
• Nutzer dazu motivieren, ersten Ingame-Kauf zu tätigen

Folgende Personalisierungstypen stehen zur Auswahl:

• Personalisierung aufseiten von Xsolla: Die Personalisierungsregeln und ‑logik werden von Xsolla konfiguriert und bei Xsolla gespeichert. Der Partner sendet Benutzerattribute an Xsolla, und Xsolla erstellt daraufhin den Katalog gemäß der konfigurierten Logik.
• Personalisierung aufseiten des Partners: Die Personalisierungsregeln und ‑logik werden vom Partner konfiguriert und beim Partner gespeichert, der dann einen Katalog für einen bestimmten Benutzer an Xsolla übermittelt.

Befolgen Sie folgende Anweisungen, um eine personalisierte Belohnungskette einzurichten.

Bei jeder Authentifizierungsart (Benutzer-ID oder Xsolla Login) lässt sich eine Personalisierung einrichten.

Personalisierung aufseiten von Xsolla

Ablauf für den Nutzer

1. Ein nicht autorisierter Nutzer ruft den Artikelkatalog auf. Je nach Position des Schalters Nicht autorisierten Nutzern Artikel anzeigen sieht der Nutzer Folgendes:
   • Artikel, für die keine Personalisierungsregeln gelten
   • alle Artikel, einschließlich der Artikel, für die Personalisierungsregeln gelten
2. Der Nutzer klickt auf Anmelden und autorisiert sich über Xsolla-Login oder seine Benutzer-ID.

3. Xsolla fragt Benutzerattribute über Xsolla-Login oder über Webhooks ab.
4. Xsolla zeigt einen personalisierten Katalog an. Die Personalisierung basiert auf den Regeln für die Verfügbarkeit von Artikeln, den bei Xsolla konfigurierten Werbeaktionen und den aus Schritt 3 stammenden Benutzerattributen.

5. Dem Nutzer wird der personalisierte Katalog angezeigt, er klickt auf Jetzt kaufen.

6. Zum Zeitpunkt des Kaufs fragt Xsolla die Attribute des Nutzers erneut ab und gleicht sie mit den Personalisierungsregeln ab:
   • Falls ein Artikel nicht mehr verfügbar ist, wird der Nutzer darüber benachrichtigt.
   • Sofern der Artikel verfügbar ist, kann der Nutzer mit dem Bezahlvorgang fortfahren.

Personalisierten Artikelkatalog einrichten

1. Richten Sie Benutzerattribute ein.
2. Aktivieren Sie die Personalisierung.
3. Legen Sie Kataloganzeigeregeln fest. Das können Sie entweder beim Aktivieren der Personalisierung oder im Kundenportal-Projekt unter LiveOps > Personalisierung > Kataloganzeigeregeln erledigen.

So aktivieren Sie die Personalisierung:

1. Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zum Menüpunkt LiveOps > Personalisierung.
2. Klicken Sie auf Personalisierung einrichten, wenn die Personalisierung nicht konfiguriert ist.
3. Wählen Sie als Typ die Option Personalisierung aufseiten von Xsolla.
4. Klicken Sie auf Weiter.

5. Erstellen Sie eine Kataloganzeigeregel:
   • Wenn noch keine Kataloganzeigeregeln vorhanden sind, öffnet sich automatisch ein entsprechendes Fenster.
   • Wenn bereits Kataloganzeigeregeln festgelegt sind, klicken Sie im Abschnitt Kataloganzeigeregeln auf Regel erstellen.

6. Vergeben Sie einen Namen für die Regel, und definieren Sie die Bedingungen für die Anzeige von Artikeln im Katalog.

7. Damit Artikel, für die Regeln festgelegt sind, nicht autorisierten Nutzern angezeigt werden, müssen Sie den Schalter Nicht angemeldeten Nutzern die betroffenen Artikel anzeigen auf Ein stellen.

8. Klicken Sie auf Weiter.
9. Wählen Sie die Artikel aus, für die die Regel gelten soll.

10. Klicken Sie auf Weiter.
11. Prüfen Sie die Einstellungen. Klicken Sie bei Bedarf auf Bearbeiten, um Änderungen vorzunehmen.

12. Klicken Sie auf Speichern und beenden.

Auf der Seite Kataloganzeigeregeln können Sie Regeln bearbeiten oder löschen. Klicken Sie dazu auf das •••-Symbol neben der entsprechenden Regel, und wählen Sie die gewünschte Option im Menü aus. Wenn Sie eine Regel aktivieren oder deaktivieren möchten, ändern Sie einfach deren Status.

Attribute einrichten

Konfigurieren Sie Benutzerattribute im Login-Produkt und halten Sie die Attributwerte auf dem neuesten Stand: Aktualisieren Sie die Attributwerte in Xsolla, wenn sie sich für den Nutzer im Spiel ändern.

Der Ablauf der Attributaktualisierung hängt von der in Web Shop verwendeten Autorisierungsoption ab.

Personalisierte Werbeaktionen einrichten

Sie können personalisierte Werbeaktionen einrichten, z. B. Benutzern, die ein bestimmtes Level im Spiel erreicht haben, Rabatte beim Kauf virtueller Gegenstände gewähren.

Es ist möglich, eine oder mehrere Bedingungen festzulegen. Beachten Sie, dass Sie eine Werbeaktion nicht ändern können, solange sie aktiv ist. Mehr Informationen über Werbeaktionsarten und Einstellungen finden Sie in der Anleitung Werbekampagnen einrichten.

So richten Sie personalisierte Werbeaktionen ein:

1. Konfigurieren Sie Benutzerattribute im Login-Produkt.
2. Richten Sie eine Bonuskampagne oder eine Rabattkampagne ein. Stellen Sie den Schalter Werbeaktion nur bei bestimmten Benutzern auslösen auf Ein, und legen Sie die Bedingungen fest.

Personalisierung aufseiten des Partners

Dieser Typ eignet sich, wenn Sie eine in Ihrem System implementierte erweiterte Personalisierungslogik verwenden und keine Regeln oder Attribute aufseiten von Xsolla festlegen möchten.

So nutzen Sie die in Ihrem System implementierte Katalogpersonalisierung:

1. Erstellen Sie einen Artikelkatalog bei Xsolla, und synchronisieren Sie ihn mit Ihrem Katalog.

• Für jeden Artikel in Ihrem System müssen Sie einen entsprechenden Artikel bei Xsolla erstellen. Dieser Artikel wird den Nutzern im Katalog angezeigt.

• Der Artikel in Ihrem System muss mit dem Artikel bei Xsolla eentweder über die item_id oder die sku verknüpft sein, die in der Antwort auf den Webhook in Schritt 3 enthalten sein müssen.

2. Aktivieren Sie die Personalisierung im Kundenportal.
3. Richten Sie die Verarbeitung des Webhooks partner_side_catalog (Katalogpersonalisierung aufseiten des Partners) ein.

Ablauf für den Nutzer

1. Ein nicht autorisierter Nutzer ruft den Artikelkatalog auf. Je nach Position des Schalters Nicht angemeldeten Nutzern relevante Artikel anzeigen sieht der Nutzer Folgendes:
   • alle Artikel im Katalog
   • Artikel, die Sie in der Antwort auf den Webhook Katalogpersonalisierung aufseiten des Partners zurückgeben.

Die Reihenfolge, in der die Artikel dem Nutzer angezeigt werden, hängt von der Position des Schalters SKU-Reihenfolge aus Webhook-Antwort abrufen ab.

2. Der Nutzer klickt auf Anmelden und autorisiert sich.

3. Xsolla sendet einen Webhook, der Artikel anhand der Benutzer-ID abfragt.
4. Die Antwort vom Partner enthält eine Liste der SKUs der Artikel, die der Nutzer erwerben kann.
5. Der Nutzer wählt einen Artikel aus dem personalisierten Katalog aus und klickt auf Jetzt kaufen.

6. Die Schritte 3 und 4 dieses Ablaufs werden aufseiten von Xsolla ausgeführt, um die Verfügbarkeit der Artikel zum Zeitpunkt des Kaufs zu prüfen:
   • Falls ein Artikel nicht mehr verfügbar ist, erhält der Nutzer eine entsprechende Meldung.
   • Sofern der Artikel verfügbar ist, kann der Nutzer mit dem Bezahlvorgang fortfahren.

Personalisierten Artikelkatalog einrichten

So aktivieren Sie die Personalisierung:

1. Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zum Menüpunkt LiveOps > Personalisierung.
2. Klicken Sie auf Personalisierung einrichten, wenn die Personalisierung nicht konfiguriert ist.
3. Wählen Sie als Typ die Option Personalisierung aufseiten des Partners.

4. Klicken Sie auf Weiter.
5. Konfigurieren Sie die Artikelanzeige:
   • Nicht angemeldeten Nutzern relevante Artikel anzeigen – ist diese Option aktiviert, werden nicht autorisierten Nutzern alle Artikel angezeigt. Andernfalls sehen nicht autorisierte Nutzer nur die Artikel, die in der Antwort auf den Webhook Katalogpersonalisierung aufseiten des Partners zurückgegeben werden.
   • SKU-Reihenfolge aus Webhook-Antwort abrufen – ist diese Option aktiviert, werden dem Nutzer Artikel in der Reihenfolge angezeigt, die in der Antwort auf den Webhook Katalogpersonalisierung aufseiten des Partners übermittelt werden. Andernfalls werden dem Nutzer die Artikel in der Reihenfolge angezeigt, die bei Xsolla festgelegt ist. Mit dem Parameter order im Unterabschnitt Verwaltung der Gruppe Virtuelle Gegenstände und Währung können Sie die Reihenfolge der angezeigten Artikel aufseiten von Xsolla festlegen oder von Xsolla abzurufen.

6. Klicken Sie auf Änderungen speichern.

Webhook-Verarbeitung einrichten

Xsolla sendet den Webhook Katalogpersonalisierung aufseiten des Partners, der die Nutzer- und Projektparameter enthält, an die Webhook-URL, wenn ein Nutzer mit dem Artikelkatalog interagiert. Richten Sie die Webhook-Verarbeitung ein:

1. Navigieren Sie im Kundenportal zu Projekteinstellungen > Webhooks, und geben Sie die URL ein, an die die Webhooks gesendet werden sollen. Falls Sie bereits Webhooks eingerichtet haben, ist dieser Schritt optional.
2. Als Antwort sollten Sie dem Nutzer eine Liste der SKUs der verfügbaren Artikel zurückgeben. Hierbei können Sie auch angeben, dass ein Nutzer einen bestimmten Artikel nur begrenzt oft oder nur innerhalb eines bestimmten Zeitraums kaufen kann. So können Sie die Anzahl und Art der für den Nutzer verfügbaren Artikel steuern.

Jede Anfrage an Xsolla, den Katalog abzurufen, generiert eine neue Anfrage von Xsolla an den Spieleserver. Xsolla speichert Daten zwischen, um die Anzahl der Anfragen an den Spieleserver zu reduzieren, und sendet den Webhook partner_side_catalog nach Ablauf der Lebensdauer des Zwischenspeichers.

Ist die Zwischenspeicherung noch nicht abgeschlossen, wird der Webhook partner_side_catalog bei jeder Anfrage an Xsolla gesendet. Wenn beispielsweise Xsolla mehrere Kataloganfragen gleichzeitig erhält, antwortet der Spielserver zeitverzögert.

Um den Webhook zu testen, können Sie den Artikelkatalog abfragen. Daraufhin erhalten Sie als Antwort einen Webhook unter der konfigurierten URL.

Dynamische Katalogaktualisierung

In der Antwort auf den Webhook Katalogpersonalisierung aufseiten des Partners müssen Sie die item_id oder die sku der bei Xsolla erstellten und dem Nutzer im Katalog angezeigten Artikel zurückgeben.

Standardmäßig muss für jeden Artikel in Ihrem System ein entsprechender Artikel bei Xsolla erstellt sein. Sie können jedoch vorhandene Artikel bei Xsolla dynamisch aktualisieren, ohne neue zu erstellen.

Die dynamische Katalogaktualisierung ermöglicht Folgendes:

• Aktualisierte Artikelinformationen anstelle der bei Xsolla gespeicherten Daten senden. Sie können Artikel bei Xsolla ohne viel Aufwand erstellen: nur Name, SKU und Preis müssen angegeben werden. Die Artikelanzeige (z. B. Name, Bild, Beschreibung usw.) wird bei jeder Katalogabfrage auf Ihrem Server generiert. Sie können also eine einzige Artikel-SKU bei Xsolla für mehrere Artikel in Ihrem System verwenden, sofern diese den gleichen Preis haben.
• Erstellen Sie ein leeres Bundle in Xsolla und stellen Sie den Inhalt des Bundles von Ihrem Server zum Zeitpunkt der Katalogabfrage bereit.

Vorteile:

• Sie können Artikelangaben und/oder Bundle-Inhalte bei jeder Katalogabfrage basierend auf Ingame-Ereignissen, saisonalen Angeboten oder Nutzerprofildaten aktualisieren.
• Es bedarf weniger bei Xsolla gespeicherter Artikel-SKUs, wodurch die Kosten für die Katalogpflege sinken.
• Sie können länderspezifische Preise für eine bestimmte SKU festlegen und so die Artikelpreise für Nutzer in verschiedenen Ländern entsprechend anpassen. Dadurch wird die SKU zu einer Preisquelle, während die Artikeldaten und/oder die Bundle-Inhalte dynamisch variieren können, sofern es sich bei dem Artikel um ein Bundle handelt.
• Dieser Ansatz entspricht der Logik der Apple-/Google-Plattformen, bei denen die Personalisierung der Inhalte vollumfänglich vom Partner gehandhabt wird, während die Preisgestaltung und der Bezahlvorgang auf allen Plattformen einheitlich bleiben.

Personalisierungstyp ändern

Einrichtung in Web Shop

So zeigen Sie Artikel mit konfigurierter Personalisierung im Web Shop an:

1. Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zum Menüpunkt Storefronts > Websites.
2. Klicken Sie bei der gewünschten Web-Shop-Website auf Site Builder öffnen.
3. Scrollen Sie im Online-Shop-Block zum Online-Shop-Abschnitt.
4. Wählen Sie in den beiden Feldern Artikeltyp und Artikelgruppe die Artikel mit konfigurierter Personalisierung aus.
5. Veröffentlichen Sie die Website, um die Änderungen zu übernehmen.

Letztmalig aktualisiert: 3. September 2025