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

Personalisierte Konfigurationen lassen sich für die folgenden Szenarien festlegen:

• Verkauf von Ingame-Items: virtuelle Gegenstände, virtuelle Währungspakete und Bundles
• Verkauf von Spielen und DLCs über Spielschlüssel

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.

Bevor Sie den Artikelkatalog personalisieren, müssen Sie den Verkauf von Ingame-Items oder Spielschlüsseln einrichten.

Personalisierung aufseiten von Xsolla

Ablauf für den Nutzer

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent' }}}%%
sequenceDiagram
    participant U as Nutzer
    participant PS as Partner-Storefront
    participant IC as Artikelkatalog aufseiten von Xsolla
    participant GS as Spielserver
    participant XL as Xsolla Login
    U->>PS: Nicht autorisierter Nutzer öffnet den Shop und gibt seine Nutzer-ID zur Autorisierung ein
    activate U
    activate PS
    PS->>XL: wird über Xsolla Login autorisiert
    deactivate PS
    activate XL
    XL-->>U: bestätigt Autorisierung
    deactivate XL
    deactivate U
    U->>PS: öffnet den Shop
    activate U
    activate PS
    PS->>IC: fragt Katalog an
    deactivate PS
    activate IC
    IC->>GS: fragt Attributsliste an
    activate GS
    GS-->>IC: gibt Attributsliste zurück
    deactivate GS
    activate IC
    Note right of IC: Personalisierungsregeln werden angewendet
    deactivate IC
    IC-->>U: gibt personalisiertem Katalog zurück
    deactivate IC
    deactivate U
    activate PS
    U->>PS: klickt auf “Zahlen”
    activate U
    activate PS
    PS->>IC: sendet Kaufanfrage
    activate IC
    IC->>GS: fragt Attributsliste an
    activate GS
    GS-->>IC: gibt Attributsliste zurück
    deactivate GS
    activate IC
    Note right of IC: Personalisierungsregeln werden angewendet
    deactivate IC
    IC-->>PS: gibt Zahlungstoken zurück
    deactivate IC
    PS-->>U: leitet zu Pay Station weiter
    deactivate PS
    deactivate U
    U->>IC: verabeitet die Zahlung
    activate IC
    IC->>GS: gewährt Artikel
    deactivate IC

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.

3. Xsolla fragt Benutzerattribute von Xsolla-Login 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 Xsolla-Login stammenden Benutzerattributen.
5. Der Nutzer wählt einen Artikel aus dem personalisierten Katalog aus und 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, erhält der Nutzer eine entsprechende Meldung.
   • 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.

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.

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.

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.

Die Reihenfolge, in der die Attribute aktualisiert werden, hängt davon ab, wie der Nutzer authentifiziert ist: über die Benutzer-ID (verfügbar bei Verwendung des Web Shops) oder über Xsolla Login.

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.

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

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent' }}}%%
sequenceDiagram
    participant U as Nutzer
    participant PS as Partner-Storefront
    participant IC as Artikelkatalog aufseiten von Xsolla
    participant GS as Spielserver
    participant XL as Xsolla Login
    U->>PS: Nicht autorisierter Nutzer öffnet den Shop und gibt seine Nutzer-ID zur Autorisierung ein
    activate U
    activate PS
    PS->>XL: wird über Xsolla Login autorisiert
    deactivate PS
    activate XL
    XL-->>U: bestätigt Autorisierung
    deactivate XL
    deactivate U
    U->>PS: öffnet den Shop
    activate U
    activate PS
    PS->>IC: fragt Katalog an
    deactivate PS
    activate IC
    IC->>GS: fragt Artikelliste an
    activate GS
    GS-->>IC: gibt Artikelliste zurück
    deactivate GS
    IC-->>U: gibt personalisiertem Katalog zurück
    deactivate IC
    deactivate U
    U->>PS: klickt auf “Zahlen”
    activate PS
    activate U
    PS->>IC: sendet Kaufanfrage
    activate IC
    IC->>GS: fragt Artikelliste an
    activate GS
    GS-->>IC: gibt Artikelliste zurück
    deactivate GS
    IC-->>PS: gibt Zahlungstoken zurück
    deactivate IC
    PS-->>U: leitet zu Pay Station weiter
    deactivate PS
    deactivate U
    U->>IC: verabeitet die Zahlung
    activate IC
    IC->>GS: gewährt Artikel
    deactivate IC

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.

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.

• 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

