Prenos in izvoz mesečnih poročil

V Konzoli Play lahko prenesete mesečna poročila o posameznih aplikacijah, ki vam lahko pomagajo spremljati in razumeti uspešnost aplikacije.

Vrste poročil

Podrobna poročila

Podrobna poročila vključujejo podatke o posameznih dogodkih:

• Mnenja
• Finančni podatki: ocenjena prodaja, zaslužek, nagradni izdelki in naročila v korejskem Googlu Play, plačana z dobroimetjem

Združena poročila

Združena poročila vsebujejo konsolidirane statistične podatke o aplikaciji (povprečja, dnevne vsote ipd.):

• Statistični podatki: namestitve, zrušitve, ocene in naročnine
• Pridobivanje uporabnikov: uporabniki, ki so namestili in obdržali aplikacijo, kupci (7 dni po namestitvi) in naročniki

Prenos poročil

1. Odprite Konzolo Play.
2. Kliknite Prenos poročil in izberite Mnenja, Statistični podatki ali Finance.
3. Pri »Izberite aplikacijo« vnesite in izberite ime aplikacije.
4. Izberite leto in mesec poročila, ki ga želite prenesti.

Opomba: Finančna poročila vključujejo vse aplikacije v računu.

Prenos poročil iz storitve Google Cloud Storage

Poročila so na voljo v storitvi Google Cloud Storage. Poročila se ustvarijo vsak dan in se zbirajo v mesečnih datotekah CSV. Shranijo se v zasebnem segmentu storitve Google Cloud Storage za vaš račun razvijalca v Googlu Play.

Do poročil lahko dostopate s storitvijo Google Cloud Storage v brskalniku ali programsko z orodjem gsutil. Za programski dostop do svojega segmenta v storitvi Cloud Storage lahko uporabite tudi druga orodja.

Nasvet: Če želite poročila iz storitve Google Cloud Storage uvoziti v BigQuery, morate datoteke CSV pretvoriti iz oblike zapisa UTF-16 v UTF-8.

Iskanje URI-ja za Google Cloud Storage

URI za Google Cloud Storage lahko kopirate tako, da kliknete gumb Kopiraj URI za Cloud Storage zraven ustrezne glave razdelka na straneh Prenos poročil.

URI za Google Storage se začne s pubsite_prod_rev (na primer: pubsite_prod_rev_01234567890987654321).

Prenos poročil z orodjem ukazne vrstice

1. Namestite orodje gsutil.
   • Prijavite se z računom, ki ima dostop do Konzole Play.
   • Če med postopkom nastavitve prvič uporabljate orodje gsutil in v storitvi Google Cloud Storage nimate konfiguriranih nobenih drugih projektov, lahko pri pozivu za vnos ID-ja projekta vnesete ime aplikacije.
2. ID segmenta s poročili poiščite tako, da kliknete gumb Kopiraj URI za Cloud Storage zraven ustrezne glave razdelka na straneh Prenos poročil.
   • URI za Google Storage se začne s pubsite_prod_rev (na primer: pubsite_prod_rev_01234567890987654321).
3. Poročila prenesite z ukazom gsutil cp.
   • Dodatne ukaze za pomoč pri dostopu do poročil poiščite v dokumentaciji orodja gsutil.

Poročila so razvrščena v imenikih, imenovanih po posameznih vrstah poročil. Imena datotek CSV vključujejo vrsto poročila, ime paketa, časovno obdobje in razsežnost (če je na voljo).

Prenos poročil s knjižnico odjemalca in storitvenim računom

1. korak: Ustvarjanje storitvenega računa

1. Odprite konzolo Google Developers Console.
2. Če že imate projekt, ga izberite v spustnem meniju. Če projekt ni naveden ali želite ustvariti novega, kliknite Ustvarjanje projekta.
3. Izberite ikono menija > Dovoljenja > Storitveni računi > Ustvari storitveni račun.
4. Upoštevajte navodila na zaslonu in izberite Ustvari.
5. Kopirajte navedeni e-poštni naslov.
   • Primer: [e-mail]

2. korak: Dodajanje storitvenega računa v Konzolo Play

1. Odprite Konzolo Play.
2. Izberite ikono nastavitev > Uporabniški računi in pravice > Povabi novega uporabnika.
3. Prilepite ali vnesite e-poštni naslov, povezan s storitvenim računom.
4. Glede na vrste poročil, ki jih potrebujete, izberite dovoljenja. 
   • Nasvet: Preberite članek Dodajanje uporabnikov računov za razvijalce in upravljanje dovoljenj, da boste razumeli različne ravni dostopa, ki jih imajo uporabniki, in pravice, ki jim jih dodeljujejo različna dovoljenja.
5. Kliknite Dodajanje uporabnika. Storitveni račun bo dodan računu.

3. korak: Pridobivanje poročil s klici API-ja

