Télécharger et exporter des rapports mensuels

Vous pouvez utiliser Play Console pour télécharger des rapports mensuels sur des applis individuelles en vue de faire le suivi des performances de votre appli et de les comprendre.

Types de rapports

Rapports détaillés

Les rapports détaillés comprennent des données sur les événements individuels :

• Avis
• Rapport financier : estimation des ventes, revenus, récompenses et commandes réglées par le solde du compte Play d'un utilisateur de la Corée du Sud

Rapports regroupés

Les rapports regroupés comprennent des données consolidées (moyennes, totaux quotidiens, etc.) pour les statistiques de l'application :

• Statistiques : installations, plantages, notes et abonnements
• Acquisition par les utilisateurs : installateurs ayant conservé l'application, acheteurs (sept jours après l'installation) et abonnés

Télécharger des rapports

1. Ouvrez Play Console.
2. Cliquez sur Télécharger des rapports , et sélectionnez Avis, Statistiques ou Finances.
3. Sous « Sélectionnez une application », tapez le nom de votre application et sélectionnez-le.
4. Sélectionnez l'année et le mois du rapport que vous souhaitez télécharger.

Remarque : Les rapports financiers comprennent toutes les applications de votre compte.

Télécharger les rapports de Google Cloud Storage

Les rapports sont accessibles sur Google Cloud Storage. Les rapports sont générés quotidiennement et regroupés dans les fichiers CSV mensuels. Ils sont stockés dans un compartiment Google Cloud Storage privé pour votre compte de développeur Google Play.

Vous pouvez accéder aux rapports en utilisant Google Cloud Storage sur votre navigateur ou en utilisant gsutil de manière programmée. Vous pouvez utiliser d'autres outils pour accéder par programmation à votre compartiment Cloud Storage.

Conseil : Si vous voulez importer vos rapports de Google Cloud Storage dans BigQuery, vous devez convertir les fichiers CSV d'UTF-16 à UTF-8.

Trouver votre URI de Google Cloud Storage

Vous pouvez copier votre URI de Google Cloud Storage en cliquant sur le bouton Copier l'URI de Cloud Storage à côté du titre de la section correspondant sur les pages Télécharger des rapports.

Votre URI de Cloud Storage commence par pubsite_prod_rev (p. ex. : pubsite_prod_rev_01234567890987654321).

Télécharger les rapports en utilisant un outil de ligne de commande

1. Installez l'outil gsutil.
   • Assurez-vous d'authentifier votre compte en utilisant un compte disposant d'un accès à Play Console.
   • Pendant le processus d'installation, si vous utilisez gsutil pour la première fois et que vous n'avez pas d'autres projets configurés dans Google Cloud Storage, vous pouvez entrer le nom de votre application lorsqu'on vous demande d'entrer un identifiant de projet.
2. Recherchez l'identifiant de votre compartiment de rapports en cliquant sur le bouton Copier l'URI de Cloud Storage à côté du titre de la section correspondant sur les pages Télécharger des rapports.
   • Votre URI de Cloud Storage commence par pubsite_prod_rev (p. ex. : pubsite_prod_rev_01234567890987654321).
3. Utilisez la commande gsutil cp pour télécharger les rapports.
   • Vous trouverez d'autres commandes vous permettant d'accéder à vos rapports dans la documentation de gsutil.

Les rapports sont organisés dans des répertoires nommés selon chaque type de rapport. Les noms de fichiers CSV comprennent le type de rapport, le nom du paquet, la période et la taille (le cas échéant).

Télécharger les rapports en utilisant une bibliothèque client et un compte de service

Étape 1 : Créer un compte de service

1. Ouvrez Google Developers Console.
2. Si vous avez déjà un projet, utilisez le menu déroulant pour le sélectionner. Si votre projet n'est pas répertorié ou si vous souhaitez en créer un, cliquez sur Créer un projet.
3. Sélectionnez l'icône Menu > Autorisations > Comptes de service > Créer un compte de service.
4. Suivez les instructions à l'écran, puis sélectionnez Créer.
5. Copiez l'adresse de courriel indiquée.
   • Exemple : [e-mail]

Étape 2 : Ajouter le compte de service à Play Console

1. Ouvrez Play Console.
2. Sélectionnez Paramètres  > Droits et comptes des utilisateurs > Inviter un nouvel utilisateur.
3. Collez ou tapez l'adresse de courriel associée à votre compte de service.
4. Selon les types de rapports nécessaires, sélectionnez les autorisations. 
   • Conseil : Lisez l'article Ajouter des utilisateurs au compte de développeur et gérer les autorisations pour comprendre les différents niveaux d'accès des utilisateurs et les droits que différentes autorisations leur accordent.
5. Cliquez sur Ajouter un utilisateur. Votre compte de service sera ajouté à votre compte.

Étape 3 : Récupérer des rapports à l'aide d'un appel d'API

