Zeitlimit für die Artikelanzeige im Shop

Funktionsweise

Sie können den Anzeigezeitraum für einen Artikel im Shop festlegen und dadurch:

• en Katalog je nach Zeitraum relevanter zu gestalten, z. B. während der Weihnachtsfeiertage.
• einen Artikel im Voraus erstellen, ohne ihn im Katalog anzuzeigen.
• einen Timer neben dem Artikel einzublenden und so Nutzer zum Kauf zu animieren. Wenn Sie eine Katalogoberfläche mit Site Builder erstellen, wird der Timer automatisch eingeblendet. Wenn Sie eine Katalogoberfläche ohne Site Builder erstellen, müssen Sie den Timer selbst implementieren.

Limits lassen sich für die folgenden Szenarien konfigurieren:

• Verkauf von Ingame-Items: virtuelle Gegenstände, virtuelle Währungspakete und Bundles
• Verkauf von Spielschlüsseln für Spiele und DLCs

Limits konfigurieren und aktualisieren

So erstellen Sie einen virtuellen Gegenstand samt Limit:

2. Wählen Sie erst Manuell erstellen aus und danach in der Drop-down-Liste die Option Virtuelle Gegenstände.

3. Geben Sie im Abschnitt Allgemeine Einstellungen Folgendes an:
   • SKU
   • Eine oder mehrere Gruppen, zu denen der Artikel gehören soll (optional)
   • Name
   • kurze Beschreibung
   • erweiterte Beschreibung – aktivieren Sie hierzu den entsprechenden Schalter (optional)

4. Im Abschnitt Medien können Sie optional ein oder mehrere Bilder oder Videos von Ihrem Gerät oder über einen Link hochladen. In dem mit dem Xsolla-Website-Editor erstellten Shop wird auf allen Artikelkarten die als Main gekennzeichnete Datei angezeigt, während die übrigen Dateien nur auf Artikelkarten mit einer Mediengalerie sichtbar sind. Die als Main gekennzeichnete Datei wird außerdem in den Antworten der API-Aufrufe zur Katalogabfrage zurückgegeben.

5. Legen Sie im Abschnitt Preiseinstellungen Preise fest oder erstellen Sie einen kostenlosen Gegenstand:
   • Wenn Sie einen Preis festlegen möchten, müssen Sie Kostenpflichtiger Gegestand auswählen, die Schalter Preise in echter Währung und/oder Preise in virtuelle Währung aktivieren und danach die gewünschten Preis angeben. Bei Bedarf können Sie regionale Preise konfigurieren.
   • Wenn Sie stattdessen keinen Preis festlegen möchten, wählen Sie Kostenloser Gegenstand aus.

6. So begrenzen Sie, wie viele Artikel ein Nutzer erhalten kann:
   1. Aktivieren Sie den Schalter im Abschnitt Limits, und legen Sie die gewünschte Höchstmenge fest.
   2. Konfigurieren Sie, wie häufig das Limit zurückgesetzt werden soll. Wählen Sie dazu einen Zeitraum aus der Drop-down-Liste aus:
      1. Täglich.
      2. Wöchentlich.
      3. Monatlich.
      4. Benutzerdefiniertes Intervall. Das Intervall läuft ab dem Datum los, an dem der Artikel im Shop erstmals angezeigt wird.
      5. Nicht regelmäßig zurücksetzen.
   3. Legen Sie anhand der Parameter für den ausgewählten Zeitraum fest, wann das Limit zurückgesetzt wird.

7. So richten Sie eine zeitliche Anzeigebegrenzung für den Artikel ein (optional):

   1. Aktivieren Sie den Schalter im Abschnitt Bestimmten Anzeigezeitraum hinzufügen.
   2. Legen Sie die Zeitzone sowie den Beginn und das Ende des Zeitraums fest.

   Aktivieren Sie bei Bedarf den Schalter Kein Enddatum, um das Ende des Anzeigezeitraums offen zu lassen.

8. Konfigurieren Sie Attribute optional auf eine der folgenden Arten:
   1. Attribute und zugehörige Werte im JSON-Format hinzufügen
   2. Attribute und Werte manuell erstellen und diese einem bestimmten Artikel zuordnen

9. Falls der kostenpflichtige Gegenstand bei Zufallsmechaniken (z. B. Lootboxen oder Gacha) verwendet wird, müssen Sie den Schalter Als kostenpflichtige zufällige Belohnung kennzeichen aktivieren.

10. Klicken Sie auf Erstellen.

