Länderspezifische Preise

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

Sie können regionale Preise auf folgende Arten hinzufügen, bearbeiten und löschen:

• mithilfe von API-Methoden

Funktionsweise

Der Artikelpreis wird beim Abruf des Katalogs je nach Land des Nutzers bestimmt. Beim Kauf über Pay Station wird der Preis eines Artikels in die Währung des Landes des Nutzers umgerechnet und enthält gegebenenfalls Steuern.

Standortbestimmung

Das Land des Nutzers wird in verschiedenen Phasen der Arbeit mit Katalog und Zahlung wie folgt ermittelt:

• Beim Abruf des Artikelkatalogs wird das Land des Nutzers im Parameter country der Methoden in den Gruppen Virtual items and currency oder Game keys übergeben.

  Wenn das Land nicht angegeben ist, wird es anhand der IP-Adresse des Nutzers ermittelt. Die Preise für den Artikelkatalog werden basierend auf dem Land des Nutzers ausgewählt.

• Beim Kauf eines Artikels:

  • Wenn Sie die Client-Methoden zum Erhalten eines Zahlungstokens verwenden, nutzen Sie diese clientseitig, nicht serverseitig. Land und Währung werden bei Client-Methoden anhand der IP-Adresse des Nutzers bestimmt. Die Verwendung von Client-Methoden auf der Serverseite kann zu einer falschen Währungsbestimmung führen und die Zahlungsmethoden im Zahlungsportal beeinflussen.

  • Wenn Sie die Servermethode Create payment token for purchase verwenden, übergeben Sie das Land im Parameter user.country.value im Anfragerumpf oder die IPv4-Adresse des Nutzers im Header X-User-Ip. Wenn beide Werte übergeben werden, hat user.country.value Priorität. IPv6-Adressen werden nicht unterstützt; die Übergabe kann zu einer falschen Erkennung von Land und Währung führen.

  Hinweis

  Sie können die Währung im Parameter settings.currency übergeben. Dieser Wert hat Vorrang vor dem Landeswert und beeinflusst die Anzeige der Zahlungswährung. Die Zahlungsmethoden in der Benutzeroberfläche der Zahlung werden weiterhin durch den Landeswert im Parameter user.country.value bestimmt.

Grundsätze der Preisdarstellung im Artikelkatalog

Verwenden Sie für alle Artikel im Katalog dieselbe Währungsliste. Die Preise werden nach folgender Logik verarbeitet:

• Wenn für mindestens einen Artikel kein Preis für das ausgewählte Land festgelegt ist, werden die Preise für den gesamten Artikelkatalog in diesem Land in die Standardwährung umgeschaltet.
• Wenn Artikel unterschiedliche Standardwährungen haben, werden die Preise in der Standardwährung des ersten Artikels im Katalog angezeigt. Wenn einer der Artikel keinen Preis in dieser Währung hat, wird in der Antwort auf die Kataloganfrage für ihn der Preiswert 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	Kommentar
USA	7 USD	In den USA wird USD verwendet. Ein spezieller Preis für die USA ist nicht festgelegt.
Japan	7 USD	Die Währung für Japan ist nicht angegeben, daher wird der Preis in der Standardwährung angezeigt.
Frankreich	6 EUR	In Frankreich wird EUR verwendet. Ein spezieller Preis für Frankreich ist nicht festgelegt.
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).
• In Malaysia sind die Preise für alle Artikel in Malaysischen Ringgit (MYR).
• In Südafrika sind die Preise für alle Artikel außer einem in Südafrikanischen Rand (ZAR).

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 in US‑Dollar (USD).
• Der Standardpreis für 2_test_item ist in 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 er nicht angegeben.

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

Die Standardwährung für 1_test_item ist USD. Sie stimmt nicht mit der Standardwährung von 2_test_item — EUR — überein. Außerdem gibt es in der Preisliste keinen Preis in USD dafür.

Daher wird für 2_test_item der Preiswert null zurückgegeben.

So erstellen Sie einen virtuellen Gegenstand mit einem regionalen Preis:

2. Wählen Sie Create manually aus und danach in der Drop-down-Liste Virtual item.

3. Geben Sie im Abschnitt General settings Folgendes an:
   • SKU
   • Eine oder mehrere Gruppen, denen der Artikel zugeordnet sein soll (optional)
   • Name
   • Kurzbeschreibung
   • Erweiterte Beschreibung — um sie hinzuzufügen, aktivieren Sie den entsprechenden Schalter (optional)

