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. 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.
Hinweis
Sie können die Währung im Parameter currency übermitteln. Dieser Wert hat Vorrang vor dem Länderwert und beeinflusst die angezeigte Zahlungswährung. Welche Zahlungsmethoden im Zahlungsportal angezeigt werden, wird weiterhin durch den Länderwert im Parameter country.value bestimmt.

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:

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:

Hinweis
Beim Import eines Katalogs aus Google Play werden den Artikeln regionale Preise zugewiesen, die Sie bearbeiten können. Berücksichtigen Sie die Besonderheiten der Datenaktualisierung beim Reimport des Katalogs.

Einrichten über das Kundenportal beim Erstellen und Bearbeiten von Artikeln

So erstellen Sie einen virtuellen Gegenstand mit einem regionalen Preis:
  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.
  1. 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
  2. Wählen Sie im Block Preiseinstellung die Option Kostenpflichtiger Gegenstand.
  3. 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.
Hinweis
Sie müssen nicht USD als Standardwährung auswählen, sondern können eine beliebige festlegen.
Achtung
Sie können keinen Artikel mit einem Preiswert von Null erstellen.
  1. 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.
  2. 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.
  3. 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.
  4. Damit der Artikel im Online-Shop angezeigt wird, müssen Sie den Schalter Gegenstand im Store aktivieren auf Ein stellen.
  5. 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.

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:
Hinweis
Ändern Sie die englischen Spaltennamen nicht, da dies zu Fehlern beim Import der Datei führen kann.
  • 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-SKUPlattformname
    steamSteam
    playstationPlayStation
    xboxXbox
    uplayUplay
    originOrigin
    drmfreeDRM Free
    gogGOG
    epicgamesEpic Games Store
    nintendo_eshopNintendo Switch eShop
    discord_game_storeDiscord Game Store
    oculusOculus
    viveportViveport
    stadiaGoogle 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):
Falsch ausgefüllte CSV-Datei für den Import (Beispiel):

Dateiimport

So importieren Sie Preise aus einer Datei:
  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.

  1. Im Importfenster können Sie die Dateivorlage herunterladen und Ihre Werte eingeben.
  2. Laden Sie die Datei im entsprechenden Feld im Importfenster hoch.
  3. 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

Um regionale Preise über API-Methoden festzulegen, übermitteln Sie ein Array von Objekten mit länderspezifischen Preiseinstellungen:Array (Beispiel):
Copy
Full screen
Small screen
  • http
"prices": [
      {
        "amount": 100,
        "currency": "USD",
        "is_enabled": true,
        "is_default": true
      },
      {
        "amount": 200,
        "currency": "CZK",
        "country_iso": "CZ",
        "is_enabled": false,
        "is_default": false
      }
    ]
War dieser Artikel hilfreich?
Vielen Dank!
Gibt es etwas, das wir verbessern können? Nachricht
Das tut uns leid
Bitte erläutern Sie, weshalb dieser Artikel nicht hilfreich ist. Nachricht
Vielen Dank für Ihr Feedback!
Wir werden Ihr Feedback aufgreifen und dazu nutzen, Ihr Erlebnis verbessern.
Letztmalig aktualisiert: 8. November 2024

Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.

Problem melden
Wir überprüfen unsere Inhalte ständig. Ihr Feedback hilft uns, sie zu verbessern.
Geben Sie eine E-Mail-Adresse an, damit wir Sie erreichen können
Vielen Dank für Ihr Feedback!