11. Wählen Sie im sich öffnenden Fenster den Artikelstatus aus, und klicken Sie auf Weiter.

Der erstellte Artikel wird im Abschnitt Alle Artikel angezeigt.

Über API-Aufrufe einrichten und aktualisieren

Verwenden Sie die folgenden API-Aufrufe, um die Anzeigedauer von Artikeln im Shop zu begrenzen:

• Virtuellen Gegenstand erstellen oder Virtuellen Gegenstand aktualisieren
• Virtuelle Währung erstellen oder Virtuelle Währung aktualisieren
• Virtuelles Währungspaket erstellen oder Virtuelles Währungspaket aktualisieren
• Bundle erstellen oder Bundle aktualisieren
• Spiel erstellen, Spiel anhand der SKU aktualisieren oder Spiel anhand der ID aktualisieren

Übermitteln Sie die folgenden Parameter im für die Artikelerstellung bzw. ‑bearbeitung genutzten API-Aufruf:

periods[0].date_from samt Startdatum und Startuhrzeit des Artikelanzeigezeitraums im Format YYYY-MM-DDThh:mm:ss±TMZ, wobei TMZ das Zeitzonen-Offset – bezogen auf GMT – im Format hh:mm ist.

• periods[0].date_until samt Enddatum und Enduhrzeit des Artikelanzeigezeitraums im Format YYYY-MM-DDThh:mm:ss±TMZ, wobei TMZ das Zeitzonen-Offset – bezogen auf GMT – im Format hh:mm ist. Wenn Sie keine Ende für den Anzeigezeitraum des Artikels festlegen möchten, müssen Sie nur ein Anfangsdatum angeben und “periods[0].date_until”: null übermitteln.

Sie können mehrere Zeiträume für die Anzeige eines Artikels im Shop festlegen. Übermitteln Sie dazu in den API-Aufrufen ein Objekt-Array mit dem jeweiligen Start- und Enddatum der Zeiträume.

Beispiel:

 1"periods": [
 2      {
 3        "date_from": "2022-06-10T14:00:00+03:00",
 4        "date_until": "2022-06-30T14:00:00+03:00"
 5      },
 6       {
 7        "date_from": "2022-07-10T14:00:00+03:00",
 8        "date_until": "2022-07-30T14:00:00+03:00"
 9      },
10       {
11        "date_from": "2022-08-10T14:00:00+03:00",
12        "date_until": "2022-08-30T14:00:00+03:00"
13      }
14]

In der Antwort auf die API-Aufrufe für den Katalogabruf sind jene Artikel enthalten, die zum Zeitpunkt der Anfrage im Shop angezeigt werden. Wenn Sie Informationen über Artikel erhalten möchten, deren Anzeigezeitraum noch nicht begonnen hat oder bereits abgelaufen ist, müssen Sie bei der Katalogabfrage dem Parameter show_inactive_time_limited_items den Wert 1 zuweisen.

Limits im Artikelkatalog anzeigen

Die Anzeige zeitlich begrenzter Artikel im Katalog hängt davon ab, wie diese implementiert sind: entweder über Site Builder oder über die API.

Anzeige über Site Builder

Wenn Sie Site Builder verwenden, werden Zeitlimits automatisch angezeigt. 30 Tage vor Ablauf des Angebotszeitraums erscheint automatisch ein Timer auf der Artikelkarte, der die verbleibende Zeit anzeigt:

•  Wenn bis zum Ende des Angebotszeitraums noch mehr als eine Woche verbleibt, zeigt der Timer Tage und Stunden an.
• Wenn bis zum Ende des Angebotszeitraums noch mehr als ein Tag verbleibt, zeigt der Timer Stunden und Minuten an.
• Wenn bis zum Ende des Angebotszeitraums weniger als ein Tag verbleibt, zeigt der Timer Minuten und Sekunden an.

Limitinformationen über die API abrufen

Wird der Katalog über die API implementiert, werden die Informationen zum Angebotszeitraum eines Artikels bei den folgenden katalogbezogenen API-Aufrufen im Array items.periods zurückgegeben:

• Liste virtueller Gegenstände abrufen
• Liste virtueller Währungen abrufen
• Liste virtueller Währungspakete abrufen
• Liste der Bundles abrufen
• Spieleliste abrufen

Mithilfe der Daten zum Angebotszeitraum eines Artikels lassen sich Limits im Katalog anzeigen, beispielsweise der Zeitraum, in dem ein Nutzer den Artikel kaufen kann.