Prix régionaux

Lors de la configuration du catalogue des objets, vous pouvez définir des politiques de prix pour les utilisateurs de différents pays (prix régionaux) pour les objets virtuels et les packages de clés de jeu. Par défaut, le prix de chaque objet ou package de clés de jeu est défini en USD. Vous pouvez définir des restrictions régionales et des prix régionaux en même temps.

Comment ça marche

Les prix du catalogue sont basés sur le pays de l’utilisateur.

Pendant le paiement via Pay Station, le prix du bien est converti dans la devise du pays de l’utilisateur et inclut les taxes, le cas échéant.

Détermination du pays

  • Lors de la récupération du catalogue des objets, le pays de l’utilisateur est passé dans le paramètre country dans les méthodes de la sous-section Catalogue du groupe de méthodes Objets et monnaie virtuels ou Game keys.
    Si le pays n’est pas spécifié, il sera déterminé en fonction de l’adresse IP de l’utilisateur. Ensuite, les prix du catalogue des objets sont sélectionnés pour le pays de l’utilisateur.
  • Lors de l’achat d’un objet :
    • Si vous utilisez les méthodes côté client pour obtenir un jeton de paiement, il est important de les utiliser uniquement côté client et non côté serveur. Le pays et la devise dans les méthodes côté client sont déterminés par l’adresse IP de l’utilisateur. Utiliser cette méthode côté serveur peut entraîner une détermination incorrecte de la devise et affecter les modes de paiement dans Pay Station.
    • Si vous utilisez la méthode serveur Créer un jeton de paiement pour un achat, assurez-vous de passer l’objet country dans le corps de la requête ou l’adresse IP de l’utilisateur dans l’en-tête X-User-Ip.
    1. Si le pays est passé dans le paramètre country.value en même temps que l'adresse IP dans l'en-tête X-User-Ip, la valeur du pays dans le paramètre country.value prévaut.
Note
Vous pouvez spécifier la devise dans le paramètre currency. Cette valeur prévaut sur la valeur du pays et affecte l’affichage de la devise de paiement. Notez toutefois que les méthodes de paiement dans l’interface de paiement dépendent toujours de la valeur du pays spécifiée dans le paramètre country.value.

Principes d'affichage des prix dans le catalogue des objets

Pour tous les objets du catalogue, veillez à utiliser une même liste de devises dans lesquelles les prix sont spécifiés.

Cette démarche est essentielle pour garantir que tous les objets du catalogue apparaissent dans une même devise. Si le prix n’est pas spécifié pour l’un des objets dans l’un des pays, les prix de l’ensemble du catalogue dans ce pays sont affichés dans la devise par défaut.

Si la devise par défaut varie pour les objets, les prix seront affichés dans la devise par défaut du premier objet du catalogue. Si l’un des objets ne comporte pas de prix dans cette devise, une valeur de prix null lui sera attribuée dans la réponse. Cela pourrait entraîner un affichage incorrect du prix de l’objet et potentiellement affecter l’affichage global du catalogue.

Exemples :

Qui peut l'utiliser

Les partenaires qui souhaitent stimuler leurs ventes dans les pays à faible pouvoir d’achat en définissant des politiques de prix pour les utilisateurs de différents pays.

Comment configurer

Vous pouvez ajouter, modifier et supprimer des prix régionaux :

Note
Lors de l’importation d’un catalogue depuis Google Play, les objets sont ajoutés avec des prix régionaux modifiables. Tenez compte des particularités de la mise à jour des données lors de la réimportation du catalogue.

Configuration dans le Compte éditeur lors de la création ou de la modification d'un objet

