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
- virtuelle Gegenstände
- virtuelle Währung und virtuelle Währungspakete
- Bundles
- für virtuelle Gegenstände den API-Aufruf Virtuellen Gegenstand erstellen oder Virtuellen Gegenstand aktualisieren
- für virtuelle Währung den API-Aufruf Virtuelle Währung erstellen oder Virtuelle Währung aktualisieren
- für virtuelle Währungspakete den API-Aufruf Virtuelles Währungspaket erstellen oder Virtuelles Währungspaket aktualisieren
für Bundles den API-Aufruf Bundle erstellen oder Bundle aktualisieren
periods[0].date_frommitsamt dem Startdatum und der Startuhrzeit des Artikelanzeigezeitraums im FormatYYYY-MM-DDThh:mm:ss±TMZ, wobeiTMZdie Zeitzonenangabe – bezogen auf GMT – im Formathh:mmist.periods[0].date_untilmitsamt dem Enddatum und der Enduhrzeit des Artikelanzeigezeitraums im FormatYYYY-MM-DDThh:mm:ss±TMZ, wobeiTMZdie Zeitzonenangabe – bezogen auf GMT – im Formathh:mmist. Wenn Sie keine Ende für den Anzeigezeitraum des Artikels festlegen möchten, übermitteln Sienull.
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:
"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.
Zeitlimits für die Artikelanzeige werden innerhalb eines Bundles nicht berücksichtigt.
BEISPIEL
- Sie erstellen einen virtuellen Gegenstand namens
Booster und legen als Anzeigezeitraum den 29. Oktober bis 15. November fest. - Sie erstellen ein Bundle names
Legendary Start Pack , in dem derBooster enthalten ist. Für das Bundle ist kein Zeitlimit festgelegt, es wird also dauerhaft im Online-Shop angezeigt. - Ein Nutzer öffnet am 20. Oktober den Ingame-Shop. Sie können folgende Methoden nutzen:
- List der virtuellen Gegenstände abrufen – Zum Abrufen des Katalogs virtueller Gegenstände.
- List der Bundles abrufen – Zum Abrufen des Bundle-Katalogs.
show_inactive_time_limited_itemsnicht übermitteln. - 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 Parametershow_inactive_time_limited_items:1übermitteln, ist derBooster 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 desLegendary Start Pack -Bundles enthalten, und der Nutzer kann den Gegenstand unabhängig vom Wert des Parametersshow_inactive_time_limited_itemserhalten.
- In der Antwort der Methode Liste virtueller Gegenstände abrufen ist der
Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.
