Zum Inhalt springen
/
Angebotskette des aktuell...

LiveOps API (2.0.0)

Überblick

  • Version: 2.0.0
  • Server: https://store.xsolla.com/api
  • Kontakt per E-Mail
  • Kontakt-URL: https://xsolla.com/
  • Erforderliche TLS-Version: 1.2

LiveOps ist ein Toolkit, mit dem sich durch Werbeaktionen und personalisierte Angebote die Spielerbindung kontinuierlich verbessern lässt.

Mit der API lassen sich die folgenden Funktionen verwalten:

  • Werbeaktionen – Erstellen und verwalten Sie Gutscheine, Promocodes, Rabatte und Bonusaktionen.
  • Personalisierung – Legen Sie für bestimmte autorisierte Nutzer Bedingungen fest, gemäß denen der Artikelkatalog und Sonderangebote angezeigt werden sollen.
  • Werbaktionslimits – Begrenzen Sie, wie oft ein Nutzer eine Werbeaktion in Anspruch nehmen darf, und legen Sie fest, wie häufig das Limit zurückgesetzt werden soll.
  • Belohnungsketten und Wertpunkte – Konfigurieren Sie Belohnungsstufen, die an das Sammeln von Wertpunkten geknüpft sind.
  • Tägliche Ketten – Richten Sie tägliche Belohnungen ein, um Nutzer zu motivieren, sich regelmäßig anzumelden.
  • Angebotsketten – Erstellen Sie aufeinander aufbauende Kaufangebote mit gestaffelten Preisen und optionalen kostenlosen Belohnungen.
  • Upselling – eine Verkaufsmethode, bei der dem Nutzer angeboten wird, einen Artikel mit einem Mehrwert zu erwerben.

API-Aufrufe

Die API ist in die folgenden Gruppen unterteilt:

  • Admin – Aufrufe zum Erstellen, Aktualisieren, Aktivieren und Löschen von Kampagnen und Ketten. Die Authentifizierung erfolgt über die Basisauthentifizierung und Ihre Händler- oder Projekt-Anmeldedaten.
  • Client – Aufrufe zum Abrufen verfügbarer Werbeaktionen, zum Abrufen aktiver Ketten, zum Einlösen von Codes und zur Inanspruchnahme von Belohnung im Namen authentifizierter Nutzer. Die Authentifizierung erfolgt über den Benutzer-JWT.
OpenAPI-Beschreibung herunterladen
index.json
index.yaml
Sprachen
Server
https://store.xsolla.com/api/
Mock server
https://xsolla.redocly.app/_mock/de/api/liveops/

Allgemeines

Operationen

Gutscheine

Mit dieser API können Sie Gutscheine verwalten.

Operationen

Promocodes

Diese API ermöglicht die Verwaltung von Promocodes.

Operationen

Katalogsonderangebote

Mit dieser API können Sie Katalogsonderangebote verwalten.

Operationen

Rabatte

Mit dieser API können Sie Rabattaktionen verwalten.

Operationen

Boni

Diese API ermöglicht die Verwaltung von Bonusaktionen.

Operationen

Personalisierter Katalog

Diese API ermöglicht es, Regeln für Benutzerattribute festzulegen. Wenn der Nutzer alle Bedingungen einer konkreten Regel erfüllt, werden personalisierte Artikel angezeigt.

Für personalisierte Werbeaktionen siehe Abschnitt Werbeaktionen.

Um Attribute vor einem Kauf zu übermitteln, können Sie die Xsolla Login API verwenden oder die Attribute in der Eigenschaft user.attributes übermitteln, während Sie den Token mit der Pay Station API generieren.

Operationen

Verwaltung

Operationen

Verwaltung

Operationen

Client

Operationen

Clans-Client

Operationen

Verwaltung

Operationen

Client

Operationen

Verwaltung

Operationen

Client

Operationen

Angebotsketten des aktuellen Nutzers abrufenClient-side

Anfrage

Ruft die aktuellen Angebotsketten des Nutzers ab.

Hinweis

In allen Projekten ist die Anzahl der Artikel, die in einer einzigen Antwort zurückgegeben werden können, begrenzt. Der Standard- und Maximalwert beträgt 30 Artikel pro Antwort. Verwenden Sie die Abfrageparameter limit und offset für die Paginierung, um weitere Daten abzurufen.
Sicherheit
XsollaLoginUserJWT
Pfad
project_idintegererforderlich

Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt.

