Kostenlose Artikel

Kostenlose Artikel sind Artikel, die ein Benutzer erhalten kann, ohne virtuelle oder echte Währung ausgeben zu müssen. Zu solchen Artikeln zählen:

• virtuelle Gegenstände
• Bundles
• Spielschlüssel
• virtuelle Währungspakete

Nur autorisierte Benutzer können kostenlose Artikel erhalten.
Nicht autorisierte Benutzer können nur den Katalog der kostenlosen Artikel einsehen.

Nutzungsbeispiel:

• An wichtigen Tagen können Sie kostenlose Artikel verschenken (z. B. am Gründungstag des Projekts), um treue Spieler zu belohnen.
• Sie können im Ingame-Shop kostenlose Starterpakete für das Spiel verschenken, um neue Nutzer für das Spiel zu gewinnen.

Für wen ist es

• Für Partner, die den Web Shop bereits integriert haben und einen neuen Produkttyp (kostenlose Artikel) einrichten möchten.
• Für Partner, die die Nutzerbindung erhöhen oder neue Spieler gewinnen möchten.

Integrationsablauf

Kostenlose Artikel lassen sich auf einen der folgenden Wege erstellen:

• über das Kundenportal
• über API-Aufrufe

Über das Kundenportal erstellen

So erstellen Sie einen kostenlosen Artikel (demonstriert am Beispiel von virtuellen Gegenständen):

1. Öffnen Sie Ihr Projekt im Kundenportal.
2. Klicken Sie in der Seitenleiste auf Online-Shop.
3. Klicken Sie bei Virtuelle Gegenstände auf Konfigurieren.
4. Klicken Sie auf das +-Symbol, und wählen Sie aus der Drop-down-Liste die Option Gruppe erstellen.
5. Geben Sie Folgendes an:
   • External ID
   • Gruppenname
6. Klicken Sie auf Gruppe erstellen, und wechseln Sie zur Gruppe.
7. Klicken Sie auf Artikel anlegen.
8. Geben Sie Folgendes an:
   • Bild
   • SKU
   • Eine oder mehrere Gruppen, zu denen der Gegenstand gehören soll
   • Name
   • Beschreibung
   • Gegenstandseigenschaften: aufbrauchbar, nicht aufbrauchbar oder zeitlich begrenzter Artikel

9. Wählen Sie im Abschnitt Preiseinstellungen die Option Kostenloser Artikel.
10. Wenn Sie beschränken möchten, wie oft ein Benutzer diesen Artikel kaufen darf, stellen Sie den Schalter Anzahl der Käufe dieses Artikels pro Benutzer beschränken auf Ein, und legen Sie fest, wie oft der Artikel gekauft werden kann.
11. Damit der Artikel im Online-Shop angezeigt wird, müssen Sie den Schalter Gegenstand im Online-Shop aktivieren auf Ein stellen.
12. Klicken Sie auf Artikel anlegen.

Über API-Aufrufe erstellen

1. Verwenden Sie API-Aufrufe aus dem Unterabschnitt "Verwaltung", um kostenlose Artikel zu erstellen:
   • Für virtuelle Gegenstände – Virtuellen Gegenstand erstellen
   • Für Währungspakete – Virtuelles Währungspaket erstellen
   • Für Bundles – Bundle erstellen
   Wenn Sie einen Artikel erstellen oder bearbeiten, müssen Sie is_free = true im Anfragerumpf übermitteln.
2. Rufen Sie den Bestellstatus eines Benutzers ab..
3. Wenn Sie beschränken möchten, wie oft ein bestimmter Benutzer einen Artikel kaufen darf, rufen Sie die Methode zum Erstellen oder Bearbeiten eines Artikels auf, und legen Sie den Wert im Parameter limits.per_user fest.

Im Web Shop einrichten

So zeigen Sie kostenlose Artikel im Web Shop an:

1. Öffnen Sie Ihr Projekt im Kundenportal, und wechseln Sie zum Site Builder.
2. Wählen Sie im Abschnitt Seiten die gewünschte Website aus, und klicken Sie auf Konfigurieren.
3. Scrollen Sie im Online-Shop-Block zum Abschnitt Online-Shop.
4. Wählen Sie im Feld Kauftyp auswählen, die zuvor hinzugefügten kostenlosen Artikel aus.

Letztmalig aktualisiert: 3. Oktober 2024