A jelentések típusai
Részletes jelentésekA részletes jelentések az egyes események adatait tartalmazzák:
- Vélemények
- Pénzügyi: becsült eladások, bevételek, jutalomként járó termékek, koreai Play-egyenleg általi finanszírozás
Az összesített jelentések az alkalmazásstatisztikák összevont adatait tartalmazzák (átlagok, napi összesítések stb.).
- Statisztikák: telepítések, összeomlások, értékelések és előfizetések
- Felhasználószerzés: megőrzött telepítők, vásárlók (7 nappal a telepítést követően), előfizetők
A jelentések letöltése
- Nyisd meg a Play Console oldalát.
- Kattints a Jelentések letöltése elemre, majd válaszd a Vélemények, Statisztikák vagy a Pénzügyek lehetőséget.
- A „Válassz alkalmazást” pontban írd be és válaszd ki alkalmazásod nevét.
- Add meg, hogy melyik évre és hónapra vonatkozó jelentést szeretnéd letölteni.
Megjegyzés: A pénzügyi jelentésekben a fiókodban található összes alkalmazás szerepel.
Jelentések letöltése a Google Cloud Storage szolgáltatásból
A Google Cloud Storage szolgáltatásban jelentések érhetők el. A jelentéseket naponta generáljuk, és havi CSV-fájlokba gyűjtjük. A jelentéseket Google Play fejlesztői fiókod privát Google Cloud Storage csoportjában tároljuk.
A jelentésekhez böngészőben a Google Cloud Storage segítségével, míg programozottan a gsutil eszközzel férhetsz hozzá. A Cloud Storage-tárhely programozott módon történő eléréséhez más eszközöket is használhatsz.
Tipp: Ha importálni szeretnéd a jelentéseket Google Cloud Storage-tárhelyedből a BigQuery szolgáltatásba, akkor a CSV-fájlokat UTF-16
kódolásúról UTF-8
kódolásúra kell konvertálnod.
Hol található a Google Cloud Storage URI-ja?
A Google Cloud Storage-URI másolásához kattints a Cloud Storage-URI másolása gombra a Jelentések letöltése oldal megfelelő szakaszának fejléce mellett.
A Cloud Storage-URI így kezdődik: pubsite_prod_rev
(például: pubsite_prod_rev_01234567890987654321
).
- Telepítsd a gsutil eszközt.
- Mindenképpen olyan fiókkal végezd a hitelesítést, amely hozzáfér a Play Console-hoz.
- Ha a telepítési folyamat során először használod a gsutil eszközt, és más projekted nincs konfigurálva a Google Cloud Storage szolgáltatásban, megadhatod az alkalmazás nevét, amikor a rendszer projektazonosítót kér.
- Jelentéskészítési tárhely-azonosítódat a Jelentések letöltése oldalon a megfelelő szakasz fejléce melletti Cloud Storage URI másolása gombra kattintva találod.
- A Cloud Storage-URI így kezdődik:
pubsite_prod_rev
(például:pubsite_prod_rev_01234567890987654321
).
- A Cloud Storage-URI így kezdődik:
- Töltsd le a jelentéseket a
gsutil cp
paranccsal.- A jelentések elérésével kapcsolatos további parancsokért olvasd el a gsutil dokumentációját.
A jelentések rendezése könyvtárakban történik, amelyek az egyes típusok szerint vannak elnevezve. A CSV-fájlnevek tartalmazzák a jelentés típusát, a csomag nevét, az időtartamot és a dimenziót (ha van ilyen).
1. lépés: Szolgáltatásfiók létrehozása
- Nyisd meg a Google Developers Console felületét.
- Ha már van projekted, válaszd ki a legördülő listából. Ha a projekted nem szerepel a listában, vagy újat szeretnél létrehozni, kattints a Projekt létrehozása lehetőségre.
- Válaszd a Menü ikon > Engedélyek > Szolgáltatásfiókok > Szolgáltatásfiók létrehozása lehetőséget.
- Kövesd a képernyőn megjelenő utasításokat, és válaszd a Létrehozás lehetőséget.
- Másold vágólapra a feltüntetett e-mail-címet.
- Példa:
accountName@project.iam.gserviceaccount.com
- Példa:
2. lépés: A szolgáltatásfiók hozzáadása Play Console-fiókodhoz
- Nyisd meg a Play Console oldalát.
- Válaszd a Beállítások > Felhasználói fiókok és jogosultságok > Új felhasználó meghívása lehetőséget.
- Illeszd vagy gépeld be a szolgáltatásfiókhoz tartozó e-mail-címet.
- Válaszd ki a jogosultságokat a szükséges jelentéstípusok alapján.
- Tipp: A Fejlesztőifiók-felhasználók hozzáadása, engedélyek kezelése cikkből tájékozódhatsz arról, hogy a felhasználóknak milyen különböző hozzáférési szintjei lehetnek, és az egyes engedélyek milyen jogosultságokat biztosítanak a számukra.
- Kattints a Felhasználó hozzáadása lehetőségre. Ekkor szolgáltatásfiókodat a rendszer hozzáadja a fiókodhoz.
3. lépés: Jelentések lekérése API-hívás segítségével
- Telepítsd a kívánt kódnyelvhez tartozó API-ügyfélkönyvtárat.
- Konfiguráld az API-hívást végrehajtó kódot úgy, hogy
OAuth2
szerver-szerver hitelesítést használjon, és kérjen engedélyt azOAuth2
-hatókör használatára (https://www.googleapis.com/auth/devstorage.read_only). - Indíts hitelesített API-hívásokat a jelentések lekéréséhez.
Ha Python segítségével kérted le a jelentéseket, íme egy példakód:
import json
from httplib2 import Http
from oauth2client.client import SignedJwtAssertionCredentials
from apiclient.discovery import build
# Változtasd meg ezeket a változókat a saját igényeid szerint
client_email = 'ide jön a te szolgáltatásfiókod'
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()
A Google Cloud Storage szolgáltatáshoz való hozzáférés szabályozása
A Google Cloud Storage szolgáltatásban rendelkezésre álló jelentések ugyanazokat a hozzáférési korlátozásokat használják, mint amelyek a Play Console adathozzáférését szabályozzák. Ez azt jelenti, hogy azok a fiókfelhasználók, akik hozzáféréssel rendelkeznek az adott Play Console-fiók egyes területeihez, a Google Cloud Storage megfelelő jelentéseihez is hozzáférnek.
A fióktulajdonosok bármikor frissíthetik az egyes felhasználók engedélyeit.
- A tömeges jelentésekhez való hozzáféréshez az „Alkalmazásinformációk megtekintése” engedélyt „Globális” értékre kell állítani.
- Pénzügyi jelentések letöltéséhez a „Pénzügyi adatok megtekintése” engedélyt „Globális” értékre kell állítani.
A részletes jelentések parancsai és fájlformátumai
Összeomlások és ANR-ek
2018 májusától kezdődően többé nem tudsz letölteni összeomlásokról és ANR-ekről szóló részletes jelentéseket.
Vélemények
Parancs
gs://[developer_bucket_id]/reviews/reviews_[package_name]_YYYYMM.csv
Fájlformátum
Mező | Formátum | Nem kötelező | Példák és megjegyzések |
---|---|---|---|
Csomagnév | Karakterlánc | NEM | com.company.app |
Alkalmazás verziójának kódja | egész szám | IGEN | Csak éles APK-k |
Alkalmazás verziójának neve | Karakterlánc | IGEN | |
Véleményező nyelve | Karakterlánc – ISO 639-1 kétbetűs rövidítés | IGEN | en |
Eszköz | Karakterlánc | IGEN | hammerhead |
Vélemény beküldésének dátuma és ideje | ISO_8601 az időt is beleértve, UTC időzóna | NEM | 2014-06-19T19:12:32Z |
Vélemény beküldésének ciklus óta eltelt másodpercei | egész szám, ezredmásodperc a ciklus óta | NEM | |
Vélemény legutóbbi frissítésének dátuma és ideje | ISO_8601 az időt is beleértve, UTC időzóna | IGEN | 2014-06-19T19:12:32Z |
Vélemény legutóbbi frissítésének ciklus óta eltelt másodpercei | egész szám, ezredmásodperc a ciklus óta | IGEN | |
Csillagos értékelés | egész szám (1 és 5 között) | NEM | |
Vélemény címe | Karakterlánc a véleményező helyi nyelvén (sortörések nélkül) | IGEN | |
Vélemény szövege | Karakterlánc a véleményező helyi nyelvén (sortörések nélkül) | IGEN | |
Fejlesztő válaszának dátuma és ideje | ISO_8601 az időt is beleértve, UTC időzóna | IGEN | 2014-06-19T19:12:32Z |
Fejlesztő válaszának ciklus óta eltelt másodpercei | egész szám, ezredmásodperc a ciklus óta | IGEN | |
Fejlesztő válaszának szövege | Karakterlánc (sortörések nélkül, térközök tömörítésével) | IGEN | |
Vélemény linkje | Karakterlánc | IGEN | https://play.google.com/apps/publish/?dev_acc=<...>#ReviewPlace:id=<..> |
Példa
Ha szeretnéd letölteni a 2014-ben létrehozott összes jelentést az alkalmazás pubsite_prod_rev_0123456789
azonosítójú jelentési tárhelyéről „com.example.app” csomagnévvel, akkor a következő parancsot kell használnod:
gsutil cp -r gs://pubsite_prod_rev_0123456789/reviews/reviews_com.example.app_2014* /your/local/directory
Pénzügyi jelentések
Becsült eladásokJavasoljuk, hogy ne a CSV-fájlokban lévő oszlopok számából indulj ki az automatikus jelentéseidnél.
Részletek
A becsült értékesítési jelentés használatával megtekintheted az alkalmazásokra, alkalmazáson belüli termékekre és előfizetésekre vonatkozó értékesítések kicsit késleltetett adatait. A jelentés a vásárlók által befizetett összegeket tartalmazza, és nem vonja ki a végösszegből az adókat és a Google által kivetett díjakat.
A jelentést felhasználhatod elemzés vagy trendelemzés céljából, de nem ajánljuk könyvelési célokra. Helyette tekintsd meg a Bevételi jelentést.
Számos okból kifolyólag tapasztalhatsz eltéréseket a jelentés és a bevételed között. Például a becsült értékesítési jelentés nem veszi figyelembe a forrásadókat és a visszaterheléseket. A jelentés a felhasználók helyi pénznemében befizetett összeget tartalmazza, a saját kifizetési pénznemedre átváltott összeg nem található meg benne.
Parancs
gs://[developer_bucket_id]/sales/salesreport_YYYYMM.zip
Példa
Ha szeretnéd letölteni a 2014-ben létrehozott összes jelentést az alkalmazás pubsite_prod_rev_0123456789
azonosítójú jelentési tárhelyéről „com.example.app” csomagnévvel, akkor a következő parancsot kell használnod:
gsutil cp -r gs://pubsite_prod_rev_0123456789/sales/salesreport_2014* /your/local/directory
Fájlformátum
Mező | Formátum | Nem kötelező | Példák és megjegyzések |
---|---|---|---|
Rendelésszám |
Karakterlánc |
Nem |
Az előfizetések rendelési azonosítója végén megtalálod a megújítási ciklus számát (például az első megújítás |
Rendelés kifizetésének dátuma |
Karakterlánc |
Nem |
A megrendelés dátuma az UTC időzóna alapján jelenik meg (ÉÉÉÉ-HH-NN formátumban). |
Rendelés kifizetésének időbélyege |
Egész szám |
Nem |
A felhasználó rendeléssel való megterheléséhez tartozó UNIX-időbélyeg. Másodpercben mérve Unix-időben. |
Pénzügyi állapot |
Karakterlánc |
Nem |
Ha teljesen visszatéríted az egyik rendelést a részleges visszatérítés után:
|
Eszköz modellje |
Karakterlánc |
Nem |
A vásárláshoz használt androidos eszköz modellje. Az előfizetéses megrendelések esetében ez arra az eszközre utal, amellyel az eredeti vásárlást végezték. |
Terméknév |
Karakterlánc |
Nem |
A termék fejlesztői által megadott név. A vásárló nyelv- és országkódjának megfelelően jelenik meg. |
Termékkód |
Karakterlánc |
Nem |
Az alkalmazás csomagneve, ahol a terméket eladták. |
Terméktípus |
Karakterlánc |
Nem |
|
SKU-azonosító |
Karakterlánc |
Nem |
A fejlesztők által megadott egyedi termékazonosító. |
Akció pénzneme |
Karakterlánc |
Nem |
|
Tétel ára |
Egész szám |
Nem |
A vásárló helyi pénznemében jelenik meg. Az ezreselválasztó a „ ”. |
Begyűjtött adók |
Egész szám |
Igen |
A vásárló helyi pénznemében jelenik meg. Az ezreselválasztó a „ ”. |
Felszámított összeg |
Egész szám |
Nem |
A vásárló helyi pénznemében jelenik meg. Ez a tétel ára és a beszedett adók összege. Az ezreselválasztó a „ ”. |
Vevő városa |
Karakterlánc |
Igen |
Csak azon értékesítéseknél van kitöltve, amelyeknél te vagy a pénzügyi felelősséget vállaló fél. |
Vevő állama |
Karakterlánc |
Igen |
|
Vevő irányítószáma |
Karakterlánc |
Igen |
Csak azon értékesítéseknél van kitöltve, amelyeknél te vagy a pénzügyi felelősséget vállaló fél. |
Vevő országa |
Karakterlánc |
Nem |
|
Alapcsomag azonosítója |
Karakterlánc |
Igen |
Az előfizetés alapcsomag-azonosítója. Csak az előfizetésekhez van kitöltve. További információ. |
Ajánlatazonosító |
Karakterlánc |
Igen |
Az előfizetés ajánlatazonosítója. Csak az előfizetésekhez van kitöltve. További információ. |
Csoportazonosító | Egész szám | Igen |
Az egyedi azonosítót fejlesztői fiók létrehozásakor kapod meg. További információ. |
Első 1 millió USD jogosult | Karakterlánc | Igen |
Csak fejlesztői fiókcsoport beállításakor lesz kitöltve. További információ. |
Promóció azonosítója | Karakterlánc | Igen |
|
Kuponérték | Egész szám | Igen |
A vásárló helyi pénznemében jelenik meg. Az ezreselválasztó a „ ”. Csak a Play-pontok kuponjaival kapcsolatos értékesítéseknél van kitöltve. További információ. |
Kedvezmény mértéke | Egész szám | Igen |
A kedvezménynek a felhasználó által a Play-pontok elköltésével a pénz elköltéséhez képest elért megtakarítás meghatározására szolgáló, százalékban kifejezett mértéke. Csak a Play-pontokkal kapcsolatos értékesítéseknél van kitöltve. További információ. |
Kiemelt termékek kódja |
Egész szám |
Igen |
Az egyedi azonosító olyankor kapható, amikor a fejlesztő kiemelt terméket hoz létre. További információ. |
Árkísérlet azonosítója | Karakterlánc | Igen |
Árkísérlet azonosítója és kísérleti ág |
Javasoljuk, hogy ne a CSV-fájlokban lévő oszlopok számából indulj ki az automatikus jelentéseidnél.
Részletek
A bevételi jelentéseket kifizetéseid és tranzakcióid értelmezésére használhatod fel. A jelentés minden egyes új sora egy bizonyos típusú tranzakciót jelképez, mint például amikor megterheled az egyik ügyfelet, vagy díjat fizetsz a Google-nak az eredeti és az átváltott összegeken felül.
A bevételi jelentések a megelőző hónap tranzakcióit tartalmazzák. Az összeg több héttel azután érkezik a számládra, hogy a bevételi jelentés hozzáférhetővé válik.
A bevételi jelentést havonta egyszer hozzuk létre, és általában a következő hónap 5. napján válik hozzáférhetővé. A Google időnként korrigálhatja a bevételeidet a számítási hibák kijavítása végett. Ha ez történik, kapcsolatba lépünk veled, és értesítünk a problémáról, illetve létrehozunk egy újabb bevételfájlt, amely csak a módosított tranzakciókat tartalmazza.
Megjegyzések:
- A Google-díjak mostantól minden tranzakció esetén láthatók, függetlenül attól, hogy az értékesített termék esetében a Google-e a pénzügyi feladatokat ellátó fél.
- A bevételi jelentés nem tartalmazza a visszaterheléseket.
- A tranzakciókkal kapcsolatos bevételi jelentéshez a rendszer minden hónapban egyetlen fájlt generál.
- A tajvani forrásadó befizetésére az adó jelentésben való megjelenését megelőző hónapban kerül sor.
Parancs
gs://[developer_bucket_id]/earnings/earnings_YYYYMM.zip
Példa
Ha szeretnéd letölteni a 2014-ben létrehozott összes jelentést az alkalmazás pubsite_prod_rev_0123456789
azonosítójú jelentési tárhelyéről „com.example.app” csomagnévvel, akkor a következő parancsot kell használnod:
gsutil cp -r gs://pubsite_prod_rev_0123456789/earnings/earnings_2014* /your/local/directory
Fájlformátum
Mező | Formátum | Nem kötelező | Példák és megjegyzések |
---|---|---|---|
Leírás |
Karakterlánc |
Nem |
Az előfizetések rendelési azonosítója végén megtalálod a megújítási ciklus számát (például az első megújítás |
Tranzakció dátuma |
Karakterlánc |
Nem |
A megrendelés dátuma a csendes-óceáni időzóna alapján jelenik meg (HHH NN, ÉÉÉÉ formátumban). Fontos tudni azt, hogy a tranzakció időbélyege a következő hónapot is tartalmazhatja, mivel a jelentések a kiadás időbélyege alapján készülnek. |
Tranzakció ideje |
Karakterlánc |
Nem |
|
Adó típusa |
Karakterlánc |
Igen |
Adómentesség esetén üres. |
Tranzakció típusa |
Karakterlánc |
Nem |
|
Visszatérítés típusa |
Karakterlánc |
Igen |
Azok a visszatérítések, amelyeknél a vevő teljes költségét visszatérítették, „Teljes” megjelölést kapnak. Azokat a visszatérítéseket, amelyeknél a vásárló által kifizetett összeg bizonyos része lett visszatérítve, „Részleges” megjelöléssel látja el a rendszer. |
Terméknév |
Karakterlánc |
Nem |
A termék fejlesztői által megadott név. A vásárló nyelv- és országkódjának megfelelően jelenik meg. |
Termékkód |
Karakterlánc |
Nem |
Az alkalmazás csomagneve, ahol a terméket eladták. |
Terméktípus |
Egész szám |
Nem |
Az eladott termék azonosítására szolgál. A „0” fizetős alkalmazás értékesítését, az „1” az alkalmazáson belüli vásárlást vagy az előfizetést jelöli. |
SKU-azonosító |
Karakterlánc |
Nem |
A fejlesztők által megadott egyedi termékazonosító. |
Hardver |
Karakterlánc |
Nem |
A vásárláshoz használt androidos eszköz modellje. Az előfizetéses megrendelések esetében arra a modellre utal, amellyel az eredeti vásárlást végezték. |
Vevő országa |
Karakterlánc |
Nem |
|
Vevő állama |
Karakterlánc |
Igen |
|
Vevő irányítószáma |
Karakterlánc |
Igen |
|
Vevő pénzneme |
Karakterlánc |
Nem |
|
Összeg (a vevő pénznemében) |
Egész szám |
Nem |
A számla pénznemátváltás előtti teljes összege. |
Valutaárfolyam |
Egész szám |
Nem |
Az az árfolyam, amelyen a vásárlás összegét átváltjuk a kereskedő pénznemére. |
Kereskedő pénzneme | Karakterlánc | Nem |
Az a pénznem, amelyre átváltották a rendelést. Ez a helyi pénznem, amelyben a kifizetésed történik. |
Összeg (a kereskedő pénznemében) | Egész szám | Nem |
A számla pénznemátváltás utáni teljes összege. |
Alapcsomag azonosítója |
Karakterlánc |
Igen |
Az előfizetés alapcsomag-azonosítója. Csak az előfizetésekhez van kitöltve. További információ. |
Ajánlatazonosító |
Karakterlánc |
Igen |
Az előfizetés ajánlatazonosítója. Csak az előfizetésekhez van kitöltve. További információ. |
Csoportazonosító | Egész szám | Igen |
Az egyedi azonosítót fejlesztői fiók létrehozásakor kapod meg. További információ. |
Első 1 millió USD jogosult | Karakterlánc | Igen |
Csak fejlesztői fiókcsoport beállításakor lesz kitöltve. További információ. |
Szolgáltatási díj % |
Egész szám |
Igen |
|
Díj leírása | Karakterlánc | Igen |
A Google-szolgáltatási díj kiszámításához megadott részlet. |
Promóció azonosítója | Karakterlánc | Igen |
Csak a Play-pontokkal és a Play Pass-szal kapcsolatos értékesítéseknél van kitöltve. A „PP.C” és a „PP.P” előtagok határozzák meg a Play Points-kuponokat magukba foglaló, illetve az alkalmazáson belüli termékek promócióit tartalmazó rendeléseket. Azok a rendelések is megjelennek, amelyeknél a Play-pontok költése közvetlenül történt. A „Pass” előtag azokat a rendeléseket határozza meg, amelyeknél a felhasználók Play Pass-előfizetésük részeként biztosított kuponokat használtak fel. |
Javasoljuk, hogy ne a CSV-fájlokban lévő oszlopok számából indulj ki az automatikus jelentéseidnél.
Részletek
Ha regisztráltál az alternatív számlázási vagy a külső ajánlatok programra, és bejelentetted a tranzakciókat a Google Playnek, akkor a Számlázási jelentésben részletesen láthatod a tranzakciókat és a Google által neked kiszámlázott szolgáltatási díjakat.
A Számlázási jelentés egyetlen CSV-fájlban tartalmazza az előző hónap tranzakcióit. A jelentés tranzakciónkénti lebontásban tartalmazza a felhasználói díjat, a Google szolgáltatási díját és az adó összegét (ha van ilyen). Annak érdekében, hogy érthetőbb legyen a szolgáltatási díjak összegének kiszámítási módja, olyan információkat is megadunk, mint a szolgáltatási díj százalékos aránya és a pénznemek közötti átváltási árfolyam.
Megjegyzés:
- A Számlázási jelentést havonta egyszer hozzuk létre, és általában a következő hónap 5. napjáig érhető el.
- A számlázás pénznemében nullára kerekített Google-díjat- vagy adót tartalmazó sorok nem szerepelnek a jelentésben.
Parancs
gsutil cp -r gs://[developer_bucket_id]/invoice_billing_reports/invoice_billing_report_YYYYMM.zip /your/local/directory
Példa
Ha szeretnéd letölteni a 2024-ben létrehozott összes jelentést a pubsite_prod_rev_0123456789
azonosítójú jelentési tárhelyről, akkor a következő parancsot kell használnod:
gsutil cp -r gs://pubsite_prod_rev_0123456789/invoice_billing_reports/invoice_billing_report_2024* /your/local/directory
Fájlformátum
A tranzakció dátuma a csendes-óceáni időzóna szerint.
Mező | Formátum | Nem kötelező | Példák és megjegyzések |
---|---|---|---|
Számlaazonosító |
Karakterlánc |
Nem |
A számlán szereplő számmal megegyező azonosító. |
Program |
Karakterlánc |
Igen |
Csak a Google-díjakat tartalmazó sorokhoz állítható be. |
Külső tranzakcióazonosító |
Karakterlánc |
Nem |
|
Tranzakció dátuma |
Karakterlánc |
Nem |
A tranzakció dátuma a csendes-óceáni időzóna szerint. |
Tranzakció időbélyege |
Egész szám |
Nem |
A tranzakció UNIX-időbélyege. Másodpercben mérve Unix-időben. |
Tranzakció típusa |
Karakterlánc |
Nem |
Felhasználói díj, Google-díj, Adó, Felhasználói díj visszatérítése, Google-díj visszatérítése, Adó-visszatérítés, Felhasználói díj részleges visszatérítése, Google-díj részleges visszatérítése, Adó részleges visszatérítése |
Adó típusa |
Karakterlánc |
Igen |
Csak az adót tartalmazó sorok esetén állítható be. |
Cikkszám típusa |
Karakterlánc |
Nem |
|
Csomagazonosító |
Karakterlánc |
Nem |
Annak az alkalmazásnak a csomagneve, ahol a terméket eladták. |
Értékesítési ország |
Karakterlánc |
Nem |
|
Adó nélküli tételár (az értékesítés pénznemében) |
Tizedes |
Igen |
A termék ára az értékesítés pénznemében, adó nélkül. Csak a felhasználói díjat tartalmazó soroknál állítható be. |
Értékesítési pénznem |
Karakterlánc |
Nem |
A vásárló helyi pénzneme. |
Fizetendő összeg (az értékesítés pénznemében) |
Tizedes |
Igen |
Fizetendő összeg az értékesítés pénznemében. Csak a Google-díjat és az adót tartalmazó soroknál állítható be. A levont összeg esetén pozitív, a visszatérítés vagy a részleges visszatérítés összege esetén negatív. |
Pénznem átváltási árfolyama |
Tizedes |
Nem |
Az az árfolyam, amelyen a fizetendő összeget az értékesítés pénzneméről átváltottuk a számlázás pénznemére. |
Számlázás pénzneme |
Karakterlánc |
Nem |
|
Fizetendő összeg (a számlázás pénznemében) |
Tizedes |
Igen |
A fizetendő összeg a számlázás pénznemében. Csak a Google-díjat és az adót tartalmazó soroknál állítható be. A levont összeg esetén pozitív, a visszatérítés vagy a részleges visszatérítés összege esetén negatív. |
Csoportazonosító |
Egész szám |
Igen |
Az egyedi azonosítót fejlesztői fiók létrehozásakor kapod meg. További információ |
Első 1 millió USD jogosult |
Karakterlánc |
Igen |
Csak fejlesztői fiókcsoport beállításakor lesz kitöltve. További információ |
Szolgáltatási díj % |
Egész szám |
Igen |
|
Díj leírása |
Karakterlánc |
Igen |
A Google-szolgáltatási díj kiszámításához megadott adat. |
Részletek
Ha olyan kereskedő vagy, akinek Dél-Koreában nyugtát kell adnia a vonatkozó jogszabályoknak és előírásoknak megfelelően, vagy önként regisztráltál a nyugták kiállítására, akkor kérésre nyugtát kell adnod a fizetős alkalmazások vagy alkalmazáson belüli termékek Google Play-ajándékutalvánnyal, koreai wonban (KRW) történő vásárlásáról.
A koreai Play-egyenleg által finanszírozott vásárlások jelentése tartalmazza a koreai wonban végzett Play-egyenleges vásárlásokat, hogy a felhasználó megkapja a fizetési bizonylatot.
Megjegyzés: A felhasználók több forrásból tölthetik fel Play-egyenlegüket, beleértve a Google-tól és a partnereinktől származó promóciós jóváírásokat is. A fizetési bizonylat kiállítása előtt fontos meggyőződni arról, hogy a felhasználó egyenlegét készpénzzel egyenértékű fizetőeszközzel töltötte fel (például ajándékutalvánnyal).
Parancs
gs://[developer_bucket_id]/play_balance_krw/play_balance_krw_YYYYMM.zip
Példa
Ha szeretnéd letölteni a 2018-ban létrehozott összes jelentést az alkalmazás pubsite_prod_rev_0123456789
azonosítójú jelentési tárhelyéről „com.example.app” csomagnévvel, akkor a következő parancsot kell használnod:
gsutil cp -r gs://pubsite_prod_rev_0123456789/play_balance_krw/play_balance_krw_2018* /your/local/directory
Fájlformátum
Mező | Formátum | Nem kötelező | Példák és megjegyzések |
---|---|---|---|
Rendelésszám |
Egész szám |
Nem |
Az előfizetések rendelési azonosítója végén megtalálod a megújítási ciklus számát (például az első megújítás |
Rendelés kifizetésének dátuma |
Karakterlánc |
Nem |
A megrendelés dátuma az UTC időzóna alapján jelenik meg (ÉÉÉÉ-HH-NN formátumban). |
Pénzügyi állapot |
Karakterlánc |
Nem |
|
Play-egyenleg finanszírozási összege |
Karakterlánc |
Nem |
A tranzakció összege. |
Play-egyenleg pénzneme | Karakterlánc | Nem | KRW A koreai Play-egyenleg által finanszírozott alkalmazások jelentéseinek esetében ez mindig koreai won (KRW). |
Rendelés kifizetésének időbélyege | Egész szám | Nem | 1480507200
A felhasználó rendeléssel való megterheléséhez tartozó UNIX-időbélyeg. Másodpercben mérve Unix-időben. |
Előfizetések
Lemondási kérdőív válaszaiParancs
gs://[developer_bucket_id]/subscriptions/cancellations/freeform_[package_name].csv
Fájlformátum
Mező | Formátum | Nem kötelező | Példák és megjegyzések |
---|---|---|---|
Lemondás dátuma | Karakterlánc | Nem | 2016-11-30 |
SKU-azonosító | Karakterlánc | Igen | kincsesláda_az_új_felhasználóknak A fejlesztők által megadott egyedi termékazonosító. |
Ország | Karakterlánc | Nem | US, CA stb. |
Válasz | Karakterlánc | Nem |
Az összesített jelentések parancsai és fájlformátumai
Statisztikák
TelepítésekParancs
gs://[developer_bucket_id]/stats/installs/installs_[package_name]_yyyyMM_[dimension].csv
Fájlformátum
Mező | Formátum | Nem kötelező | Példa |
---|---|---|---|
Dátum | ÉÉÉÉ-hh-nn | NEM | 2014-06-19 |
Csomagnév | Karakterlánc | NEM | com.my.app |
Eszköz (vagy egyéb támogatott dimenzió) | Karakterlánc | IGEN | hammerhead |
Jelenlegi telepítések eszköz szerint | egész szám | NEM | |
Telepítések aktív eszközökön | egész szám | NEM | |
Napi telepítések eszköz szerint | egész szám | NEM | |
Napi eltávolítások eszköz szerint | egész szám | NEM | |
Napi frissítések eszköz szerint | egész szám | NEM | |
Jelenlegi telepítések felhasználó szerint | egész szám | NEM | |
Összes telepítés felhasználó szerint | egész szám | NEM | |
Napi telepítések felhasználó szerint | egész szám | NEM | |
Napi eltávolítások felhasználó szerint | egész szám | NEM |
Támogatott dimenziók
Dimenzió | Fájlnév |
---|---|
Alkalmazás verziójának kódja | ..._app_version.csv |
Szolgáltató | ..._carrier.csv |
Ország | ..._country.csv |
Eszköz | ..._device.csv |
Nyelv | ..._language.csv |
Android operációs rendszer verziója | ..._os_version.csv |
Példa
Ha szeretnéd letölteni a 2014-ben létrehozott összes jelentést az alkalmazás pubsite_prod_rev_0123456789
azonosítójú jelentési tárhelyéről „com.example.app” csomagnévvel, akkor a következő parancsot kell használnod:
gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/installs/installs_com.example.app_2014* /your/local/directory
Megjegyzés: 2018. januártól az exportált elemek tartalmazzák az új adatforrás adatait, és megegyeznek az alkalmazásod Statisztikák oldalán található adataival. A 2018. január előtt exportált elemek csak a korábbi adatforrások esetében érhetők el.
Parancs
gs://[developer_bucket_id]/stats/crashes/crashes_[package_name]_yyyyMM_[dimension].csv
Fájlformátum
Mező | Formátum | Nem kötelező | Példa |
---|---|---|---|
Dátum | ÉÉÉÉ-hh-nn | NEM | 2014-06-19 |
Csomagnév | Karakterlánc | NEM | com.my.app |
Eszköz (vagy egyéb támogatott dimenzió) | Karakterlánc | IGEN | hammerhead |
Napi rendszerösszeomlások | egész szám | NEM | |
Napi ANR-ek | egész szám | NEM |
Támogatott dimenziók
Dimenzió | Fájlnév |
---|---|
Alkalmazás verziójának kódja | ..._app_version.csv |
Eszköz | ..._device.csv |
Android operációs rendszer verziója | ..._os_version.csv |
Példa
Ha szeretnéd letölteni a 2014-ben létrehozott összes jelentést az alkalmazás pubsite_prod_rev_0123456789
azonosítójú jelentési tárhelyéről „com.example.app” csomagnévvel, akkor a következő parancsot kell használnod:
gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/crashes/crashes_com.example.app_2014* /your/local/directory
Parancs
gs://[developer_bucket_id]/stats/ratings/ratings_[package_name]_yyyyMM_[dimension].csv
Fájlformátum
Mező | Formátum | Nem kötelező | Példa |
---|---|---|---|
Dátum | ÉÉÉÉ-hh-nn | NEM | 2014-06-19 |
Csomagnév | Karakterlánc | NEM | com.my.app |
Eszköz (vagy egyéb támogatott dimenzió) | Karakterlánc | IGEN | hammerhead |
Napi átlagos értékelés | %.2f | IGEN | |
Összes átlagos értékelés | %.2f | Igen | 4.16 |
Támogatott dimenziók
Dimenzió | Fájlnév |
---|---|
Alkalmazás verziójának kódja | ..._app_version.csv |
Szolgáltató | ..._carrier.csv |
Ország | ..._country.csv |
Eszköz | ..._device.csv |
Nyelv | ..._language.csv |
Android operációs rendszer verziója | ..._os_version.csv |
Példa
Ha szeretnéd letölteni a 2014-ben létrehozott összes jelentést az alkalmazás pubsite_prod_rev_0123456789
azonosítójú jelentési tárhelyéről „com.example.app” csomagnévvel, akkor a következő parancsot kell használnod:
gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/ratings/ratings_com.example.app_2014* /your/local/directory
Parancs
gs://[developer_bucket_id]/financial-stats/subscriptions/subscriptions_[package_name]_[product_id]_yyyyMM_[dimension].csv
Fájlformátum
Mező | Formátum | Nem kötelező | Példák és megjegyzések |
---|---|---|---|
Dátum | ÉÉÉÉ-HH-NN | NEM |
A megrendelés dátuma az UTC időzóna alapján jelenik meg (ÉÉÉÉ-HH-NN formátumban). |
Csomagnév | Karakterlánc | NEM | com.example.app |
Termékkód | Karakterlánc | NEM | Prémium hozzáférés |
Ország | Karakterlánc | NEM |
|
Új előfizetések | Szám | NEM | 1234 |
Törölt előfizetések | Szám | NEM | 1234 |
Aktív előfizetések | Szám | NEM | 1234 |
Alapcsomag azonosítója | Karakterlánc | NEM | heti |
Ajánlatazonosító | Karakterlánc | NEM | tavaszi ajánlat |
Megjegyzés: Az új, lemondott és aktív előfizetések statisztikáiról az alkalmazás bevételi és vásárlói adatainak áttekintéséről szóló súgócikkben tájékozódhatsz.
Támogatott dimenziók
Dimenzió | Fájlnév |
---|---|
Ország | ..._country.csv |
Felhasználószerzés
A Megőrzött telepítők és a Vásárlói jelentések automatikus hozzáférést biztosítanak a régi ügyfélszerzési jelentés adataihoz. Ezt az exportálást egy új automatizált exportálás váltja, amely magában foglalja az Áruházi elemzés és aKonverzióelemzés oldalak adatait a Play Console-ban. Ez 2021 márciusától használható.
A régi jelentéseket 2021 októberében eltávolítottuk.
További információért olvasd el a Hogyan tölthetem le a felhasználószerzési adatokat? című szakaszt.
Megjegyzés: Az előfizetői jelentés támogatása 2019 novemberétől megszűnt. További információért tájékozódj az ügyfélszerzési forrásokról és mutatókról.
Megőrzött telepítők (a régi exportálás 2021 augusztusáig áll rendelkezésre)Parancs
gs://[developer_bucket_id]/acquisition/retained_installers/retained_installers_[package_name]_yyyyMM_[dimension].csv
Fájlformátum
Mező | Formátum | Nem kötelező | Példák és megjegyzések |
---|---|---|---|
Dátum | ÉÉÉÉ-hh-nn | NEM |
Az a dátum, amikor a felhasználó utoljára megnyitotta az áruházi adatlapodat Megjegyzés: Az áruházi adatlap egyedi látogatóinak több napon át történő hozzáadása azt eredményezi, hogy az áruházi adatlapodat nagyobb számú látogató keresi fel, mint ami a heti vagy havi csoportmegtekintéseknél szerepel. A heti és havi csoportmegtekintéseknél minden egyes látogató egynek számít, még akkor is, ha az adott látogató többször nyitja meg az áruházi adatlapodat. |
Felhasználószerzési csatorna | Karakterlánc | IGEN |
A „Felhasználószerzési csatorna” dimenziónál van jelen Megjegyzés: A „Play Áruház (organikus)” csatorna a „Keresés a Play Áruházban (organikus)” és a „Böngészés a Play Áruházban (organikus)” dimenzió összesítése. A jelentésben kétféle módon kerülheted el a látogatók duplán számolását: vagy a teljes „Play Áruház (organikus)” sort, vagy pedig a keresési és böngészési sorokat hagyd figyelmen kívül. |
Ország | Karakterlánc | IGEN | Az „Ország” és az „Ország (Play Áruház – organikus)” dimenzióknál van jelen |
UTM-forrás/kampány | Karakterlánc | IGEN |
A „Nyomon követett csatornák (UTM)” dimenziónál van jelen |
Kulcsszó | Karakterlánc | IGEN |
A „Keresés a Play Áruházban (organikus)” dimenziónál van jelen |
Áruházbeli adatlap látogatói | Egész szám | NEM | |
Telepítők | Egész szám | NEM | |
Látogatók és telepítők konverziós aránya | Tizedes | NEM | |
Látogatók és telepítők átlagos konverziós arányának összehasonlítása | Tizedes | IGEN |
2019 augusztusától nem tölti ki a rendszer. Az Ügyfélszerzési jelentések oldalon frissített összehasonlítások állnak rendelkezésre, melyek új számítási módszert használnak. További információért olvasd el a kapcsolódó súgócikk A Play Áruház forgalmára vonatkozó konverziós arány hasonló alkalmazásokkal való összevetése című szakaszát. |
1 napig megőrzött telepítők | Egész szám | NEM | |
Telepítők és 1 napig megőrzöttek aránya | Tizedes | NEM | |
7 napig megőrzött telepítők | Egész szám | NEM | |
Telepítők és 7 napig megőrzöttek aránya | Tizedes | NEM | |
15 napig megőrzött telepítők | Egész szám | NEM | |
Telepítők és 15 napig megőrzöttek aránya | Tizedes | NEM | |
30 napig megőrzött telepítők | Egész szám | NEM | |
Telepítők és 30 napig megőrzöttek aránya | Tizedes | NEM |
Támogatott dimenziók
Dimenzió | Fájlnév |
---|---|
Felhasználószerzési csatorna* | ..._channel.csv |
Ország | ..._country.csv |
Ország (Play Áruház – organikus) | ..._play_country.csv |
Keresés a Play Áruházban (organikus) | ..._play_search.csv |
Nyomon követett csatornák (UTM) | ..._utm_tagged.csv |
* Megjegyzés: A „Play Áruház (organikus)” csatorna a „Keresés a Play Áruházban (organikus)” és a „Böngészés a Play Áruházban (organikus)” dimenzió összesítése. A jelentésben kétféle módon kerülheted el a látogatók duplán számolását: vagy a teljes „Play Áruház (organikus)” sort, vagy pedig a keresési és böngészési sorokat hagyd figyelmen kívül.
A Google Kereső (organikus) dimenzió 2019 júniusától már nem támogatott.
CSV-nevek
Minden hozzáférhető CSV-fájl egy hónapra vonatkozó lebontott adatokat tartalmaz. A CSV-fájlok strukturált neveket kapnak, amelyek a következő mintát követve jelzik a jelentés által lefedett időszakot, valamint a lebontását:
Fájlnév formátuma: store_performance_[package_name]_[yyyyMM]_[breakdown].csv
Megjegyzések:
- A fájlnév tartalmazza a csomag adott állapotú nevét, valamint a speciális karaktereket is, ha vannak ilyenek („
.
” vagy „_
”). - Az
ééééHH
az évet és a hónapot jelöli, például:202101
.
Parancs
gs://[developer_bucket_id]/stats/store_performance/store_performance_[package_name]_[yyyyMM]_[breakdown].csv
Fájlformátum
Mező | Formátum | Nem kötelező | Példa | Leírás |
---|---|---|---|---|
Dátum | ÉÉÉÉ-hh-nn | NEM | 2021-01-01 |
Az a dátum, amikor a felhasználó utoljára megnyitotta az áruházi adatlapodat |
Csomagnév | Karakterlánc | NEM | com.example.app |
A jelentés adatait tartalmazó csomagnév |
Ország/régió | Karakterlánc | NEM | Egyesült Királyság |
Az ország vagy régió, ahol a felhasználó a Google-fiókját regisztrálta |
Forgalom forrása | Karakterlánc | NEM | Keresés a Google Playen |
Így jutott a felhasználó az áruházi adatlapodra:
Megjegyzés: Felvehet |
Keresési kifejezés | Karakterlánc | IGEN | alkalmazásbolt |
A felhasználó által keresett kifejezés, amellyel az áruházi adatlapra jutott. Csak a Google Play felületén végzett keresések esetében látható. Megjegyzés: Felvehet |
UTM-forrás | Karakterlánc | IGEN | google |
Az áruházi adatlapra mutató mélylinkekben szereplő utm_source URL-paraméter értéke. Csak harmadik felektől származó hivatkozások esetében látható Megjegyzés: Felvehet |
UTM-kampány | Karakterlánc | IGEN | kampány |
Az áruházi adatlapra mutató mélylinkekben szereplő utm_campaign URL-paraméter értéke. Csak harmadik felektől származó hivatkozások esetében látható. Megjegyzés: FelvehetOther értéket, ha nem ér el bizonyos minimális küszöbértéket |
Áruházi adatlap felhasználószerzései | Egész szám | NEM | 10 |
Azoknak a felhasználóknak a száma, akik megnyitották az áruházi adatlapodat, és telepítették az alkalmazást, a telepítés pillanatában pedig az alkalmazás még nem volt megtalálható más eszközükön |
Áruházbeli adatlap látogatói | Egész szám | NEM | 100 |
Az áruházi adatlapot felkereső olyan felhasználók száma, akiknél az alkalmazás még nem volt telepítve egyik eszközükön sem |
Áruházi adatlap konverziós aránya | Tizedes | NEM | 0,1 |
Az áruházi adatlap azon látogatóinak százalékos aránya, akik telepítették az alkalmazásodat Megjegyzés: Azokat a felhasználókat nem vesszük figyelembe (sem a látogatás, sem a telepítés szempontjából), akik egy másik eszközükre korábban már telepítették az alkalmazást |
Rendelkezésre álló lebontási struktúra
A következő lebontások használhatók:
Lebontás neve | Az egyes CSV-fájlokban szereplő mezők (sorrendben): |
---|---|
Példa fájlnévre:
|
Dátum, Csomagnév, Ország, Áruházi adatlap felhasználószerzései, Áruházi adatlap látogatói, Áruházi adatlap konverziós aránya |
Példa fájlnévre:
|
Dátum, Csomagnév, Forgalom forrása, Keresési kifejezés, UTM-forrás, UTM-kampány, Áruházi adatlap felhasználószerzései, Áruházi adatlap látogatói, Áruházi adatlap konverziós aránya |
Feloldási séma
- Duplázd meg az idézőjeleket. (
"
->""
) - Ha a cellák tartalmaznak lapfüleket, új sorokat, idézőjeleket vagy vesszőket, tedd idézőjelek közé a cellát. (
...
->"..."
)
Példa
Ha szeretnéd letölteni a 2020-ban létrehozott összes jelentést az alkalmazás pubsite_prod_0123456789
azonosítójú jelentési tárhelyéről com.example.app
csomagnévvel, akkor a következő parancsot kell használnod:
gsutil cp -r gs://pubsite_prod_0123456789/stats/store_performance/store_performance_com.example.app_2020* /your/local/directory
Parancs
gs://[developer_bucket_id]/acquisition/buyers_7d/buyers_7d_[package_name]_yyyyMM_[dimension].csv
Fájlformátum
Mező | Formátum | Nem kötelező | Példák és megjegyzések |
---|---|---|---|
Dátum | ÉÉÉÉ-hh-nn | NEM |
Az a dátum, amikor a felhasználó utoljára megnyitotta az áruházi adatlapodat Megjegyzés: Az áruházi adatlap egyedi látogatóinak több napon át történő hozzáadása azt eredményezi, hogy az áruházi adatlapodat nagyobb számú látogató keresi fel, mint ami a heti vagy havi csoportmegtekintéseknél szerepel. A heti és havi csoportmegtekintéseknél minden egyes látogató egynek számít, még akkor is, ha az adott látogató többször nyitja meg az áruházi adatlapodat. |
Felhasználószerzési csatorna | Karakterlánc | IGEN |
A „Felhasználószerzési csatorna” dimenziónál van jelen Megjegyzés: A „Play Áruház (organikus)” csatorna a „Keresés a Play Áruházban (organikus)” és a „Böngészés a Play Áruházban (organikus)” dimenzió összesítése. A jelentésben kétféle módon kerülheted el a látogatók duplán számolását: vagy a teljes „Play Áruház (organikus)” sort, vagy pedig a keresési és böngészési sorokat hagyd figyelmen kívül. |
Ország | Karakterlánc | IGEN | Az „Ország” és az „Ország (Play Áruház – organikus)” dimenzióknál van jelen |
UTM-forrás/kampány | Karakterlánc | IGEN | A „Nyomon követett csatornák (UTM)” dimenziónál van jelen |
Kulcsszó | Karakterlánc | IGEN |
A „Keresés a Play Áruházban (organikus)” dimenziónál van jelen |
Áruházbeli adatlap látogatói | Egész szám | NEM | |
Telepítők | Egész szám | NEM | |
Látogatók és telepítők konverziós aránya | Tizedes | NEM | |
Látogatók és telepítők átlagos konverziós arányának összehasonlítása | Tizedes | IGEN |
2019 augusztusától nem tölti ki a rendszer. Az Ügyfélszerzési jelentések oldalon frissített összehasonlítások állnak rendelkezésre, melyek új számítási módszert használnak. További információért olvasd el a kapcsolódó súgócikk A Play Áruház forgalmára vonatkozó konverziós arány hasonló alkalmazásokkal való összevetése című szakaszát. |
Vásárlók | Egész szám | NEM | |
Telepítők és vásárlók konverziós aránya | Tizedes | NEM | |
Visszatérő vásárlók | Egész szám | NEM | |
Telepítők és visszatérő vásárlók konverziós aránya | Tizedes | NEM | |
Vásárlók és visszatérő vásárlók konverziós aránya | Egész szám | NEM |
Támogatott dimenziók
Dimenzió | Fájlnév |
---|---|
Felhasználószerzési csatorna* | ..._channel.csv |
Ország |
..._country.csv |
Ország (Play Áruház – organikus) |
..._play_country.csv |
Keresés a Play Áruházban (organikus) | ..._play_search.csv |
Nyomon követett csatornák (UTM) | ..._utm_tagged.csv |
* Megjegyzés: A „Play Áruház (organikus)” csatorna a „Keresés a Play Áruházban (organikus)” és a „Böngészés a Play Áruházban (organikus)” dimenzió összesítése. A jelentésben kétféle módon kerülheted el a látogatók duplán számolását: vagy a teljes „Play Áruház (organikus)” sort, vagy pedig a keresési és böngészési sorokat hagyd figyelmen kívül.
A Google Kereső (organikus) dimenzió 2019 júniusától már nem támogatott.