Créer un produit intégré

À l'aide du système de facturation de Google Play, vous pouvez proposer des produits intégrés que les utilisateurs ne paient qu'une seule fois. C'est ce que l'on appelle des "produits ponctuels". Les produits intégrés peuvent inclure, entre autres, des récompenses virtuelles (par exemple, des niveaux de jeu ou des potions) ou encore des services premium dans votre application sur Google Play.

Vous pouvez également créer un abonnement que les utilisateurs paient de manière récurrente.

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

Disponibilité

Si vous vous trouvez dans un pays où l'inscription en tant que marchand est possible, vous pouvez utiliser le système de facturation Google Play.

Dans ce cas, pour pouvoir commencer à utiliser le système de facturation de Google Play dans vos applications, configurez un profil de paiement et consultez la documentation concernant l'API du système de facturation de Google Play.

Pour être disponible à l'achat, un produit doit être actif, son application doit être publiée et disponible dans le pays de l'utilisateur.

Si vous utilisez un compte de test, les articles actifs sont disponibles dans les applications non publiées. Pour en savoir plus, consultez le site pour les développeurs Android.

Une fois que vous avez créé un produit intégré, il est disponible pour tous les utilisateurs de la dernière version du Google Play Store.

Autorisations requises

Pour proposer un produit intégré, 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 toujours publier des applications qui utilisent l'autorisation com.android.vending.BILLING dans tous les pays.

Créer des produits intégrés

Créer un seul produit intégré

Avant de créer un produit, assurez-vous d'avoir bien réfléchi à vos identifiants produit. Les identifiants produit doivent être propres à votre application. Ils ne peuvent être ni modifiés, ni réutilisés après leur création.

• Les identifiants produit doivent commencer par un chiffre ou une lettre minuscule, et ils ne peuvent contenir que des chiffres (0-9), des lettres minuscules (a-z), des traits de soulignement (_) et des points (.).
• Vous ne pouvez pas modifier ni réutiliser un identifiant produit une fois le produit créé.
• 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 intégré, procédez comme suit :

1. Ouvrez la Play Console, puis accédez à la page Produits intégrés à l'application (Monétiser > Produits > Produits intégrés à l'application).
2. Cliquez sur Créer un produit.
3. Saisissez les informations détaillées sur le produit.
   • Identifiant produit : identifiant unique de votre produit intégré.
   • Titre : nom court de l'article (55 caractères au maximum, mais nous vous recommandons de limiter les titres à 25 caractères pour qu'ils s'affichent correctement partout), par exemple "Somnifère".
   • Description : description longue de l'article (200 caractères maximum), par exemple "Endort instantanément les créatures".
   • Icône : image unique et précise représentant votre produit. N'incluez ni texte, ni promotions, ni branding. L'icône du produit apparaît sur votre fiche Play Store et tout au long du parcours d'achat.
     • PNG 32 bits
     • 512 x 512 px
     • Jusqu'à 1 Mo
   • Prix : saisissez le prix dans votre devise locale ou sélectionnez un modèle de tarification.
   • Quantité multiple : autorisez le règlement de quantités multiples pour ce produit. Les utilisateurs pourront effectuer des achats en plusieurs quantités en dessous du seuil de leur pays/région. Veuillez noter les informations suivantes :
     • Pour que vous puissiez configurer le règlement de quantités multiples dans la Play Console, votre application a besoin de la bibliothèque Google Play Billing 4.0. Consultez le site pour les développeurs Android afin de découvrir comment intégrer la bibliothèque Google Play Billing à votre application.
     • Le règlement de quantités multiples n'est pas disponible dans certains pays ni certaines régions.
     • Dans la plupart des pays/régions où le règlement de quantités multiples est disponible, le seuil de tarification des codes SKU est d'environ 100 USD. Pour autoriser le règlement de quantités multiples, vous devez ajuster le prix (hors taxe) sous le seuil applicable dans chaque pays/région.
   • Exclusivité Play Points : proposez votre produit uniquement aux personnes participant au programme Google Play Points.