4. Laden Sie im Abschnitt Media optional ein oder mehrere Bilder oder Videos hoch — von Ihrem Gerät oder über einen Link. Im mit dem Xsolla Site Editor erstellten Shop zeigen alle Artikelkarten die Datei mit der Markierung Main an, während die übrigen Dateien nur in Artikelkarten mit Mediengalerie verfügbar sind. Die als Main markierte Datei wird außerdem in den Antworten der API-Aufrufe zur Katalogabfrage zurückgegeben.

5. Wählen Sie im Abschnitt Price settings die Option Paid item.

6. Stellen Sie den Schalter Real currency prices auf Ein und klicken Sie auf Set up prices.

7. Geben Sie im sich öffnenden Fenster die Währung und den Standardpreis an. Sie können USD durch eine andere Standardwährung ersetzen.

8. Richten Sie regionale Preise ein. Das ist auf zwei Arten möglich – 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. Um Länder zu entfernen, für die Sie keine regionalen Preise festlegen möchten, klicken Sie rechts neben dem Preis auf das Minus-Symbol.

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

4. Klicken Sie auf Apply.

9. Wenn Sie einen Preis in virtueller Währung hinzufügen möchten, aktivieren Sie den Schalter Virtual currency prices und geben Sie die Werte an.

10. So begrenzen Sie die Anzahl der zum Kauf verfügbaren Artikel:

    1. Aktivieren Sie den Schalter im Abschnitt Limits und geben Sie die Menge an.
    2. Konfigurieren Sie die Häufigkeit des Limit-Resets. Wählen Sie dazu einen Zeitraum aus der Drop-down-Liste:
       • Daily.
       • Weekly.
       • Monthly.
       • Custom interval. Das Intervall wird ab dem Startdatum der Artikelanzeige im Shop berechnet.
       • No regular refresh.
    3. Richten Sie den Reset-Zeitplan ein, indem Sie die Parameter angeben, die dem gewählten Zeitraum entsprechen.

11. So konfigurieren Sie eine zeitliche Anzeigebegrenzung für den Artikel (optional):

    1. Aktivieren Sie den Schalter im Abschnitt Add specific display period.
    2. Geben Sie die Zeitzone sowie den Beginn und das Ende des Zeitraums an.

    Um das Ende des Anzeigezeitraums offen zu lassen, aktivieren Sie den Schalter No end date.

12. Konfigurieren Sie Attribute optional auf eine der folgenden Arten:
    1. Fügen Sie Attribute und ihre Werte im JSON-Format hinzu.
    2. Erstellen Sie Attribute und ihre Werte manuell und verknüpfen Sie sie mit Artikeln.

13. Wenn der kostenpflichtige Artikel in Mechaniken mit zufälliger Belohnung verwendet wird (z. B. Lootboxen oder Gacha), aktivieren Sie den Schalter Mark as paid randomized reward.

14. Klicken Sie auf Create.

15. Wählen Sie im sich öffnenden Fenster den Artikelstatus und klicken Sie auf Continue.

Der erstellte Artikel erscheint im Abschnitt All items.

So bearbeiten Sie Preise:

2. Klicken Sie neben dem gewünschten Artikel auf ⋮ und wählen Sie Edit aus der Drop-down-Liste.

3. Klicken Sie im Abschnitt Price settings unter dem Standardpreis auf das Bearbeitungssymbol.

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

Merkmale:

• Laden Sie regionale Preise für mehrere Artikel gleichzeitig hoch oder aktualisieren Sie sie.
• Unterstützung für Artikel aller Typen:
  • virtuelle Gegenstände
  • virtuelle Währung
  • virtuelle Währungspakete
  • Bundles
  • Pakete von Spielschlüsseln auf einer bestimmten Plattform
• Validierung der hochgeladenen Daten. Wenn die Dateistruktur oder das Datenformat nicht den Anforderungen entspricht, sehen Sie während des Imports eine Fehlerliste.

Dateistruktur

Erforderliche Spalten der Datei:

• SKU — die Artikel-SKU, für die regionale Preise festgelegt werden sollen.
• Country — der Ländercode im Format ISO 3166-1 alpha-2. Prüfen Sie vor dem Hochladen der CSV-Datei die Liste der von Xsolla unterstützten Länder. Das Ausfüllen dieser Spalte ist optional. Beispiele für die Preisanzeige finden Sie, wenn das Land nicht angegeben ist.
• Currency — der Währungscode im Format ISO 4217.
• Amount — der Preis des Artikels. Verwenden Sie einen Punkt als Dezimaltrennzeichen.
• IsDefault — gibt an, ob es sich um den Standardpreis handelt. Geben Sie an:
  • 1 — für die Zeile mit dem Standardpreis. Dieser wird in allen Ländern angezeigt, für die keine regionalen Preise vorhanden sind.
  • 0 — für alle anderen Zeilen. Sie können die Zelle in der Spalte IsDefault auch leer lassen.

Hinweis

Der Preis in der Standardwährung darf nicht regional sein — lassen Sie die Zelle in der Spalte Country leer.

BEISPIEL

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

Falsch ausgefüllte Datei (mehrere Artikel, 3 Währungen, regionale Preise sind vorhanden).
Fehler: In virtual-item-1 und bundle-1 sind die Zellen in der Spalte Country nicht 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, 3 Währungen, regionale Preise sind vorhanden).

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

• Platform — die Plattform-SKU. Sie wird beim Festlegen regionaler Preise für Spielschlüssel verwendet, jedoch nicht für andere Artikel.

  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 gelten als verschiedene Entitäten. Für jede Entität muss ein Preis in der Standardwährung angegeben sein.

BEISPIEL

Korrekt ausgefüllte Datei (mehrere Spielschlüssel, 3 Währungen, regionale Preise sind vorhanden, 2 Plattformen).

Falsch ausgefüllte Datei (mehrere Spielschlüssel, 3 Währungen, regionale Preise sind vorhanden, 2 Plattformen).
Fehler 1: Falsche Gruppierung der Spielschlüssel nach SKU und Platform, wodurch statt drei neun Entitäten gefunden werden.
Fehler 2: Die Gruppen 3, 4, 5 und 6 haben aufgrund der falschen Gruppierung keinen Standardpreis.
Fehler 3: Gruppe 9 überschreibt die Daten der Gruppe 7, da sie einen vollständigen Preissatz für dieselbe Entität haben. Dadurch hat game-key-2 für die Plattform playstation nach dem Import nur einen Preis in MYR.

Beispiele für das Ausfüllen der Datei und mögliche Fehler

Beispiele für eine korrekt ausgefüllte CSV-Datei für den Import:

• 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

Beispiele für eine falsch ausgefüllte CSV-Datei für den Import:

• 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: Die Gruppen game-key-1 + steam und game-key-2 + steam haben keine Standardwährungen.

Fehler: In den Gruppen game-key-1 + steam und game-key-2 + steam ist US als Land für Standardpreise angegeben.

Fehler: Die Gruppen virtual-item-1 und bundle-1 haben keine Standardpreise.

Fehler: In den Gruppen virtual-item-1 und bundle-1 ist US als Land für Standardpreise angegeben.

Fehler 1: Falsche Gruppierung der Artikel nach SKU, wodurch statt drei fünf Entitäten gefunden werden.
Fehler 2: Gruppe 3 hat aufgrund der falschen Gruppierung keinen Standardpreis.
Fehler 3: Gruppe 4 überschreibt die Daten der Gruppe 2, weil beide einen vollständigen Preissatz für denselben Artikel enthalten. Dadurch hat die SKU für virtual-currency-1-pack-100 nach dem Import nur einen Preis in MYR.

Dateiimport

So importieren Sie Preise aus einer Datei:

3. Klicken Sie auf Import/Export und wählen Sie in der Drop-down-Liste im Block Import die Option Prices from CSV.

4. Laden Sie die Datei in das entsprechende Feld im Importfenster 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.

Beispiel:

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

Einrichtung mithilfe von API-Methoden

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

• in den Methoden zum Erstellen und Aktualisieren virtueller Gegenstände
• in den Methoden zum Erstellen und Aktualisieren virtueller Währungen
• in den Methoden zum Erstellen und Aktualisieren virtueller Währungspakete
• in den Methoden zum Erstellen und Aktualisieren von Bundles
• in den Methoden zum Erstellen und Aktualisieren von Spielschlüsselpaketen

Array (Beispiel):

 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]