Créer un produit géré

À l'aide du service de facturation Google Play, vous pouvez proposer des produits intégrés aux applications, pour lesquels les utilisateurs ne sont débités qu'une seule fois. On appelle cela des produits gérés. Les produits gérés peuvent inclure des articles tels que des biens virtuels (par exemple des niveaux de jeu ou des potions) et des services premium dans votre application sur Google Play.

  • Vous pouvez également créer un abonnement, qui facture les utilisateurs de manière récurrente.

Important : Le Règlement du programme Google Play (pour les développeurs) et les frais de transaction s'appliquent à tous les produits intégrés aux applications, y compris les abonnements et les produits gérés.

Disponibilité

Si vous vous trouvez dans un pays où il est possible de s'inscrire en tant que marchand, vous pouvez utiliser le service de facturation Google Play.

Pour ce faire, configurez un profil de paiement et consultez la documentation de l'API de facturation Google Play.

Une fois que vous avez créé un produit géré, ce dernier est accessible par tous les utilisateurs de la dernière version du Google Play Store.

Autorisations requises

Pour proposer un produit géré, vous devez déclarer l'autorisation com.android.vending.BILLING dans le fichier manifeste de l'APK de votre application. Si vous publiez votre application dans le monde entier, vous pouvez publier des applications qui utilisent l'autorisation com.android.vending.BILLING dans tous les pays.

Créer des produits gérés

Créer un seul produit géré

Avant de créer un produit géré, assurez-vous d'avoir réfléchi à vos identifiants produit. Les identifiants produit doivent être propres à votre application. Ils ne peuvent être modifiés ni réutilisés après leur création.
  • Les identifiants produit doivent commencer par une lettre minuscule ou un chiffre, et ils ne peuvent contenir que des lettres minuscules (a-z), des chiffres (0 à 9), des traits de soulignement (_) et des points (.).
  • Remarque : Vous ne pouvez pas utiliser android.test en tant qu'identifiant produit. Un identifiant produit ne peut pas non plus commencer par android.test.

Pour créer un produit géré, procédez comme suit :

  1. Connectez-vous à la console Play.
  2. Sélectionnez une application.
  3. Dans le menu de gauche, cliquez sur Présence sur le Play Store > Produits intégrés à l'application.
  4. Dans la partie droite de l'écran, cliquez sur Créer un produit géré.
  5. Saisissez les détails du produit.
    • Titre : nom court de l'article (55 caractères maximum, mais nous vous recommandons de limiter les titres à 25 caractères pour qu'ils s'affichent correctement partout), comme "Potion de sommeil".
    • Description : description longue de l'article (80 caractères maximum) de type "Endort instantanément les créatures".
    • Prix : saisissez le prix dans votre devise locale ou sélectionnez un modèle de tarification.
  6. À côté de l'option "État", sélectionnez Actif ou Inactif.
    • Pour être disponible à l'achat, un produit doit être actif et son application doit être publiée.
    • Si vous utilisez un compte de test, les articles actifs sont disponibles dans les applications non publiées. Pour en savoir plus, consultez notre site pour les développeurs Android.
  7. Cliquez sur Enregistrer.

Langues et traductions

Les produits gérés utilisent la même langue par défaut que l'application. Pour ajouter des traductions dans des langues spécifiques, sélectionnez un produit géré, puis cliquez sur Ajouter des traductionsEn savoir plus sur la traduction de votre application

Créer plusieurs produits gérés

Pour créer simultanément plusieurs produits gérés, vous pouvez télécharger un fichier CSV contenant les détails de chacun de vos produits.
Les fichiers CSV utilisent des virgules (,) et des points-virgules (;) pour séparer les valeurs de données. Les virgules séparent les valeurs de données principales et les points-virgules séparent les sous-valeurs.
Lorsque vous créez un fichier CSV de produits gérés, spécifiez la syntaxe CSV dans la première ligne, et indiquez les détails des produits dans les lignes suivantes.
Important : Chaque élément doit apparaître entièrement sur une seule ligne dans le fichier CSV.

Télécharger un fichier CSV de produits gérés

  1. Connectez-vous à la console Play.
  2. Sélectionnez une application.
  3. Dans le menu de gauche, cliquez sur Présence sur le Play Store > Produits intégrés à l'application.
  4. Sous l'onglet "Produits gérés", cliquez sur Importer/Exporter > Importer des produits gérés depuis un fichier CSV .
    • Pour écraser les produits gérés existants figurant dans votre liste de produits, cochez la case Écraser les produits existants. Les produits existants sont alors écrasés si la valeur d'un identifiant produit dans le fichier CSV correspond à l'identifiant produit d'un produit géré figurant dans la liste des produits. L'écrasement d'un produit ne supprime pas les produits gérés qui ne sont pas inclus dans le fichier CSV.
  5. Cliquez sur Parcourir les fichiers, puis sélectionnez votre fichier CSV.

