Zeitlimit für die Artikelanzeige im Shop

So funktioniert's

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
• Nutzer zum Kauf motivieren, indem man einen Timer neben dem Artikel einblendet. Wenn Sie mit Site Builder eine Katalogoberfläche erstellen, wird der Timer automatisch eingeblendet. Wenn Sie ohne Site Builder eine Katalogoberfläche erstellen, müssen Sie den Timer selbst implementieren.

• Verkauf von Ingame-Items: virtuelle Gegenstände, virtuelle Währungspakete und Bundles
• Verkauf von Spielen und DLCs über Spielschlüssel

Limits konfigurieren und aktualisieren

Im Kundenportal konfigurieren und aktualisieren

1. Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zum Menüpunkt Artikelkatalog > Alle Artikel > Virtuelle Gegenstände.
2. Klicken Sie auf Hinzufügen, und wählen Sie Virtuelle Gegenstände aus.

3. Legen Sie die folgenden Parameter fest:
   • Bild
   • SKU
   • eine oder mehrere Gruppen, zu denen der Gegenstand gehören soll
   • Name
   • Beschreibung
   • Preise

4. Um zu begrenzen, wie oft ein Nutzer den Gegenstand kaufen darf, müssen Sie den Schalter Anzahl der Käufe dieses Artikels pro Benutzer beschränken auf Ein stellen und das Limit festlegen.
5. So legen Sie fest, wie oft die Limits zurückgesetzt werden:
   1. Wählen Sie in der Drop-down-Liste den Zeitraum aus:
      • Täglich
      • Wöchentlich
      • Monatlich
      • Benutzerdefiniertes Intervall. Das Intervall berechnet sich ausgehend vom Startdatum des Artikel-Anzeigezeitraums im Shop.
      • Nicht regelmäßig aktualisieren

1. 2. Legen Sie den Zeitplan fest, indem Sie die Parameter entsprechend dem Zeitraum angeben.

6. Sie können festlegen, wie lange der Gegenstand im Katalog angezeigt wird. Wählen Sie dazu Begrenzte Zeit aus, und legen Sie Zeitzone, Start- und Enddatum fest. Ist hingegen Kein Enddatum ausgewählt, verbleibt der Gegenstand auf unbestimmte Zeit im Katalog.
7. Klicken Sie auf Artikel anlegen.

Einrichten und aktualisieren über API-Aufrufe

Verwenden Sie die folgenden API-Aufrufe, um eine zeitliche Begrenzung für die Anzeige von Artikeln im Shop festzulegen:

• 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

• periods[0].date_from mitsamt dem Startdatum und der Startuhrzeit des Artikelanzeigezeitraums im Format YYYY-MM-DDThh:mm:ss±TMZ, wobei TMZ die Zeitzonenangabe – bezogen auf GMT – 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:

 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, weisen Sie bei der Katalogabfrage dem Parameter show_inactive_time_limited_items den Wert 1 zu.

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 eine API implementiert, werden die Informationen zum Angebotszeitraum eines Artikels in 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