1. Namestite knjižnico odjemalca vmesnika API za želeni jezik kode.
2. Kodo, ki izvaja klic API-ja, konfigurirajte tako, da bo uporabljala preverjanje pristnosti OAuth2 med strežniki in zahtevala dovoljenje za obseg OAuth2 (https://www.googleapis.com/auth/devstorage.read_only).
3. Za pridobivanje poročil uporabite klice API-ja s preverjeno pristnostjo.

Oglejte si primer (Python)

Če ste za pridobivanje poročil uporabili Python, je tu primer kode:

import json

from httplib2 import Http

from oauth2client.client import SignedJwtAssertionCredentials

from apiclient.discovery import build

# Te spremenljivke ustrezno spremenite

client_email = 'tukaj vpišite storitveni račun'

json_file = 'pot_do_datoteke_json_pridobljene_pri_ustvarjanju_storitvenega_računa'

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()

Nadzor dostopa do storitve Google Cloud Storage

Poročila, ki so na voljo v storitvi Google Cloud Storage, uporabljajo enake omejitve dostopa, kot nadzirajo dostop do podatkov v Konzoli Play. To pomeni, da imajo uporabniki računa z dostopom do delov računa za Konzolo Play dostop do ustreznih poročil v storitvi Google Cloud Storage. 

Lastniki računov lahko kadarkoli posodobijo dovoljenja za posamezne uporabnike.

• Če želite dostopati do poročil v velikem obsegu, mora biti dovoljenje »Ogled podatkov o aplikaciji« nastavljeno na »Globalno«. 
• Če želite prenesti finančna poročila, mora biti dovoljenje »Ogled finančnih podatkov« nastavljeno na »Globalno«.

Ukazi in oblike datotek za podrobna poročila

Zrušitve in ANR-ji

Od maja 2018 ni mogoče več prenesti podrobnih poročil za zrušitve in ANR-je.

Mnenja

Mnenja

Ukaz

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

Oblika datoteke

Polje	Oblika zapisa	Izbirno	Primeri in opombe
Ime paketa	Niz	NE	com.company.app
Koda različice aplikacije	Celo število	DA	Samo APK-ji v dokončni različici
Ime različice aplikacije	Niz	DA
Jezik avtorja mnenja	Niz – dvočrkovna okrajšava po ISO 639-1	DA	sl
Naprava	Niz	DA	hammerhead
Datum in ura objave mnenja	ISO_8601 z uro (UTC)	NE	2014-06-19T19:12:32Z
Čas objave mnenja v milisekundah od začetka epohe	Celo število, v milisekundah od začetka epohe	NE
Datum in ura zadnje posodobitve mnenja	ISO_8601 z uro (UTC)	DA	2014-06-19T19:12:32Z
Čas zadnje posodobitve mnenja v milisekundah od začetka epohe	Celo število, v milisekundah od začetka epohe	DA
Ocena z zvezdicami	Celo število (med 1 in 5)	NE
Naslov mnenja	Niz, v lokalnem jeziku avtorja mnenja (prehodi v nove vrstice odstranjeni)	DA
Besedilo mnenja	Niz, v lokalnem jeziku avtorja mnenja (prehodi v nove vrstice odstranjeni)	DA
Datum in ura odgovora razvijalca	ISO_8601 z uro (UTC)	DA	2014-06-19T19:12:32Z
Čas odgovora razvijalca v milisekundah od začetka epohe	Celo število, v milisekundah od začetka epohe	DA
Besedilo odgovora razvijalca	Niz (prehodi v nove vrstice odstranjeni, stisnjen prazen prostor)	DA
Povezava do mnenja	Niz	DA	https://play.google.com/apps/publish/?dev_acc=<...>#ReviewPlace:id=<..>

Primer

Če želite na primer prenesti vsa poročila, ustvarjena leta 2014, iz segmenta s poročili z ID-jem pubsite_prod_rev_0123456789 za aplikacijo z imenom paketa »com.example.app«, je ukaz tak:

gsutil cp -r gs://pubsite_prod_rev_0123456789/reviews/reviews_com.example.app_2014* /vas/krajevni/imenik

Finančna poročila

Ocenjena prodaja

Priporočamo, da se pri samodejnih poročilih ne zanašate na število stolpcev v datotekah CSV.

Vizitka

V poročilu o ocenjeni prodaji si lahko ogledate podatke z rahlo zakasnitvijo o aplikaciji, izdelku v aplikaciji ali prodaji naročnin. Poročilo vsebuje zneske, ki jih plačajo kupci, pri čemer od skupne vsote niso odšteti davki ali Googlove provizije.

Poročilo lahko uporabite za analitične namene ali analizo gibanj, za računovodske operacije pa ga ne priporočamo. V tem primeru si oglejte Poročilo o zaslužku.

To poročilo se lahko razlikuje od vašega zaslužka iz več razlogov. V poročilu o ocenjeni prodaji na primer niso upoštevani zadržani davki in povratne bremenitve. Poročilo vsebuje zneske, ki jih plačajo kupci v lokalni valuti, in ne vsebuje pretvorjenih zneskov v valuti izplačila.

Ukaz

gs://[id_segmenta_razvijalca]/sales/salesreport_LLLLMM.zip

Primer

Če želite na primer prenesti vsa poročila, ustvarjena leta 2014, iz segmenta s poročili z ID-jem pubsite_prod_rev_0123456789 za aplikacijo z imenom paketa »com.example.app«, je ukaz tak:

gsutil cp -r gs://pubsite_prod_rev_0123456789/sales/salesreport_2014* /vas/krajevni/imenik

Oblika datoteke

Polje	Oblika zapisa	Izbirno	Primeri in opombe
Številka naročila	Niz	Ne	GPA.1234-1234-1234-12345 ID-ji naročil naročnin imajo na koncu številko cikla podaljšanja (prvo podaljšanje je na primer GPA.1234-1234-1234-12345..0, drugo podaljšanje pa GPA.1234-1234-1234-12345..1 in tako naprej).
Datum zaračunanja naročila	Niz	Ne	2016-11-30 Datum tega naročila glede na časovni pas UTC (v obliki LLLL-MM-DD).
Časovni žig zaračunanja naročila	Celo število	Ne	1480507200 Časovni žig UNIX za čas, ko je bilo naročilo zaračunano uporabniku, merjen v sekundah od začetka epohe.
Finančno stanje	Niz	Ne	zaračunano, vračilo kupnine, delno vračilo kupnine in podobno. Če v celoti vrnete kupnino za naročilo po delnem vračilu kupnine: Delno vračilo kupnine je prikazano v ločeni vrstici. V vrstici z vračilom kupnine v celoti je prikazan preostali znesek.
Model naprave	Niz	Ne	mako ipd. Model naprave Android, s katero je bil opravljen nakup. Pri naročilih naročnin se to nanaša na napravo, uporabljeno za prvotni nakup.
Ime izdelka	Niz	Ne	kovanci, mesečna naročnina in podobno. Ime izdelka, ki ga je določil razvijalec, prikazano v jeziku kupca.
ID izdelka	Niz	Ne	com.example.app Ime paketa aplikacije, v kateri je bil prodan izdelek.
Vrsta izdelka	Niz	Ne	plačljiva aplikacija, naročnina, v aplikaciji
ID inventarne enote	Niz	Ne	skrinja_z_zakladom_za_nove_uporabnike Enolični ID izdelka, ki ga določi razvijalec.
Valuta prodaje	Niz	Ne	USD, EUR, THB in podobno.
Cena izdelka	Celo število	Ne	12,345.67 Prikazana v lokalni valuti kupca, pri čemer je »,« znak za ločevanje tisočic.
Pobrani davki	Celo število	Da	12,345.67 V lokalni valuti kupca, pri čemer je »,« znak za ločevanje tisočic.
Zaračunan znesek	Celo število	Ne	12,345.67 V lokalni valuti kupca, Je vsota maloprodajne cene in zbranih davkov, pri čemer je »,« znak za ločevanje tisočic.
Mesto kupca	Niz	Da	Boston, Toronto in podobno. Izpolnjeno samo pri prodajah, pri katerih ste vi odgovorni trgovec.
Zvezna država kupca	Niz	Da	MA, ON in podobno.
Poštna številka kupca	Niz	Da	02140, M5B 1L6 in podobno. Izpolnjeno samo pri prodajah, pri katerih ste vi odgovorni trgovec.
Država kupca	Niz	Ne	US, CA in podobno.
ID osnovnega paketa	Niz	Da	tedensko ID osnovnega paketa naročnine. Izpolni se samo za naročnine. Preberite več o tem.
ID ponudbe	Niz	Da	pomladna-ponudba ID ponudbe za naročnino. Izpolni se samo za naročnine. Preberite več o tem.
ID skupine	Celo število	Da	1234567891234567890 Enoznačni ID se dodeli, ko je ustvarjena skupina računov razvijalca. Preberite več o tem.
Primerno za prvi milijon USD	Niz	Da	Da, Ne Izpolni se samo, ko je nastavljena skupina računov razvijalca. Preberite več o tem.
ID promocije	Niz	Da	PP.C2fy7Ns0/+e2w, PP.P2fy7Ns0/+e2w, uporabljene samo točke Izpolnjeno samo pri prodajah, povezanih s točkami Play. Predponi »PP.C« in »PP.P« določata naročila, ki vključujejo kupone oziroma promocije izdelkov v aplikacijah. Prikazana so tudi naročila, pri katerih so neposredno porabljene točke Play. Preberite več o tem.
Vrednost kupona	Celo število	Da	3,00 Prikazana v lokalni valuti kupca, pri čemer je »,« znak za ločevanje tisočic. Izpolnjeno samo pri prodajah, povezanih s kuponi za točke Play. Preberite več o tem.
Cena s popustom	Celo število	Da	45, 55, 70 Stopnja popusta (v odstotkih), ki se uporablja za določanje, koliko prihrani uporabnik, če namesto denarja porabi točke Play. Izpolnjeno samo pri prodajah, povezanih s točkami Play. Preberite več o tem.
ID predstavljenih izdelkov	Celo število	Da	1234567891234567890 Enolični ID se dodeli, ko razvijalec ustvari predstavljen izdelek. Preberite več o tem.
ID preizkusa cene	Niz	Da	5697329857888256(različica B) ID preizkusa cene in enota preizkusa

Zaslužek

Priporočamo, da se pri samodejnih poročilih ne zanašate na število stolpcev v datotekah CSV.

Vizitka

Poročilo o zaslužku lahko uporabite za razumevanje izplačil in transakcij. Vsaka vrstica v poročilu predstavlja vrsto transakcije, na primer ko kupcu zaračunate denar ali Googlu plačate provizijo, vključno s prvotnim in pretvorjenim zneskom.

Poročila o zaslužku vsebujejo transakcije iz prejšnjega meseca. Izplačilo prejmete nekaj tednov po tem, ko je poročilo o zaslužku na voljo.

Poročilo o zaslužku se ustvari enkrat na mesec in je običajno na voljo do 5. v naslednjem mesecu. Google lahko občasno prilagodi vaš zaslužek, da odpravi napake pri izračunu. Če se to zgodi, vas obvestimo o težavi in ustvarimo dodatno datoteko z zaslužkom, ki vsebuje samo prilagojene transakcije za vašo evidenco.

Opombe:

• Googlove provizije so zdaj vidne za vse transakcije ne glede na to, ali je Google odgovorni trgovec za izdelke, ki se prodajajo.
• Poročilo o zaslužku ne vključuje povratnih bremenitev.
• Za poročilo o zaslužku glede transakcij v posameznem mesecu se ustvari ena datoteka.
• Davčni odtegljaj na Tajvanu je izplačan v prejšnjem mesecu, ko je prijavljen.

Ukaz

gs://[id_segmenta_razvijalca]/earnings/earnings_LLLLMM.zip

Primer

Če želite na primer prenesti vsa poročila, ustvarjena leta 2014, iz segmenta s poročili z ID-jem pubsite_prod_rev_0123456789 za aplikacijo z imenom paketa »com.example.app«, je ukaz tak:

gsutil cp -r gs://pubsite_prod_rev_0123456789/earnings/earnings_2014* /vas/krajevni/imenik

Oblika datoteke

Polje	Oblika zapisa	Izbirno	Primeri in opombe
Opis	Niz	Ne	GPA.1234-1234-1234-12345 ID-ji naročil naročnin imajo na koncu številko cikla podaljšanja (prvo podaljšanje je na primer GPA.1234-1234-1234-12345..0, drugo podaljšanje pa GPA.1234-1234-1234-12345..1 in tako naprej).
Datum transakcije	Niz	Ne	Nov 30, 2016 Datum tega naročila glede na pacifiški časovni pas (v obliki MMM DD, LLLL). Upoštevajte, da je lahko za časovni žig transakcije zabeležen naslednji mesec, saj se poročila ustvarijo glede na časovni žig izdaje.
Čas transakcije	Niz	Ne	12:00:00 PDT
Vrsta davka	Niz	Da	Davek za tretjo osebo Prazno pri vrsticah, ki niso povezane z davki.
Vrsta transakcije	Niz	Ne	Bremenitev, Googlova provizija, davek, vračilo bremenitve, vračilo Googlove provizije, vnovično zaračunavanje bremenitve, vnovično zaračunavanje davka, vnovično zaračunavanje Googlove provizije, prilagoditev.
Vrsta vračila kupnine	Niz	Da	Delno, v celoti Vračila kupnine, pri katerih je dobil kupec povrnjeno kupnino v celoti, bodo označena »V celoti«. Vračila kupnine dela zneska uporabnikovega plačila bodo označena »Delno«.
Ime izdelka	Niz	Ne	kovanci, mesečna naročnina in podobno. Ime izdelka, ki ga je določil razvijalec, prikazano v jeziku kupca.
ID izdelka	Niz	Ne	com.example.app Ime paketa aplikacije, v kateri je bil prodan izdelek.
Vrsta izdelka	Celo število	Ne	0,1 Uporablja se za prepoznavo vrste prodanega izdelka. »0« predstavlja prodajo plačljive aplikacijo, »1« pa prodajo izdelka v aplikaciji ali naročnine.
ID inventarne enote	Niz	Ne	skrinja_z_zakladom_za_nove_uporabnike Enolični ID izdelka, ki ga določi razvijalec.
Strojna oprema	Niz	Ne	mako ipd. Model naprave Android, s katero je bil opravljen nakup. Pri naročilih naročnin se to nanaša na model, uporabljen za prvotni nakup.
Država kupca	Niz	Ne	US, CA in podobno.
Zvezna država kupca	Niz	Da	MA, ON in podobno.
Poštna številka kupca	Niz	Da	02140, M5B 1L6 in podobno.
Valuta kupca	Niz	Ne	USD, EUR, THB in podobno.
Znesek (valuta kupca)	Celo število	Ne	12345.67 Skupni znesek za to vrstico računa pred pretvorbo valute.
Valuta menjalnega tečaja	Celo število	Ne	0.56789 Menjalni tečaj, uporabljen pri pretvorbi zneskov kupcev v zneske izplačil v valuti trgovca.
Valuta trgovca	Niz	Ne	USD, EUR, THB in podobno. Valuta, v katero je bilo pretvorjeno naročilo. Lokalna valuta, v kateri ste plačani.
Znesek (valuta trgovca)	Celo število	Ne	12345.67 Skupni znesek za to vrstico računa po pretvorbi valute.
ID osnovnega paketa	Niz	Da	tedensko ID osnovnega paketa naročnine. Izpolni se samo za naročnine. Preberite več o tem.
ID ponudbe	Niz	Da	pomladna-ponudba ID ponudbe za naročnino. Izpolni se samo za naročnine. Preberite več o tem.
ID skupine	Celo število	Da	1234567891234567890 Enoznačni ID se dodeli, ko je ustvarjena skupina računov razvijalca. Preberite več o tem.
Primerno za prvi milijon USD	Niz	Da	Da, Ne Izpolni se samo, ko je nastavljena skupina računov razvijalca. Preberite več o tem.
Odstotek storitvenega nadomestila	Celo število	Da	15, 30
Opis nadomestila	Niz	Da	NAROČNINE Podrobnosti za izračun Googlovega storitvenega nadomestila.
ID promocije	Niz	Da	PP.C_x0a08trvC1, PP.PdYfn342Ox10, pass-QbTfn350O810. Uporabljata Play Points in Play Pass Izpolnjeno samo pri prodajah, povezanih s programom Play Points in naročnino Play Pass. Predponi »PP.C« in »PP.P« določata naročila, ki vključujejo kupone za točke Play oziroma promocije izdelkov v aplikacijah. Prikazana so tudi naročila, pri katerih so neposredno porabljene točke Play. Predpona »pass« določa naročila, pri katerih so uporabniki uporabili kupone, ki so jih dobili v okviru naročnine Play Pass.

Obračunavanje na podlagi faktur

Priporočamo, da se pri samodejnih poročilih ne zanašate na število stolpcev v datotekah CSV.

Vizitka

Če ste včlanjeni v program nadomestnega plačilnega sistema ali zunanjih ponudb in ste transakcije prijavili Googlu Play, lahko s poročilom o obračunavanju na podlagi faktur razumete transakcije in obveznosti za Googlovo storitveno nadomestilo, ki so vam zaračunane. 

Poročilo o obračunavanju na podlagi faktur vsebuje transakcije iz prejšnjega meseca v eni datoteki CSV. V poročilu je na voljo razčlenitev bremenitev uporabnika, Googlovega storitvenega nadomestila in zneska davka za posamezno transakcijo, če je to ustrezno. Vključeni so podatki, kot je odstotek storitvenega nadomestila in menjalni tečaj valute, da boste lažje razumeli, kako se izračuna znesek storitvenih nadomestil na fakturi.

Opomba:

• Poročilo o obračunavanju na podlagi faktur se ustvari enkrat na mesec in je običajno na voljo do 5. v naslednjem mesecu.
• Vrstice z Googlovim nadomestilom ali davkom, zaokrožene na nič v valuti za obračun, so izključene iz poročila. 

Ukaz

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

Primer

Če želite na primer prenesti vsa poročila, ustvarjena leta 2024, iz segmenta s poročili z ID-jem pubsite_prod_rev_0123456789, je ukaz tak:

gsutil cp -r gs://pubsite_prod_rev_0123456789/invoice_billing_reports/invoice_billing_report_2024* /vaš/krajevni/imenik

Oblika datoteke

Datum transakcije glede na pacifiški časovni pas.

Polje	Oblika zapisa	Izbirno	Primeri in opombe
ID računa	Niz	Ne	1234567890 ID, ki se ujema s številko, prikazano na fakturi.
Program	Niz	Da	User Choice Billing, Alternative Billing Only, External Offers Nastavite samo za vrstice z Googlovim nadomestilom.
Zunanji ID transakcije	Niz	Ne	com.example.app:1a2b3c4e5f
Datum transakcije	Niz	Ne	July 1, 2024 Datum transakcije glede na pacifiški časovni pas.
Časovni žig transakcije	Celo število	Ne	1719849600 Časovni žig UNIX transakcije. Merjen v sekundah od začetka epohe.
Vrsta transakcije	Niz	Ne	User charge, Google fee, Tax, User charge refund, Google fee refund, Tax refund, User charge partial refund, Google fee partial refund, Tax partial refund
Vrsta davka	Niz	Da	VAT / GST Nastavite samo za vrstice z davki.
Vrsta SKU-ja	Niz	Ne	In-app product, Subscription
ID paketa	Niz	Ne	com.example.app Ime paketa aplikacije, v kateri je bil prodan izdelek.
Država prodaje	Niz	Ne	US, KR, and so on.
Cena artikla brez davka (valuta prodaje)	Decimalno število	Da	12.34 Cena izdelka v valuti prodaje brez davka. Nastavite samo za vrstice za bremenitve uporabnikov.
Valuta prodaje	Niz	Ne	USD, KRW, and so on. Lokalna valuta kupca.
Neplačan znesek (valuta prodaje)	Decimalno število	Da	1.23 or -1.23 Zapadli znesek v valuti prodaje. Nastavite samo za vrstice z Googlovim nadomestilom in davki. Pozitiven za zaračunani znesek in negativen za zneske vračil kupnine ali delnih vračil kupnine.
Valuta menjalnega tečaja	Decimalno število	Ne	1.076 Menjalni tečaj, uporabljen pri pretvorbi zapadlega zneska iz valute prodaje v valuto za obračun.
Valuta za obračun	Niz	Ne	USD, EUR, and so on.
Zapadli znesek (valuta obračuna)	Decimalno število	Da	1.32 Zapadli znesek v valuti za obračun. Nastavite samo za vrstice z Googlovim nadomestilom in davki. Pozitiven za zaračunani znesek in negativen za zneske vračil kupnine ali delnih vračil kupnine.
ID skupine	Celo število	Da	1234567891234567890 Enoznačni ID se dodeli, ko je ustvarjena skupina računov razvijalca. Preberite več o tem.
Primerno za prvi milijon USD	Niz	Da	Yes, No Izpolni se samo, ko je nastavljena skupina računov razvijalca. Preberite več o tem.
Odstotek storitvenega nadomestila	Celo število	Da	11, 26, and so on
Opis nadomestila	Niz	Da	SUBSCRIPTIONS, MEDIA_PARTNERSHIPS, and so on Podrobnosti za izračun Googlovega storitvenega nadomestila.

Naročila v korejskem Googlu Play, plačana z dobroimetjem

Vizitka

Če ste trgovec, ki mora v Južni Koreji skladno z veljavnimi predpisi in zakonodajo izdajati potrdila o gotovinskem prejemku, ali če ste se prostovoljno registrirali za izdajanje potrdil o gotovinskem prejemku, morate na zahtevo kupcev aplikacij izdati potrdila o gotovinskem prejemku za nakupe plačljivih aplikacij ali izdelkov v aplikacijah, opravljene z darilnimi karticami za Google Play v valuti KRW.

Poročilo o naročilih v korejskem Googlu Play, plačanih z dobroimetjem, vsebuje prodaje, plačane z dobroimetjem v valuti KRW, zaradi pošiljanja potrdil o gotovinskem prejemku uporabnikom.

Opomba: Uporabniki lahko povečajo dobroimetje v Googlu Play iz več virov, vključno s promocijskim dobroimetjem Googla ali naših partnerjev. Pred izdajo potrdila o gotovinskem prejemku morate zagotoviti, da je uporabnik dobroimetje povečal z ustreznikom denarnega sredstva (na primer darilno kartico).

Ukaz

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

Primer

Če želite na primer prenesti vsa poročila, ustvarjena leta 2018, iz segmenta s poročili z ID-jem pubsite_prod_rev_0123456789 za aplikacijo z imenom paketa »com.example.app«, je ukaz tak:

gsutil cp -r gs://pubsite_prod_rev_0123456789/play_balance_krw/play_balance_krw_2018* /vas/krajevni/imenik

Oblika datoteke

Polje	Oblika zapisa	Izbirno	Primeri in opombe
Številka naročila	Celo število	Ne	GPA.1234-1234-1234-12345 ID-ji naročil naročnin imajo na koncu številko cikla podaljšanja (prvo podaljšanje je na primer GPA.1234-1234-1234-12345..0, drugo podaljšanje pa GPA.1234-1234-1234-12345..1 in tako naprej).
Datum zaračunanja naročila	Niz	Ne	2016-11-30 Datum tega naročila glede na časovni pas UTC (v obliki LLLL-MM-DD).
Finančno stanje	Niz	Ne	Zaračunano, vračilo kupnine in tako naprej.
Znesek naročila, plačanega z dobroimetjem v Googlu Play	Niz	Ne	12.345,67 Znesek transakcije.
Valuta dobroimetja v Googlu Play	Niz	Ne	KRW V poročilih o naročilih v korejskem Googlu Play, plačanih z dobroimetjem, je valuta vedno KRW.
Časovni žig zaračunanja naročila	Celo število	Ne	1480507200 Časovni žig UNIX za čas, ko je bilo naročilo zaračunano uporabniku, Merjen v sekundah od začetka epohe.

Naročnine

Odgovori na vprašanja ankete o preklicih

Ukaz

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

Oblika datoteke

Polje	Oblika zapisa	Izbirno	Primeri in opombe
Datum preklica	Niz	Ne	2016-11-30
ID inventarne enote	Niz	Da	skrinja_z_zakladom_za_nove_uporabnike Enolični ID izdelka, ki ga določi razvijalec.
Država	Niz	Ne	US, CA ipd.
Odgovor	Niz	Ne

Ukazi in oblike zapisa datotek za združena poročila

Statistični podatki

Namestitve

Ukaz

gs://[id_segmenta_razvijalca]/stats/installs/installs_[ime_paketa]_LLLLMM_[razsežnost].csv

Oblika datoteke

Polje	Oblika zapisa	Izbirno	Primer
Datum	LLLL-mm-dd	NE	2014-06-19
Ime paketa	Niz	NE	com.my.app
Naprava (ali druga podprta razsežnost)	Niz	DA	hammerhead
Trenutne namestitve v napravah	Celo število	NE
Namestitve v aktivnih napravah	Celo število	NE
Dnevne namestitve v napravah	Celo število	NE
Dnevne odmestitve v napravah	Celo število	NE
Dnevne nadgraditve v napravah	Celo število	NE
Trenutne namestitve uporabnikov	Celo število	NE
Skupne namestitve uporabnikov	Celo število	NE
Dnevne namestitve uporabnikov	Celo število	NE
Dnevne odmestitve uporabnikov	Celo število	NE

Podprte razsežnosti

Razsežnost	Ime datoteke
Koda različice aplikacije	..._app_version.csv
Operater	..._carrier.csv
Država	..._country.csv
Naprava	..._device.csv
Jezik	..._language.csv
Različica sistema Android	..._os_version.csv

Primer

Če želite na primer prenesti vsa poročila, ustvarjena leta 2014, iz segmenta s poročili z ID-jem pubsite_prod_rev_0123456789 za aplikacijo z imenom paketa »com.example.app«, je ukaz tak:

gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/installs/installs_com.example.app_2014* /vas/krajevni/imenik

Zrušitve

Opomba: Od januarja 2018 naprej poročila vključujejo podatke iz novega vira podatkov in se ujemajo s podatki na strani Statistični podatki. Izvozi pred januarjem 2018 so na voljo samo za podatke, zbrane iz prejšnjega vira podatkov.

Ukaz

gs://[id_segmenta_razvijalca]/stats/crashes/crashes_[ime_paketa]_LLLLMM_[razsežnost].csv

Oblika datoteke

Polje	Oblika zapisa	Izbirno	Primer
Datum	LLLL-mm-dd	NE	2014-06-19
Ime paketa	Niz	NE	com.my.app
Naprava (ali druga podprta razsežnost)	Niz	DA	hammerhead
Dnevne zrušitve	Celo število	NE
Dnevni ANR-ji	Celo število	NE

Podprte razsežnosti

Razsežnost	Ime datoteke
Koda različice aplikacije	..._app_version.csv
Naprava	..._device.csv
Različica sistema Android	..._os_version.csv

Primer

Če želite na primer prenesti vsa poročila, ustvarjena leta 2014, iz segmenta s poročili z ID-jem pubsite_prod_rev_0123456789 za aplikacijo z imenom paketa »com.example.app«, je ukaz tak:

gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/crashes/crashes_com.example.app_2014* /vas/krajevni/imenik

Ocene

Ukaz

gs://[id_segmenta_razvijalca]/stats/ratings/ratings_[ime_paketa]_LLLLMM_[razsežnost].csv

Oblika datoteke

Polje	Oblika zapisa	Izbirno	Primer
Datum	LLLL-mm-dd	NE	2014-06-19
Ime paketa	Niz	NE	com.my.app
Naprava (ali druga podprta razsežnost)	Niz	DA	hammerhead
Povprečna dnevna ocena	%.2f	DA
Skupna povprečna ocena	%.2f	Da	4.16

Podprte razsežnosti

Razsežnost	Ime datoteke
Koda različice aplikacije	..._app_version.csv
Operater	..._carrier.csv
Država	..._country.csv
Naprava	..._device.csv
Jezik	..._language.csv
Različica sistema Android	..._os_version.csv

Primer

Če želite na primer prenesti vsa poročila, ustvarjena leta 2014, iz segmenta s poročili z ID-jem pubsite_prod_rev_0123456789 za aplikacijo z imenom paketa »com.example.app«, je ukaz tak:

gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/ratings/ratings_com.example.app_2014* /vas/krajevni/imenik

Naročnine

Ukaz

gs://[id_segmenta_razvijalca]/financial-stats/subscriptions/subscriptions_[ime_paketa]_[id_izdelka]_LLLLMM_[razsežnost].csv

Oblika datoteke

Polje	Oblika zapisa	Izbirno	Primeri in opombe
Datum	LLLL-MM-DD	NE	2022-01-01 Datum tega naročila glede na časovni pas UTC (v obliki LLLL-MM-DD).
Ime paketa	Niz	NE	com.example.app
ID izdelka	Niz	NE	Plačljiv dostop
Država	Niz	NE	US, CA in tako naprej.
Nove naročnine	Številka	NE	1234
Preklicane naročnine	Številka	NE	1234
Aktivne naročnine	Številka	NE	1234
ID osnovnega paketa	Niz	NE	tedensko
ID ponudbe	Niz	NE	pomladna-ponudba

Opomba: Če želite več informacij glede statističnih podatkov o novih, preklicanih in aktivnih naročninah, odprite pregled podatkov o prihodku in kupcih za aplikacijo.

Podprte razsežnosti

Razsežnost	Ime datoteke
Država	..._country.csv

Pridobivanje uporabnikov

Poročili o kupcih in uporabnikih, ki so namestili in obdržali aplikacijo, omogočata programski dostop do podatkov iz starega poročila o pridobitvi. Ta izvoz je nadomestil nov programski izvoz, ki vključuje podatke za strani Analiza trgovine in Analiza konverzije v Konzoli Play. Na voljo je od marca 2021.

Stara poročila so bila odstranjena oktobra 2021.

Če želite izvedeti več, preberite Kako prenesem podatke o pridobitvi?.

Opomba: Poročilo o naročnikih od novembra 2019 ni več podprto. Če želite več informacij, preberite več o virih in meritvah pridobitve.

Uporabniki, ki so namestili in obdržali aplikacijo (stara možnost izvoza – na voljo do avgusta 2021)

Ukaz

gs://[id_segmenta_razvijalca]/acquisition/retained_installers/retained_installers_[ime_paketa]_LLLLMM_[razsežnost].csv

Oblika datoteke

Polje	Oblika zapisa	Izbirno	Primeri in opombe
Datum	LLLL-mm-dd	NE	Datum, ko je uporabnik obiskal objavo v trgovini Opomba: Če več dni dodajate posamezne obiskovalce objave v trgovini, bo število obiskovalcev objave v trgovini večje od števila v pogledih tedenske ali mesečne kohorte. V pogledih tedenske in mesečne kohorte je vsak obiskovalec štet enkrat, tudi če opravi več obiskov.
Pot pridobitve	Niz	DA	organsko, Google Ads, z oznako sistema UTM Prisotno za razsežnost »Pot pridobitve« Opomba: Kanal »Trgovina Play (organsko)« je vsota razsežnosti »Iskanje v Trgovini Play (organsko)« in »Brskanje v Trgovini Play (organsko)«. Če se želite izogniti dvojnemu štetju obiskovalcev v tem poročilu, prezrite skupno vrstico »Trgovina Play (organsko)« ali obe vrstici za iskanje in brskanje.
Država	Niz	DA	Prisotno za razsežnosti »Država« in »Država (organsko v Trgovini Play)«
Vir v sistemu UTM/oglaševalska akcija	Niz	DA	Prisotno za razsežnost »Kanali, ki se jim sledi (sistem UTM)«
Ključna beseda	Niz	DA	Primer: »igre« Prisotno za razsežnost »Iskanje v Trgovini Play (organsko)«
Št. obiskovalcev objave v trgovini	Celo število	NE
Uporabniki, ki so namestili aplikacijo	Celo število	NE
Stopnja konverzije iz obiskovalca v uporabnika, ki je namestil aplikacijo	Decimalno število	NE
Srednja vrednost primerjalne vrednosti stopnje konverzije iz obiskovalca v uporabnika, ki je namestil aplikacijo	Decimalno število	DA	Od avgusta 2019 ni izpolnjeno. Na strani s poročili o pridobitvah je na voljo posodobljen niz primerjalnih preizkusov, ki uporabljajo nov izračun. Če želite več informacij, preberite članek Primerjava stopnje konverzije podobnih aplikacij za promet v Trgovini Play.
Št. uporabnikov, ki so namestili aplikacijo in jo ohranili 1 dan	Celo število	NE
Razmerje med številom vseh uporabnikov, ki so namestili aplikacijo, in številom tistih, ki so jo nato ohranili 1 dan	Decimalno število	NE
Št. uporabnikov, ki so namestili aplikacijo in jo ohranili 7 dni	Celo število	NE
Razmerje med številom vseh uporabnikov, ki so namestili aplikacijo, in številom tistih, ki so jo nato ohranili 7 dni	Decimalno število	NE
Št. uporabnikov, ki so namestili aplikacijo in jo ohranili 15 dni	Celo število	NE
Razmerje med številom vseh uporabnikov, ki so namestili aplikacijo, in številom tistih, ki so jo nato ohranili 15 dni	Decimalno število	NE
Št. uporabnikov, ki so namestili aplikacijo in jo ohranili 30 dni	Celo število	NE
Razmerje med številom vseh uporabnikov, ki so namestili aplikacijo, in številom tistih, ki so jo nato ohranili 30 dni	Decimalno število	NE

Podprte razsežnosti

Razsežnost	Ime datoteke
Pot pridobitve*	..._channel.csv
Država	..._country.csv
Država (organsko v Trgovini Play)	..._play_country.csv
Iskanje v Trgovini Play (organsko)	..._play_search.csv
Kanali, ki se jim sledi (sistem UTM)	..._utm_tagged.csv

* Opomba: Kanal »Trgovina Play (organsko)« je vsota razsežnosti »Iskanje v Trgovini Play (organsko)« in »Brskanje v Trgovini Play (organsko)«. Če se želite izogniti dvojnemu štetju obiskovalcev v tem poročilu, prezrite skupno vrstico »Trgovina Play (organsko)« ali obe vrstici za iskanje in brskanje. 

Razsežnost Iskanje Google (organsko) od junija 2019 ni več podprta.

Uspešnost trgovine (nova možnost izvoza – na voljo marca 2021)

Imena datotek CSV

Vsaka razpoložljiva datoteka CSV vsebuje podatke za en mesec in razčlenitev. Datoteke CSV imajo strukturirana imena, ki odražajo, katero leto, mesec in razčlenitev poročila pokrivajo, in sicer po tem vzorcu:

Oblika imena datoteke: store_performance_[ime_paketa]_[llllMM]_[razsežnost].csv

Opombe:

• Ime paketa bo vključeno v ime datoteke, kakršno je, z vsemi posebnimi znaki, če so prisotni  (».« ali »_«).
• llllMM predstavlja leto in mesec, npr. 202101.

Ukaz

gs://[id_segmenta_razvijalca]/stats/store_performance/store_performance_[ime_paketa]_[llllMM]_[razčlenitev].csv

Oblika zapisa datoteke

Polje	Oblika zapisa	Izbirno	Primer	Opis
Datum	LLLL-mm-dd	NE	2021-01-01	Datum, ko je uporabnik obiskal objavo v trgovini
Ime paketa	Niz	NE	com.example.app	Ime paketa, ki je lastnik podatkov iz poročila
Država/regija	Niz	NE	Združeno kraljestvo	Država ali regija, kjer ima uporabnik registriran račun Google
Vir prometa	Niz	NE	Iskanje v Googlu Play	Kako je uporabnik pristal v objavi v trgovini: Iskanje v Googlu Play Napotitve tretjih oseb Raziskovanje v Googlu Play Opomba: Lahko je Other, če ta vrednost ne dosega najmanjših zahtevanih pragov.
Iskalna poizvedba	Niz	DA	trgovina z aplikacijami	Izraz, ki ga je uporabnik iskal, preden se je premaknil na vašo objavo v trgovini. Na voljo samo v iskanju v Googlu Play. Opomba: Lahko je Other, če ta vrednost ne dosega najmanjših zahtevanih pragov.
Vir iz sistema UTM	Niz	DA	google	Vrednost parametra URL-ja za utm_source v povezavah v globino do objave v trgovini. Na voljo samo za zunanje napotitve. Opomba: Lahko je Other, če ta vrednost ne dosega najmanjših zahtevanih pragov.
Oglaševalska akcija iz sistema UTM	Niz	DA	akcija	Vrednost parametra URL-ja za utm_campaign v povezavah v globino do objave v trgovini. Na voljo samo za zunanje napotitve. Opomba: Lahko je Other, če ta vrednost ne dosega najmanjših zahtevanih pragov.
Pridobitve prek objave v trgovini	Celo število	NE	10	Število uporabnikov, ki so obiskali objavo v trgovini in namestili aplikacijo in je takrat niso imeli nameščene v drugih napravah.
Obiskovalci objave v trgovini	Celo število	NE	100	Število uporabnikov, ki so obiskali objavo v trgovini in aplikacije takrat niso imeli nameščene v drugih napravah.
Stopnja konverzije za objavo v trgovini	Decimalno	NE	0,1	Odstotek obiskovalcev objave v trgovini, ki so namestili vašo aplikacijo.  Opomba: Vanj niso vključeni obiski ali namestitve uporabnikov, ki imajo vašo aplikacijo že nameščeno v drugi napravi.

Razpoložljiva struktura razčlenitve

Na voljo so te razčlenitve:

Ime razčlenitve	Polja v vsaki datoteki CSV (v vrstnem redu):
država Primer imena datoteke: uspešnost_v_trgovini_com.primer.aplikacija_202012_država.csv	Datum, ime paketa, država, pridobitve prek objave v trgovini, obiskovalci objave v trgovini, stopnja konverzije za objavo v trgovini
vir_prometa Primer imena datoteke: uspešnost_v_trgovini_com.primer.aplikacija_202012_vir_prometa.csv	Datum, ime paketa, vir prometa, iskalna poizvedba, vir iz sistema UTM, oglaševalska akcija iz sistema UTM, pridobitve prek objave v trgovini, obiskovalci objave v trgovini, stopnja konverzije za objavo v trgovini

 

Ubežna shema

• Podvojite morebitne narekovaje. (" -> "")
• Če celica vsebuje zavihke, nove vrstice, dvojne narekovaje ali vejice, obdajte celico z dvojnimi narekovaji. (… -> "…")

Primer

Če želite na primer prenesti vsa poročila, ustvarjena leta 2020, iz segmenta s poročili z ID-jem pubsite_prod_rev_0123456789 za aplikacijo z imenom paketa com.example.app, je ukaz tak:

gsutil cp -r gs://pubsite_prod_0123456789/stats/store_performance/store_performance_com.example.app_2020* /vaš/krajevni/imenik

Kupci (7 dni po namestitvi – na voljo do avgusta 2021)

Ukaz

gs://[id_segmenta_razvijalca]/acquisition/buyers_7d/buyers_7d_[ime_paketa]_LLLLMM_[razsežnost].csv

Oblika datoteke

Polje	Oblika zapisa	Izbirno	Primeri in opombe
Datum	LLLL-mm-dd	NE	Datum, ko je uporabnik obiskal objavo v trgovini Opomba: Če več dni dodajate posamezne obiskovalce objave v trgovini, bo število obiskovalcev objave v trgovini večje od števila v pogledih tedenske ali mesečne kohorte. V pogledih tedenske in mesečne kohorte je vsak obiskovalec štet enkrat, tudi če opravi več obiskov.
Pot pridobitve	Niz	DA	organsko, Google Ads, z oznako sistema UTM Prisotno za razsežnost »Pot pridobitve« Opomba: Kanal »Trgovina Play (organsko)« je vsota razsežnosti »Iskanje v Trgovini Play (organsko)« in »Brskanje v Trgovini Play (organsko)«. Če se želite izogniti dvojnemu štetju obiskovalcev v tem poročilu, prezrite skupno vrstico »Trgovina Play (organsko)« ali obe vrstici za iskanje in brskanje.
Država	Niz	DA	Prisotno za razsežnosti »Država« in »Država (organsko v Trgovini Play)«
Vir v sistemu UTM/oglaševalska akcija	Niz	DA	Prisotno za razsežnost »Kanali, ki se jim sledi (sistem UTM)«
Ključna beseda	Niz	DA	Primer: »igre« Prisotno za razsežnost »Iskanje v Trgovini Play (organsko)«
Št. obiskovalcev objave v trgovini	Celo število	NE
Uporabniki, ki so namestili aplikacijo	Celo število	NE
Stopnja konverzije iz obiskovalca v uporabnika, ki je namestil aplikacijo	Decimalno število	NE
Srednja vrednost primerjalne vrednosti stopnje konverzije iz obiskovalca v uporabnika, ki je namestil aplikacijo	Decimalno število	DA	Od avgusta 2019 ni izpolnjeno. Na strani s poročili o pridobitvah je na voljo posodobljen niz primerjalnih preizkusov, ki uporabljajo nov izračun. Če želite več informacij, preberite članek Primerjava stopnje konverzije podobnih aplikacij za promet v Trgovini Play.
Kupci	Celo število	NE
Stopnja konverzije med številom uporabnikov, ki so namestili aplikacijo, in številom kupcev	Decimalno število	NE
Večkratni kupci	Celo število	NE
Stopnja konverzije med številom uporabnikov, ki so namestili aplikacijo, in številom večkratnih kupcev	Decimalno število	NE
Stopnja konverzije med številom kupcev in številom večkratnih kupcev	Celo število	NE

Podprte razsežnosti

Razsežnost	Ime datoteke
Pot pridobitve*	..._channel.csv
Država	..._country.csv
Država (organsko v Trgovini Play)	..._play_country.csv
Iskanje v Trgovini Play (organsko)	..._play_search.csv
Kanali, ki se jim sledi (sistem UTM)	..._utm_tagged.csv

* Opomba: Kanal »Trgovina Play (organsko)« je vsota razsežnosti »Iskanje v Trgovini Play (organsko)« in »Brskanje v Trgovini Play (organsko)«. Če se želite izogniti dvojnemu štetju obiskovalcev v tem poročilu, prezrite skupno vrstico »Trgovina Play (organsko)« ali obe vrstici za iskanje in brskanje. 

Razsežnost Iskanje Google (organsko) od junija 2019 ni več podprta.