Kauflimits für Artikel
Funktionsweise
Sie können begrenzen, wie viele Exemplare eines Artikels ein Nutzer kaufen darf, und festlegen, wann dieses Limit zurückgesetzt wird.
Die Limitkonfiguration ist in folgenden Szenarien verfügbar:
- Verkauf von In-Game-Items – virtuelle Gegenstände, virtuelle Währungspakete und Bundles
- Verkauf von Spielen und DLC über Spielschlüssel
Sie können festlegen, dass das Limit regelmäßig zurückgesetzt wird, um:
- wiederholte Käufe zulassen
- Daten mit Ihrem System synchronisieren, wenn Artikel auf mehreren Publishing-Plattformen verkauft werden
Damit die für einen Nutzer verfügbare Menge korrekt angezeigt wird, müssen Sie die Authentifizierung konfigurieren.
Nicht authentifizierte Nutzer sehen immer die maximale Anzahl der jeweiligen Artikel, die sie erwerben können. Um den Nutzern die verbleibende Artikelanzahl gemäß des aktiven Limits anzuzeigen, müssen Sie die Autorisierungsdaten des Nutzers hinzufügen, wenn Sie Folgendes abfragen:
- den Artikelkatalog über Aufrufe aus dem Unterabschnitt Catalog der Gruppe Virtual Items & Currency
- den Spielekatalog über Aufrufe aus dem Unterabschnitt Catalog der Gruppe Game Keys
Xsolla setzt Limits durch und verhindert, dass Nutzer mehr Artikel kaufen, als das festgelegte Limit zulässt:
- Wenn das Zahlungsportal geöffnet ist und ein Artikel bezahlt wird, werden alle unbezahlten Bestellungen, die diesen Artikel enthalten, ungültig.
- Beispiel: Ein Nutzer kann die Bezahlmaske für einen begrenzten Artikel in mehreren Browser-Tabs oder verschiedenen Browsern öffnen, bevor er den Kauf abschließt. Dadurch werden mehrere Bestellungen für denselben Artikel angelegt. Sobald der Kauf in einem Tab abgeschlossen ist, storniert Xsolla alle unbezahlten Bestellungen für diesen Artikel.
- Wenn eine Zahlung erstattet oder eine Bestellung storniert wird, werden die Limits nicht zurückgesetzt. Sie können sie mit den folgenden API-Aufrufen zurücksetzen: Refresh all purchase limits for specified user und Refresh all promotion limits for specified user.
- Beispiel: Ein Nutzer kann einen Artikel mit Kauflimits kaufen, ihn im Spiel verwenden und anschließend eine Erstattung anfordern. Würden die Limits automatisch zurückgesetzt, könnte der Nutzer den Artikel erneut kaufen, ihn nutzen und diesen Zyklus wiederholen – die vorgesehenen Limits würden so faktisch umgangen. Um dies zu verhindern, werden die Limits bei einer Erstattung oder Stornierung einer Bestellung nicht zurückgesetzt.
Informationen zur Konfiguration von Nutzungslimits für Werbeaktionen finden Sie in der Anleitung.
Limits konfigurieren und aktualisieren
Im Kundenportal konfigurieren und aktualisieren
- Der folgende Konfigurationsablauf wird beispielhaft mit virtuellen Gegenständen gezeigt.
- Vor der Konfiguration virtueller Gegenstände empfiehlt es sich, Gruppen zu erstellen. Gruppen ermöglichen einen mehrstufigen Katalog und die Steuerung der Anzeige im Shop.
- Im Kundenportal können Sie Limits für einen bestimmten Artikel für alle Nutzer aktualisieren. Erweiterte Konfigurationsoptionen sind per API-Aufrufen verfügbar.
So erstellen Sie einen virtuellen Gegenstand samt Limit:
- Öffnen Sie Ihr Projekt im Kundenportal und wechseln Sie zum Abschnitt Items catalog > All items > Virtual items.
- Öffnen Sie das Projekt in Ihrem Konto und wechseln Sie zum Abschnitt Items catalog > All items > Virtual items.
- Öffnen Sie das Projekt in Ihrem Konto und wechseln Sie zum Abschnitt Items catalog > All items > Virtual items.
- Öffnen Sie das Projekt in Ihrem Konto und wechseln Sie zum Abschnitt Items catalog > All items > Virtual items.
- Öffnen Sie Ihr Projekt im Konto für Handyspiele und wechseln Sie zum Abschnitt Catalog.
- Wählen Sie Create manually aus und danach in der Drop-down-Liste Virtual item.
- Geben Sie im Abschnitt General settings Folgendes an:
- SKU
- eine oder mehrere Gruppen, zu denen der Artikel gehören soll (optional)
- Name
- Kurzbeschreibung
- Erweiterte Beschreibung – aktivieren Sie zum Hinzufügen den entsprechenden Schalter (optional)
- Laden Sie im Abschnitt Media optional ein oder mehrere Bilder oder Videos hoch – von Ihrem Gerät oder über einen Link. Im mit dem Xsolla Site Editor erstellten Shop zeigen alle Artikelkarten die Datei mit der Markierung Main an, während die übrigen Dateien nur in Artikelkarten mit Mediengalerie verfügbar sind. Die als Main markierte Datei wird außerdem in den Antworten der API-Aufrufe zur Katalogabfrage zurückgegeben.
- Legen Sie im Abschnitt Price settings Preise fest oder erstellen Sie einen kostenlosen Artikel:
- Um einen Preis festzulegen, wählen Sie Paid item, aktivieren Sie Real currency prices und/oder Virtual currency prices, und geben Sie den Preis an. Bei Bedarf regionale Preise konfigurieren.
- Um einen kostenlosen Artikel zu erstellen, wählen Sie Free item.
Ein Artikel kann Preise in mehreren echten und virtuellen Währungen haben. In diesem Fall müssen Sie für jeden Währungstyp eine Standardwährung angeben – jeweils eine unter den echten Währungen und eine unter den virtuellen Währungen.
Sie können einen Preis in virtueller Währung nur angeben, wenn die virtuelle Währung bereits im Projekt erstellt wurde.
- Um die Anzahl der zum Kauf verfügbaren Artikel zu begrenzen:
- Aktivieren Sie den Schalter im Abschnitt Limits und geben Sie die Menge an.
- Konfigurieren Sie die Häufigkeit des Limit-Resets. Wählen Sie dazu einen Zeitraum aus der Drop-down-Liste aus:
- Daily.
- Weekly.
- Monthly.
- Custom interval. Der Zeitraum wird ab dem Startdatum der Artikelanzeige im Shop berechnet.
- No regular refresh.
- Richten Sie den Reset-Zeitplan ein, indem Sie die zum gewählten Zeitraum passenden Parameter angeben.
So richten Sie eine zeitliche Anzeigebegrenzung für den Artikel ein (optional):
- Aktivieren Sie den Schalter im Abschnitt Add specific display period.
- Geben Sie die Zeitzone sowie den Beginn und das Ende des Zeitraums an.
Um das Ende des Anzeigezeitraums offen zu lassen, aktivieren Sie den Schalter No end date.
- Konfigurieren Sie Attribute optional auf eine der folgenden Arten:
- Wenn der kostenpflichtige Artikel in Mechaniken mit zufälliger Belohnung (z. B. Lootboxen oder Gacha) verwendet wird, aktivieren Sie den Schalter Mark as paid randomized reward.
Wählen Sie Create aus.
Wählen Sie im sich öffnenden Fenster den Artikelstatus aus und wählen Sie Continue aus.
Der erstellte Artikel erscheint im Abschnitt All items.
So konfigurieren oder aktualisieren Sie ein Limit für einen bestehenden Gegenstand:
- Öffnen Sie Ihr Projekt im Kundenportal und wechseln Sie zum Abschnitt Items catalog > All items > Virtual items.
In Ihrem Konto konfigurieren und aktualisieren
- Der folgende Konfigurationsablauf wird beispielhaft mit virtuellen Gegenständen gezeigt.
- Vor der Konfiguration virtueller Gegenstände empfiehlt es sich, Gruppen zu erstellen. Gruppen ermöglichen einen mehrstufigen Katalog und die Steuerung der Anzeige im Shop.
- In Ihrem Konto können Sie Limits für einen bestimmten Artikel für alle Nutzer aktualisieren. Erweiterte Konfigurationsoptionen sind per API-Aufrufen verfügbar.
So erstellen Sie einen virtuellen Gegenstand samt Limit:
- Öffnen Sie Ihr Projekt im Kundenportal und wechseln Sie zum Abschnitt Items catalog > All items > Virtual items.
- Öffnen Sie das Projekt in Ihrem Konto und wechseln Sie zum Abschnitt Items catalog > All items > Virtual items.
- Öffnen Sie das Projekt in Ihrem Konto und wechseln Sie zum Abschnitt Items catalog > All items > Virtual items.
- Öffnen Sie das Projekt in Ihrem Konto und wechseln Sie zum Abschnitt Items catalog > All items > Virtual items.
- Öffnen Sie Ihr Projekt im Konto für Handyspiele und wechseln Sie zum Abschnitt Catalog.
- Wählen Sie Create manually aus und danach in der Drop-down-Liste Virtual item.
- Geben Sie im Abschnitt General settings Folgendes an:
- SKU
- eine oder mehrere Gruppen, zu denen der Artikel gehören soll (optional)
- Name
- Kurzbeschreibung
- Erweiterte Beschreibung – aktivieren Sie zum Hinzufügen den entsprechenden Schalter (optional)
- Laden Sie im Abschnitt Media optional ein oder mehrere Bilder oder Videos hoch – von Ihrem Gerät oder über einen Link. Im mit dem Xsolla Site Editor erstellten Shop zeigen alle Artikelkarten die Datei mit der Markierung Main an, während die übrigen Dateien nur in Artikelkarten mit Mediengalerie verfügbar sind. Die als Main markierte Datei wird außerdem in den Antworten der API-Aufrufe zur Katalogabfrage zurückgegeben.
- Legen Sie im Abschnitt Price settings Preise fest oder erstellen Sie einen kostenlosen Artikel:
- Um einen Preis festzulegen, wählen Sie Paid item, aktivieren Sie Real currency prices und/oder Virtual currency prices, und geben Sie den Preis an. Bei Bedarf regionale Preise konfigurieren.
- Um einen kostenlosen Artikel zu erstellen, wählen Sie Free item.
Ein Artikel kann Preise in mehreren echten und virtuellen Währungen haben. In diesem Fall müssen Sie für jeden Währungstyp eine Standardwährung angeben – jeweils eine unter den echten Währungen und eine unter den virtuellen Währungen.
Sie können einen Preis in virtueller Währung nur angeben, wenn die virtuelle Währung bereits im Projekt erstellt wurde.
- Um die Anzahl der zum Kauf verfügbaren Artikel zu begrenzen:
- Aktivieren Sie den Schalter im Abschnitt Limits und geben Sie die Menge an.
- Konfigurieren Sie die Häufigkeit des Limit-Resets. Wählen Sie dazu einen Zeitraum aus der Drop-down-Liste aus:
- Daily.
- Weekly.
- Monthly.
- Custom interval. Der Zeitraum wird ab dem Startdatum der Artikelanzeige im Shop berechnet.
- No regular refresh.
- Richten Sie den Reset-Zeitplan ein, indem Sie die zum gewählten Zeitraum passenden Parameter angeben.
So richten Sie eine zeitliche Anzeigebegrenzung für den Artikel ein (optional):
- Aktivieren Sie den Schalter im Abschnitt Add specific display period.
- Geben Sie die Zeitzone sowie den Beginn und das Ende des Zeitraums an.
Um das Ende des Anzeigezeitraums offen zu lassen, aktivieren Sie den Schalter No end date.
- Konfigurieren Sie Attribute optional auf eine der folgenden Arten:
- Wenn der kostenpflichtige Artikel in Mechaniken mit zufälliger Belohnung (z. B. Lootboxen oder Gacha) verwendet wird, aktivieren Sie den Schalter Mark as paid randomized reward.
Wählen Sie Create aus.
Wählen Sie im sich öffnenden Fenster den Artikelstatus aus und wählen Sie Continue aus.
Der erstellte Artikel erscheint im Abschnitt All items.
So konfigurieren oder aktualisieren Sie Limits für einen bestehenden Artikel:
- Öffnen Sie das Projekt in Ihrem Konto und wechseln Sie zum Abschnitt Items catalog > All items > Virtual items.
- Öffnen Sie das Projekt in Ihrem Konto und wechseln Sie zum Abschnitt Items catalog > All items > Virtual items.
- Öffnen Sie das Projekt in Ihrem Konto und wechseln Sie zum Abschnitt Items catalog > All items > Virtual items.
In Ihrem Konto konfigurieren und aktualisieren
- Der folgende Konfigurationsablauf wird beispielhaft mit virtuellen Gegenständen gezeigt.
- Vor der Konfiguration virtueller Gegenstände empfiehlt es sich, Gruppen zu erstellen. Gruppen ermöglichen einen mehrstufigen Katalog und die Steuerung der Anzeige im Shop.
- In Ihrem Konto können Sie Limits für einen bestimmten Artikel für alle Nutzer aktualisieren. Erweiterte Konfigurationsoptionen sind per API-Aufrufen verfügbar.
So erstellen Sie einen virtuellen Gegenstand samt Limit:
- Öffnen Sie Ihr Projekt im Kundenportal und wechseln Sie zum Abschnitt Items catalog > All items > Virtual items.
- Öffnen Sie das Projekt in Ihrem Konto und wechseln Sie zum Abschnitt Items catalog > All items > Virtual items.
- Öffnen Sie das Projekt in Ihrem Konto und wechseln Sie zum Abschnitt Items catalog > All items > Virtual items.
- Öffnen Sie das Projekt in Ihrem Konto und wechseln Sie zum Abschnitt Items catalog > All items > Virtual items.
- Öffnen Sie Ihr Projekt im Konto für Handyspiele und wechseln Sie zum Abschnitt Catalog.
- Wählen Sie Create manually aus und danach in der Drop-down-Liste Virtual item.
- Geben Sie im Abschnitt General settings Folgendes an:
- SKU
- eine oder mehrere Gruppen, zu denen der Artikel gehören soll (optional)
- Name
- Kurzbeschreibung
- Erweiterte Beschreibung – aktivieren Sie zum Hinzufügen den entsprechenden Schalter (optional)
- Laden Sie im Abschnitt Media optional ein oder mehrere Bilder oder Videos hoch – von Ihrem Gerät oder über einen Link. Im mit dem Xsolla Site Editor erstellten Shop zeigen alle Artikelkarten die Datei mit der Markierung Main an, während die übrigen Dateien nur in Artikelkarten mit Mediengalerie verfügbar sind. Die als Main markierte Datei wird außerdem in den Antworten der API-Aufrufe zur Katalogabfrage zurückgegeben.
- Legen Sie im Abschnitt Price settings Preise fest oder erstellen Sie einen kostenlosen Artikel:
- Um einen Preis festzulegen, wählen Sie Paid item, aktivieren Sie Real currency prices und/oder Virtual currency prices, und geben Sie den Preis an. Bei Bedarf regionale Preise konfigurieren.
- Um einen kostenlosen Artikel zu erstellen, wählen Sie Free item.
Ein Artikel kann Preise in mehreren echten und virtuellen Währungen haben. In diesem Fall müssen Sie für jeden Währungstyp eine Standardwährung angeben – jeweils eine unter den echten Währungen und eine unter den virtuellen Währungen.
Sie können einen Preis in virtueller Währung nur angeben, wenn die virtuelle Währung bereits im Projekt erstellt wurde.
- Um die Anzahl der zum Kauf verfügbaren Artikel zu begrenzen:
- Aktivieren Sie den Schalter im Abschnitt Limits und geben Sie die Menge an.
- Konfigurieren Sie die Häufigkeit des Limit-Resets. Wählen Sie dazu einen Zeitraum aus der Drop-down-Liste aus:
- Daily.
- Weekly.
- Monthly.
- Custom interval. Der Zeitraum wird ab dem Startdatum der Artikelanzeige im Shop berechnet.
- No regular refresh.
- Richten Sie den Reset-Zeitplan ein, indem Sie die zum gewählten Zeitraum passenden Parameter angeben.
So richten Sie eine zeitliche Anzeigebegrenzung für den Artikel ein (optional):
- Aktivieren Sie den Schalter im Abschnitt Add specific display period.
- Geben Sie die Zeitzone sowie den Beginn und das Ende des Zeitraums an.
Um das Ende des Anzeigezeitraums offen zu lassen, aktivieren Sie den Schalter No end date.
- Konfigurieren Sie Attribute optional auf eine der folgenden Arten:
- Wenn der kostenpflichtige Artikel in Mechaniken mit zufälliger Belohnung (z. B. Lootboxen oder Gacha) verwendet wird, aktivieren Sie den Schalter Mark as paid randomized reward.
Wählen Sie Create aus.
Wählen Sie im sich öffnenden Fenster den Artikelstatus aus und wählen Sie Continue aus.
Der erstellte Artikel erscheint im Abschnitt All items.
So konfigurieren oder aktualisieren Sie ein Limit für einen bestehenden Gegenstand:
- Öffnen Sie das Projekt in Ihrem Konto für Handyspiele und gehen Sie zum Abschnitt Catalog > Virtual items.
Öffnen Sie die Gruppe, die den Artikel enthält.
Klicken Sie in der Zeile des Artikels auf ••• und wählen Sie in der Drop-down-Liste Edit.
Legen Sie im Abschnitt Limits for single user das Limit fest und/oder wählen Sie die Häufigkeit des Limit-Resets. Geben Sie anschließend Uhrzeit und Zeitzone an.
- Klicken Sie auf Save changes.
Über API-Aufrufe einrichten und aktualisieren
Um Kauflimits per API zu konfigurieren, verwenden Sie das Objekt limits in folgenden Methoden:
Übermitteln Sie das Objekt limits.recurrent_schedule mit dem entsprechenden Wert, je nachdem, ob die Zurücksetzung täglich, wöchentlich oder monatlich erfolgen soll.
Wenn ein Zeitraum für das Limit-Refresh konfiguriert ist, können Sie außerdem steuern, ob der Artikel nach Erreichen des Kauflimits im Katalog sichtbar bleibt. Übermitteln Sie dazu den Parameter “limits.per_user.limit_exceeded_visibility”: “show”.
Wenn kein wiederkehrendes Refresh konfiguriert ist, wird der Artikel nach Erreichen des Limits unabhängig vom Parameterwert im Katalog ausgeblendet.
Verwenden Sie die Methoden im Unterabschnitt Verwaltung der Methodengruppe Limits, um Limits über die API zu aktualisieren und zu verwalten.
| Funktion | API-Aufruf |
|---|---|
| Limits für einen bestimmten Artikel für alle oder ausgewählte Nutzer aktualisieren. | Refresh purchase limit. |
| Alle Artikellimits für einen bestimmten Nutzer zurücksetzen. | Refresh all purchase limits for specified user. |
| Kauflimit für einen bestimmten Artikel bei einem bestimmten Nutzer ändern. | Set number of items available to specified user. |
| Information zu den konfigurierten Limits eines bestimmten Artikels für einen bestimmten Nutzer abrufen. | Get number of items available to specified user. |
| Anzahl der Artikel, die ein bestimmter Nutzer kaufen kann, erhöhen. | Increase number of items available to specified user. |
| Anzahl der Artikel, die ein bestimmter Nutzer kaufen kann, verringern. | Decrease number of items available to specified user. |
Limits im Artikelkatalog anzeigen
Limits für Artikelverkäufe werden im Katalog angezeigt – je nachdem, wie sie implementiert sind: entweder über den Site Builder oder per API.
Anzeige über den Site Builder
Wenn Sie Site Builder verwenden, werden die Limits automatisch angezeigt: Auf der jeweiligen Artikelkarte zeigt ein Zähler die für den Nutzer verfügbare Artikelmenge an.
Limitinformationen per API abrufen
Wird der Katalog über eine API implementiert, werden die Begrenzungsinformationen in den folgenden katalogbezogenen API-Aufrufen im Array items.limits zurückgegeben:
- Get virtual items list
- Get virtual currency list
- Get virtual currency packages list
- Get bundles list
- Get games list
Artikel, bei denen der Nutzer das Kauflimit erreicht hat, werden zurückgesandt mit can_be_bought = false.
Sie können diese Limits bei Bedarf aktualisieren.
Diese Daten können dazu verwendet werden, Limits im Katalog anzuzeigen. Beispielsweise die maximale Anzahl an Exemplaren eines Artikels, die gekauft werden können.
Nützliche Links
Letztmalig aktualisiert: 15. Mai 2026Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.