Pour créer un objet virtuel avec un prix régional :
  1. Ouvrez votre projet dans le Compte éditeur.
  2. Dans le menu latéral, cliquez sur Store.
  3. Dans le volet Virtual Items, cliquez sur Configure.
  4. Cliquez sur + et sélectionnez Create item dans la liste déroulante.
  1. Spécifiez :
    • l'image ;
    • l'UGS ;
    • le ou les groupes auxquels l'objet doit appartenir ;
    • le nom ;
    • la description ;
    • la propriété de l'objet — consommable, non consommable ou à durée limitée.
  2. Dans le bloc Price settings, choisissez Paid item.
  3. Réglez la bascule Pricing in real currency sur On et spécifiez le prix. Si vous ne définissez pas de prix régionaux, le prix de l'objet sera le même pour tous les pays, et ce, en dollars américains.
Note
Vous pouvez remplacer le dollar par une autre devise par défaut.
Avis
Vous ne pouvez pas créer un objet avec une valeur de prix nulle.
  1. Définissez les prix :
    • Pour définir le prix d'un objet dans différentes devises, cliquez sur + et spécifiez la devise et le prix ;
    • Pour définir des prix spéciaux pour des pays, cliquez sur Add pricing et spécifiez le pays, la devise et la quantité. Définissez autant de prix régionaux que vous souhaitez.
  2. Pour ajouter le prix en monnaie virtuelle, réglez la bascule Pricing in virtual currency sur On et spécifiez le prix.
  3. Pour limiter la disponibilité des objets à des utilisateurs spécifiques, réglez la bascule Limit number of times one user can buy this item sur On et précisez le nombre.
  4. Pour afficher un objet dans Store, réglez la bascule Show item in store sur On.
  5. Cliquez sur Create item.

Importer à partir d'un fichier dans le Compte éditeur

Vous pouvez importer des prix régionaux à partir d’un fichier pour des objets prédéfinis.

Fonctionnalités

  • Téléchargez ou mettez à jour des prix régionaux pour plusieurs objets à la fois.
  • Prise en charge de tous les types de biens :
    • objets virtuels ;
    • monnaie virtuelle ;
    • packages de monnaie virtuelle ;
    • lots ;
    • packages de clés de jeu pour une plateforme spécifique.
  • Validation des données téléchargées. Si la structure du fichier ou le format des données ne répond pas aux exigences, une liste d’erreurs s’affiche pendant l’importation.

Structure du fichier

Le fichier doit être au format CSV et contenir les colonnes suivantes :
Note
Ne modifiez pas les noms de colonnes en anglais, car cela pourrait entraîner des erreurs lors de l’importation du fichier.
  • SKU — UGS de l’objet pour lequel des prix régionaux doivent être définis.
  • Country — code du pays au format ISO 3166-1 alpha-2. Consultez la liste des pays pris en charge par Xsolla avant d’uploader le fichier CSV. Le remplissage des cellules de cette colonne est facultatif. Consultez les exemples d’affichage des prix si le pays n’est pas spécifié.
  • Currency — code de devise selon la norme ISO 4217.
  • Amount — prix de l’objet. Utilisez un point comme séparateur de décimales.
  • IsDefault — détermine si le prix est le prix par défaut. Spécifiez :

    • 1 — pour la ligne avec le prix par défaut. Il est affiché pour tous les pays sans prix régional ;
    • 0 — pour toutes les autres lignes. Vous pouvez également laisser la cellule dans la colonne IsDefault vide.

Note

Le prix par défaut ne doit pas être régional : laissez la cellule de la colonne Country vide.

EXEMPLE

Fichier correctement rempli (plusieurs articles, 3 devises, prix régionaux disponibles).

Fichier mal rempli (plusieurs objets, 3 devises, prix régionaux disponibles).
Erreur : Dans virtual-item-1 et bundle-1, les cellules des groupes dans la colonne Country ne sont pas vides.


Pour chaque nouvel objet ajouté, définissez le prix dans la devise par défaut. Sinon, une erreur s’affichera lors de l’importation du fichier.

EXEMPLE

Fichier correctement rempli (plusieurs articles, 3 devises, prix régionaux disponibles).

