Länderspezifische Preise

Sie können regionale Preise für alle Artikel in Ihrem Katalog festlegen und so den Umsatz in Ländern mit geringer Kaufkraft steigern. Standardmäßig sind die Preise in USD angegeben. Zusätzlich können Sie regionale Beschränkungen konfigurieren.

Regionale Preise lassen sich wie folgt hinzufügen, bearbeiten und löschen:

• im Kundenportal beim Erstellen/Bearbeiten eines Artikels
• durch Importieren der Preise aus einer JSON-Datei im Kundenportal oder mithilfe des API-Aufrufs Artikel aus JSON-Datei importieren
• mithilfe von API-Methoden

So funktioniert's

Die Preise im Katalog basieren auf dem Land des Nutzers.

Wird ein Artikel über Pay Station erworben, wird der Preis in die Landeswährung des Nutzers umgerechnet und enthält ggf. Steuern.

Standortbestimmung

• Beim Abruf eines Artikelkatalogs wird das Land des Nutzers im Parameter country in den Methoden der Untergruppe Katalog aus der Methodengruppe Virtuelle Gegenstände und Währung oder Spielschlüssel übermittelt.
  Ist kein Land angegeben, wird es anhand der IP-Adresse des Nutzers ermittelt. Anschließend werden die entsprechenden Preise für den Artikelkatalog ausgewählt.
• Beim Kauf eines Artikels:
  • Dürfen Sie Client-Aufrufe zur Erlangung eines Zahlungstokens nur clientseitig und nicht serverseitig verwenden. Das Land und die Währung in den Client-Aufrufen werden anhand der IP-Adresse des Nutzers ermittelt. Wird diese Methode serverseitig verwendet, besteht die Gefahr, dass eine falsche Währung ermittelt wird, was wiederum Auswirkungen hat auf die in Pay Station zur Auswahl stehenden Zahlungsmethoden.
  • Müssen Sie, sofern Sie den Serveraufruf Zahlungstoken für den Kauf erstellen verwenden, das Objekt country im Anfragerumpf oder die IP-Adresse des Nutzers im Header X-User-Ip übermitteln.

1. 1. Wenn das Land im Parameter country.value und die IP-Adresse im Header X-User-Ip übermittelt werden, hat der Länderwert im Parameter country.value Vorrang.

Grundlagen der Preisanzeige im Artikelkatalog

Sie sollten alle Artikel im Katalog durchgehend in denselben Währungen bepreisen. Das ist notwendig, damit alle Artikel im Katalog in derselben Währung angezeigt werden. Falls einer der Artikel nicht in der Landeswährung bepreist ist, werden den Nutzern aus diesem Land die Preise im gesamten Katalog in der Standardwährung angezeigt.

Sind für die Artikel unterschiedliche Standardwährungen festgelegt, werden im Katalog die Preise in der Standardwährung des ersten Artikels angezeigt. Wenn einer der Artikel nicht in dieser Währung bepreist ist, wird in der Antwort auf die Kataloganfrage als Preis dieses Artikels der Wert null zurückgegeben. Das führt zu einer falschen Anzeige des Artikelpreises und kann die Darstellung des gesamten Katalogs beeinträchtigen.

Beispiele:

• 1 Artikel, 1 Währung, keine regionalen Preise
• 1 Artikel, regionale Preise vorhanden
• Mehrere Artikel, regionale Preise vorhanden, eine Standardwährung
• Mehrere Artikel, regionale Preise vorhanden, verschiedene Standardwährungen

Die Standardwährung für den Artikel ist USD und der Preis beträgt 5 USD, es gibt keine länderspezifischen Einstellungen. In diesem Fall wird allen Nutzern unabhängig von ihrem Land dieser Preis angezeigt.

Im Projekt sind Preise in den folgenden Währungen festgelegt:

• Standardpreis: 7 USD
• Preis in Euro: 6 EUR
• regionale Preise:
  • Deutschland: 8 EUR
  • Italien: 5 EUR
  • Malaysia: 20 MYR
  • Südafrika: 90 ZAR

Je nach Land des Nutzers werden die Preise im Katalog wie folgt angezeigt:

