So begrenzen Sie die Anzeigedauer für Artikel im Shop

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

  • den Katalog je nach Zeitraum relevanter gestalten, z. B. während der Weihnachtsfeiertage
  • einen Artikel im Voraus erstellen, ohne ihn im Katalog anzuzeigen
  • Benutzer zum Kauf motivieren, indem man einen Timer neben dem Artikel einblendet
Hinweis
Wenn Sie eine Katalogoberfläche mit dem Site Builder erstellen, wird der Timer automatisch eingeblendet. Wenn Sie einen Katalog ohne den Site Builder erstellen, müssen Sie den Timer selbst implementieren.
Die Anzeigedauer lässt sich für folgende Artikeltypen begrenzen:
  • virtuelle Gegenstände
  • virtuelle Währung und virtuelle Währungspakete
  • Bundles
Hinweis
Für virtuelle Gegenstände, virtuelle Währungspakete und Bundles ist die Konfiguration über das Kundenportal und über API-Aufrufe möglich. Für virtuelle Währungen ist die Konfiguration nur über API-Aufrufe möglich.
Sie können im Kundenportal festlegen, wie lange eine virtuelle Währung, ein virtuelles Währungspaket und ein Bundle im Shop angezeigt werden. Wählen sie dazu die Option Zeitraum, und legen Sie die Zeitzone sowie das Start- und das Enddatum fest. Wenn Sie kein Enddatum für den Anzeigezeitraum des Artikels festlegen möchten, setzen Sie ein Häkchen bei Kein Enddatum.
Hinweis
Nachdem Sie einen virtuellen Gegenstand, eine virtuelle Währung oder ein virtuelles Währungspaket erstellt haben, können Sie dem Artikel einen Status zuweisen und so festlegen, ob er verfügbar, nicht verfügbar oder teilweise verfügbar ist.
Um die Anzeigedauer eines Artikels im Shop über die API zu begrenzen, verwenden Sie:Übermitteln Sie die folgenden Parameter im API-Aufruf:
  • periods[0].date_from mitsamt dem Startdatum und der Startuhrzeit des Artikelanzeigezeitraums im Format YYYY-MM-DDThh:mm:ss±TMZ, wobei TMZ die Zeitzonenangabe im Format hh:mm ist.
  • periods[0].date_until mitsamt dem Enddatum und der Enduhrzeit des Artikelanzeigezeitraums im Format YYYY-MM-DDThh:mm:ss±TMZ, wobei TMZ die Zeitzonenangabe – bezogen auf GMT – im Format hh:mm ist. Wenn Sie keine Ende für den Anzeigezeitraum des Artikels festlegen möchten, übermitteln Sie null.

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:

Copy
Full screen
Small screen
    "periods": [
          {
            "date_from": "2022-06-10T14:00:00+03:00",
            "date_until": "2022-06-30T14:00:00+03:00"
          },
           {
            "date_from": "2022-07-10T14:00:00+03:00",
            "date_until": "2022-07-30T14:00:00+03:00"
          },
           {
            "date_from": "2022-08-10T14:00:00+03:00",
            "date_until": "2022-08-30T14:00:00+03:00"
          }
    ]
    

    Die Antwort der Katalog-abrufen-Methoden enthält jene Artikel, 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, weisen Sie bei der Katalogabfrage dem Parameter show_inactive_time_limited_items den Wert 1 zu.

    Hinweis

    Zeitlimits für die Artikelanzeige werden innerhalb eines Bundles nicht berücksichtigt.

    BEISPIEL

    1. Sie erstellen einen virtuellen Gegenstand namens Booster und legen als Anzeigezeitraum den 29. Oktober bis 15. November fest.

    2. Sie erstellen ein Bundle names Legendary Start Pack, in dem der Booster enthalten ist. Für das Bundle ist kein Zeitlimit festgelegt, es wird also dauerhaft im Online-Shop angezeigt.

    3. Ein Nutzer öffnet am 20. Oktober den Ingame-Shop. Sie können folgende Methoden nutzen:

    Bei diesen Methoden müssen Sie den Parameter show_inactive_time_limited_items nicht übermitteln.

    4. Beim Abrufen des Artikelkatalogs geschieht Folgendes:

    • In der Antwort der Methode Liste virtueller Gegenstände abrufen ist der Booster nicht enthalten, da als Anzeigezeitraum der 29. Oktober bis 15. November festgelegt ist. Wenn Sie in der Methode Liste der virtuellen Gegenstände abrufen den Parameter show_inactive_time_limited_items:1 übermitteln, ist der Booster in der Antwort enthalten und im Array Zeiträume ist der Zeitraum angegeben, in dem der virtuelle Gegenstand erhältlich ist.
    • In der Antwort der Methode Liste der Bundles abrufen ist der Booster als Teil des Legendary Start Pack-Bundles enthalten, und der Nutzer kann den Gegenstand unabhängig vom Wert des Parameters show_inactive_time_limited_items erhalten.

    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.
    Letztmalig aktualisiert: 3. Oktober 2024

    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!