Fichier mal rempli (plusieurs objets, 3 devises, prix régionaux disponibles).
Erreur : il n’y a pas de devise par défaut pour les groupes virtual-item-1 et bundle-1.

  • Platform — UGS de la plateforme. Utilisée pour fixer les prix régionaux des clés de jeu, elle ne s’applique pas à d’autres objets.

    Plateformes disponibles.
    UGS de la plateformeNom de la plateforme
    steamSteam
    playstationPlayStation
    xboxXbox
    uplayUplay
    originOrigin
    drmfreeDRM Free
    gogGOG
    epicgamesEpic Games Store
    nintendo_eshopNintendo Switch eShop
    discord_game_storeDiscord Game Store
    oculusOculus
    viveportViveport
    stadiaGoogle Stadia

Note

Les clés de jeu portant la même UGS, mais associées à des plateformes différentes sont considérées comme des entités distinctes. Chaque entité doit disposer d’un prix spécifié dans la devise par défaut.

EXEMPLE

Fichier bien rempli (plusieurs clés de jeu, 3 devises, prix régionaux disponibles, 2 plateformes).

Fichier mal rempli (plusieurs clés de jeu, 3 devises, prix régionaux disponibles, 2 plateformes).
Erreur 1 : le groupement incorrect des clés de jeu par SKU et Platform, a conduit à l’identification de neuf entités au lieu de trois.
Erreur 2 : les groupes 3, 4, 5 et 6 n’ont pas de prix par défaut en raison d’un groupement incorrect.
Erreur 3 : le groupe 9 écrasera les données du groupe 7 parce qu’il contient un ensemble complet de prix pour la même entité. Par conséquent, game-key-2 pour la plateforme playstation ne comportera qu’un prix en MYR après l’importation.

Exemples de fichiers complétés et d'erreurs possibles

Exemples de remplissage correct du fichier CSV pour l’importation :
Exemples de remplissage incorrect du fichier CSV pour l’importation :

Importation de fichiers

Pour importer des prix à partir d’un fichier :
  1. Ouvrez votre projet dans le Compte éditeur.
  2. Dans le menu latéral, cliquez sur Store et accédez à la section contenant n’importe quel type de bien.
  3. Cliquez sur Import prices.

  1. Dans la fenêtre d’importation, vous pouvez télécharger le modèle de fichier et ajouter les valeurs.
  2. Téléchargez le fichier dans le champ correspondant de la fenêtre d’importation.
  3. En cas d’erreur lors de l’importation, la fenêtre d’importation affiche une liste de ces erreurs ainsi que des recommandations de correction. Apportez les modifications nécessaires au fichier et téléchargez-le à nouveau.

Après un téléchargement réussi, les prix régionaux des objets ayant les UGS spécifiées seront mis à jour en fonction des prix figurant dans le fichier. Les prix spécifiés précédemment seront supprimés.

Exemple :

Plusieurs prix sont indiqués dans différentes devises et plusieurs prix régionaux sont définis pour l’objet dans le Compte éditeur. Cependant, dans le fichier importé, il n’y a qu’un seul prix en euros. Après l’importation du fichier, seul un prix en euros sera spécifié pour cet objet dans le Compte éditeur.

Configuration à l'aide des méthodes API

Pour définir les prix régionaux à l’aide des méthodes API, passez un tableau d’objets contenant les paramètres de prix pour les pays :Exemple de tableau :
Copy
Full screen
Small screen
"prices": [
      {
        "amount": 100,
        "currency": "USD",
        "is_enabled": true,
        "is_default": true
      },
      {
        "amount": 200,
        "currency": "CZK",
        "country_iso": "CZ",
        "is_enabled": false,
        "is_default": false
      }
    ]
Cet article vous a été utile ?
Merci !
Que pouvons-nous améliorer ? Message
Nous sommes désolés de l'apprendre
Dites-nous pourquoi vous n'avez pas trouvé cet article utile. Message
Merci pour votre commentaire !
Nous examinerons votre message et l'utiliserons pour améliorer votre expérience.
Dernière mise à jour: 8 Novembre 2024

Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entée.

Signaler un problème
Nous améliorons continuellement notre contenu grâce à vos commentaires.
Indiquez votre adresse e-mail pour un suivi
Merci pour votre commentaire !