• Zur Personalisierung aufseiten des Partners wechseln
• Zur Personalisierung aufseiten von Xsolla wechseln

1. Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zum Menüpunkt LiveOps > Personalisierung.

2. Klicken Sie bei Kataloganzeigeregeln auf Bearbeiten.

3. Wählen Sie die Option Personalisierung aufseiten des Partners aus, und fahren Sie mit der Einrichtung fort.

1. Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zum Menüpunkt LiveOps > Personalisierung.

2. Klicken Sie auf Bearbeiten.

3. Wählen Sie die Option Personalisierung aufseiten von Xsolla aus, und fahren Sie mit der Einrichtung fort.

Sie können auch die Personalisierung aufseiten des Partners deaktivieren, indem Sie den entsprechenden Schalter deaktivieren. Der Personalisierungstyp ändert sich in Personalisierung aufseiten von Xsolla, vorausgesetzt, dies ist in Ihrem Projekt konfiguriert.

Die Personalisierung ermöglicht es Ihnen, zu steuern, welche Katalogartikel für bestimmte Gruppen von autorisierten Nutzern sichtbar sind.

Die Funktion wird durch Segmente implementiert – Regelsets, die definieren, welche Nutzer bestimmte Produkte sehen können. Indem Sie einem Artikel ein Segment zuweisen, bestimmen Sie die Bedingungen, unter denen der Artikel im Katalog sichtbar ist.

Voraussetzungen

Segmente werden basierend auf Benutzerattributen definiert. Sie müssen diese Attribute in Ihrem Projekt konfigurieren, bevor Sie die Personalisierung nutzen können. Attribute beschreiben die Eigenschaften Ihrer Nutzer und ermöglichen es Ihnen, flexible Bedingungen für die Sichtbarkeit von Artikeln im Katalog zu erstellen.

Typische Anwendungsfälle umfassen die Zielgruppenansprache nach Region, Plattform, Spielfortschritt oder wichtigen Daten wie Registrierung oder Geburtstag. Durch die Kombination mehrerer Attribute in einem Segment können Sie feinabstimmen, welche Artikel jeder Nutzergruppe angezeigt werden.

Segment erstellen

Um ein Segment zu erstellen:

2. Beginnen Sie mit der Erstellung eines Segments auf eine der folgenden Arten:
   • Option 1:
     1. Klicken Sie in der Symbolleiste auf das  Symbol.
     2. Klicken Sie im Bereich der Segmentliste auf das + Symbol.

1. • Option 2: Klicken Sie in der Symbolleiste auf das +-Symbol und wählen Sie Neues Segment erstellen.

1. • Option 3: Öffnen Sie das Kontextmenü irgendwo auf der Leinwand und wählen Sie Neues Segment.

3. Geben Sie den Segmentnamen und die Beschreibung an.
4. Klicken Sie auf Weiter.
5. Geben Sie die Bedingung an:
1. Geben Sie den Benutzertyp des Attributs an – Zeichenfolge, Zahl oder Datum.
2. Wählen Sie das Benutzerattribut aus der Drop-down-Liste aus.
3. Wählen Sie den Vergleichsoperator aus.
4. Geben Sie den Wert des Benutzerattributs an.
6. Um weitere Bedingungen hinzuzufügen, klicken Sie auf Bedingung hinzufügen und füllen Sie die angezeigten Felder aus (optional).
7. Um die Position der Bedingung zu ändern (optional), ziehen Sie die Zeile mit dem ☰-Symbol an die gewünschte Position.
8. Klicken Sie auf Weiter.
9. Überprüfen Sie die Einstellungen und klicken Sie auf Segment erstellen.

10. Um Artikel hinzuzufügen, auf die die Segmentbedingungen angewendet werden:
    1. Klicken Sie im Abschnitt Betroffene Artikel auf Artikel auswählen.
    2. Aktivieren Sie im sich öffnenden Fenster die Kontrollkästchen neben den erforderlichen Artikeln.
    3. Klicken Sie auf Auswählen.
11. Aktivieren Sie die Personalisierungsbedingungen (optional).

Auf der Leinwand werden visuelle Links zwischen der Segmentkarte und den zugehörigen Artikeln angezeigt.

Um deren Anzeige zu verwalten, klicken Sie auf das →- oder ←-Symbol rechts von der zugehörigen Artikelkarte, neben dem  Symbol. Wenn ein Artikel zu mehreren Segmenten gehört, wird jeweils nur ein Link angezeigt.