So automatisieren Sie Katalogaktualisierungen

Sie können Katalogaktualisierungen mithilfe der In-Game Store API automatisieren. Dadurch können Sie Ihren Katalog ohne viel Zeitaufwand auf dem neuesten Stand halten. Mit der Katalogautomatisierung können Sie sowohl Artikel als auch Werbeaktion erstellen und aktualisieren sowie Daten aus externen Systemen importieren.

Dies reduziert den Zeitaufwand für die Pflege und Aktualisierung von:

  • Katalogen mit einer Vielzahl von Artikeln
  • Werbeaktionen jeglicher Art
  • länderspezifischen Preisen

Die Basisauthentifizierung wird für API-Aufrufe genutzt, um Artikel und Werbeaktionen zu erstellen und zu aktualisieren. Übermitteln Sie Authorization:Basic <your_authorization_basic_key>, wobei <your_authorization_basic_key> das gemäß dem Base64-Standard kodierte Paar Händler-ID:API-Schlüssel ist. Die Parameter finden Sie im Kundenportal:

  • Die Händler-ID finden Sie:
    • unter Projekteinstellungen > Webhooks.
    • unter Firmeneinstellungen > Firma.
    • in der URL in der Adresszeile des Browsers auf einer beliebigen Seite im Kundenportal. Die URL weist das folgende Format auf: https://publisher.xsolla.com/​Händler-ID/Kundeportalabschnitt.

  • Der API-Schlüssel wird im Kundenportal nur einmal angezeigt, nämlich dann, wenn er erstellt wird. Sie sind selbst dafür verantwortlich, den Schlüssel zu speichern. Einen neuen Schlüssel können Sie in den folgenden Abschnitten erstellen:
    • Firmeneinstellungen > API-Schlüssel
    • Projekteinstellungen > API-Schlüssel

Artikel erstellen und aktualisieren

Achtung
Die Liste der Parameter, die von den "Abrufen"-Methoden zurückgegeben wird, unterscheidet sich von den Parametern, die Sie in den Katalogaktualisierungsmethoden übermitteln. Neben den erforderlichen und aktualisierten Parametern müssen Sie auch die Parameter aus der "Aktualisieren"-Methode, die in der Antwort auf die Anfrage zurückgegeben werden, an die Methode übermitteln, mit der Sie die Liste der Artikel abrufen.

Virtuelle Gegenstände

So aktualisieren Sie den Katalog:

  1. Rufen Sie die Daten aus dem Katalog mithilfe der API-Methode Virtuellen Gegenstand abrufen oder Liste aller virtuellen Gegenstände abrufen ab.
  2. Übermitteln Sie die neuen Parameterwerte mithilfe der API-Methode Virtuellen Gegenstand aktualisieren.

Verwenden Sie die API-Methode Virtuellen Gegenstand erstellen, um einen virtuellen Gegenstand zu erstellen.

Virtuelle Währung

So aktualisieren Sie den Katalog:

  1. Rufen Sie die Daten aus dem Katalog mithilfe der API-Methode Liste der virtuellen Währungen abrufen ab.
  2. Übermitteln Sie die neuen Parameterwerte mithilfe der API-Methode Virtuelle Währung aktualisieren.

Verwenden Sie die API-Methode Virtuelle Währung erstellen, um eine virtuelle Währung zu erstellen.

Virtuelle Währungspakete

So aktualisieren Sie den Katalog:

  1. Rufen Sie die Daten aus dem Katalog mithilfe der API-Methode Liste der virtuellen Währungspakete abrufen ab.
  2. Übermitteln Sie die neuen Parameterwerte mithilfe der API-Methode Virtuelles Währungspaket aktualisieren.

Verwenden Sie die API-Methode Virtuelles Währungspaket erstellen, um ein virtuelles Währungspaket zu erstellen.

Bundles

So aktualisieren Sie den Katalog:

  1. Rufen Sie die Daten aus dem Katalog mithilfe der API-Methode Liste der Bundles abrufen ab.
  2. Übermitteln Sie die neuen Parameterwerte mithilfe der API-Methode Bundles aktualisieren.

Verwenden Sie die API-Methode Bundle erstellen, um ein Bundle zu erstellen.
Wie Sie Spielschlüssel, Länderbeschränkungen oder Preise den Bundles hinzufügen, erfahren Sie in dieser Anleitung.

Werbeaktionen erstellen und aktualisieren

Achtung
Die Liste der Parameter, die von den "Abrufen"-Methoden zurückgegeben wird, unterscheidet sich von den Parametern, die Sie in den Werbeaktionsaktualisierungsmethoden übermitteln. Neben den erforderlichen und aktualisierten Parametern müssen Sie auch die Parameter aus der "Aktualisieren"-Methode, die in der Antwort auf die Anfrage zurückgegeben werden, an die Methode übermitteln, mit der Sie die Liste der Werbeaktionen abrufen.