Land des Nutzers	Katalogpreis	Anmerkung
USA	7 USD	In den USA wird der US-Dollar verwendet. Ein gesonderter Preis für die USA ist nicht angegeben.
Japan	7 USD	Eine Preisangabe in Japanischen Yen fehlt, deshalb wird der Preis in der Standardwährung angezeigt.
Frankreich	6 EUR	In Frankreich wird der Euro verwendet. Ein gesonderter Preis für Frankreich ist nicht angegeben.
Deutschland	8 EUR	Für Deutschland ist ein regionaler Preis festgelegt.
Italien	5 EUR	Für Italien ist ein regionaler Preis festgelegt.
Malaysia	20 MYR	Für Malaysia ist ein regionaler Preis festgelegt.
Südafrika	90 ZAR	Für Südafrika ist ein regionaler Preis festgelegt.

Im Projekt sind Preise in den folgenden Währungen festgelegt:

• der Standardpreis für alle Artikel ist in US-Dollar (USD) angegeben
• für Malaysia sind alle Artikel in Malaysischen Ringgit (MYR) bepreist
• für Südafrika sind alle Artikel außer einem in Südafrikanischen Rand (ZAR) bepreist

In diesem Fall wird der Katalog für Nutzer aus Malaysia in MYR angezeigt, für Nutzer aus Südafrika jedoch in USD, da der Preis eines Artikels nicht in ZAR angegeben wurde.

Im Projekt sind Preise in den folgenden Währungen festgelegt:

• der Standardpreis für 1_test_item ist US-Dollar (USD)
• der Standardpreis für 2_test_item ist Euro (EUR)
• in Südafrika ist der Preis für 1_test_item in Südafrikanischen Rand (ZAR) angegeben, für 2_test_item ist kein Preis in ZAR angegeben

In diesem Fall wird für Nutzer aus Südafrika der Preis in der Standardwährung des ersten Artikels (1_test_item) im Katalog angezeigt werden.

Die Standardwährung für 1_test_item ist USD. Sie ist nicht identisch mit der Standardwährung von 2_test_item, EUR. Außerdem fehlen in der Preisliste Angaben in USD.

Daher wird für 2_test_item als Preis der Wert null zurückgegeben.

Einrichtung über das Kundenportal beim Erstellen und Bearbeiten von Artikeln

1. Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zum Menüpunkt Artikelkatalog > Alle Artikel > Virtuelle Gegenstände.
2. Klicken Sie auf Hinzufügen, und wählen Sie Virtuelle Gegenstände aus.

3. Legen Sie Folgendes fest:
   • Bild
   • SKU
   • eine oder mehrere Gruppen, zu denen der Gegenstand gehören soll
   • Name
   • Beschreibung
   • Gegenstandseigenschaft: aufbrauchbar, nicht aufbrauchbar oder zeitlich begrenzter Artikel
4. Wählen Sie unter Preiseinstellungen die Option Kostenpflichtiger Gegenstand.
5. Stellen Sie den Schalter Preise in echter Währung auf Ein, und klicken Sie auf Preise festlegen.

6. Daraufhin öffnet sich ein Fenster. Legen Sie darin die Währung und den Standardpreis fest. Sie können USD durch eine andere Standardwährung ersetzen.

7. Legen Sie länderspezifische Preise fest. Dies kann auf zwei Arten erfolgen, manuell oder automatisch:

• So legen Sie Preise manuell fest:

1. Klicken Sie auf Länderspezifischen Preis hinzufügen, und fügen Sie die einzelnen Preise zeilenweise hinzu.

2. Klicken Sie auf Anwenden.

• So legen Sie Preise automatisch fest:

1. Klicken Sie auf Anhand des Standardpreises berechnen. Daraufhin wird eine Liste der Länder in alphabetischer Reihenfolge generiert, und für jedes Land wird der Preis in der Landeswährung auf der Grundlage von Wechselkursen und Steuern berechnet.

2. Sie können Länder, für die keine regionalen Preise angegeben werden müssen, entfernen, indem Sie rechts neben dem Preis auf das X klicken.

3. Um einen automatisch berechneten Preis zu bearbeiten, ändern Sie einfach den Wert in der entsprechenden Zeile.

4. Klicken Sie auf Änderungen übernehmen.

8. Wenn Sie den Preis in virtueller Währung angeben möchten, müssen Sie den Schalter Preise in virtueller Währung auf Ein stellen und den Preis festlegen.
9. Wenn Sie begrenzen möchten, wie oft ein Nutzer einen Gegenstand erwerben kann, gehen Sie bitte wie folgt vor:

1. Stellen Sie den Schalter Anzahl der Käufe dieses Artikels pro Benutzer beschränken auf Ein.

2. Legen Sie fest, wie oft der Artikel gekauft werden kann.

3. Wählen Sie ein Intervall aus, nach dem das Limit zurückgesetzt wird:

• Nicht regelmäßig aktualisieren

• Täglich

• Wöchentlich

• Monatlich

• Benutzerdefiniertes Intervall. Das Intervall berechnet sich ausgehend vom Startdatum des Artikel-Anzeigezeitraums im Shop.

10. Sie können festlegen, wie lange der Artikel im Shop angezeigt werden soll. Geben Sie dazu unter Gegenstand im Store aktivieren an, wann der Artikel angezeigt werden soll:
    • Immer – der Artikel ist ohne zeitliche Begrenzung im Shop erhältlich.
    • Begrenzte Zeit – wie können einen oder mehrere Zeiträume festlegen, innerhalb derer der Artikel im Shop erhältlich ist. Legen Sie für jeden Zeitraum die Zeitzone sowie das Start- und Enddatum fest. Aktivieren Sie bei Bedarf das Kontrollkästchen Kein Enddatum, damit der Artikel ab dem ausgewählten Datum im Shop erhältlich ist.

11. Klicken Sie auf Artikel anlegen.

1. Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zum Menüpunkt Artikelkatalog > Alle Artikel > Virtuelle Gegenstände.
2. Klicken Sie neben dem gewünschten Gegenstand auf ⋮, und wählen Sie Bearbeiten aus der Drop-down-Liste aus.
3. Klicken Sie im Abschnitt Preiseinstellungen unter dem Standardpreis auf Bearbeiten.

Einrichtung über das Kundenportal beim Import von Preisen aus einer Datei

Für vorab angelegte Artikel können Sie regionale Preise aus einer Datei importieren.

Funktionen

• Upload oder Aktualisierung regionaler Preise für mehrere Artikel auf einmal.
• Unterstützung für alle Artikeltypen:
  • virtuelle Gegenstände
  • virtuelle Währung
  • virtuelle Währungspakete
  • Bundles
  • Pakete mit Spielschlüsseln für eine bestimmte Plattform
• Prüfung der hochgeladenen Daten. Wenn die Struktur oder das Datenformat der Datei den Anforderungen nicht genügt, wird während des Imports eine Fehlerliste angezeigt.

Dateistruktur

Die Datei muss im CSV-Format vorliegen und die folgenden Spalten enthalten:

• SKU – die SKU des Artikels, für den regionale Preise festgelegt werden müssen.
• Country – Ländercode gemäß ISO 3166-1 Alpha-2. Werfen Sie einen Blick auf die Liste der von Xsolla unterstützten Länder, bevor Sie die CSV-Datei hochladen. Die Zellen in dieser Spalte müssen nicht ausgefüllt sein. Hier sehen Sie eine beispielhafte Preisanzeige, wenn kein Land festgelegt ist.
• Currency – der Währungscode gemäß ISO 4217.
• Amount – der Preis des Artikels. Verwenden Sie einen Punkt als Dezimaltrennzeichen.

• IsDefault – ob es sich um den Standardpreis handelt. Legen Sie Folgendes fest:

  • 1 – für die Zeile mit dem Standardpreis. Wird in allen Ländern angezeigt, für die keine regionalen Preise festgelegt sind.
  • 0 – für alle anderen Zeilen. Sie können die Zellen in der Spalte IsDefault auch leer lassen.

Hinweis

Der Standardpreis sollte nicht regionalspezifisch sein – lassen Sie die Zelle in der Spalte Country leer.

BEISPIEL

Korrekt ausgefüllte Datei (mehrere Artikel, drei Währungen, regionale Preise sind festgelegt).

Falsch ausgefüllte Datei (mehrere Artikel, drei Währungen, regionale Preise sind festgelegt).
Fehler: In den Gruppen virtual-item-1 und bundle-1 ist die jeweilige Zelle in der Spalte Country ausgefüllt statt leer.

Wenn Sie einen neuen Artikel hinzufügen, müssen Sie dessen Preis in der Standardwährung angeben. Wenn Sie dies nicht tun, wird beim Importieren der Datei ein Fehler angezeigt.