4. Enregistrez vos modifications, puis cliquez sur Activer pour que les utilisateurs aient accès à votre produit intégré.

Langues et traductions

Les produits intégrés sont disponibles dans la même langue par défaut que l'application à laquelle ils sont associés. Pour ajouter des traductions dans des langues spécifiques, sélectionnez un produit intégré, puis cliquez sur Gérer les traductions et appliquez les langues de votre choix. Pour en savoir plus, consultez Traduire et localiser votre application.

Créer un lot avec plusieurs produits intégrés

Pour créer plusieurs produits intégrés en une seule fois, vous pouvez importer un fichier CSV contenant des informations sur 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 intégrés, spécifiez la syntaxe CSV dans la première ligne et indiquez les informations détaillées sur les produits dans les lignes suivantes.

Important : Chaque article doit apparaître entièrement sur une seule ligne dans le fichier CSV.

Importer un fichier CSV de produits intégrés

1. Ouvrez la Play Console.
2. Accéder à la page Produits intégrés (Monétiser > Produits > Produits intégrés).
3. Cliquez sur Importer.
   • Importer plusieurs produits via un fichier CSV n'écrase les produits existants que si la valeur d'un identifiant produit dans le fichier CSV correspond à l'identifiant produit d'un produit intégré figurant dans la liste des produits. Le fait d'écraser un produit ne supprime pas les produits intégrés qui ne sont pas inclus dans le fichier CSV.
4. Pour importer votre fichier CSV, vous devez le glisser-déposer ou cliquer sur Importer.

Exporter un fichier CSV contenant les produits intégrés existants

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

1. Ouvrez la Play Console.
2. Accéder à la page Produits intégrés (Monétiser > Produits > Produits intégrés).
3. Cliquez sur Exporter.

Afficher un exemple de fichier CSV

Voici un exemple de syntaxe CSV à utiliser et trois exemples de produits intégré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. À la place, un prix est précisé pour le pays par défaut (France). La Play Console 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 distribué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 intégré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 intégrés peut contenir les valeurs suivantes, mais au moins une de ces valeurs n'est pas définie sur chaque ligne :

Product ID	Définir cette valeur dans le fichier CSV a le même effet que saisir un identifiant produit lors de la création d'un produit intégré. Si vous spécifiez un identifiant produit (Product ID) affecté à un produit intégré qui figure déjà dans une liste de produits, les données du produit intégré existant sont remplacées par les valeurs spécifiées dans le fichier CSV.
Publish State	Cette valeur doit être définie sur published ou unpublished. Cela revient à définir un produit intégré 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 informations détaillées sur le produit intégré n'est pas prise en charge. Si vous souhaitez fournir les traductions du titre et de la description d'un produit intégré, indiquez ces traductions explicitement dans le paramètre Locale.
Locale, Title et 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 lorsque vous ajoutez les 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 intégré 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 intégré 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,. Cependant, les autres langues peuvent varier selon les articles.
Auto Fill Prices, Country et Price	Vous pouvez définir le paramètre Auto Fill Prices sur true ou false. Si un produit intégré utilise un modèle de tarification, vous devez définir le paramètre Auto Fill Prices sur false et vous ne devez pas spécifier de valeur pour le paramètre Price. Remarque : Lorsque vous indiquez le prix d'un article dans un fichier CSV, vous devez spécifier 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 intégré 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 distribuez 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, utilisez l'onglet Pays/Régions de la page Production. 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 définir le paramètre Auto Fill Prices sur false et vous ne devez pas spécifier 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. Définissez à la place les paramètres Auto Fill Prices, Country et Price en fonction de la manière dont vous souhaitez définir les prix du produit intégré. Si vous importez un fichier CSV, vous pouvez mettre à jour les liens entre les produits intégré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 intégré 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 intégré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.