Regionale Preise

Wenn Sie einen Artikelkatalog einrichten, können Sie je nach Land unterschiedliche Preise (regionale Preise) für virtuelle Gegenstände und Spielschlüsselpakete festlegen. Der Preis für jeden Gegenstand oder jedes Spielschlüsselpaket ist standardmäßig in USD angegeben. Sie können regionale Einschränkungen und regionale Preise gleichzeitig festlegen.

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 für Nutzer 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 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, 2 Währungen, 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.

Der Artikel ist in zwei Währungen bepreist: in USD und in EUR. Allerdings sind keine länderspezifischen Preise festgelegt. In diesem Fall wird Nutzern aus Ländern der Eurozone 7 EUR als Preis angezeigt. Nutzern aus allen anderen Ländern wird 5 USD als Preis angezeigt, da es sich hierbei um den Preis in der Standardwährung hält.

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 Benutzers	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.

Für wen ist es

Partner, die ihren Umsatz in Ländern mit geringer Kaufkraft steigern wollen, indem sie im Shop unterschiedliche Preise für Nutzer aus verschiedenen Ländern festlegen.

Wie komme ich dazu

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

• im Kundenportal beim Erstellen/Bearbeiten eines Artikels
• im Kundenportal durch Import der Preise aus einer Datei
• über API-Methoden

Einrichten über das Kundenportal beim Erstellen und Bearbeiten von Artikeln

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 +, und wählen Sie in der Drop-down-Liste die Option Artikel anlegen.

5. Legen Sie Folgendes fest:
   • Bild
   • SKU
   • Eine oder mehrere Gruppen, zu denen der Gegenstand gehören soll
   • Name
   • Beschreibung
   • Gegenstandseigenschaften: Aufbrauchbar, Nicht aufbrauchbar oder zeitlich begrenzter Artikel
6. Wählen Sie im Block Preiseinstellung die Option Kostenpflichtiger Gegenstand.
7. Stellen Sie den Schalter Preise in echter Währung auf Ein, und legen Sie den Preis fest. Wenn Sie keine regionalen Preise festlegen, ist der Preis eines Artikels in allen Ländern derselbe und in US-Dollar angegeben.

8. Preise festlegen:
   • Wenn Sie den Preis eines Artikels in verschiedenen Währungen angeben möchten, klicken Sie auf + und geben Sie die Währung und den Preis an.
   • Wenn Sie spezielle Preise für Länder festlegen möchten, klicken Sie auf Preis hinzufügen und geben Sie das Land, die Währung und den Betrag an. Sie können beliebig viele regionale Preise festlegen.
9. Wenn Sie den Preis in virtueller Währung angeben möchten, stellen Sie den Schalter Preise in virtueller Währung auf Ein, und geben Sie den Preis an.
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 Store aktivieren auf Ein stellen.
12. Klicken Sie auf Artikel anlegen.

Im Kundenportal durch Import einer Datei

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

Merkmale:

• 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 Dateistruktur oder das Datenformat den Anforderungen nicht genügt, wird während des Imports eine Fehlerliste angezeigt.

• 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 – in der Zeile mit dem Standardpreis. Wird in allen Ländern angezeigt, für die keine regionalen Preise festgelegt sind.
  • 0 – in allen anderen Zeilen. Sie können die Zellen in der Spalte IsDefault auch leer lassen.

1. Der Standardpreis sollte nicht länderspezifisch sein, lassen Sie also die Zelle in der Spalte Country leer.
   Enthält die Datei mehrere Artikel-SKUs, muss für jede SKU ein Preis in der Standardwährung festgelegt sein. Ist dies nicht der Fall, wird beim Importieren der Datei ein Fehler angezeigt.

Preisdatei (Beispiel):

1. Öffnen Sie Ihr Projekt im Kundenportal.
2. Klicken Sie in der Seitenleiste auf Online-Shop, und scrollen Sie zu einem beliebigen Produkttyp.
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.

Beispiel:

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.

Über API-Methoden einrichten

• 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üsseln

"prices": [
      {
        "amount": 100,
        "currency": "USD",
        "is_enabled": true,
        "is_default": true
      },
      {
        "amount": 200,
        "currency": "CZK",
        "country_iso": "CZ",
        "is_enabled": false,
        "is_default": false
      }
    ]