BEISPIEL

Korrekt ausgefüllte Datei (mehrere Artikel, drei Währungen, regionale Preise sind festgelegt).

Falsch ausgefüllte Datei (mehrere Artikel, drei Währungen, regionale Preise sind festgelegt).
Fehler: Für die beiden Gruppen virtual-item-1 und bundle-1 ist keine Standardwährung festgelegt.

• Platform – Die Plattform-SKU. Wird nur bei der Festlegung regionaler Preise für Spielschlüssel verwendet, bei anderen Artikeln kommt sie nicht zum Einsatz.

  Verfügbare Plattformen:

  Plattform-SKU	Plattformname
  steam	Steam
  playstation	PlayStation
  xbox	Xbox
  uplay	Uplay
  origin	Origin
  drmfree	DRM Free
  gog	GOG
  epicgames	Epic Games Store
  nintendo_eshop	Nintendo Switch eShop
  discord_game_store	Discord Game Store
  oculus	Oculus
  viveport	Viveport
  stadia	Google Stadia

Hinweis

Spielschlüssel mit derselben SKU, aber für unterschiedliche Plattformen, werden als unterschiedliche Entitäten betrachtet. Für jede Entität muss ein Preis in der Standardwährung angegeben sein.

BEISPIEL

Korrekt ausgefüllte Datei (mehrere Spielschlüssel, drei Währungen, regionale Preise sind festgelegt, zwei Plattformen).

Falsch ausgefüllte Datei (mehrere Spielschlüssel, drei Währungen, regionale Preise sind festgelegt, zwei Plattformen).
Fehler 1: Spielschlüssel fälschlicherweise nach SKU und Platform gruppiert, wodurch neun statt drei Entitäten entstehen.
Fehler 2: Die Gruppen 3, 4, 5 und 6 haben aufgrund der falschen Gruppierung keinen Standardpreis.
Fehler 3: Gruppe 9 überschreibt die Daten von Gruppe 7, da beide Gruppen einen kompletten Satz Preise für dieselbe Entität enthalten. Folglich wird game-key-2 für die Plattform playstation nach dem Import nur in MYR bepreist sein.

Ausgefüllte Dateien und mögliche Fehler (Beispiele)

Korrekt ausgefüllte CSV-Datei für den Import (Beispiel):

• Mehrere Artikel, drei Währungen, keine regionalen Preise
• Mehrere Artikel, eine Währung, keine regionalen Preise
• Mehrere Spielschlüssel, drei Währungen, regionale Preise sind festgelegt, eine Plattform
• Mehrere Spielschlüssel, drei Währungen, keine regionalen Preise, zwei Plattformen

Copy

Full screen

Small screen

• csv

 1SKU,Currency,Amount,Country,IsDefault
 2virtual-item-1,EUR,9.09,,0
 3virtual-item-1,USD,10.1,,1
 4virtual-item-1,MYR,47,,0
 5virtual-currency-1-pack-100,EUR,2.09,,0
 6virtual-currency-1-pack-100,USD,2.3,,1
 7virtual-currency-1-pack-100,MYR,24,,0
 8bundle-1,EUR,15,,0
 9bundle-1,USD,17,,1
10bundle-1,MYR,82,,0

Copy

Full screen

Small screen

• csv

1SKU,Currency,Amount,Country,IsDefault
2virtual-item-1,USD,10.1,,1
3virtual-currency-1-pack-100,USD,2.3,,1
4bundle-1,USD,17,,1

Copy

Full screen

Small screen

• csv

 1SKU,Currency,Amount,Country,IsDefault,Platform
 2game-key-1,EUR,9.09,,1,steam
 3game-key-1,EUR,9.2,DE,0,steam
 4game-key-1,EUR,8.09,IT,0,steam
 5game-key-1,USD,10.1,US,0,steam
 6game-key-1,MYR,47,MY,0,steam
 7game-key-2,EUR,2.09,,1,steam
 8game-key-2,EUR,2.2,DE,0,steam
 9game-key-2,EUR,1.79,IT,0,steam
10game-key-2,USD,2.3,US,0,steam
11game-key-2,MYR,24,MY,0,steam

Copy

Full screen

Small screen

