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
Die Anzeigedauer lässt sich für folgende Artikeltypen begrenzen:
- virtuelle Gegenstände
- virtuelle Währung und virtuelle Währungspakete
- Bundles
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.
Um die Anzeigedauer eines Artikels im Shop über die API zu begrenzen, verwenden Sie:
- 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
Übermitteln Sie die folgenden Parameter im API-Aufruf:
periods[0].date_frommitsamt dem Startdatum und der Startuhrzeit des Artikelanzeigezeitraums im FormatYYYY-MM-DDThh:mm:ss±TMZ, wobeiTMZdie Zeitzonenangabe 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
1. Sie erstellen einen virtuellen Gegenstand namens
2. Sie erstellen ein Bundle names
3. 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_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 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.
War dieser Artikel hilfreich?
Diese Seite bewerten
Jetzt nicht
Vielen Dank für Ihr Feedback!
Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.
