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.
Limits lassen sich für die folgenden Szenarien festlegen:
- Verkauf von Ingame-Items: virtuelle Gegenstände, virtuelle Währungspakete und Bundles
- Verkauf von Spielen und DLCs über Spielschlüssel
Sie können festlegen, dass das Limit regelmäßig zurückgesetzt wird, um:
- Wiederholungskäufe zu ermöglichen
- Daten mit Ihrem System zu synchronisieren, falls 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. Damit die verbleibende Anzahl der für den Nutzer erhältlichen Artikel unter Berücksichtigung des aktiven Limits angezeigt wird, müssen Sie die Autorisierungsdaten des Nutzers bei den folgenden Abfragen angeben:
- bei Abfrage des Artikelkatalogs über die Aufrufe aus dem Unterabschnitt Katalog der Gruppe Virtuelle Gegenstände und Währung
- bei Abfrage des Spielekatalogs über die Aufrufe aus dem Unterabschnitt Katalog der Gruppe Spielschlüssel
Xsolla kontrolliert die Limits und verhindert, dass die Nutzer mehr Artikel als erlaubt kaufen.
- Wenn das Zahlungsportal geöffnet und ein Artikel bezahlt wird, werden alle unbezahlten Bestellungen, die diesen Artikel enthalten, hinfällig.
- 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.
- Wird eine Zahlung erstattet oder eine Bestellung storniert, werden die Limits nicht zurückgesetzt. Die Limits lassen sich mit den folgenden API-Aufrufen zurücksetzen: Alle Kauflimits für den angegebenen Benutzer aktualisieren und Alle Werbeaktionslimits für den angegebenen Benutzer aktualisieren.
- Beispiel: Ein Nutzer kann einen Artikel mit Kauflimit erwerben, ihn im Spiel verwenden und anschließend eine Erstattung beantragen. Würden die Limits automatisch zurückgesetzt, könnte der Nutzer den Artikel erneut erwerben, verwenden und somit die vorgesehenen Limits umgehen. Deshalb werden die Limits bei einer Zahlungserstattung oder Bestellstornierung nicht zurückgesetzt.
Wie Sie eine Werbeaktion begrenzen, erfahren Sie in der entsprechenden Anleitung.
Limits konfigurieren und aktualisieren
Im Kundenportal konfigurieren und aktualisieren
- Der unten beschriebene Konfigurationsvorgang wird am Beispiel virtueller Gegenstände veranschaulicht.
- Vor der Konfiguration virtueller Gegenstände empfiehlt es sich, Gruppen zu erstellen. Mithilfe von Gruppen lässt sich ein mehrstufiger Katalog erstellen und die Anzeige der Artikel im Shop steuern.
- Im Kundenportal können Sie die Limits eines bestimmten Artikels für alle Nutzer aktualisieren. Erweiterte Konfigurationsoptionen sind über API-Aufrufe verfügbar.
So erstellen Sie einen virtuellen Gegenstand samt Limit:
- Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zum Menüpunkt Artikelkatalog > Alle Artikel > Virtuelle Gegenstände.
- Öffnen Sie das Projekt in Ihrem Konto, und navigieren Sie zum Menüpunkt Artikelkatalog > Alle Artikel > Virtuelle Gegenstände.
- Öffnen Sie das Projekt in Ihrem Konto, und navigieren Sie zum Menüpunkt Artikelkatalog > Alle Artikel > Virtuelle Gegenstände.
- Öffnen Sie das Projekt in Ihrem Konto, und navigieren Sie zum Menüpunkt Artikelkatalog > Alle Artikel > Virtuelle Gegenstände.
- Öffnen Sie Ihr Projekt im Handyspiele-Konto, und navigieren Sie zum Menüpunkt Katalog.
- Wählen Sie erst Manuell erstellen aus und danach in der Drop-down-Liste die Option Virtuelle Gegenstände.
- Geben Sie im Abschnitt Allgemeine Einstellungen Folgendes an:
- SKU
- Eine oder mehrere Gruppen, zu denen der Artikel gehören soll (optional)
- Name
- kurze Beschreibung
- erweiterte Beschreibung – aktivieren Sie hierzu den entsprechenden Schalter (optional)
- Im Abschnitt Medien können Sie optional ein oder mehrere Bilder oder Videos von Ihrem Gerät oder über einen Link hochladen. In dem mit dem Xsolla-Website-Editor erstellten Shop wird auf allen Artikelkarten die als Main gekennzeichnete Datei angezeigt, während die übrigen Dateien nur auf Artikelkarten mit einer Mediengalerie sichtbar sind. Die als Main gekennzeichnete Datei wird außerdem in den Antworten der API-Aufrufe zur Katalogabfrage zurückgegeben.
- Legen Sie im Abschnitt Preiseinstellungen Preise fest oder erstellen Sie einen kostenlosen Gegenstand:
- Wenn Sie einen Preis festlegen möchten, müssen Sie Kostenpflichtiger Gegestand auswählen, die Schalter Preise in echter Währung und/oder Preise in virtuelle Währung aktivieren und danach die gewünschten Preis angeben. Bei Bedarf können Sie regionale Preise konfigurieren.
- Wenn Sie stattdessen keinen Preis festlegen möchten, wählen Sie Kostenloser Gegenstand aus.
Ein Artikel kann in mehreren echten und virtuellen Währungen bepreist sein. In diesem Fall müssen Sie jeweils eine echte und eine virtuelle Währung als Standardwährung festlegen.
Sie können einen Preis in virtueller Währung nur angeben, wenn die virtuelle Währung bereits im Projekt erstellt wurde.
- So begrenzen Sie, wie viele Artikel ein Nutzer erhalten kann:
- Aktivieren Sie den Schalter im Abschnitt Limits, und legen Sie die gewünschte Höchstmenge fest.
- Konfigurieren Sie, wie häufig das Limit zurückgesetzt werden soll. Wählen Sie dazu einen Zeitraum aus der Drop-down-Liste aus:
- Täglich.
- Wöchentlich.
- Monatlich.
- Benutzerdefiniertes Intervall. Das Intervall läuft ab dem Datum los, an dem der Artikel im Shop erstmals angezeigt wird.
- Nicht regelmäßig zurücksetzen.
- Legen Sie anhand der Parameter für den ausgewählten Zeitraum fest, wann das Limit zurückgesetzt wird.
So richten Sie eine zeitliche Anzeigebegrenzung für den Artikel ein (optional):
- Aktivieren Sie den Schalter im Abschnitt Bestimmten Anzeigezeitraum hinzufügen.
- Legen Sie die Zeitzone sowie den Beginn und das Ende des Zeitraums fest.
Aktivieren Sie bei Bedarf den Schalter Kein Enddatum, um das Ende des Anzeigezeitraums offen zu lassen.
- Konfigurieren Sie Attribute optional auf eine der folgenden Arten:
- Falls der kostenpflichtige Gegenstand bei Zufallsmechaniken (z. B. Lootboxen oder Gacha) verwendet wird, müssen Sie den Schalter Als kostenpflichtige zufällige Belohnung kennzeichen aktivieren.
Klicken Sie auf Erstellen.
Wählen Sie im sich öffnenden Fenster den Artikelstatus aus, und klicken Sie auf Weiter.
Der erstellte Artikel wird im Abschnitt Alle Artikel angezeigt.
So konfigurieren oder aktualisieren Sie ein Limit für einen bestehenden Gegenstand:
In Ihrem Konto konfigurieren und aktualisieren
- Der unten beschriebene Konfigurationsvorgang wird am Beispiel virtueller Gegenstände veranschaulicht.
- Vor der Konfiguration virtueller Gegenstände empfiehlt es sich, Gruppen zu erstellen. Mithilfe von Gruppen lässt sich ein mehrstufiger Katalog erstellen und die Anzeige der Artikel im Shop steuern.
- In Ihrem Konto können Sie die Limits eines bestimmten Artikels für alle Nutzer aktualisieren. Erweiterte Konfigurationsoptionen sind über API-Aufrufe verfügbar.
So erstellen Sie einen virtuellen Gegenstand samt Limit:
- Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zum Menüpunkt Artikelkatalog > Alle Artikel > Virtuelle Gegenstände.
- Öffnen Sie das Projekt in Ihrem Konto, und navigieren Sie zum Menüpunkt Artikelkatalog > Alle Artikel > Virtuelle Gegenstände.
- Öffnen Sie das Projekt in Ihrem Konto, und navigieren Sie zum Menüpunkt Artikelkatalog > Alle Artikel > Virtuelle Gegenstände.
- Öffnen Sie das Projekt in Ihrem Konto, und navigieren Sie zum Menüpunkt Artikelkatalog > Alle Artikel > Virtuelle Gegenstände.
- Öffnen Sie Ihr Projekt im Handyspiele-Konto, und navigieren Sie zum Menüpunkt Katalog.
- Wählen Sie erst Manuell erstellen aus und danach in der Drop-down-Liste die Option Virtuelle Gegenstände.
- Geben Sie im Abschnitt Allgemeine Einstellungen Folgendes an:
- SKU
- Eine oder mehrere Gruppen, zu denen der Artikel gehören soll (optional)
- Name
- kurze Beschreibung
- erweiterte Beschreibung – aktivieren Sie hierzu den entsprechenden Schalter (optional)
- Im Abschnitt Medien können Sie optional ein oder mehrere Bilder oder Videos von Ihrem Gerät oder über einen Link hochladen. In dem mit dem Xsolla-Website-Editor erstellten Shop wird auf allen Artikelkarten die als Main gekennzeichnete Datei angezeigt, während die übrigen Dateien nur auf Artikelkarten mit einer Mediengalerie sichtbar sind. Die als Main gekennzeichnete Datei wird außerdem in den Antworten der API-Aufrufe zur Katalogabfrage zurückgegeben.
- Legen Sie im Abschnitt Preiseinstellungen Preise fest oder erstellen Sie einen kostenlosen Gegenstand:
- Wenn Sie einen Preis festlegen möchten, müssen Sie Kostenpflichtiger Gegestand auswählen, die Schalter Preise in echter Währung und/oder Preise in virtuelle Währung aktivieren und danach die gewünschten Preis angeben. Bei Bedarf können Sie regionale Preise konfigurieren.
- Wenn Sie stattdessen keinen Preis festlegen möchten, wählen Sie Kostenloser Gegenstand aus.
Ein Artikel kann in mehreren echten und virtuellen Währungen bepreist sein. In diesem Fall müssen Sie jeweils eine echte und eine virtuelle Währung als Standardwährung festlegen.
Sie können einen Preis in virtueller Währung nur angeben, wenn die virtuelle Währung bereits im Projekt erstellt wurde.
- So begrenzen Sie, wie viele Artikel ein Nutzer erhalten kann:
- Aktivieren Sie den Schalter im Abschnitt Limits, und legen Sie die gewünschte Höchstmenge fest.
- Konfigurieren Sie, wie häufig das Limit zurückgesetzt werden soll. Wählen Sie dazu einen Zeitraum aus der Drop-down-Liste aus:
- Täglich.
- Wöchentlich.
- Monatlich.
- Benutzerdefiniertes Intervall. Das Intervall läuft ab dem Datum los, an dem der Artikel im Shop erstmals angezeigt wird.
- Nicht regelmäßig zurücksetzen.
- Legen Sie anhand der Parameter für den ausgewählten Zeitraum fest, wann das Limit zurückgesetzt wird.
So richten Sie eine zeitliche Anzeigebegrenzung für den Artikel ein (optional):
- Aktivieren Sie den Schalter im Abschnitt Bestimmten Anzeigezeitraum hinzufügen.
- Legen Sie die Zeitzone sowie den Beginn und das Ende des Zeitraums fest.
Aktivieren Sie bei Bedarf den Schalter Kein Enddatum, um das Ende des Anzeigezeitraums offen zu lassen.
- Konfigurieren Sie Attribute optional auf eine der folgenden Arten:
- Falls der kostenpflichtige Gegenstand bei Zufallsmechaniken (z. B. Lootboxen oder Gacha) verwendet wird, müssen Sie den Schalter Als kostenpflichtige zufällige Belohnung kennzeichen aktivieren.
Klicken Sie auf Erstellen.
Wählen Sie im sich öffnenden Fenster den Artikelstatus aus, und klicken Sie auf Weiter.
Der erstellte Artikel wird im Abschnitt Alle Artikel angezeigt.
So konfigurieren oder aktualisieren Sie ein Limit für einen bestehenden Gegenstand:
In Ihrem Konto konfigurieren und aktualisieren
- Der unten beschriebene Konfigurationsvorgang wird am Beispiel virtueller Gegenstände veranschaulicht.
- Vor der Konfiguration virtueller Gegenstände empfiehlt es sich, Gruppen zu erstellen. Mithilfe von Gruppen lässt sich ein mehrstufiger Katalog erstellen und die Anzeige der Artikel im Shop steuern.
- In Ihrem Konto können Sie die Limits eines bestimmten Artikels für alle Nutzer aktualisieren. Erweiterte Konfigurationsoptionen sind über API-Aufrufe verfügbar.
So erstellen Sie einen virtuellen Gegenstand samt Limit:
- Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zum Menüpunkt Artikelkatalog > Alle Artikel > Virtuelle Gegenstände.
- Öffnen Sie das Projekt in Ihrem Konto, und navigieren Sie zum Menüpunkt Artikelkatalog > Alle Artikel > Virtuelle Gegenstände.
- Öffnen Sie das Projekt in Ihrem Konto, und navigieren Sie zum Menüpunkt Artikelkatalog > Alle Artikel > Virtuelle Gegenstände.
- Öffnen Sie das Projekt in Ihrem Konto, und navigieren Sie zum Menüpunkt Artikelkatalog > Alle Artikel > Virtuelle Gegenstände.
- Öffnen Sie Ihr Projekt im Handyspiele-Konto, und navigieren Sie zum Menüpunkt Katalog.
- Wählen Sie erst Manuell erstellen aus und danach in der Drop-down-Liste die Option Virtuelle Gegenstände.
- Geben Sie im Abschnitt Allgemeine Einstellungen Folgendes an:
- SKU
- Eine oder mehrere Gruppen, zu denen der Artikel gehören soll (optional)
- Name
- kurze Beschreibung
- erweiterte Beschreibung – aktivieren Sie hierzu den entsprechenden Schalter (optional)
- Im Abschnitt Medien können Sie optional ein oder mehrere Bilder oder Videos von Ihrem Gerät oder über einen Link hochladen. In dem mit dem Xsolla-Website-Editor erstellten Shop wird auf allen Artikelkarten die als Main gekennzeichnete Datei angezeigt, während die übrigen Dateien nur auf Artikelkarten mit einer Mediengalerie sichtbar sind. Die als Main gekennzeichnete Datei wird außerdem in den Antworten der API-Aufrufe zur Katalogabfrage zurückgegeben.
- Legen Sie im Abschnitt Preiseinstellungen Preise fest oder erstellen Sie einen kostenlosen Gegenstand:
- Wenn Sie einen Preis festlegen möchten, müssen Sie Kostenpflichtiger Gegestand auswählen, die Schalter Preise in echter Währung und/oder Preise in virtuelle Währung aktivieren und danach die gewünschten Preis angeben. Bei Bedarf können Sie regionale Preise konfigurieren.
- Wenn Sie stattdessen keinen Preis festlegen möchten, wählen Sie Kostenloser Gegenstand aus.
Ein Artikel kann in mehreren echten und virtuellen Währungen bepreist sein. In diesem Fall müssen Sie jeweils eine echte und eine virtuelle Währung als Standardwährung festlegen.
Sie können einen Preis in virtueller Währung nur angeben, wenn die virtuelle Währung bereits im Projekt erstellt wurde.
- So begrenzen Sie, wie viele Artikel ein Nutzer erhalten kann:
- Aktivieren Sie den Schalter im Abschnitt Limits, und legen Sie die gewünschte Höchstmenge fest.
- Konfigurieren Sie, wie häufig das Limit zurückgesetzt werden soll. Wählen Sie dazu einen Zeitraum aus der Drop-down-Liste aus:
- Täglich.
- Wöchentlich.
- Monatlich.
- Benutzerdefiniertes Intervall. Das Intervall läuft ab dem Datum los, an dem der Artikel im Shop erstmals angezeigt wird.
- Nicht regelmäßig zurücksetzen.
- Legen Sie anhand der Parameter für den ausgewählten Zeitraum fest, wann das Limit zurückgesetzt wird.
So richten Sie eine zeitliche Anzeigebegrenzung für den Artikel ein (optional):
- Aktivieren Sie den Schalter im Abschnitt Bestimmten Anzeigezeitraum hinzufügen.
- Legen Sie die Zeitzone sowie den Beginn und das Ende des Zeitraums fest.
Aktivieren Sie bei Bedarf den Schalter Kein Enddatum, um das Ende des Anzeigezeitraums offen zu lassen.
- Konfigurieren Sie Attribute optional auf eine der folgenden Arten:
- Falls der kostenpflichtige Gegenstand bei Zufallsmechaniken (z. B. Lootboxen oder Gacha) verwendet wird, müssen Sie den Schalter Als kostenpflichtige zufällige Belohnung kennzeichen aktivieren.
Klicken Sie auf Erstellen.
Wählen Sie im sich öffnenden Fenster den Artikelstatus aus, und klicken Sie auf Weiter.
Der erstellte Artikel wird im Abschnitt Alle Artikel angezeigt.
So konfigurieren oder aktualisieren Sie ein Limit für einen bestehenden Gegenstand:
- Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zum Menüpunkt Artikelkatalog > Alle Artikel > Virtuelle Gegenstände.
- Öffnen Sie das Projekt in Ihrem Konto, und navigieren Sie zum Menüpunkt Artikelkatalog > Alle Artikel > Virtuelle Gegenstände.
- Öffnen Sie das Projekt in Ihrem Konto, und navigieren Sie zum Menüpunkt Artikelkatalog > Alle Artikel > Virtuelle Gegenstände.
- Öffnen Sie das Projekt in Ihrem Konto, und navigieren Sie zum Menüpunkt Artikelkatalog > Alle Artikel > Virtuelle Gegenstände.
- Öffnen Sie das Projekt in Ihrem Handyspiele-Konto, und navigieren Sie zum Menüpunkt Katalog > Virtuelle Gegenstände.
- Öffnen Sie die Gruppe mit dem gewünschten Gegenstand.
- Klicken Sie in der Zeile mit dem gewünschten Gegenstand auf •••, und wählen Sie in Drop-down-Liste die Option Bearbeiten.
- Legen Sie im Abschnitt Limits pro Benutzer das Limit fest und/oder wie oft dieses zurückgestzt wird (Intervall). Geben Sie dann die Uhrzeit und die Zeitzone an.
- Klicken Sie auf Speichern.
Über API-Aufrufe einrichten und aktualisieren
Wenn Sie das Artikel-Kauflimit über die API konfiguireren möchten, müssen Sie das Objekt limits in den folgenden Methoden verwenden:
- Virtuellen Gegenstand erstellen
- Spiel erstellen
- Virtuelle Währung erstellen
- Virtuelles Währungspaket erstellenVirtuelles Währungspaket erstellen
- Bundle erstellen
Übermitteln Sie das Objekt limits.recurrent_schedule mit dem entsprechenden Wert, je nachdem, ob das Limit täglich, wöchentlich oder monatlich zurückgesetzt werden soll.
Nachdem Sie eingestellt haben, wie häufig das Limit zurückgesetzt wird, können Sie auch steuern, ob der Artikel im Katalog sichtbar bleibt, nachdem das Kauflimit erreicht wurde. Übermitteln Sie dazu den Parameter “limits.per_user.limit_exceeded_visibility”: “show”.
Wenn eingestellt ist, dass das Limit nicht regelmäßig zurückgesetzt wird, wird der Artikel – unabhängig vom Parameterwert – nach Erreichen des Limits 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 eines bestimmten Artikels für alle oder bestimmte Nutzer zurücksetzen. | Kauflimit aktualisieren. |
| Alle Artikellimits für bestimmten Nutzer löschen. | Alle Kauflimits für den angegebenen Benutzer aktualisieren. |
| Kauflimits eines bestimmten Artikels für einem bestimmten Nutzer ändern. | Anzahl der für einen bestimmten Benutzer verfügbaren Artikel festlegen. |
| Information zu den festgelegten Limits eines bestimmten Artikels für einen bestimmten Nutzer abrufen. | Anzahl der für einen bestimmten Benutzer verfügbaren Artikel abrufen. |
| Anzahl der Artikel, die ein bestimmter Nutzer kaufen kann, erhöhen. | Anzahl der für einen bestimmten Benutzer verfügbaren Artikel erhöhen. |
| Anzahl der Artikel, die ein bestimmter Nutzer kaufen kann, verringern. | Anzahl der für einen bestimmten Benutzer verfügbaren Artikel reduzieren. |
Limits im Artikelkatalog anzeigen
Die Verkaufslimits für Artikel werden im Katalog angezeigt, je nachdem, wie die Limits implementiert sind: entweder über Site Builder oder über die API.
Anzeige über 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 über die API abrufen
Wird der Katalog über eine API implementiert, werden die Limitinformationen in den folgenden katalogbezogenen API-Aufrufen im Array items.limits zurückgegeben:
- Liste virtueller Gegenstände abrufen
- Liste virtueller Währungen abrufen
- Liste virtueller Währungspakete abrufen
- Liste der Bundles abrufen
- Spieleliste abrufen
Artikel, bei denen der Nutzer das Kauflimit erreicht hat, werden unter Angabe voncan_be_bought = false zurückgegeben.
Die Limits können Sie bei Bedarf aktualisieren.
Mit den Daten lassen sich Limits im Katalog anzeigen, z. B. wie viele Exemplare eines Artikels maximal erhältlich sind.
Nützliche Links
Letztmalig aktualisiert: 14. Oktober 2026Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.
