Integration in PlayFab

So funktioniert's

PlayFab bietet Spieleentwicklern gebrauchsfertige Serverlösungen für die Verwaltung des Artikelkatalogs und für die Monetarisierung. Nachdem PlayFab integriert wurde, können Sie:

• einen Katalog aus PlayFab in den Ingame-Shop importieren, um Xsolla-Lösungen zu verwenden.
• Artikel automatisch an PlayFab übermitteln, die ein Benutzer über den Ingame-Shop gekauft hat.

Für wen ist es

• Partner, die PlayFab integriert haben und nun den Absatz von Artikeln (virtuelle Währungen und virtuelle Gegenstände) über Xsolla-Lösungen ankurbeln möchten.
• Partner, die Xsolla-Lösungen integriert haben und nun ihre Artikel in PlayFab monetarisieren (Artikel gegen echte Währung verkaufen) möchten.

Importregeln

Beim Import von Artikeln aus PlayFab ist Folgendes zu beachten:

• Nicht aufbrauchbare Gegenstände aus PlayFab werden als virtuelle Gegenstände (und nicht als virtuelle Währung oder Bundles) importiert.
• Alle Artikel sowie virtuelle Währungspakete und Artikel in einem PlayFab-Bundle werden als aufbrauchbare Gegenstände (Parameter consumable = true oder nicht angegeben) importiert.
• Virtuelle Währungen werden mit dem Status Teilweise verfügbar und ohne Preisangabe importiert (API Flags: is_show_in_store = false, is_enabled = true, is_free = true).
• Ein Bundle, das nur eine virtueller Währung enthält, wird als virtuelles Währungspaket importiert.
• Bei einem Bundle, das mehrere virtuelle Währungen enthält, werden die einzelnen Währungen als separate virtuelle Währungspakete importiert. Für jede eindeutige Kombination aus SKU und Menge wird ein kostenloses virtuelles Währungspaket mit dem Status Teilweise verfügbar erstellt (API Flags: is_show_in_store = false, is_enabled = true, is_free = true).
• Ein Bundle, das verschiedene Artikeltypen enthält, wird als Bundle importiert.
• Wenn das Feld Beschreibung für einen Artikel in PlayFab nicht ausgefüllt ist, wird als Artikelbeschreibung die Bezeichnung aus dem Feld Name verwendet. Wenn kein Name angegeben ist, wird die SKU verwendet.

Importbeschränkungen

In-Game Store – Beschränkungen

• Container und Bundles, die Container enthalten, werden nicht importiert.
• DropTables und Bundles, die DropTables enthalten, werden nicht importiert.
• PlayFab-spezifische Parameter (z. B. isStackable, isTradable, UsageCount, UsagePeriod, UsagePeriodGroup) werden ignoriert.
• Aufbrauchbare Gegenstände werden ohne Berücksichtigung der Menge erstellt (der Gegenstand verschwindet nach der ersten Verwendung aus dem Inventar).

PlayFab – Beschränkungen

• PlayFab speichert keine in echten Währungen angegebenen Preise. Es wird nur eine vorkonfigurierte virtuelle Währung verwendet, die als RM (Real Money) kodiert ist und einer echten Währung entspricht: 1 Cent (100 RM = 1 USD). Daher können Artikel nur in virtueller Währung oder in RM bepreist werden.
• Die SKUs der Artikel müssen eindeutig sein und dürfen aus Zahlen, lateinischen Buchstaben, Bindestrichen und Unterstrichen bestehen.

Wie komme ich dazu

Katalog aus PlayFab importieren

Wenn Sie PlayFab noch nicht konfiguriert haben, gehen Sie wie folgt vor:

• Erstellen Sie ein PlayFab-Konto.
• Erstellen Sie Ihr Spiel.
• Besorgen Sie sich die eindeutige Titel-ID Ihres Spiels.
• Besorgen Sie sich Ihren geheimen PlayFab-Schlüssel.

Wechseln Sie zum Kundenportal, und importieren Sie den Artikelkatalog aus PlayFab in den Ingame-Shop.

1. Öffnen das Kundenportal, und navigieren Sie zu Store > Katalogverwaltung > Integration in externe Plattformen > PlayFab.
2. Geben Sie auf der Registerkarte Artikelimport Folgendes an:
   • Titel-ID – Projekt-ID in PlayFab.
   • Geheimer Schlüssel – Schlüssel des Projekts in PlayFab.
3. Klicken Sie auf Speichern.
4. Synchronisieren Sie das Benutzerinventar mit PlayFab (optional):
   1. Wechseln Sie zur Registerkarte Inventarsynchronisierung, und geben Sie Folgendes an:
      • Titel-ID – Projekt-ID in PlayFab.
      • Geheimer Schlüssel – Schlüssel des Projekts in PlayFab.
   2. Stellen Sie den Schalter Benutzerinventar mit PlayFab synchronisieren auf Ein.
   3. Klicken Sie auf Speichern.
5. Wechseln Sie zur Registerkarte Artikelimport, und klicken Sie auf Import starten. Daraufhin beginnt der Katalogimport.
6. Um virtuelle Gegenstände in dem über den Site Builder erstellten Web Shop zu verkaufen, konfigurieren Sie Gegenstandsgruppen im Kundenportal und weisen Sie jedem Gegenstand mindestens eine der konfigurierten Gruppen zu.
7. Um die Gegenstandsbilder anzuzeigen, müssen Sie diese im Kundenportal zunächst hochladen.

Um zu prüfen, ob der Import erfolgreich abgeschlossen wurde, müssen Sie in der Seitenleiste auf Store klicken und dann sicherstellen, dass Gegenstände, Währungen und Bundles auf den Registerkarten Virtuelle Währung, Virtuelle Gegenstände und Bundles aktiviert sind.

Katalog neu importieren

Wenn Sie einen Katalog neu importieren, ist Folgendes zu beachten:

• Bereits im Store befindliche Artikel werden aktualisiert.
• Noch nicht im Store befindliche Artikel werden hinzugefügt.
• Aus der Importquelle entfernte Artikel verbleiben im Store. Solche Artikel können Sie im Kundenportal oder über die API löschen.

Dem PlayFab-Inventar Artikel hinzufügen

Sie können einrichten, dass im Xsolla-Ingame-Shop gekaufte Artikel Ihrem PlayFab-Inventar hinzugefügt werden. Folgende Möglichkeiten stehen zur Verfügung:

• Durch Synchronisierung des Benutzerinventars mit PlayFab.
• Indem Sie den PlayFab-Speicher in Xsolla Login integrieren. In diesem Fall ist die PlayFab-ID im Token angegeben. Werden vonseiten Xsollas Artikel zurückgegeben, wird eine Anfrage an PlayFab im Token gesendet.

So synchronisieren Sie das Benutzerinventar mit PlayFab:

1. Öffnen das Kundenportal, und navigieren Sie zu Store > Katalogverwaltung > Integration in externe Plattformen > PlayFab.
2. Wechseln Sie zur Registerkarte Inventarsynchronisierung, und geben Sie Folgendes an:
   • Titel-ID – eindeutige Spiel-ID in PlayFab.
   • Geheimer Schlüssel – Schlüssel des Projekts in PlayFab.
3. Stellen Sie den Schalter Benutzerinventar mit PlayFab synchronisieren auf Ein.
4. Klicken Sie auf Speichern.

Daraufhin werden die Informationen über die im Ingame-Shop gekauften Artikel automatisch an PlayFab übermittelt.

Letztmalig aktualisiert: 27. Dezember 2024