1. Installez la bibliothèque client API pour votre langage de code favori.
2. Configurez le code effectuant l'appel d'API à utiliser pour l'authentification de serveur à serveur OAuth2 et pour demander l'autorisation relative à la portée OAuth2 (https://www.googleapis.com/auth/devstorage.read_only).
3. Problème d'appels API authentifiés pour récupérer des rapports.

Afficher un exemple (Python)

Si vous avez utilisé Python pour récupérer des rapports, voici un exemple de code :

import json

from httplib2 import Http

from oauth2client.client import SignedJwtAssertionCredentials

from apiclient.discovery import build

# Changez ces variables pour s'adapter à votre cas

client_email = 'votre compte de service ici'

json_file = 'path_to_json_file_obtained_when_creating_the_service_account'

cloud_storage_bucket = 'pubsite_prod_rev_…'

report_to_download = ‘earnings/earnings_….zip’

 

private_key = json.loads(open(json_file).read())['private_key']

credentials = SignedJwtAssertionCredentials(client_email, private_key,

   'https://www.googleapis.com/auth/devstorage.read_only')

storage = build('storage', 'v1', http=credentials.authorize(Http()))

print storage.objects().get(

   bucket=cloud_storage_bucket,

   object=report_to_download).execute()

Contrôler l'accès à Google Cloud Storage

Les rapports proposés dans Google Cloud Storage utilisent les mêmes restrictions d'accès que celles qui contrôlent l'accès aux données dans Play Console. Les utilisateurs d'un compte ayant accès à des sections d'un compte Play Console auront donc accès aux rapports correspondants dans Google Cloud Storage. 

Les propriétaires de compte peuvent en tout temps mettre à jour les autorisations pour les utilisateurs individuels.

• Pour accéder aux lots de rapports, votre autorisation « Visibilité » doit être définie à « Globale ». 
• Pour télécharger des rapports financiers, votre autorisation « Afficher les données financières » doit être définie à « Globale ».

Commandes et formats de fichiers des rapports détaillés

Plantages et applications qui ne répondent pas

Depuis mai 2018, vous ne pouvez plus télécharger les rapports détaillés des plantages et des ANR.

Avis

Avis

Commande

gs://[developer_bucket_id]/reviews/reviews_[package_name]_YYYYMM.csv

Format de fichier

Champ	Format	Facultatif	Exemples et remarques
Nom du paquet	Chaîne	NON	com.company.app
Code de la version de l'application	Nombre entier	OUI	Fichiers APK de production seulement
Nom de la version de l'application	Chaîne	OUI
Langue du rédacteur de l'avis	Chaîne – abréviation de deux lettres ISO 639-1	OUI	en
Appareil	Chaîne	OUI	hammerhead
Date et heure de l'envoi de l'avis	ISO_8601, y compris l'heure et le fuseau horaire UTC	NON	2014-06-19T19:12:32Z
Millisecondes de l'envoi de l'avis depuis l'époque	Nombre entier, millisecondes depuis l'époque	NON
Date et heure de la dernière mise à jour de l'avis	ISO_8601, y compris l'heure et le fuseau horaire UTC	OUI	2014-06-19T19:12:32Z
Millisecondes depuis l'époque de la dernière mise à jour de l'avis	Nombre entier, millisecondes depuis l'époque	OUI
Note	Entier (de 1 à 5)	NON
Titre de l'avis	Chaîne, dans la langue locale du rédacteur de l'avis (nouvelles lignes alternées)	OUI
Texte de l'avis	Chaîne, dans la langue locale du rédacteur de l'avis (nouvelles lignes alternées)	OUI
Date et heure de la réponse du développeur	ISO_8601, y compris l'heure et le fuseau horaire UTC	OUI	2014-06-19T19:12:32Z
Millisecondes depuis l'époque de la réponse du développeur	Nombre entier, millisecondes depuis l'époque	OUI
Texte de la réponse du développeur	Chaîne (nouvelles lignes alternées et espaces blancs de compression)	OUI
Lien de l'avis	Chaîne	OUI	https://play.google.com/apps/publish/?dev_acc=<...>#ReviewPlace:id=<..>

Exemple

Si vous voulez télécharger tous les rapports générés en 2014 sous l'identifiant de compartiment de rapport pubsite_prod_rev_0123456789 pour votre application avec le nom de paquet com.example.app, utilisez la commande suivante :

gsutil cp -r gs://pubsite_prod_rev_0123456789/reviews/reviews_com.example.app_2014* /your/local/directory

Rapports financiers

Estimation des ventes

Nous vous recommandons de ne pas vous fier au nombre de colonnes des fichiers CSV pour vos rapports automatisés.

À propos

Vous pouvez utiliser le rapport d'estimation des ventes pour afficher des données à faible latence concernant l'application, les produits intégrés à l'application ou les ventes par abonnement. Ce rapport contient le montant payé par les acheteurs et ne déduit pas les taxes ni les frais Google des totaux.

Vous pouvez utiliser ce rapport pour l'analyse des données ou des tendances, mais son usage n'est pas recommandé pour la comptabilité. Consultez plutôt le rapport de revenus.

Vous pourriez constater des différences entre ce rapport et vos revenus pour un certain nombre de raisons. Par exemple, le rapport d'estimation des ventes ne prend pas en compte l'impôt retenu à la source ou les rejets de débit. Ce rapport contient les montants payés par les acheteurs dans leur devise locale, mais il ne contient pas les montants convertis dans votre devise de paiement.

Commande

gs://[developer_bucket_id]/sales/salesreport_YYYYMM.zip

Exemple

Si vous voulez télécharger tous les rapports générés en 2014 sous l'identifiant de compartiment de rapport pubsite_prod_rev_0123456789 pour votre application avec le nom de paquet com.example.app, utilisez la commande suivante :

gsutil cp -r gs://pubsite_prod_rev_0123456789/sales/salesreport_2014* /your/local/directory

Format de fichier

Champ	Format	Facultatif	Exemples et remarques
Numéro de commande	Chaîne	Non	GPA.1234-1234-1234-12345 Les identifiants de commande de l'abonnement comprennent le numéro du cycle de renouvellement à la fin (p. ex. le premier renouvellement est GPA.1234-1234-1234-12345..0, le deuxième renouvellement est GPA.1234-1234 -1234-12345..1, etc.).
Date de facturation de la commande	Chaîne	Non	30-11-2016 Date de cette commande en fonction du fuseau horaire UTC (au format JJ-MM-AAAA).
Estampille temporelle de la facturation de la commande	Nombre entier	Non	1480507200 Estampille temporelle UNIX correspondant au moment où la commande a été imputée au compte de l'utilisateur. Mesurée en secondes depuis l'époque.
État financier	Chaîne	Non	facturé, remboursé, remboursé partiellement, etc. Si vous remboursez totalement une commande après avoir émis un remboursement partiel : Le remboursement partiel s'affiche sur une autre ligne La ligne du remboursement total indique le solde restant
Modèle de l'appareil	Chaîne	Non	mako, etc. Modèle d'appareil Android utilisé pour effectuer l'achat. Pour les commandes d'abonnement, il s'agit de l'appareil utilisé lors de l'achat initial.
Titre du produit	Chaîne	Non	pièces, abonnement mensuel, etc. Nom défini par le développeur du produit. Affiché dans les paramètres régionaux de l'acheteur.
Identifiant de produit	Chaîne	Non	com.example.app Nom du paquet de l'application où le produit a été vendu.
Type de produit	Chaîne	Non	application payante, abonnement, intégré à l'application
Numéro d'article	Chaîne	Non	treasure_chest_for_new_users Identifiant unique défini par le développeur du produit.
Devise utilisée pour la vente	Chaîne	Non	USD, EUR, THB, etc.
Prix de l'article	Nombre entier	Non	12 345,67 Indiqué dans la devise locale de l'acheteur. Avec une espace insécable pour séparer les milliers.
Taxes perçues	Nombre entier	Oui	12 345,67 Dans la devise locale de l'acheteur. Avec une espace insécable pour séparer les milliers.
Montant facturé	Nombre entier	Non	12 345,67 Dans la devise locale de l'acheteur. Cette valeur correspond à la somme du prix de l'article et des taxes perçues. Avec une espace insécable pour séparer les milliers.
Ville de l'acheteur	Chaîne	Oui	Boston, Toronto, etc. Seulement rempli pour les ventes où vous êtes le vendeur officiel.
État ou province de l'acheteur	Chaîne	Oui	MA, ON, etc.
Code postal de l'acheteur	Chaîne	Oui	02140, M5B 1L6, etc. Seulement rempli pour les ventes où vous êtes le vendeur officiel.
Pays de l'acheteur	Chaîne	Non	CA, US, etc.
Identifiant du forfait de base	Chaîne	Oui	chaque semaine Identifiant du forfait de base de l'abonnement. Seulement rempli pour les abonnements. Apprenez-en plus.
Identifiant de l'offre	Chaîne	Oui	offre printanière Identifiant de l'offre de l'abonnement. Seulement rempli pour les abonnements. Apprenez-en plus.
Identifiant du groupe	Nombre entier	Oui	1234567891234567890 Un identifiant unique est attribué lors de la création d'un groupe de comptes de développeur. Apprenez-en plus.
Premier million de dollars américains admissible	Chaîne	Oui	Oui, Non Seulement rempli lorsqu'un groupe de comptes de développeur est configuré. Apprenez-en plus.
Identifiant de promotion	Chaîne	Oui	PP.C2fy7Ns0/+e2w, PP.P2fy7Ns0/+e2w, points utilisés uniquement Uniquement rempli pour les ventes liées aux points Play. Les préfixes « PP.C » et « PP.P » définissent respectivement les commandes impliquant des coupons et les promotions de produits intégrés à l'application. Les commandes pour lesquelles des points Play sont utilisés directement sont également affichées. Apprenez-en plus.
Valeur du coupon	Nombre entier	Oui	3,00 Indiqué dans la devise locale de l'acheteur. Avec une espace insécable pour séparer les milliers. Uniquement rempli pour les ventes liées aux coupons Play Points. Apprenez-en plus.
Taux de rabais	Nombre entier	Oui	45, 55, 70 Taux de rabais exprimé en %, utilisé pour indiquer l'économie que l'utilisateur réalise en dépensant des points Play en comparaison avec de l'argent. Uniquement rempli pour les ventes liées aux points Play. Apprenez-en plus.
Identifiants des produits vedettes	Nombre entier	Oui	1234567891234567890 Un identifiant unique est attribué lorsqu'un développeur crée un produit vedette. Apprenez-en plus.
Identifiant du test de prix	Chaîne	Oui	5697329857888256(Variant B) Identifiant du test de prix et volet de test

Revenus

Nous vous recommandons de ne pas vous fier au nombre de colonnes des fichiers CSV pour vos rapports automatisés.

À propos

Vous pouvez utiliser le rapport de revenus pour comprendre vos paiements et vos transactions. Chaque ligne du rapport représente un type de transaction incluant les montants initiaux et convertis, par exemple lorsque vous imputez des frais à un client ou que vous payez des frais à Google.

Les rapports de revenus contiennent les transactions du mois précédent. Vous recevrez le paiement plusieurs semaines après la publication du rapport de revenus.

Le rapport de revenus est généré une fois par mois et il est généralement proposé le 5 du mois suivant. De temps en temps, Google peut procéder à des ajustements de vos revenus pour corriger des erreurs de calcul. Si cela se produit, nous communiquerons avec vous pour vous informer du problème et pour créer un fichier de revenus supplémentaire contenant uniquement les transactions ajustées pour vos dossiers.

Remarques :

• Les frais Google sont désormais visibles pour toutes les transactions, que Google soit ou non le vendeur officiel des produits vendus.
• Le rapport de revenus ne comprend pas les rejets de débit.
• Un seul fichier est généré chaque mois pour le rapport de revenus relatif aux transactions.
• L'impôt retenu à la source de Taïwan est payé au cours du mois précédant sa déclaration.

Commande

gs://[developer_bucket_id]/earnings/earnings_YYYYMM.zip

Exemple

Si vous voulez télécharger tous les rapports générés en 2014 sous l'identifiant de compartiment de rapport pubsite_prod_rev_0123456789 pour votre application avec le nom de paquet com.example.app, utilisez la commande suivante :

gsutil cp -r gs://pubsite_prod_rev_0123456789/earnings/earnings_2014* /your/local/directory

Format de fichier

Champ	Format	Facultatif	Exemples et remarques
Description	Chaîne	Non	GPA.1234-1234-1234-12345 Les identifiants de commande de l'abonnement comprennent le numéro du cycle de renouvellement à la fin (p. ex. le premier renouvellement est GPA.1234-1234-1234-12345..0, le deuxième renouvellement est GPA.1234-1234 -1234-12345..1, etc.).
Date de la transaction	Chaîne	Non	30 nov. 2016 Date de cette commande en fonction du fuseau horaire du Pacifique (au format DD MMM AAAA). Notez que l'estampille temporelle de la transaction peut afficher le mois suivant puisque les rapports sont générés selon l'estampille temporelle de l'émission.
Heure de la transaction	Chaîne	Non	00 h 00 min 00 s HAP
Type de taxe	Chaîne	Oui	Taxe de tiers Vide pour les lignes ne comportant aucune taxe.
Type de transaction	Chaîne	Non	Frais, frais Google, taxes, remboursement des frais, remboursement des frais Google, refacturation des frais, refacturation des taxes, refacturation des frais Google, ajustement.
Type de remboursement	Chaîne	Oui	Intégral, partiel Les remboursements pour lesquels l'acheteur a été intégralement remboursé seront marqués comme « Intégral ». Les remboursements d'une partie du paiement de l'utilisateur seront marqués comme « Partiel ».
Titre du produit	Chaîne	Non	pièces, abonnement mensuel, etc. Nom défini par le développeur du produit. Comme affiché dans les paramètres régionaux de l'acheteur.
Identifiant de produit	Chaîne	Non	com.example.app Nom du paquet de l'application où le produit a été vendu.
Type de produit	Nombre entier	Non	0,1 Utilisé pour déterminer le type de produit vendu. « 0 » correspond à la vente d'une application payante et « 1 », à la vente d'un produit ou d'un abonnement intégré à l'application.
Numéro d'UGS	Chaîne	Non	treasure_chest_for_new_users Identifiant unique défini par le développeur du produit.
Matériel	Chaîne	Non	mako, etc. Modèle d'appareil Android utilisé pour effectuer l'achat. Pour les commandes d'abonnement, il s'agit du modèle utilisé lors de l'achat initial.
Pays de l'acheteur	Chaîne	Non	CA, US, etc.
État ou province de l'acheteur	Chaîne	Oui	MA, ON, etc.
Code postal de l'acheteur	Chaîne	Oui	02140, M5B 1L6, etc.
Devise de l'acheteur	Chaîne	Non	USD, EUR, THB, etc.
Montant (devise de l'acheteur)	Nombre entier	Non	12 345,67 Montant total pour cette ligne de la facture avant la conversion de devise.
Taux de conversion des devises	Nombre entier	Non	0,56789 Le taux de change utilisé lors de la conversion des dépenses de l'acheteur en montants de paiement dans la devise du marchand.
Devise du marchand	Chaîne	Non	USD, EUR, THB, etc. Devise dans laquelle la commande a été convertie. C'est la devise locale dans laquelle vous êtes payé.
Montant (devise du marchand)	Nombre entier	Non	12 345,67 Montant total pour cette ligne de la facture après la conversion de devise.
Identifiant du forfait de base	Chaîne	Oui	chaque semaine Identifiant du forfait de base de l'abonnement. Seulement rempli pour les abonnements. Apprenez-en plus.
Identifiant de l'offre	Chaîne	Oui	offre printanière Identifiant de l'offre de l'abonnement. Seulement rempli pour les abonnements. Apprenez-en plus.
Identifiant du groupe	Nombre entier	Oui	1234567891234567890 Un identifiant unique est attribué lors de la création d'un groupe de comptes de développeur. Apprenez-en plus.
Premier million de dollars américains admissible	Chaîne	Oui	Oui, Non Seulement rempli lorsqu'un groupe de comptes de développeur est configuré. Apprenez-en plus.
Pourcentage de frais de service	Nombre entier	Oui	15, 30
Description des frais	Chaîne	Oui	ABONNEMENTS Détail fourni pour le calcul des frais de service Google.
Identifiant de promotion	Chaîne	Oui	PP.C_x0a08trvC1, PP.PdYfn342Ox10, pass-QbTfn350O810. Utilisé par Play Points et Play Pass Uniquement rempli pour les ventes liées à Play Points et à Play Pass. Les préfixes « PP.C » et « PP.P » définissent respectivement les commandes liées aux coupons de Play Points et les promotions de produits intégrés à l'appli. Les commandes pour lesquelles des points Play sont utilisés directement sont également affichées. Le préfixe « pass » définit les commandes dans lesquelles les utilisateurs ont appliqué des bons fournis dans le cadre de leur abonnement à Play Pass.

Facturation

Nous vous recommandons de ne pas vous fier au nombre de colonnes des fichiers CSV pour vos rapports automatisés.

À propos

Si vous vous êtes inscrit à des programmes relatifs à d'autres systèmes de facturation ou à des offres externes et que vous avez déclaré des transactions à Google Play, vous pouvez utiliser le rapport sur la facturation pour comprendre vos transactions et les frais de service Google qui vous ont été facturés. 

Le rapport sur la facturation contient les transactions du mois précédent dans un seul fichier CSV. Le rapport fournit une répartition par transaction des frais d'utilisation, des frais de service Google et du montant des taxes, le cas échéant. Des informations telles que le pourcentage des frais de service et le taux de change des devises sont incluses pour aider à comprendre comment le montant de la facture des frais de service est calculé.

Remarque :

• Le rapport sur la facturation est généré une fois par mois et est généralement accessible au plus tard le 5 du mois suivant.
• Les lignes relatives aux frais Google ou aux taxes arrondies à zéro dans la devise de facturation sont exclues du rapport. 

Commande

gsutil cp -r gs://[developer_bucket_id]/invoice_billing_reports/invoice_billing_report_YYYYMM.zip /your/local/directory

Exemple

Si vous souhaitez télécharger tous les rapports générés en 2024 à partir de l'identifiant du compartiment de rapport pubsite_prod_rev_0123456789, la commande est la suivante :

gsutil cp -r gs://pubsite_prod_rev_0123456789/invoice_billing_reports/invoice_billing_report_2024* /your/local/directory

Format de fichier

Date de la transaction en fonction du fuseau horaire du Pacifique.

Champ	Format	Facultatif	Exemples et remarques
Numéro de facture	Chaîne	Non	1234567890 Identifiant correspondant au numéro affiché sur votre facture.
Programme	Chaîne	Oui	Facturation au choix de l'utilisateur, Autre système de facturation uniquement, Offres externes Défini uniquement pour les lignes relatives aux frais Google.
Identifiant de la transaction externe	Chaîne	Non	com.example.app:1a2b3c4e5f
Date de la transaction	Chaîne	Non	1ᵉʳ juillet 2024 Date de la transaction en fonction du fuseau horaire du Pacifique.
Estampille temporelle de la transaction	Nombre entier	Non	1719849600 L'estampille temporelle UNIX de la transaction. Mesurée en secondes depuis l'époque.
Type de transaction	Chaîne	Non	Frais d'utilisation, Frais Google, Taxe, Remboursement des frais d'utilisation, Remboursement des frais Google, Remboursement des taxes, Remboursement partiel des frais d'utilisation, Remboursement partiel des frais Google, Remboursement partiel des taxes
Type de taxe	Chaîne	Oui	TVA/TPS Défini uniquement pour les lignes relatives aux taxes.
Type de l'UGS	Chaîne	Non	Produit intégré à l'appli, Abonnement
Identifiant de l'ensemble	Chaîne	Non	com.example.app Nom de l'ensemble de l'appli où le produit a été vendu.
Pays de vente	Chaîne	Non	Corée, États-Unis, etc.
Prix de l'article hors taxes (devise de vente)	Décimal	Oui	12,34 Prix du produit en devise de vente hors taxes. Défini uniquement pour les lignes relatives aux frais d'utilisation.
Devise de vente	Chaîne	Non	USD, KRW, etc. Devise locale de l'acheteur.
Montant dû (devise de vente)	Décimal	Oui	1,23 ou -1,23 Montant dû dans la devise de vente. Défini uniquement pour les lignes relatives aux frais Google et aux taxes. Positif pour le montant facturé et négatif pour les montants remboursés ou partiellement remboursés.
Taux de change des devises	Décimal	Non	1,076 Taux de change utilisé pour convertir le montant dû de la devise de vente à la devise de facturation.
Devise de facturation	Chaîne	Non	USD, EUR, etc.
Montant dû (devise de facturation)	Décimal	Oui	1,32 Montant dû dans la devise de facturation. Défini uniquement pour les lignes relatives aux frais Google et aux taxes. Positif pour le montant facturé et négatif pour les montants remboursés ou partiellement remboursés.
Identifiant du groupe	Nombre entier	Oui	1234567891234567890 Un identifiant unique est attribué lors de la création d'un groupe de comptes de développeur. Apprenez-en plus.
Premier million de dollars américains admissible	Chaîne	Oui	Oui, Non Seulement rempli lorsqu'un groupe de comptes de développeur est configuré. Apprenez-en plus.
Pourcentage de frais de service	Nombre entier	Oui	11, 26, etc.
Description des frais	Chaîne	Oui	SUBSCRIPTIONS, MEDIA_PARTNERSHIPS, etc. Détail fourni pour le calcul des frais de service Google.

Soldes réglés par le compte Play d'un utilisateur de la Corée du Sud

À propos

Si vous êtes un marchand qui est tenu de remettre des reçus en Corée du Sud conformément aux règles et réglementations applicables (ou si vous vous êtes volontairement inscrit pour remettre des reçus), vous devez alors remettre des reçus sur demande pour les applications payantes ou pour les achats de produits intégrés à l'application effectués avec des cartes cadeaux Google Play en wons sud-coréens (KRW).

Le rapport des commandes réglées par le solde du compte Play d'un utilisateur de la Corée du Sud contient les ventes effectuées par le biais des soldes de comptes Play réalisées en wons sud-coréens, dans le but d'envoyer un reçu à l'utilisateur.

Remarque : Les utilisateurs peuvent alimenter le solde Play grâce à plusieurs sources, y compris des crédits promotionnels de Google ou de nos partenaires. Avant de produire un reçu, vous devez vous assurer que l'utilisateur a ajouté un équivalent monétaire (par exemple, une carte-cadeau) à son solde.

Commande

gs://[developer_bucket_id]/play_balance_krw/play_balance_krw_YYYYMM.zip

Exemple

Si vous voulez télécharger tous les rapports générés en 2018 sous l'identifiant de compartiment de rapport pubsite_prod_rev_0123456789 pour votre application avec le nom du paquet com.example.app, utilisez la commande suivante :

gsutil cp -r gs://pubsite_prod_rev_0123456789/play_balance_krw/play_balance_krw_2018* /your/local/directory

Format de fichier

Champ	Format	Facultatif	Exemples et remarques
Numéro de commande	Nombre entier	Non	GPA.1234-1234-1234-12345 Les identifiants de commande de l'abonnement comprennent le numéro du cycle de renouvellement à la fin (p. ex. le premier renouvellement est GPA.1234-1234-1234-12345..0, le deuxième renouvellement est GPA.1234-1234 -1234-12345..1, etc.).
Date de facturation de la commande	Chaîne	Non	30-11-2016 Date de cette commande en fonction du fuseau horaire UTC (au format JJ-MM-AAAA)
État financier	Chaîne	Non	Facturation, remboursement, etc.
Montant de la commande réglée par le solde d'un compte Play	Chaîne	Non	12 345,67 Montant de la transaction
Devise des soldes Play	Chaîne	Non	KRW Pour les rapports des commandes réglées par le solde du compte Play d'un utilisateur de la Corée, il s'agit toujours du won sud-coréen (KRW).
Estampille temporelle de la facturation de la commande	Nombre entier	Non	1480507200 Estampille temporelle UNIX correspondant au moment où la commande a été imputée au compte de l'utilisateur. Mesurée en secondes depuis l'époque.

Abonnements

Réponses du sondage d'annulation

Commande

gs://[developer_bucket_id]/subscriptions/cancellations/freeform_[package_name].csv

Format de fichier

Champ	Format	Facultatif	Exemples et remarques
Date d'annulation	Chaîne	Non	30-11-2016
Numéro d'UGS	Chaîne	Oui	treasure_chest_for_new_users Identifiant unique défini par le développeur du produit.
Pays	Chaîne	Non	CA, US, etc.
Réponse	Chaîne	Non

Commandes et formats de fichiers pour les rapports regroupés

Statistiques

Installations

Commande

gs://[developer_bucket_id]/stats/installs/installs_[package_name]_yyyyMM_[dimension].csv

Format de fichier

Champ	Format	Facultatif	Exemple
Date	jj-mm-AAAA	NON	19-06-2014
Nom du paquet	Chaîne	NON	com.my.app
Appareil (ou toute autre dimension prise en charge)	Chaîne	OUI	hammerhead
Installations actuelles sur les appareils	Nombre entier	NON
Installations sur des appareils actifs	Nombre entier	NON
Installations quotidiennes sur les appareils	Nombre entier	NON
Désinstallations quotidiennes (appareils)	Nombre entier	NON
Mises à jour quotidiennes (appareil)	Nombre entier	NON
Installations actuelles par l'utilisateur	Nombre entier	NON
Total des installations par l'utilisateur	Nombre entier	NON
Installations quotidiennes par l'utilisateur	Nombre entier	NON
Désinstallations quotidiennes par l'utilisateur	Nombre entier	NON

Dimensions prises en charge

Dimension	Nom de fichier
Code de la version de l'application	..._app_version.csv
Fournisseur de services	..._carrier.csv
Pays	…_country.csv
Appareil	..._device.csv
Langue	..._language.csv
Version du système d'exploitation Android	..._os_version.csv

Exemple

Si vous voulez télécharger tous les rapports générés en 2014 sous l'identifiant de compartiment de rapport pubsite_prod_rev_0123456789 pour votre application avec le nom de paquet com.example.app, utilisez la commande suivante :

gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/installs/installs_com.example.app_2014* /your/local/directory

Plantages

Remarque : Depuis janvier 2018, les exportations comprennent des données provenant de la nouvelle source de données et correspondent aux renseignements de la page Statistiques de votre application. Les exportations d'avant janvier 2018 ne sont disponibles que pour les données collectées à partir de la source de données précédente.

Commande

gs://[developer_bucket_id]/stats/crashes/crashes_[package_name]_yyyyMM_[dimension].csv

Format de fichier

Champ	Format	Facultatif	Exemple
Date	jj-mm-AAAA	NON	19-06-2014
Nom du paquet	Chaîne	NON	com.my.app
Appareil (ou toute autre dimension prise en charge)	Chaîne	OUI	hammerhead
Plantages quotidiens	Nombre entier	NON
Nombre quotidien d'applications qui ne répondent pas	Nombre entier	NON

Dimensions prises en charge

Dimension	Nom de fichier
Code de la version de l'application	..._app_version.csv
Appareil	..._device.csv
Version du système d'exploitation Android	..._os_version.csv

Exemple

Si vous voulez télécharger tous les rapports générés en 2014 sous l'identifiant de compartiment de rapport pubsite_prod_rev_0123456789 pour votre application avec le nom de paquet com.example.app, utilisez la commande suivante :

gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/crashes/crashes_com.example.app_2014* /your/local/directory

Notes

Commande

gs://[developer_bucket_id]/stats/ratings/ratings_[package_name]_yyyyMM_[dimension].csv

Format de fichier

Champ	Format	Facultatif	Exemple
Date	jj-mm-AAAA	NON	19-06-2014
Nom du paquet	Chaîne	NON	com.my.app
Appareil (ou toute autre dimension prise en charge)	Chaîne	OUI	hammerhead
Note moyenne quotidienne	%.2f	OUI
Note moyenne totale	%.2f	Oui	4.16

Dimensions prises en charge

Dimension	Nom de fichier
Code de la version de l'application	..._app_version.csv
Fournisseur de services	..._carrier.csv
Pays	…_country.csv
Appareil	..._device.csv
Langue	..._language.csv
Version du système d'exploitation Android	..._os_version.csv

Exemple

Si vous voulez télécharger tous les rapports générés en 2014 sous l'identifiant de compartiment de rapport pubsite_prod_rev_0123456789 pour votre application avec le nom de paquet com.example.app, utilisez la commande suivante :

gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/ratings/ratings_com.example.app_2014* /your/local/directory

Abonnements

Commande

gs://[developer_bucket_id]/financial-stats/subscriptions/subscriptions_[package_name]_[product_id]_yyyyMM_[dimension].csv

Format de fichier

Champ	Format	Facultatif	Exemples et remarques
Date	JJ-MM-AAAA	NON	01-01-2022 Date de cette commande en fonction du fuseau horaire UTC (au format JJ-MM-AAAA)
Nom du paquet	Chaîne	NON	com.example.app
Identifiant de produit	Chaîne	NON	Accès avancé
Pays	Chaîne	NON	CA, US, etc.
Nouveaux abonnements	Numéro	NON	1234
Abonnements annulés	Numéro	NON	1234
Abonnements actifs	Numéro	NON	1234
Identifiant du forfait de base	Chaîne	NON	chaque semaine
Identifiant de l'offre	Chaîne	NON	offre printanière

Remarque : Pour en savoir plus à propos des statistiques sur les nouveaux abonnements ainsi que sur les abonnements annulés ou actifs, accédez à l'article Consulter les données associées aux revenus et aux acheteurs d'une application.

Dimensions prises en charge

Dimension	Nom de fichier
Pays	…_country.csv

Acquisition par les utilisateurs

Les rapports sur les acheteurs et les installateurs ayant conservé l'application fournissent un accès programmatique aux données de l'ancien rapport d'acquisition. Cette exportation a été remplacée par une nouvelle nouvelle exportation programmatique, qui comprend des données pour les pages Analyse de la boutique et Analyse des conversions dans Play Console. Elle a initialement été proposée en mars 2021.

Les anciens rapports ont été retirés en octobre 2021.

Assurez-vous de lire l'article Comment puis-je télécharger les données d'acquisition? pour en savoir plus.

Remarque : Le rapport Abonnés n'est plus pris en charge depuis novembre 2019. Pour en savoir plus, assurez-vous de consulter les sources et les mesures d'acquisition.

Installateurs ayant conservé l'application (ancienne exportation : proposée jusqu'en août 2021)

Commande

gs://[developer_bucket_id]/acquisition/retained_installers/retained_installers_[package_name]_yyyyMM_[dimension].csv

Formats de fichiers

Champ	Format	Facultatif	Exemples et remarques
Date	jj-mm-AAAA	NON	Date à laquelle l'utilisateur a consulté votre fiche Google Play Store Remarque : L'ajout de visiteurs de la fiche Google Play Store uniques sur plusieurs jours entraînera un nombre de visiteurs de la fiche Google Play Store supérieur à ce que vous voyez dans les cohortes d'utilisateurs hebdomadaires ou mensuelles. Celles-ci comptabilisent chaque visiteur une seule fois, même si ces derniers consultent votre fiche à plusieurs reprises.
Canal d'acquisition	Chaîne	OUI	Organic, Google Ads, UTM-Tagged Présent pour la dimension « Canal d'acquisition » Remarque : Le circuit de distribution « Boutique Play Store (naturelle) » représente la somme de « Recherche de la boutique Play Store (naturelle) » et de « Parcourir la boutique Play Store (naturelle) ». Pour éviter le double comptage des visiteurs dans ce rapport, ignorez l'intégralité de la ligne « Boutique Play Store (naturelle) » ou à la fois les lignes Recherche et Parcourir.
Pays	Chaîne	OUI	Présent pour les dimensions « Pays » et « Pays (Play Store [naturels]) »
Source/Campagne UTM	Chaîne	OUI	Présent pour la dimension « Canaux suivis (UTM) »
Mot clé	Chaîne	OUI	Exemple : « jeux » Présent pour la « Recherche boutique Play Store (naturelle) »
Visiteurs de la fiche Google Play Store	Nombre entier	NON
Installateurs	Nombre entier	NON
Taux de conversion des visiteurs en installateurs	Décimal	NON
Référence du taux de conversion moyen des visiteurs en installateurs	Décimal	OUI	Non rempli en août 2019. Un ensemble de références mis à jour, utilisant un nouveau mode de calcul, est disponible dans la page Rapports d'acquisition. Pour en savoir plus, assurez-vous de lire l'article Comparaison du taux de conversion des applications similaires pour les consultations de la boutique Play Store.
Personnes ayant installé et conservé l'application pendant une journée	Nombre entier	NON
Installateurs avec un taux de rétention d'une journée	Décimal	NON
Personnes ayant installé et conservé l'application pendant sept jours	Nombre entier	NON
Installateurs avec un taux de rétention de sept jours	Décimal	NON
Personnes ayant installé et conservé l'application pendant 15 jours	Nombre entier	NON
Installateurs avec un taux de rétention de 15 jours	Décimal	NON
Personnes ayant installé et conservé l'application pendant 30 jours	Nombre entier	NON
Installateurs avec un taux de rétention de 30 jours	Décimal	NON

Dimensions prises en charge

Dimension	Nom de fichier
Canal d'acquisition*	…_channel.csv
Pays	..._country.csv
Pays (Play Store [naturels])	…_play_country.csv
Recherche de la boutique Play Store (naturelle)	…_play_search.csv
Chaînes suivies (UTM)	..._utm_tagged.csv

* Remarque : Le circuit de distribution « Boutique Play Store (naturelle) » représente la somme de « Recherche de la boutique Play Store (naturelle) » et de « Parcourir la boutique Play Store (naturelle) ». Pour éviter de compter en double les visiteurs dans ce rapport, ignorez l'intégralité de la ligne « Boutique Play Store (naturelle) » ou les lignes Recherche et Parcourir. 

La dimension de la recherche Google (naturelle) n'est plus prise en charge depuis juin 2019.

Performances dans la boutique (nouvelle exportation : proposée en mars 2021)

Noms de fichiers CSV

Chaque fichier CSV proposé contient des données pour un mois et une ventilation. Les fichiers CSV reçoivent des noms structurés qui reflètent l'année, le mois et la ventilation du rapport qu'ils couvrent, selon le modèle suivant :

Format du nom de fichier : store_performance_[package_name]_[yyyyMM]_[breakdown].csv

Remarques :

• Le nom du paquet sera inclus tel quel dans le nom du fichier, avec les éventuels caractères spéciaux, le cas échéant (« . » ou « _ »).
• aaaaMM représente l'année et le mois, par exemple 202101.

Commande

gs://[developer_bucket_id]/stats/store_performance/store_performance_[package_name]_[yyyyMM]_[breakdown].csv

Formats de fichiers

Champ	Format	Facultatif	Exemple	Description
Date	jj-mm-AAAA	NON	01-01-2021	Date à laquelle l'utilisateur a consulté votre fiche Google Play Store
Nom du paquet	Chaîne	NON	com.example.app	Le nom du paquet comprenant les données du rapport
Pays/Région	Chaîne	NON	R.-U.	Le pays ou la région où le compte Google de l'utilisateur est inscrit
Source de trafic	Chaîne	NON	Recherche Google Play	La manière dont l'utilisateur est arrivé sur votre fiche Google Play Store : Recherche Google Play Références tierces Exploration Google Play Remarque : Le terme peut être Autre si cette valeur n'atteint pas certains seuils minimaux
Terme de recherche	Chaîne	OUI	app store	Le terme que l'utilisateur a recherché avant de naviguer vers votre fiche Google Play Store. Proposé uniquement pour la recherche Google Play. Remarque : Le terme peut être Autre si cette valeur n'atteint pas certains seuils minimaux
Source UTM	Chaîne	OUI	Google	La valeur du paramètre de l'URL utm_source dans les liens profonds vers votre fiche Google Play Store. Proposée uniquement pour les références tierces Remarque : Le terme peut être Autre si cette valeur n'atteint pas certains seuils minimaux
Campagne UTM	Chaîne	OUI	campagne	La valeur du paramètre de l'URL utm_campaign dans les liens profonds vers votre fiche Google Play Store. Proposée uniquement pour les références tierces. Remarque : Le terme peut être Autre si cette valeur n'atteint pas certains seuils minimaux
Nombre d'acquisitions après consultation de la fiche Google Play Store	Nombre entier	NON	10	Le nombre d'utilisateurs qui ont consulté votre fiche Google Play Store, qui ont installé votre application et qui ne l'avaient installée sur aucun autre appareil à ce moment-là
Visiteurs de la fiche Google Play Store	Nombre entier	NON	100	Le nombre d'utilisateurs qui ont consulté votre fiche Google Play Store et qui n'avaient pas déjà installé votre application sur un de leurs appareils
Taux de conversion de la fiche Google Play Store	Décimal	NON	0,1	Le pourcentage de visiteurs de la fiche Google Play Store qui ont installé votre application  Remarque : Ce pourcentage ne comprend pas les utilisateurs qui l'ont déjà installée sur un autre appareil

Structure de ventilation disponible

Les ventilations suivantes sont disponibles :

Nom de la ventilation	Champs dans chaque fichier CSV (dans l'ordre) :
pays Exemple de nom de fichier : store_performance_com.example.app_202012_country.csv	Date, nom du paquet, pays, nombre d'acquisitions après consultation de la fiche Google Play Store, visiteurs de la fiche Google Play Store, taux de conversion de la fiche Google Play Store
traffic_source Exemple de nom de fichier : store_performance_com.example.app_202012_traffic_source.csv	Date, nom du paquet, source de trafic, terme de recherche, source UTM, campagne UTM, nombre d'acquisitions après consultation de la fiche Google Play Store, visiteurs de la fiche Google Play Store, taux de conversion de la fiche Google Play Store

 

Schéma de fuite

• Doublez tout guillemet double. (" -> "")
• Si une cellule contient des tabulations, des retours de la ligne, des guillemets doubles ou des virgules, placez des guillemets doubles autour de la cellule. (... -> "...")

Exemple

Si vous voulez télécharger tous les rapports générés en 2020 sous l'identifiant de compartiment de rapport pubsite_prod_0123456789 pour votre application avec le nom de paquet com.example.app, utilisez la commande suivante :

gsutil cp -r gs://pubsite_prod_0123456789/stats/store_performance/store_performance_com.example.app_2020* /your/local/directory

Acheteurs (7 jours après l'installation – proposé jusqu'en août 2021)

Commande

gs://[developer_bucket_id]/acquisition/buyers_7d/buyers_7d_[package_name]_yyyyMM_[dimension].csv

Formats de fichiers

Champ	Format	Facultatif	Exemples et remarques
Date	jj-mm-AAAA	NON	Date à laquelle l'utilisateur a consulté votre fiche Google Play Store Remarque : L'ajout de visiteurs de la fiche Google Play Store uniques sur plusieurs jours entraînera un nombre de visiteurs de la fiche Google Play Store supérieur à ce que vous voyez dans les cohortes d'utilisateurs hebdomadaires ou mensuelles. Celles-ci comptabilisent chaque visiteur une seule fois, même si ces derniers consultent votre fiche à plusieurs reprises.
Canal d'acquisition	Chaîne	OUI	Organic, Google Ads, UTM-Tagged Présent pour la dimension « Canal d'acquisition » Remarque : Le circuit de distribution « Boutique Play Store (naturelle) » représente la somme de « Recherche de la boutique Play Store (naturelle) » et de « Parcourir la boutique Play Store (naturelle) ». Pour éviter le double comptage des visiteurs dans ce rapport, ignorez l'intégralité de la ligne « Boutique Play Store (naturelle) » ou à la fois les lignes Recherche et Parcourir.
Pays	Chaîne	OUI	Présent pour les dimensions « Pays » et « Pays (Play Store [naturels]) »
Source/Campagne UTM	Chaîne	OUI	Présent pour la dimension « Canaux suivis (UTM) »
Mot clé	Chaîne	OUI	Exemple : « jeux » Présent pour la « Recherche boutique Play Store (naturelle) »
Visiteurs de la fiche Google Play Store	Nombre entier	NON
Installateurs	Nombre entier	NON
Taux de conversion des visiteurs en installateurs	Décimal	NON
Référence du taux de conversion moyen des visiteurs en installateurs	Décimal	OUI	Non rempli en août 2019. Un ensemble de références mis à jour, utilisant un nouveau mode de calcul, est proposé dans la page Rapports d'acquisition. Pour en savoir plus, assurez-vous de lire l'article Comparaison du taux de conversion des applications similaires pour les consultations de la boutique Play Store.
Acheteurs	Nombre entier	NON
Taux de conversion des installateurs en acheteurs	Décimal	NON
Acheteurs fréquents	Nombre entier	NON
Taux de conversion des installateurs en acheteurs fréquents	Décimal	NON
Taux de conversion des acheteurs en acheteurs fréquents	Nombre entier	NON

Dimensions prises en charge

Dimension	Nom de fichier
Canal d'acquisition*	…_channel.csv
Pays	..._country.csv
Pays (Play Store [naturels])	…_play_country.csv
Recherche de la boutique Play Store (naturelle)	…_play_search.csv
Chaînes suivies (UTM)	..._utm_tagged.csv

* Remarque : Le circuit de distribution « Boutique Play Store (naturelle) » représente la somme de « Recherche de la boutique Play Store (naturelle) » et de « Parcourir la boutique Play Store (naturelle) ». Pour éviter de compter en double les visiteurs dans ce rapport, ignorez l'intégralité de la ligne « Boutique Play Store (naturelle) » ou les lignes Recherche et Parcourir. 

La dimension de la recherche Google (naturelle) n'est plus prise en charge depuis juin 2019.