• csv

 1SKU,Currency,Amount,Country,IsDefault,Platform
 2game-key-1,USD,10.1,,1,steam
 3game-key-1,EUR,9.09,,0,steam
 4game-key-1,MYR,47,,0,steam
 5game-key-1,USD,17,,1,playstation
 6game-key-1,EUR,15,,0,playstation
 7game-key-1,MYR,82,,0,playstation
 8game-key-2,USD,2.3,,1,steam
 9game-key-2,EUR,2.09,,0,steam
10game-key-2,MYR,24,,0,steam

• Mehrere Spielschlüssel, drei Währungen, keine regionalen Preise, zwei Plattformen
• Mehrere Spielschlüssel, drei Währungen, regionale Preise sind festgelegt, zwei Plattformen
• Mehrere Artikel, drei Währungen, regionale Preise sind festgelegt
• Mehrere Artikel, drei Währungen, regionale Preise sind festgelegt
• Mehrere Artikel, drei Währungen, keine regionalen Preise

Fehler: Für die beiden Gruppen game-key-1 + steam und game-key-2 + steam sind keine Standardpreise festgelegt.

Fehler: Für die beiden Gruppen game-key-1 + steam und game-key-2 + steam ist US als Land für Standardpreise festgelegt.

Fehler: Für die beiden Gruppen virtual-item-1 und bundle-1 sind keine Standardpreise festgelegt.

Fehler: Für die beiden Gruppen virtual-item-1 und bundle-1 ist US als Land für Standardpreise festgelegt.

Fehler 1: Artikel fälschlicherweise nach SKU gruppiert, wodurch fünf statt drei Entitäten entstehen.
Fehler 2: Gruppe 3 hat aufgrund der falschen Gruppierung keinen Standardpreis.
Fehler 3: Gruppe 4 überschreibt die Daten von Gruppe 2, da beide Gruppen einen kompletten Satz Preise für denselben Artikel enthalten. Folglich wird die SKU für virtual-currency-1-pack-100 nach dem Import nur in MYR bepreist sein.

Dateiimport

So importieren Sie Preise aus einer Datei:

1. Öffnen Sie Ihr Projekt im Kundenportal.
2. Klicken Sie in der Seitenleiste auf Artikelkatalog, und wählen Sie einen beliebigen Artikeltyp.
3. Klicken Sie auf Preise importieren.

4. Im Importfenster können Sie die Dateivorlage herunterladen und Ihre Werte eingeben.
5. Laden Sie die Datei im entsprechenden Feld im Importfenster hoch.
6. Falls während des Imports Fehler auftreten, werden im Importfenster eine Liste dieser Fehler und passende Korrekturvorschläge angezeigt. Nehmen Sie die erforderlichen Änderungen an der Datei vor, und laden Sie die Datei erneut hoch.

Nach dem erfolgreichen Upload werden die regionalen Preise für Artikel mit den angegebenen SKUs entsprechend den Preisen in der Datei aktualisiert. Zuvor festgelegte Preise werden überschrieben.

Example:

Im Kundenportal sind für einen Artikel mehrere Preise in verschiedenen Währungen sowie mehrere regionale Preise festgelegt. In der importierten Datei ist der Preis nur in EUR angegeben. Nach dem Import der Datei ist der Artikel im Kundenportal nur noch in EUR bepreist.

Darüber hinaus können Sie beim Import von Artikeln über den API-Aufruf Artikel aus JSON-Datei importieren regionale Preise festlegen.

Über API-Methoden einrichten

Um regionale Preise über API-Methoden festzulegen, übermitteln Sie ein Array von Objekten mit länderspezifischen Preiseinstellungen:

• in den Methoden für das Erstellen und Aktualisieren von virtuellen Gegenständen
• in den Methoden für das Erstellen und Aktualisieren von virtueller Währung
• in den Methoden für das Erstellen und Aktualisieren von virtuellen Währungspaketen
• in den Methoden für das Erstellen und Aktualisieren von Bundles

• in den Methoden für das Erstellen und Aktualisieren von Spielschlüsselpaketen

 1"prices": [
 2  {
 3    "amount": 100,
 4    "currency": "USD",
 5    "is_enabled": true,
 6    "is_default": true
 7  },
 8  {
 9    "amount": 200,
10    "currency": "CZK",
11    "country_iso": "CZ",
12    "is_enabled": false,
13    "is_default": false
14  }
15]