Exporter un fichier CSV de produits gérés existants

Si vous avez créé séparément des produits gérés dans la console Play, l'exportation d'un fichier CSV peut être un bon moyen pour vous aider à en créer plusieurs à la fois directement grâce à ce type de fichier.

  1. Connectez-vous à la console Play.
  2. Sélectionnez une application.
  3. Dans le menu de gauche, cliquez sur Présence sur le Play Store > Produits intégrés à l'application.
  4. Sous l'onglet "Produits gérés", cliquez sur Importer/Exporter > Exporter des produits intégrés à l'application dans un fichier CSV.

Afficher un exemple de fichier CSV

Voici un exemple de syntaxe CSV à utiliser et trois exemples de produits gérés :
  • Le premier exemple définit un titre et une description dans deux langues différentes (fr_FR et es_ES). Un modèle de tarification définit le prix de l'article.
  • Le deuxième exemple n'utilise pas de modèle de tarification. Au lieu de cela, un prix est précisé pour le pays par défaut (France). La console Play utilise les taux de change en vigueur et les modèles de tarification pertinents localement pour définir automatiquement les prix dans tous les pays où l'application est publiée.
  • Le troisième exemple n'utilise pas non plus de modèle de tarification. Le prix de l'article est spécifié manuellement pour chaque pays dans lequel l'application est publiée.

Exemple de syntaxe CSV

Product ID,Published State,Purchase Type,Auto Translate,Locale; Title; Description,Auto Fill Prices,Price,Pricing Template ID

Exemples de produits gérés

Exemple 1

potion_de_sommeil_de_base,published,managed_by_android,false,fr_FR; Potion de sommeil de base; Endort les petites créatures.; es_ES; Poción básica de dormir; Causa las criaturas pequeñas ir a dormir.,false,,4637138456024710495

Exemple 2

potion_de_sommeil_standard, published,managed_by_android,false,fr_FR; Potion de sommeil standard; Endort les petites créatures pendant deux minutes.,true, 1990000,

Exemple 3

potion_d'invisibilité,published, managed_by_android,false,fr_FR; Potion d'invisibilité; Invisible pour tous les ennemis pendant 5 minutes., false, FR; 1990000; BR; 6990000; RU; 129000000; IN; 130000000; ID; 27000000000; MX; 37000000;

Valeurs de données pour les fichiers CSV 

Chaque ligne d'un fichier CSV de produits gérés peut contenir les valeurs suivantes, mais au moins une de ces valeurs n'est pas définie dans chaque ligne :  
Product ID

La définition de cette valeur dans le fichier CSV a le même effet que la saisie d'un identifiant produit lors de la création d'un produit géré.

Si vous spécifiez un identifiant produit (Product ID) affecté à un produit géré qui figure dans une liste de produits et que vous avez coché la case Écraser les produits existants dans la boîte de dialogue "Importer des produits intégrés à l'application", les données du produit géré existant sont remplacées par les valeurs que vous spécifiez dans le fichier CSV.

Publish State Cette valeur doit être définie sur published ou unpublished. Cela revient à définir un produit géré comme Actif ou Inactif.
Purchase Type

Cette valeur doit être définie sur managed_by_android.

Auto Translate

Cette valeur doit être définie sur false, car la traduction automatique des détails du produit géré n'est pas prise en charge.

Si vous souhaitez fournir la traduction du titre et de la description d'un produit géré, spécifiez ces traductions explicitement dans le paramètre Locale.

Locale, Titleet Description

Si vous n'incluez qu'une seule langue pour un article, vous devez spécifier les paramètres régionaux par défaut de votre application, ainsi que le titre et la description par défaut de l'article :

app_default_locale; item_default_title; item_default_description;

Lorsque vous définissez la valeur du paramètre Locale, vous pouvez utiliser les codes de langue qui s'affichent lors de l'ajout des traductions de votre fiche Play Store.

Remarque : Lorsque vous spécifiez les valeurs des paramètres Title et Description, utilisez des barres obliques inverses devant les points-virgules (\;) et les barres obliques inverses (\\).