Beispiel: 44056
Abfrage
limitinteger>= 1

Begrenzung der Elementanzahl auf der Seite.

Beispiel: limit=50
offsetinteger>= 0

Elementnummer, aus der die Liste generiert wird (die Zählung beginnt bei 0).

Beispiel: offset=0
curl -i -X GET \
  'https://store.xsolla.com/api/v2/project/44056/user/offer_chain?limit=50&offset=0' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Antworten

Die Liste der Angebotsketten wurde erfolgreich empfangen.

Bodyapplication/json
has_moreboolean

Gibt an, ob weitere Seiten verfügbar sind.

Beispiel: true
itemsArray of objects(client-offer-chain-model)
total_items_countinteger

Gesamtzahl der verfügbaren Angebotsketten.

Beispiel: 10
Antwort
application/json
{
  "has_more": false,
  "items": [
    { … },
    { … },
    { … }
  ],
  "total_items_count": 3
}

Angebotskette des aktuellen Nutzers anhand der ID abrufenClient-side

Anfrage

Ruft die Angebotskette des aktuellen Nutzers anhand der Angebotsketten-ID ab.

Sicherheit
XsollaLoginUserJWT
Pfad
project_idintegererforderlich

Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt.

Beispiel: 44056
offer_chain_idintegererforderlich

Angebotsketten-ID.

Beispiel: 101
curl -i -X GET \
  https://store.xsolla.com/api/v2/project/44056/user/offer_chain/101 \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Antworten

Die Angebotskette des Nutzers wurde erfolgreich abgerufen.

Bodyapplication/json
date_endstring or null(date-time)(offer_chain_date_end)

Datum, an dem die Angebotskette endet. Kann null sein. Wenn für date_end der Wert null festgelegt ist, ist die Angebotskette zeitlich unbegrenzt.

Beispiel: "2020-04-15T18:16:00+05:00"
date_startstring(date-time)(offer_chain_date_start)

Datum, an dem die Angebotskette beginnt.

Beispiel: "2020-04-15T18:16:00+05:00"
descriptionstring or null

Angebotskettenbeschreibung.

Beispiel: "Major weekly quest"
idinteger

Angebotsketten-ID.

Beispiel: 9
namestring

Angebotskettenname.

Beispiel: "Weekly quest"
next_step_numberinteger or null

Nächste Angebotskettenschritt-Nummer. null, wenn die Angebotskette abgeschlossen ist.

Beispiel: 1
orderinteger(order)

Definiert die Anordnungsreihenfolge.

Beispiel: 1
recurrent_scheduleobject or null(offer_chain_recurrent_schedule_client_side)

Reset-Zeitraum der Angebotskette.

stepsArray of objects(client-offer-chain-step-model)
Antwort
application/json
{
  "date_end": "2025-04-25T18:16:00+05:00",
  "date_start": "2010-04-15T18:16:00+05:00",
  "description": null,
  "id": 4,
  "name": "Offer chain with bundles",
  "next_step_number": 1,
  "order": 1,
  "recurrent_schedule": null,
  "steps": [
    { … },
    { … }
  ]
}

Kostenlosen Angebotskettenschritt sichernClient-side

Anfrage

Schließt den aktuellen Fortschritt des Nutzers in der Angebotskette ab und gewährt die zugehörige Belohnung.

Hinweis

Verwenden Sie diesen Aufruf nur bei kostenlosen Schritten in der Angebotskette. Bei Schritten, die eine Zahlung in echter Währung erfordern, müssen Sie stattdessen den Aufruf Bestellung für kostenpflichtigen Angebotskettenschritt anlegen verwenden.
Sicherheit
XsollaLoginUserJWT
Pfad
project_idintegererforderlich

Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt.

Beispiel: 44056
offer_chain_idintegererforderlich

Angebotsketten-ID.

Beispiel: 101
step_numberintegererforderlich

Nummer des Angebotskettenschritts.

Beispiel: 1
curl -i -X POST \
  https://store.xsolla.com/api/v2/project/44056/user/offer_chain/101/step/number/1/claim \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Antworten

Der kostenlose Schritt wurde erfolgreich in Anspruch genommen und die Belohnung gewährt.

Bodyapplication/json
order_idinteger

Bestell-ID.

Antwort
application/json
{
  "order_id": 641
}

Verwaltung

Operationen

Client

Operationen