Tipurile de rapoarte
Rapoarte detaliateRapoartele detaliate includ date privind evenimente individuale:
- recenzii,
- Financiare: vânzări estimate, venituri, produse cu recompensă, echilibrarea soldului Google Play Coreea
Rapoartele cumulate includ date consolidate (statistici medii, totaluri zilnice etc.) pentru statisticile privind aplicațiile.
- Statistici: instalări, blocări, evaluări și abonamente
- Achizițiile utilizatorilor: utilizatori care au instalat și au păstrat aplicația, cumpărători (la șapte zile după instalare) și abonați
Descarcă rapoarte
- Deschide Play Console.
- Dă clic pe Descarcă rapoartele și selectează Recenzii, Statistici sau Financiar.
- Sub Selectează o aplicație, introdu și selectează denumirea aplicației.
- Selectează anul și luna raportului pe care vrei să îl descarci.
Notă: rapoartele financiare includ toate aplicațiile din cont.
Descarcă rapoarte din Google Cloud Storage
Rapoartele sunt disponibile în Google Cloud Storage. Rapoartele sunt generate zilnic și cumulate în fișiere CSV lunare.Acestea sunt stocate într-o grupare privată din Google Cloud Storage pentru contul tău de dezvoltator Google Play.
Poți accesa rapoartele folosind Google Cloud Storage în browser sau programatic, folosind instrumentul gsutil. Poți folosi alte instrumente pentru a accesa programatic grupul din Cloud Storage.
Sfat: dacă vrei să imporți rapoartele din Google Cloud Storage în BigQuery, trebuie să convertești fișierele CSV din formatul UTF-16
în UTF-8
.
Găsește identificatorul URI din Google Cloud Storage
Poți copia URI-ul din Google Cloud Storage dând clic pe butonul Copiază adresa URI-ului din Cloud Storage de lângă antetul secțiunii corespunzătoare din paginile Descarcă rapoartele.
URI-ul din Google Cloud Storage începe cu pubsite_prod_rev
(de exemplu, pubsite_prod_rev_01234567890987654321
).
- Instalează instrumentul gsutil.
- Asigură-te că te conectezi cu un cont cu acces la Play Console.
- În timpul procesului de configurare, dacă folosești instrumentul gsutil pentru prima dată și nu ai niciun alt proiect configurat în Google Cloud Storage, poți introduce numele aplicației când ți se solicită ID-ul proiectului.
- Găsește ID-ul grupului de raportare dând clic pe butonul Copiază adresa URI-ului din Cloud Storage de lângă antetul secțiunii corespunzătoare din paginile Descarcă rapoartele.
- URI-ul din Google Cloud Storage începe cu
pubsite_prod_rev
(de exemplu,pubsite_prod_rev_01234567890987654321
).
- URI-ul din Google Cloud Storage începe cu
- Folosește comanda
gsutil cp
pentru a descărca rapoartele.- Pentru mai multe comenzi cu care poți accesa rapoartele, consultă documentația gsutil.
Rapoartele sunt organizate în directoare denumite în funcție de fiecare tip de raport. Numele fișierelor CSV includ tipul de raport, numele pachetului, intervalul de timp și parametrul (dacă este cazul).
Pasul 1: creează un cont de serviciu
- Deschide Google Developers Console.
- Dacă ai deja un proiect, folosește meniul drop-down pentru a selecta un proiect. Dacă nu ai un proiect afișat sau dacă dorești să creezi unul nou, dă clic pe Creează un proiect.
- Selectează pictograma Meniu > Permisiuni > Conturi de serviciu > Creează un cont de serviciu.
- Urmează instrucțiunile de pe ecran și selectează Creează.
- Copiază adresa de e-mail afișată.
- Exemplu:
accountName@project.iam.gserviceaccount.com
- Exemplu:
Pasul 2: adaugă contul de serviciu în Play Console
- Deschide Play Console.
- Selectează Setări > Conturi și drepturi de utilizator > Invită un nou utilizator.
- Inserează sau introdu adresa de e-mail asociată contului de serviciu.
- Selectează permisiunile în funcție de tipurile de rapoarte necesare.
- Sfat: citește articolul Adaugă utilizatori în contul de dezvoltator și gestionează permisiunile pentru a înțelege diferitele niveluri de acces ale utilizatorilor și drepturile pe care le acordă permisiuni diferite.
- Dă clic pe Adaugă utilizatorul. Contul de serviciu va fi adăugat în contul tău.
Pasul 3: preia rapoartele folosind un apel API
- Instalează biblioteca client a API-ului pentru limbajul de programare dorit.
- Configurează codul care realizează apelarea API-ului, astfel încât să folosească autentificarea
OAuth2
de la server la server și să solicite permisiunea la aria de acoperireOAuth2
(https://www.googleapis.com/auth/devstorage.read_only). - Creați apelări autentificate ale API-ului pentru a prelua rapoartele.
Dacă folosiți Python pentru a prelua rapoartele, iată un exemplu de cod:
import json
from httplib2 import Http
from oauth2client.client import SignedJwtAssertionCredentials
from apiclient.discovery import build
# Modificați aceste variabile pentru a se potrivi cazului dvs.
client_email = 'contul dvs. de serviciu aici'
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()
Gestionează accesul la Google Cloud Storage
Rapoartele disponibile în Google Cloud Storage folosesc aceleași restricții de acces care gestionează accesul la datele din Play Console. Aceasta înseamnă că utilizatorii conturilor care au acces la zonele dintr-un cont din Play Console au acces la rapoartele aferente din Google Cloud Storage.
Proprietarii de conturi pot actualiza permisiunile pentru utilizatorii individuali în orice moment.
- Pentru a accesa rapoartele în bloc, trebuie setat „Global” pentru permisiunea „Vede informațiile aplicației”.
- Pentru a descărca rapoartele financiare, permisiunea Vede datele financiare trebuie setată la Global.
Comenzi și formate de fișiere pentru rapoartele detaliate
Blocări și erori ANR
Începând cu luna mai 2018, nu mai poți descărca rapoarte detaliate privind blocările și erorile ARN.
Recenzii
Comandă
gs://[developer_bucket_id]/reviews/reviews_[package_name]_YYYYMM.csv
Formatul fișierului
Câmp | Format | Opțional | Exemple și note |
---|---|---|---|
Nume pachet | Șir de caractere | NU | com.company.app |
Codul versiunii aplicației | număr întreg | DA | Numai APK-uri în versiune pentru lansare |
Numele versiunii aplicației | Șir de caractere | DA | |
Limbă recenzent | șir de caractere din două litere cu abrevierea limbii conform standardului ISO 639-1 | DA | en |
Dispozitiv | Șir de caractere | DA | hammerhead |
Dată și oră postare recenzie | valoare conform standardului ISO 8601 incluzând ora, specificată în funcție de UTC (ora universală coordonată) | NU | 2014-06-19T19:12:32Z |
Postare recenzie – milisecunde de la începutul erei Unix | număr întreg, milisecunde de la începutul erei Unix | NU | |
Ultima actualizare a recenziei – dată și oră | valoare conform standardului ISO 8601 incluzând ora, specificată în funcție de UTC (ora universală coordonată) | DA | 2014-06-19T19:12:32Z |
Ultima actualizare a recenziei – milisecunde de la începutul erei Unix | număr întreg, milisecunde de la începutul erei Unix | DA | |
Evaluare cu stele | număr întreg (între 1 și 5) | NU | |
Titlu recenzie | Șir de caractere, în limba locală a recenzentului (eliminare simboluri de linii noi) | DA | |
Textul recenziei | Șir de caractere, în limba locală a recenzentului (eliminare simboluri de linii noi) | DA | |
Dată și oră răspuns dezvoltator | valoare conform standardului ISO 8601 incluzând ora, specificată în funcție de UTC (ora universală coordonată) | DA | 2014-06-19T19:12:32Z |
Răspuns dezvoltator – milisecunde de la începutul erei Unix | număr întreg, milisecunde de la începutul erei Unix | DA | |
Textul răspunsului dezvoltatorului | Șir de caractere (eliminare simboluri de linii noi și comprimare spațiu alb) | DA | |
Link recenzie | Șir de caractere | DA | https://play.google.com/apps/publish/?dev_acc=<...>#ReviewPlace:id=<..> |
Exemplu
Dacă vrei să descarci toate rapoartele generate în anul 2014 cu ID-ul grupului de raportare pubsite_prod_rev_0123456789
pentru aplicația cu numele pachetului „com.example.app”, ai următoarea comandă:
gsutil cp -r gs://pubsite_prod_rev_0123456789/reviews/reviews_com.example.app_2014* /your/local/directory
Rapoarte financiare
Vânzări estimateÎți recomandăm să nu te bazezi pe numărul de coloane din fișierele CSV pentru rapoartele automate.
Despre
Poți folosi raportul privind vânzările estimate pentru a vedea informații cu latență redusă despre aplicație, despre produsele în aplicație sau despre vânzările de abonamente. Acest raport conține sumele plătite de cumpărători, fără a scădea taxe sau taxe Google din total.
Poți folosi acest raport pentru statistici sau pentru analiza tendințelor, însă nu este recomandat să îl folosești pentru contabilitate. Pentru aceasta, consultă Raportul privind veniturile.
Din mai multe motive, este posibil să observi diferențe între acest raport și veniturile tale. De exemplu, raportul privind vânzările estimate nu ia în considerare taxele reținute la sursă sau rambursările. Acest raport conține sumele plătite de cumpărători în moneda lor locală și nu conține sumele convertite în moneda ta de plată.
Comandă
gs://[developer_bucket_id]/sales/salesreport_YYYYMM.zip
Exemplu
Dacă vrei să descarci toate rapoartele generate în anul 2014 cu ID-ul grupului de raportare pubsite_prod_rev_0123456789
pentru aplicația cu numele pachetului „com.example.app”, ai următoarea comandă:
gsutil cp -r gs://pubsite_prod_rev_0123456789/sales/salesreport_2014* /your/local/directory
Formatul fișierului
Câmp | Format | Opțional | Exemple și note |
---|---|---|---|
Numărul comenzii |
Șir de caractere |
Nu |
ID-urile comenzilor pentru abonamente includ numărul ciclului de reînnoire la sfârșit (de exemplu, prima reînnoire este |
Data debitării comenzii |
Șir de caractere |
Nu |
Data comenzii se bazează pe fusul orar UTC (în format AAAA-LL-ZZ). |
Marcajul temporal al debitării comenzii |
Număr întreg |
Nu |
Marcajul temporal UNIX pentru momentul în care comanda a fost debitată din contul utilizatorului. Se măsoară în secunde de la începutul erei Unix. |
Starea financiară |
Șir de caractere |
Nu |
Dacă rambursezi integral o comandă după ce ai emis o rambursare parțială:
|
Modelul dispozitivului |
Șir de caractere |
Nu |
Modelul dispozitivului Android folosit pentru achiziție. Pentru comenzile pentru abonamente, câmpul se referă la dispozitivul folosit pentru achiziția inițială. |
Titlul produsului |
Șir de caractere |
Nu |
Numele specificat de dezvoltator pentru produs. Se afișează în codul local al cumpărătorului. |
ID-ul produsului |
Șir de caractere |
Nu |
Numele pachetului aplicației în care a fost vândut produsul. |
Tip de produs |
Șir de caractere |
Nu |
|
ID SKU |
Șir de caractere |
Nu |
Codul unic specificat de dezvoltator pentru produs. |
Moneda vânzării |
Șir de caractere |
Nu |
|
Prețul articolului |
Număr întreg |
Nu |
Se afișează în moneda locală a cumpărătorului. Se folosește simbolul „,” ca separator de mii. |
Taxele colectate |
Număr întreg |
Da |
În moneda locală a cumpărătorului. Se folosește simbolul „,” ca separator de mii. |
Suma debitată |
Număr întreg |
Nu |
În moneda locală a cumpărătorului. Aceasta este suma dintre prețul articolului și taxele colectate. Se folosește simbolul „,” ca separator de mii. |
Orașul cumpărătorului |
Șir de caractere |
Da |
Câmp completat doar pentru vânzările în care ești comerciantul înregistrat. |
Statul cumpărătorului |
Șir de caractere |
Da |
|
Codul poștal al cumpărătorului |
Șir de caractere |
Da |
Câmp completat doar pentru vânzările în care ești comerciantul înregistrat. |
Țara cumpărătorului |
Șir de caractere |
Nu |
|
Codul planului de bază |
Șir de caractere |
Da |
Codul planului de bază al abonamentului. Se completează numai pentru abonamente. Află mai multe. |
ID-ul ofertei |
Șir de caractere |
Da |
Codul ofertei pentru abonament. Se completează numai pentru abonamente. Află mai multe. |
ID-ul grupului | Număr întreg | Da |
ID-ul unic este generat la crearea unui grup de conturi de dezvoltator. Află mai multe. |
Eligibil pentru primul milion de dolari | Șir de caractere | Da |
Completat numai atunci când este configurat un grup de conturi de dezvoltator. Află mai multe. |
Codul promoției | Șir de caractere | Da |
|
Valoarea cuponului | Număr întreg | Da |
Se afișează în moneda locală a cumpărătorului. Se folosește simbolul „,” ca separator de mii. Câmp completat doar pentru vânzările asociate cupoanelor Play Points. Află mai multe. |
Prețul redus. | Număr întreg | Da |
Procentul de reducere folosit pentru a indica economia făcută de utilizator cheltuind Puncte Play și nu bani. Câmp completat doar pentru vânzările asociate programului Play Points. Află mai multe. |
ID-ul produselor promovate |
Număr întreg |
Da |
ID-ul unic se oferă când un dezvoltator creează un produs promovat. Află mai multe. |
ID-ul experimentului privind prețurile | Șir de caractere | Da |
ID-ul experimentului privind prețurile și secțiunea experimentului |
Îți recomandăm să nu te bazezi pe numărul de coloane din fișierele CSV pentru rapoartele automate.
Despre
Poți folosi raportul privind veniturile pentru a înțelege plățile și tranzacțiile. Fiecare rând al raportului reprezintă un tip de tranzacție, cum ar fi când percepi o sumă de bani de la cumpărător sau când plătești o taxă către Google, împreună cu sumele originale și convertite.
Raportul privind veniturile conține tranzacțiile din luna anterioară. Vei primi plata la câteva săptămâni după ce raportul privind veniturile devine disponibil.
Raportul privind veniturile se generează o dată pe lună și este disponibil, de obicei, până pe data de 5 a lunii următoare. Ocazional, Google îți poate ajusta veniturile pentru a corecta calculele greșite. Dacă se întâmplă acest lucru, te vom contacta pentru a te informa cu privire la această problemă și vom crea un fișier suplimentar privind veniturile, care conține numai tranzacțiile ajustate pentru evidențele tale.
Note:
- taxele Google sunt acum vizibile pentru toate tranzacțiile, indiferent dacă Google este comerciantul înregistrat pentru produsele vândute;
- raportul privind veniturile nu include rambursările;
- în fiecare lună se generează un singur fișier pentru raportul privind veniturile pentru tranzacții;
- taxa reținută la sursă în Taiwan este plătită în luna anterioară raportării.
Comandă
gs://[developer_bucket_id]/earnings/earnings_YYYYMM.zip
Exemplu
Dacă vrei să descarci toate rapoartele generate în anul 2014 cu ID-ul grupului de raportare pubsite_prod_rev_0123456789
pentru aplicația cu numele pachetului „com.example.app”, ai următoarea comandă:
gsutil cp -r gs://pubsite_prod_rev_0123456789/earnings/earnings_2014* /your/local/directory
Formatul fișierului
Câmp | Format | Opțional | Exemple și note |
---|---|---|---|
Descriere |
Șir de caractere |
Nu |
ID-urile comenzilor pentru abonamente includ numărul ciclului de reînnoire la sfârșit (de exemplu, prima reînnoire este |
Data tranzacției |
Șir de caractere |
Nu |
Data comenzii se calculează după Ora Pacificului (în format LLL ZZ, AAAA).Reține că marcajul temporal al tranzacției poate avea următoarea lună înregistrată, deoarece rapoartele sunt generate după marcajul temporal de emitere. |
Ora tranzacției |
Șir |
Nu |
|
Tipul taxei |
Șir de caractere |
Da |
Necompletat pentru rândurile fără taxe. |
Tipul tranzacției |
Șir de caractere |
Nu |
|
Tipul rambursării |
Șir de caractere |
Da |
Rambursarea în cazul căreia cumpărătorului i-a fost rambursată întreaga sumă va fi marcată ca Full.Rambursarea parțială a sumei de plată a unui utilizator va fi marcată ca Partial. |
Titlul produsului |
Șir de caractere |
Nu |
Numele specificat de dezvoltator pentru produs. Se afișează în codul local al cumpărătorului. |
ID-ul produsului |
Șir de caractere |
Nu |
Numele pachetului aplicației în care a fost vândut produsul. |
Tip de produs |
Număr întreg |
Nu |
Folosit pentru a identifica tipul de produs vândut. „0” reprezintă vânzarea unei aplicații cu plată, „1” reprezintă vânzarea unui produs în aplicație sau a unui abonament. |
ID SKU |
Șir de caractere |
Nu |
Codul unic specificat de dezvoltator pentru produs. |
Hardware |
Șir de caractere |
Nu |
Modelul dispozitivului Android folosit pentru achiziție. Pentru comenzile pentru abonamente, acesta se referă la modelul folosit pentru achiziția inițială. |
Țara cumpărătorului |
Șir de caractere |
Nu |
|
Statul cumpărătorului |
Șir de caractere |
Da |
|
Codul poștal al cumpărătorului |
Șir de caractere |
Da |
|
Moneda cumpărătorului |
Șir de caractere |
Nu |
|
Suma (moneda cumpărătorului) |
Număr întreg |
Nu |
Suma totală pentru acest rând din factură înainte de conversia valutară. |
Rata de conversie a monedei |
Număr întreg |
Nu |
Cursul de schimb folosit la conversia sumelor cumpărătorului în sumele de plată în moneda comerciantului. |
Moneda comerciantului | Șir de caractere | Nu |
Moneda la care a fost convertită comanda. Aceasta este moneda locală în care ești plătit(ă). |
Suma (moneda comerciantului) | Număr întreg | Nu |
Suma totală pentru acest rând din factură după conversia valutară. |
Codul planului de bază |
Șir de caractere |
Da |
Codul planului de bază al abonamentului. Se completează numai pentru abonamente. Află mai multe. |
ID-ul ofertei |
Șir de caractere |
Da |
Codul ofertei pentru abonament. Se completează numai pentru abonamente. Află mai multe. |
ID-ul grupului | Număr întreg | Da |
ID-ul unic este generat la crearea unui grup de conturi de dezvoltator. Află mai multe. |
Eligibil pentru primul milion de dolari | Șir | Da |
Completat numai atunci când este configurat un grup de conturi de dezvoltator. Află mai multe. |
Procentul taxei de serviciu |
Număr întreg |
Da |
|
Descrierea taxei | Șir | Da |
Detalii oferite pentru calcularea taxei de serviciu Google. |
Codul promoției | Șir de caractere | Da |
Câmp completat doar pentru vânzările asociate programelor Play Points și Play Pass. Prefixele „PP.C” și „PP.P” identifică acele comenzi care folosesc cupoane Play Points și, respectiv, promoții pentru produse în aplicație. Sunt afișate și comenzile pentru care se cheltuie direct Puncte Play. Prefixul „pass” identifică acele comenzi pentru care utilizatorii au aplicat cupoane oferite în cadrul abonamentului Play Pass. |
Îți recomandăm să nu te bazezi pe numărul de coloane din fișierele CSV pentru rapoartele automate.
Despre
Dacă te-ai înregistrat în programe de facturare alternativă sau de oferte externe și ai raportat tranzacții la Google Play, poți folosi raportul Facturare pentru a înțelege tranzacțiile și taxele de serviciu Google care îți sunt facturate.
Raportul Facturare conține tranzacțiile din luna anterioară într-un singur fișier CSV. Raportul oferă o detaliere pentru fiecare tranzacție a debitării, a taxei de serviciu Google și a valorii taxei pentru utilizator, dacă este cazul. Sunt incluse informații precum procentul taxei de serviciu și cursul de schimb valutar, pentru a înțelege cum se calculează valoarea taxelor de serviciu din factură.
Note
- Raportul Facturare se generează o dată pe lună și este disponibil, de obicei, până pe data de 5 a lunii următoare.
- Rândurile pentru taxele Google sau taxe rotunjite la zero în moneda de facturare sunt excluse din raport.
Comandă
gsutil cp -r gs://[developer_bucket_id]/invoice_billing_reports/invoice_billing_report_YYYYMM.zip /your/local/directory
Exemplu
Dacă vrei să descarci toate rapoartele generate în anul 2024 cu ID-ul grupului de raportare pubsite_prod_rev_0123456789
, comanda este:
gsutil cp -r gs://pubsite_prod_rev_0123456789/invoice_billing_reports/invoice_billing_report_2024* /your/local/directory
Formatul fișierului
Data tranzacției bazată pe Ora Pacificului
Câmp | Format | Opțional | Exemple și note |
---|---|---|---|
ID-ul facturii |
Șir de caractere |
Nu |
ID-ul care corespunde numărului afișat pe factură. |
Program |
Șir de caractere |
Da |
Setat numai pentru rândurile pentru taxele Google. |
Codul extern al tranzacției |
Șir de caractere |
Nu |
|
Data tranzacției |
Șir de caractere |
Nu |
Data tranzacției bazată pe Ora Pacificului |
Marcajul temporal al tranzacției |
Număr întreg |
Nu |
Marcajul temporal UNIX al tranzacției. Se măsoară în secunde de la începutul erei Unix. |
Tipul tranzacției |
Șir de caractere |
Nu |
User charge, Google fee, Tax, User charge refund, Google fee refund, Tax refund, User charge partial refund, Google fee partial refund, Tax partial refund |
Tipul taxei |
Șir de caractere |
Da |
Setat numai pentru rândurile pentru taxe. |
Tipul de SKU |
Șir de caractere |
Nu |
|
ID-ul pachetului |
Șir de caractere |
Nu |
Numele pachetului aplicației în care a fost vândut produsul. |
Țara de vânzare |
Șir de caractere |
Nu |
|
Prețul articolului fără taxe (moneda de vânzare) |
Număr zecimal |
Da |
Prețul produsului în moneda de vânzare, fără taxe. Setat numai pentru rândurile pentru debitarea utilizatorului. |
Moneda de vânzare |
Șir de caractere |
Nu |
Moneda locală a cumpărătorului. |
Suma datorată (moneda de vânzare) |
Număr zecimal |
Da |
Suma datorată în moneda de vânzare. Setată numai pentru rândurile pentru Taxa Google și Taxe. Valoare pozitivă pentru suma debitată și negativă pentru sumele rambursate sau rambursate parțial. |
Curs de schimb valutar |
Număr zecimal |
Nu |
Cursul de schimb folosit la conversia sumei datorate din moneda de vânzare în moneda de facturare. |
Monedă de facturare |
Șir de caractere |
Nu |
|
Suma datorată (moneda de facturare) |
Număr zecimal |
Da |
Suma datorată în moneda de facturare. Setată numai pentru rândurile pentru Taxa Google și Taxe. Valoare pozitivă pentru suma debitată și negativă pentru sumele rambursate sau rambursate parțial. |
ID-ul grupului |
Număr întreg |
Da |
ID-ul unic este generat la crearea unui grup de conturi de dezvoltator. Află mai multe. |
Eligibil pentru primul milion de dolari |
Șir de caractere |
Da |
Completat numai atunci când este configurat un grup de conturi de dezvoltator. Află mai multe. |
Procentul taxei de serviciu |
Număr întreg |
Da |
|
Descrierea taxei |
Șir |
Da |
Detalii oferite pentru calcularea taxei de serviciu Google. |
Despre
Dacă ești comerciant în Coreea de Sud și, conform regulilor și reglementărilor aplicabile, ai obligația să emiți chitanțe pentru numerar sau dacă te-ai înscris din proprie inițiativă ca să emiți chitanțe pentru numerar, trebuie să eliberezi chitanțe pentru numerar la solicitarea clienților pentru aplicațiile cu plată sau pentru achizițiile de produse în aplicație făcute folosind carduri cadou Google Play în Woni sud-coreeni.
Raportul privind soldul stocat în Play în monedă coreeană conține vânzările folosind soldul Play făcute în Woni sud-coreeni, cu scopul de a trimite o chitanță utilizatorului.
Notă: utilizatorii pot suplimenta soldul Play folosind mai multe surse, inclusiv creditul promoțional de la Google sau de la partenerii noștri. Înainte de a emite o chitanță, este important să te asiguri că utilizatorul a suplimentat soldul său folosind un echivalent în bani (de exemplu, un card cadou).
Comandă
gs://[developer_bucket_id]/play_balance_krw/play_balance_krw_YYYYMM.zip
Exemplu
Dacă vrei să descarci toate rapoartele generate în anul 2018 cu ID-ul grupului de raportare pubsite_prod_rev_0123456789
pentru aplicația cu numele pachetului „com.example.app”, ai următoarea comandă:
gsutil cp -r gs://pubsite_prod_rev_0123456789/play_balance_krw/play_balance_krw_2018* /your/local/directory
Formatul fișierului
Câmp | Format | Opțional | Exemple și note |
---|---|---|---|
Numărul comenzii |
Număr întreg |
Nu |
ID-urile comenzilor pentru abonamente includ numărul ciclului de reînnoire la sfârșit (de exemplu, prima reînnoire este |
Data debitării comenzii |
Șir de caractere |
Nu |
Data comenzii se bazează pe fusul orar UTC (în format AAAA-LL-ZZ). |
Starea financiară |
Șir de caractere |
Nu |
|
Suma de finanțare a soldului Play |
Șir de caractere |
Nu |
Suma tranzacționată. |
Moneda soldului Play | Șir de caractere | Nu | KRW Pentru rapoartele privind soldul stocat în Play în monedă coreeană, moneda este întotdeauna Wonul sud-coreean (KRW). |
Marcajul temporal al debitării comenzii | Număr întreg | Nu | 1480507200
Marcajul temporal UNIX pentru momentul în care comanda a fost debitată din contul utilizatorului. Se măsoară în secunde de la începutul erei Unix. |
Abonamente
Răspunsuri la sondajul privind anulărileComandă
gs://[developer_bucket_id]/subscriptions/cancellations/freeform_[package_name].csv
Formatul fișierului
Câmp | Format | Opțional | Exemple și note |
---|---|---|---|
Data anulării | Șir | Nu | 2016-11-30 |
ID SKU | Șir | Da | treasure_chest_for_new_users Codul unic specificat de dezvoltator pentru produs. |
Țară | Șir | Nu | US, CA etc. |
Răspuns | Șir | Nu |
Comenzi și formate de fișier pentru rapoarte cumulate
Statistici
InstalăriComandă
gs://[developer_bucket_id]/stats/installs/installs_[package_name]_yyyyMM_[dimension].csv
Formatul fișierului
Câmp | Format | Opțional | Exemplu |
---|---|---|---|
Dată | AAAA-LL-ZZ | NU | 2014-06-19 |
Nume pachet | Șir de caractere | NU | com.my.app |
Dispozitiv (sau orice alt parametru acceptat) | Șir de caractere | DA | hammerhead |
Instalări actuale pe dispozitive | număr întreg | NU | |
Instalări pe dispozitive active | număr întreg | NU | |
Instalări zilnice pe dispozitive | număr întreg | NU | |
Dezinstalări zilnice de pe dispozitive | număr întreg | NU | |
Upgrade-uri zilnice pe dispozitive | număr întreg | NU | |
Instalări actuale efectuate de utilizatori | număr întreg | NU | |
Total instalări efectuate de utilizatori | număr întreg | NU | |
Instalări zilnice efectuate de utilizatori | număr întreg | NU | |
Dezinstalări zilnice efectuate de utilizatori | număr întreg | NU |
Parametri acceptați
Parametru | Numele fișierului |
---|---|
Codul versiunii aplicației | ..._app_version.csv |
Operator | ..._carrier.csv |
Țară | ..._country.csv |
Dispozitiv | ..._device.csv |
Limbă | ..._language.csv |
Versiune sistem de operare Android | ..._os_version.csv |
Exemplu
Dacă vrei să descarci toate rapoartele generate în anul 2014 cu ID-ul grupului de raportare pubsite_prod_rev_0123456789
pentru aplicația cu numele pachetului „com.example.app”, ai următoarea comandă:
gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/installs/installs_com.example.app_2014* /your/local/directory
Notă: începând din ianuarie 2018, exporturile includ date din noua sursă de date și corespund informațiilor din pagina Statistici a aplicației. Exporturile realizate înainte de ianuarie 2018 sunt disponibile numai pentru datele colectate din sursa de date anterioară.
Comandă
gs://[developer_bucket_id]/stats/crashes/crashes_[package_name]_yyyyMM_[dimension].csv
Formatul fișierului
Câmp | Format | Opțional | Exemplu |
---|---|---|---|
Dată | AAAA-LL-ZZ | NU | 2014-06-19 |
Nume pachet | Șir de caractere | NU | com.my.app |
Dispozitiv (sau orice alt parametru acceptat) | Șir de caractere | DA | hammerhead |
Blocări zilnice | număr întreg | NU | |
Erori ANR zilnice | număr întreg | NU |
Parametri acceptați
Parametru | Numele fișierului |
---|---|
Codul versiunii aplicației | ..._app_version.csv |
Dispozitiv | ..._device.csv |
Versiune sistem de operare Android | ..._os_version.csv |
Exemplu
Dacă vrei să descarci toate rapoartele generate în anul 2014 cu ID-ul grupului de raportare pubsite_prod_rev_0123456789
pentru aplicația cu numele pachetului „com.example.app”, ai următoarea comandă:
gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/crashes/crashes_com.example.app_2014* /your/local/directory
Comandă
gs://[developer_bucket_id]/stats/ratings/ratings_[package_name]_yyyyMM_[dimension].csv
Formatul fișierului
Câmp | Format | Opțional | Exemplu |
---|---|---|---|
Dată | AAAA-LL-ZZ | NU | 2014-06-19 |
Nume pachet | Șir de caractere | NU | com.my.app |
Dispozitiv (sau orice alt parametru acceptat) | Șir de caractere | DA | hammerhead |
Evaluare medie zilnică | float cu 2 cifre zecimale | DA | |
Evaluare medie totală | float cu 2 cifre zecimale | Da | 4.16 |
Parametri acceptați
Parametru | Numele fișierului |
---|---|
Codul versiunii aplicației | ..._app_version.csv |
Operator | ..._carrier.csv |
Țară | ..._country.csv |
Dispozitiv | ..._device.csv |
Limbă | ..._language.csv |
Versiune sistem de operare Android | ..._os_version.csv |
Exemplu
Dacă vrei să descarci toate rapoartele generate în anul 2014 cu ID-ul grupului de raportare pubsite_prod_rev_0123456789
pentru aplicația cu numele pachetului „com.example.app”, ai următoarea comandă:
gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/ratings/ratings_com.example.app_2014* /your/local/directory
Comandă
gs://[developer_bucket_id]/financial-stats/subscriptions/subscriptions_[package_name]_[product_id]_yyyyMM_[dimension].csv
Formatul fișierului
Câmp | Format | Opțional | Exemple și note |
---|---|---|---|
Dată | AAAA-LL-ZZ | NU |
Data comenzii se bazează pe fusul orar UTC (în format AAAA-LL-ZZ) |
Nume pachet | Șir de caractere | NU | com.example.app |
ID produs | Șir de caractere | NU | Premium access |
Țară | Șir | NU |
|
Abonamente noi | Număr | NU | 1234 |
Abonamente anulate | Număr | NU | 1234 |
Abonamente active | Număr | NU | 1234 |
Codul planului de bază | Șir | NU | weekly |
ID-ul ofertei | Șir | NU | spring-offer |
Notă: pentru mai multe informații despre statisticile privind abonamentele noi, cele anulate și cele active, accesează pagina Consultă datele privind cumpărătorii și veniturile pentru aplicație.
Parametri acceptați
Parametru | Numele fișierului |
---|---|
Țară | ..._country.csv |
Achiziție de utilizatori
Rapoartele privind cumpărătorii și utilizatorii care au instalat și au păstrat aplicația oferă acces programatic la date pentru vechiul raport privind achizițiile. Acest export a fost înlocuit cu un export programatic nou, care include date pentru paginile Analiza magazinului șiAnaliza conversiilor din Play Console. A devenit disponibil în martie 2021.
Vechile rapoarte au fost eliminate în octombrie 2021.
Consultă articolul Cum pot descărca datele despre achiziții? pentru a afla mai multe.
Notă: raportul Abonați nu mai este acceptat începând din noiembrie 2019. Pentru a afla mai multe, citește despre sursele și valorile pentru achiziții.
Utilizatori care au instalat și au păstrat aplicația (export vechi – disponibil până în august 2021)Comandă
gs://[developer_bucket_id]/acquisition/retained_installers/retained_installers_[package_name]_yyyyMM_[dimension].csv
Formatul fișierului
Câmp | Format | Opțional | Exemple și note |
---|---|---|---|
Dată | AAAA-LL-ZZ | NU |
Data la care utilizatorul a accesat înregistrarea în magazin Notă: adăugarea de vizitatori unici ai înregistrării din magazin pe parcursul mai multor zile va avea ca rezultat un număr mai mare de vizitatori ai înregistrării din magazin decât cel pe care îl vezi în vizualizările pe grupuri săptămânale sau lunare. Vizualizările pe grupuri săptămânale sau lunare iau în considerare fiecare vizitator doar o singură dată, chiar dacă acesta accesează înregistrarea de mai multe ori. |
Canal de achiziții | Șir de caractere | DA |
Prezent pentru parametrul „Canal de achiziții” Notă: canalul „Magazinul Play (organic)” este suma dintre „Căutare în Magazinul Play (organică)” și „Navigare în Magazinul Play (organică)”. Pentru a evita dubla contorizare a vizitatorilor în acest raport, ignoră complet rândul „Magazinul Play (organic)” sau rândurile de căutare și de navigare. |
Țară | Șir de caractere | DA | Prezent pentru parametrii „Țară” și „Țară (Magazin Play – organic)” |
Sursă UTM/campanie | Șir de caractere | DA |
Prezent pentru parametrul „Canale urmărite (UTM)” |
Cuvânt cheie | Șir de caractere | DA |
Prezent pentru parametrul „Căutare în Magazinul Play (organică)” |
Vizitatorii înregistrării din magazin | Număr întreg | NU | |
Utilizatori care au instalat aplicația | Număr întreg | NU | |
Rata de conversie a vizitatorilor în utilizatori care au instalat aplicația | Număr zecimal | NU | |
Etalon pentru rata de conversie medie a vizitatorilor în utilizatori care au instalat aplicația | Număr zecimal | DA |
Necompletat începând din august 2019. În pagina Rapoarte privind achizițiile este disponibil un set de etaloane actualizat, bazat pe o nouă metodă de calcul. Pentru a afla mai multe, citește Comparație privind rata de conversie a grupului de aplicații peer pentru traficul în Magazinul Play. |
Utilizatori care au instalat aplicația și au păstrat-o timp de o zi | Număr întreg | NU | |
Rata de fidelizare timp de o zi a utilizatorilor care au instalat aplicația | Număr zecimal | NU | |
Utilizatori care au instalat aplicația și au păstrat-o timp de 7 zile | Număr întreg | NU | |
Rata de fidelizare timp de 7 zile a utilizatorilor care au instalat aplicația | Număr zecimal | NU | |
Utilizatori care au instalat aplicația și au păstrat-o timp de 15 zile | Număr întreg | NU | |
Rata de fidelizare timp de 15 zile a utilizatorilor care au instalat aplicația | Număr zecimal | NU | |
Utilizatori care au instalat aplicația și au păstrat-o timp de 30 de zile | Număr întreg | NU | |
Rata de fidelizare timp de 30 de zile a utilizatorilor care au instalat aplicația | Număr zecimal | NU |
Parametri acceptați
Parametru | Numele fișierului |
---|---|
Canal de achiziție* | ..._channel.csv |
Țară | ..._country.csv |
Țară (Magazinul Play – organic) | ..._play_country.csv |
Căutare în Magazinul Play (organică) | ..._play_search.csv |
Canale urmărite (UTM) | ..._utm_tagged.csv |
*Notă: canalul „Magazinul Play (organic)” este suma dintre „Căutare în Magazinul Play (organică)” și „Navigare în Magazinul Play (organică)”. Pentru a evita dubla contorizare a vizitatorilor în acest raport, ignoră complet rândul „Magazinul Play (organic)” sau rândurile de căutare și de navigare.
Parametrul Căutare Google (organică) nu mai este acceptat începând din iunie 2019.
Numele fișierelor CSV
Fiecare fișier CSV disponibil conține date pentru o lună și detalierea. Fișierele CSV au nume structurate care reflectă anul, luna și detalierea rapoartelor pe care le acoperă, în conformitate cu următorul model.
Formatul numelui de fișier: store_performance_[package_name]_[yyyyMM]_[breakdown].csv
Note
- Numele pachetului va fi inclus în numele fișierului așa cum este, cu orice caractere speciale, dacă există („
.
” sau „_
”). yyyyMM
reprezintă anul și luna, de exemplu,202101
.
Comandă
gs://[developer_bucket_id]/stats/store_performance/store_performance_[package_name]_[yyyyMM]_[breakdown].csv
Formatul fișierului
Câmp | Format | Opțional | Exemplu | Descriere |
---|---|---|---|---|
Dată | AAAA-LL-ZZ | NU | 2021-01-01 |
Data la care utilizatorul a accesat înregistrarea în magazin |
Nume pachet | Șir de caractere | NU | com.example.app |
Numele pachetului care deține datele din raport |
Țara / Regiunea | Șir de caractere | NU | UK |
Țara sau regiunea în care este înregistrat contul Google al utilizatorului |
Sursă de trafic | Șir de caractere | NU | Google Play search |
Cum a ajuns utilizatorul la înregistrarea ta în magazin
Notă: poate fi |
Termen de căutare | Șir de caractere | DA | app store |
Termenul căutat de utilizator înainte de a naviga la înregistrarea ta în magazin. Disponibil doar pentru căutarea în Google Play. Notă: poate fi |
Sursa UTM | Șir de caractere | DA | google |
Valoarea parametrului URL utm_source din linkurile directe la înregistrarea ta în magazin. Disponibilă numai pentru recomandări terță parte Notă: poate fi |
Campanie UTM | Șir de caractere | DA | campaign |
Valoarea parametrului URL utm_campaign din linkurile directe la înregistrarea ta în magazin. Disponibil numai pentru recomandări terță parte. Notă: poate fiOther dacă această valoare nu atinge anumite praguri minime |
Achiziții de la înregistrarea în magazin | Număr întreg | NU | 10 |
Numărul de utilizatori care au accesat înregistrarea în magazin și au instalat aplicația, dar care nu o aveau instalată anterior pe niciunul dintre dispozitivele lor |
Vizitatorii înregistrării din magazin | Număr întreg | NU | 100 |
Numărul de utilizatori care au accesat înregistrarea în magazin și care nu aveau aplicația instalată pe niciun dispozitiv |
Rata de conversie a înregistrării în magazin | Număr zecimal | NU | 0,1 |
Procentul de vizitatori ai înregistrării din magazin care au instalat aplicația Notă: nu include vizitele sau instalările utilizatorilor care au deja aplicația instalată pe alt dispozitiv |
Structura de detaliere disponibilă
Sunt disponibile următoarele detalieri:
Numele detalierii | Câmpuri din fiecare fișier CSV (în ordine): |
---|---|
Exemplu de nume de fișier:
|
Data, Numele pachetului, Țara, Achizițiile din înregistrarea în magazin, Vizitatorii înregistrării din magazin, Rata de conversie a înregistrării în magazin |
Exemplu de nume de fișier:
|
Data, Numele pachetului, Sursa de trafic, Termenul de căutare, Sursa UTM, Campania UTM, Achizițiile din înregistrarea în magazin, Vizitatorii înregistrării din magazin, Rata de conversie a înregistrării în magazin |
Schema de reinterpretare
- Dublează ghilimelele duble. (
"
->""
) - Dacă o celulă conține tabulatori, linii noi, ghilimele duble sau virgule, plasează celula între ghilimele duble. (
...
->"..."
)
Exemplu
Dacă vrei să descarci toate rapoartele generate în anul 2020 cu ID-ul grupului de raportare pubsite_prod_0123456789
pentru aplicația cu numele pachetului com.example.app
, comanda este:
gsutil cp -r gs://pubsite_prod_0123456789/stats/store_performance/store_performance_com.example.app_2020* /your/local/directory
Comandă
gs://[developer_bucket_id]/acquisition/buyers_7d/buyers_7d_[package_name]_yyyyMM_[dimension].csv
Formatul fișierului
Câmp | Format | Opțional | Exemple și note |
---|---|---|---|
Dată | AAAA-LL-ZZ | NU |
Data la care utilizatorul a accesat înregistrarea în magazin Notă: adăugarea de vizitatori unici ai înregistrării din magazin pe parcursul mai multor zile va avea ca rezultat un număr mai mare de vizitatori ai înregistrării din magazin decât cel pe care îl vezi în vizualizările pe grupuri săptămânale sau lunare. Vizualizările pe grupuri săptămânale sau lunare iau în considerare fiecare vizitator doar o singură dată, chiar dacă acesta accesează înregistrarea de mai multe ori. |
Canal de achiziții | Șir de caractere | DA |
Prezent pentru parametrul „Canal de achiziții” Notă: canalul „Magazinul Play (organic)” este suma dintre „Căutare în Magazinul Play (organică)” și „Navigare în Magazinul Play (organică)”. Pentru a evita dubla contorizare a vizitatorilor în acest raport, ignoră complet rândul „Magazinul Play (organic)” sau rândurile de căutare și de navigare. |
Țară | Șir de caractere | DA | Prezent pentru parametrii „Țară” și „Țară (Magazin Play – organic)” |
Sursă UTM/campanie | Șir de caractere | DA | Prezent pentru parametrul „Canale urmărite (UTM)” |
Cuvânt cheie | Șir de caractere | DA |
Prezent pentru parametrul „Căutare în Magazinul Play (organică)” |
Vizitatorii înregistrării din magazin | Număr întreg | NU | |
Utilizatori care au instalat aplicația | Număr întreg | NU | |
Rata de conversie a vizitatorilor în utilizatori care au instalat aplicația | Număr zecimal | NU | |
Etalon pentru rata de conversie medie a vizitatorilor în utilizatori care au instalat aplicația | Număr zecimal | DA |
Necompletat începând din august 2019. În pagina Rapoarte privind achizițiile este disponibil un set de etaloane actualizat, bazat pe o nouă metodă de calcul. Pentru a afla mai multe, citește Comparație privind rata de conversie a grupului de aplicații peer pentru traficul în Magazinul Play. |
Cumpărători | Număr întreg | NU | |
Rata de conversie a utilizatorilor care au instalat aplicația în cumpărători | Număr zecimal | NU | |
Cumpărători cu achiziții repetate | Număr întreg | NU | |
Rata de conversie a utilizatorilor care au instalat aplicația în cumpărători cu achiziții repetate | Număr zecimal | NU | |
Rata de conversie a cumpărătorilor în cumpărători cu achiziții repetate | Număr întreg | NU |
Parametri acceptați
Parametru | Numele fișierului |
---|---|
Canal de achiziție* | ..._channel.csv |
Țară |
..._country.csv |
Țară (Magazinul Play – organic) |
..._play_country.csv |
Căutare în Magazinul Play (organică) | ..._play_search.csv |
Canale urmărite (UTM) | ..._utm_tagged.csv |
*Notă: canalul „Magazinul Play (organic)” este suma dintre „Căutare în Magazinul Play (organică)” și „Navigare în Magazinul Play (organică)”. Pentru a evita dubla contorizare a vizitatorilor în acest raport, ignoră complet rândul „Magazinul Play (organic)” sau rândurile de căutare și de navigare.
Parametrul Căutare Google (organică) nu mai este acceptat începând din iunie 2019.