Si vous souhaitez inclure des versions traduites du titre et de la description de l'article, vous devez répertorier la langue, le titre et la description par défaut, suivis des langues, des titres et des descriptions de chaque traduction. Dans l'exemple suivant, le produit géré utilise fr_FR (français de France) comme langue par défaut et es_ES (espagnol d'Espagne) comme traduction :

fr_FR; Cape d'invisibilité; Vous rend invisible.; es_ES; Capote Invisible; Se vuelven invisible.

Remarque : Une application contient une seule langue par défaut, mais chaque produit géré conserve sa propre liste de traductions. La première langue indiquée dans le paramètre Locale de chaque article doit être la même dans tout le fichier CSV, mais les autres langues peuvent varier selon les articles.

Auto Fill Prices (Remplissage automatique des prix), Country (Pays) et Price (Prix)

Vous pouvez régler le paramètre Auto Fill Prices sur true ou false. Si un produit géré utilise un modèle de tarification, vous devez définir le paramètre Auto Fill Prices sur false, et vous ne devez pas définir de valeur pour le paramètre Price.

Remarque : Lorsque vous spécifiez le prix d'un article dans un fichier CSV, vous devez indiquer le prix en micro-unités, où 1 000 000 micro-unités équivalent à 1 unité de monnaie réelle.

Utiliser le remplissage automatique des prix

Les sections suivantes décrivent l'impact du paramètre Auto Fill Prices sur la syntaxe et la signification des valeurs des paramètres Country et Price.

Si vous définissez Auto Fill Prices sur true, vous spécifiez uniquement le prix par défaut de l'article. N'incluez pas de valeur Country.

Supposons les conditions suivantes :

  • Le paramètre régional par défaut de votre application est fr_FR.
  • Le prix par défaut hors taxe d'un produit géré est de 1,99 €.
  • Vous voulez que les prix pour les autres pays soient remplis automatiquement.

Vous devez alors définir les paramètres Auto Fill Prices et Price à la fin d'une ligne dans le fichier CSV comme suit : true,1990000,

Définir votre propre prix par pays

Si vous définissez le paramètre Auto Fill Prices sur false, vous pouvez spécifier une série de valeurs Country et Price pour tous les pays où vous publiez votre application, y compris le pays correspondant aux paramètres régionaux par défaut de votre application. Chaque valeur Country correspond au code pays ISO composé de deux lettres majuscules, et représente un pays où votre application est disponible.

Remarque : Vous devez indiquer un code pays et un prix pour chaque pays ciblé par votre application. Pour afficher et modifier la liste des pays ciblés par votre application, ouvrez la page Tarifs et disponibilité de celle-ci.

Chaque valeur du paramètre Price correspond au coût de l'article en micro-unités de la devise utilisée dans ce pays.

Par exemple, si vous proposez votre application aux prix suivants (toutes taxes comprises) dans d'autres pays :

  • 6,99 R$ au Brésil 
  • 129 ₽ en Russie
  • 130 ₹ en Inde
  • 27 000 Rp en Indonésie
  • 37 $ au Mexique

Vous devez définir les paramètres Auto Fill Prices, Country et Price à la fin d'une ligne du fichier CSV comme suit :

false, BR; 6990000; RU; 129000000; IN; 130000000; ID; 27000000000; MX; 37000000;

Pricing Template ID (ID du modèle de tarification)

Si un article est associé à un modèle de tarification, vous devez régler le paramètre Auto Fill Prices sur false, et vous ne devez pas définir de valeur pour la colonne Price. Si l'article n'est pas associé à un modèle de tarification, vous ne devez pas définir de valeur pour le paramètre Pricing Template ID. Au lieu de cela, vous devez définir les paramètres Auto Fill Prices, Country et Price en fonction de la manière dont vous souhaitez définir les prix des produits gérés.

Si vous importez un fichier CSV et que vous avez coché la case Écraser les produits existants dans la boîte de dialogue "Importer les produits intégrés à l'application", vous pouvez mettre à jour les liens entre les produits gérés et les modèles de tarification. Pour associer le produit à un modèle de tarification spécifique, indiquez l'identifiant du modèle de tarification comme valeur du paramètre Pricing Template ID. Pour dissocier un produit géré de tous les modèles de tarification, ne définissez pas de valeur pour le paramètre Pricing Template ID correspondant.

Vous pouvez associer jusqu'à 1 000 prix d'application ou prix de produits gérés à un modèle de tarification particulier. Par conséquent, ne spécifiez pas la même valeur pour le paramètre Pricing Template ID dans plus de 1 000 lignes d'un fichier CSV.

Cet article vous a-t-il été utile ?
Comment pouvons-nous l'améliorer ?