Bundles

So funktioniert's

Ein Bundle enthält mehrere Artikel, die als Gesamtpaket verkauft werden.

Hauptmerkmale:

• Hinzufügen verschiedener Artikeltypen zu einem Bundle:
  • virtuelle Währung (einschließlich der plattformabhängigen Währung)
  • Paket mit virtueller Währung
  • Spielschlüssel für vorab ausgewählte DRMs
  • virtuelle Gegenstände, einschließlich automatisch endender Abos
  • Bundles
• Legen Sie die Preise für das Bundle in Echtgeld und virtueller Währung fest.

Ein Bundle wird automatisch nach folgenden Aktionen entpackt:

• Erfolgreicher Kauf
• Erfolgreiches Hinzufügen ins Spielerinventar über die Inventarverwaltungsmethoden

Die Bereitstellungsmethode für das Entpacken eines Bundles hängt vom Artikeltyp ab:

• virtuelle Währungspakete, virtuelle Gegenstände, automatisch endende Abos und Bundles werden wie folgt bereitgestellt:
  • ins Inventar (Standardmethode)
  • per PlayFab, sofern es integriert ist
• Spielschlüssel werden wie folgt bereitgestellt:
  • per E-Mail (Standardmethode)
  • per PlayFab, sofern es integriert ist

Wenn der Käufer das Paket zurückgibt, indem er z. B. eine Transaktion storniert, werden ihm automatisch alle aus dem Bundle gewährten Artikel entzogen. Wenn der Käufer einige der Artikel bereits genutzt hat, werden ihm die restlichen Artikel trotzdem entzogen.

Einschränkungen:

• Folgende Artikel können einem Bundle nicht hinzugefügt werden:
• dasselbe Bundle
• physische Waren
• Es kann kein leeres Bundle erstellt werden.
• Der Verkauf des Bundles wird pausiert, wenn die darin enthaltenen Schlüssel aufgebraucht sind.
• Das Bundle sollte gegen Echtgeld und/oder virtuelle Währung sowie zu einem Festpreis angeboten werden.
• Sie können regionale Beschränkungen für ein Bundle nur über die API konfigurieren.

Für wen ist es

Partner, die ein Set von Artikeln zu einem günstigeren Preis anbieten möchten, als die Gesamtsumme aller im Bundle enthalten Artikel (um so den Umsatz anzukurbeln und neue Spieler zu gewinnen) und die mindestens eines der beiden folgenden Produkte integriert haben:

• Ingame-Online-Shop samt konfiguriertem Virtuelle Gegenstände- oder Virtuelle Währung-Modul.
• Buy Button samt konfiguriertem Spielschlüssel-Modul.

Wie komme ich dazu

Voraussetzungen

1. Erstellen Sie ein Konto im Xsolla-Kundenportal.
2. Navigieren Sie zu Ihrem Projekt.

3. Navigieren Sie zu Projekteinstellungen > Integrationseinstellungen, und stellen Sie den Umschalter Commerce API integrieren auf Ein.

4. Konfigurieren Sie das Ingame-Online-Shop- oder das Buy Button-Modul.

Integrationsablauf

1. Richten Sie ein Bundle ein.
2. Implementieren Sie den Abruf von in Katalogen befindlichen Bundles.

Bundle einrichten

Richten Sie Bundles auf eine der folgenden Arten ein:

• über das Kundenportal
• über API-Methoden

Über Kundenportal einrichten

1. Navigieren Sie im Kundenportal zu Online-Shop > Bundles, und klicken Sie auf Bundle erstellen.
2. Legen Sie die folgenden Parameter für das Bundle fest:
   1. Bild
   2. Name
   3. Beschreibung
   4. Inhalte
   5. Preis
   6. Im Online-Shop anzeigen
3. Prüfen Sie die Einstellungen, und klicken Sie auf Speichern.

Über API-Methoden einrichten

Sie können die Methoden aus der Untergruppe Admin der Methodengruppe Bundles nutzen, um Bundles einzurichten.

Spielschlüssel einem Bundle hinzufügen

Um einem Bundle einen Spielschlüssel für ein ausgewähltes DRM hinzuzufügen, übermitteln Sie ein Array mit SKUs der erforderlichen DRMs an die Methode Create bundle oder Update bundle.

"content": [{
     “sku”: “brilliant_game_sku_steam”,
     “quantity”: 1
  }
]

Regionale Beschränkungen einrichten

Um für ein Bundle regionale Beschränkungen einzurichten, übermitteln Sie ein Array der IDs der unterstützten Regionen an die Methode Create bundle oder Update bundle.

"regions": [{
     “id”: “123”
  }, {
     “id”: “456”
  }
]

Regionale Preise festlegen

Um für ein Bundle regionale Preise festzulegen, übermitteln Sie ein Array der Objekte mit den Preisen für die jeweiligen Regionen an die Methode Create bundle oder Update bundle.

"regional_prices": [{
     “region_id”: “123”,
     “country_iso”: “CHN”,
     “amount”: 40,
     “currency_iso”: “CNY”,
     “is_default”: true,
     “is_enabled”: true
  }
]

In einem Katalog befindliche Bundles abrufen

Sie können die Methoden aus der Untergruppe Catalog der Methodengruppe Bundles nutzen, um in einem Katalog vorhandene Bundles abzurufen.