Gutscheine

Hinweis
Damit Gutscheinaktionen korrekt funktionieren, müssen Sie zunächst eine Werbeaktion erstellen und dann die Codes für diese Werbeaktion generieren.

So aktualisieren Sie eine Werbeaktion:

  1. Rufen Sie die Daten aus dem Katalog mithilfe der API-Methode Gutscheinaktion abrufen oder Liste der Gutscheinaktionen abrufen ab.
  2. Übermitteln Sie die neuen Parameterwerte mithilfe der API-Methode Gutscheinaktion aktualisieren.
  3. Aktivieren Sie die Werbeaktion mithilfe der API-Methode Gutscheinaktion aktivieren.

Verwenden Sie zunächst die API-Methode Gutscheinaktion erstellen und dann Gutscheincode erstellen, um eine Werbeaktion samt eigenen Gutscheincodes zu erstellen. Alternativ können Sie mithilfe der API-Methode Gutscheincodes generieren zufällige Gutscheincodes generieren.
Mit der API-Methode Gutscheinaktion deaktivieren können Sie eine Werbeaktion deaktivieren.

Promocodes

Hinweis
Damit Promocode-Aktionen korrekt funktionieren, müssen Sie zunächst eine Werbeaktion erstellen und dann die Codes für diese Werbeaktion generieren.

So aktualisieren Sie eine Werbeaktion:

  1. Rufen Sie die Daten aus dem Katalog mithilfe der API-Methode Promocode-Aktion abrufen oder Liste der Promocode-Aktionen abrufen ab.
  2. Übermitteln Sie die neuen Parameterwerte mithilfe der API-Methode Promocode-Aktion aktualisieren.
  3. Aktivieren Sie die Werbeaktion mithilfe der API-Methode Promocode-Aktion aktivieren.

Verwenden Sie zunächst die API-Methode Promocode-Aktion erstellen und dann Code für Promocode-Aktion erstellen, um eine Werbeaktion samt eigenen Promocodes zu erstellen. Alternativ können Sie mithilfe der API-Methode Codes für eine Promocode-Aktion generieren zufällige Promocodes generieren.
Mit der API-Methode Promocode-Aktion deaktivieren können Sie eine Werbeaktion deaktivieren.

Rabatte

So aktualisieren Sie eine Werbeaktion:

  1. Rufen Sie die Daten aus dem Katalog mithilfe der API-Methode Artikelaktion abrufen oder Liste der Artikelaktionen abrufen ab.
  2. Übermitteln Sie die neuen Parameterwerte mithilfe der API-Methode Artikelaktion aktualisieren.
  3. Aktivieren Sie die Werbeaktion mithilfe der API-Methode Werbeaktion aktivieren.

Verwenden Sie die API-Methode Rabattaktion für Artikel erstellen, um eine Werbeaktion zu erstellen.
Mit der API-Methode Werbeaktion deaktivieren können Sie eine Werbeaktion deaktivieren.

Boni

So aktualisieren Sie eine Werbeaktion:

  1. Rufen Sie die Daten aus dem Katalog mithilfe der API-Methode Bonusaktion abrufen oder Liste der Bonusaktionen abrufen ab.
  2. Übermitteln Sie die neuen Parameterwerte mithilfe der API-Methode Bonusaktion aktualisieren.
  3. Aktivieren Sie die Werbeaktion mithilfe der API-Methode Werbeaktion aktivieren.

Verwenden Sie die API-Methode Bonusaktion erstellen, um eine Werbeaktion zu erstellen.
Mit der API-Methode Werbeaktion deaktivieren können Sie eine Werbeaktion deaktivieren.

Aktualisieren durch den Import aus externen Systemen

Befolgen Sie die Anweisungen für den Import von Daten aus externen Systemen wie z. B. PlayFab oder Google Play.

War dieser Artikel hilfreich?
Vielen Dank!
Gibt es etwas, das wir verbessern können? Nachricht
Das tut uns leid
Bitte erläutern Sie, weshalb dieser Artikel nicht hilfreich ist. Nachricht
Vielen Dank für Ihr Feedback!
Wir werden Ihr Feedback aufgreifen und dazu nutzen, Ihr Erlebnis verbessern.
Diese Seite bewerten
Diese Seite bewerten
Gibt es etwas, das wir verbessern können?

Jetzt nicht

Vielen Dank für Ihr Feedback!
Letztmalig aktualisiert: 10. Oktober 2023

Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.

Problem melden
Wir überprüfen unsere Inhalte ständig. Ihr Feedback hilft uns, sie zu verbessern.
Geben Sie eine E-Mail-Adresse an, damit wir Sie erreichen können
Vielen Dank für Ihr Feedback!