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.

Für wen ist es

• Partner, die den In-Game Store integriert und mindestens einen der folgenden Artikeltypen konfiguriert haben:
  • virtuelle Währung
  • virtuelle Gegenstände
  • Bundles
• Partner, die den Artikelkatalog in Eigenregie oder mithilfe von Xsolla personalisieren möchten.

Voraussetzungen

Bevor Sie den Artikelkatalog personalisieren, müssen Sie das Produkt “In-Game Store” integrieren.

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.

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

So nutzen Sie die aufseiten von Xsolla implementierte Katalogpersonalisierung:

1. Richten Sie Benutzerattribute unter dem Menüpunkt “Login” 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 Store > Katalogverwaltung > Kataloganzeigeregeln erledigen.

So aktivieren Sie die Personalisierung:

1. Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zu Store > 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.

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 aufseiten von Xsolla, und synchronisieren Sie ihn mit Ihrem eigenen Katalog. Jeder Artikel in Ihrem System muss eine entsprechende item_id oder SKU bei Xsolla haben.
2. Aktivieren Sie die Personalisierung im Kundenportal.
3. Richten Sie die Verarbeitung des Webhooks “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 zu Store > 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.

Personalisierungstyp ändern

Letztmalig aktualisiert: 19. März 2025