Stažení a export měsíčních přehledů

Pomocí služby Play Console si můžete stáhnout měsíční přehledy o jednotlivých aplikacích. Tyto přehledy vám umožní sledovat výkon aplikace a porozumět mu.

Typy přehledů

Podrobné přehledy

Podrobné přehledy obsahují data o jednotlivých událostech:

Recenze
Finanční údaje: odhadované prodeje, příjmy, produkty za odměnu a objednávky placené zůstatkem služby Play Korea

Souhrnné přehledy

Souhrnné přehledy obsahují konsolidovaná data statistik aplikací (průměry, denní součty apod.).

Statistiky: instalace, selhání, hodnocení a předplatné
Akvizice uživatelů: ponechané instalace, kupující (sedm dní po instalaci) a předplatitelé

Stažení přehledů

Otevřete Play Console.
Klikněte na Stáhnout přehledy a vyberte Recenze, Statistiky nebo Finanční přehledy.
V sekci Vyberte aplikaci zadejte a vyberte název aplikace.
Vyberte rok a měsíc přehledu, který chcete stáhnout.

Poznámka: Finanční přehledy zahrnují všechny aplikace ve vašem účtu.

Stažení přehledů z úložiště Google Cloud Storage

Přehledy jsou k dispozici v úložišti Google Cloud Storage. Přehledy se generují každý den a akumulují se v měsíčních souborech CSV. Ukládají se do soukromého segmentu Google Cloud Storage pro váš účet vývojáře Google Play.

K přehledům můžete přistupovat prostřednictvím služby Google Cloud Storage v prohlížeči nebo programaticky pomocí nástroje gsutil. K programatickému přístupu k úložišti Cloud Storage můžete použít také jiné nástroje.

Tip: Pokud chcete přehledy ze služby Google Cloud Storage importovat do služby BigQuery, je třeba soubory CSV převést z kódování UTF-16 na kódování UTF-8.

Vyhledání identifikátoru URI úložiště Google Cloud Storage

Identifikátor URI úložiště Google Cloud Storage můžete zkopírovat kliknutím na tlačítko Kopírovat URI služby Cloud Storage vedle příslušného záhlaví sekce na stránkách Stáhnout přehledy.

URI úložiště Cloud Storage začíná řetězcem pubsite_prod_rev (příklad: pubsite_prod_rev_01234567890987654321).

Stažení přehledů pomocí nástroje příkazové řádky

Nainstalujte nástroj gsutil.
- Nezapomeňte svůj účet ověřit pomocí účtu s přístupem do služby Play Console.
- Pokud při nastavení používáte nástroj gsutil poprvé a v úložišti Google Cloud Storage nemáte nakonfigurovány žádné další projekty, můžete po zobrazení výzvy k zadání ID projektu zadat název aplikace.
ID segmentu s přehledy zobrazíte kliknutím na tlačítko Kopírovat URI služby Cloud Storage vedle příslušného záhlaví sekce na stránkách Stáhnout přehledy.
- URI úložiště Cloud Storage začíná řetězcem: pubsite_prod_rev (příklad: pubsite_prod_rev_01234567890987654321).
Stáhněte přehledy pomocí příkazu gsutil cp.
- Další příkazy k získání přístupu k přehledům naleznete v dokumentaci nástroje gsutil.

Přehledy jsou uspořádány do adresářů pojmenovaných po jednotlivých typech přehledů. Názvy souborů CSV obsahují typ přehledu, název balíčku, časové období a dimenzi (pokud je k dispozici).

Stažení přehledů pomocí klientské knihovny a servisního účtu

Krok 1: Vytvoření servisního účtu

Otevřete konzoli Google Developers Console.
Pokud již máte projekt, vyberte ho v rozbalovacím seznamu. Pokud zatím žádný projekt nemáte nebo chcete vytvořit nový, klikněte na Vytvořit projekt.
Vyberte ikonu Nabídky > Permissions (Oprávnění) > Service accounts (Servisní účty) > Create service account (Vytvořit servisní účet).
Postupujte podle pokynů na obrazovce a vyberte Create (Vytvořit).
Zkopírujte uvedenou e-mailovou adresu.
- Příklad: [email protected]

Krok 2: Přidání servisního účtu do služby Play Console

Otevřete Play Console.
Vyberte Nastavení > > Uživatelské účty a práva > Pozvat nového uživatele.
Vložte nebo napište e‑mailovou adresu přidruženou k vašemu servisnímu účtu.
Vyberte oprávnění podle požadovaných typů přehledů.
- Tip: Přečtěte si článek Přidání uživatelů účtu vývojáře a správa oprávnění, abyste porozuměli různým úrovním přístupu, které mají uživatelé, a právům, která jim různá oprávnění udělují.
Klikněte na Přidat uživatele. Servisní účet bude přidán do vašeho účtu.

Krok 3: Načtení přehledů pomocí volání rozhraní API

Nainstalujte klientskou knihovnu rozhraní API pro svůj preferovaný programovací jazyk.
Nakonfigurujte program, který volá rozhraní API tak, aby používal ověření server–server OAuth2 a požadoval oprávnění pro obor OAuth2 (https://googleapis.com/auth/devstorage.read_only).
Odešlete volání rozhraní API, která načtou přehledy.

Zobrazit příklad (Python)

V jazyce Python byste k načtení přehledů mohli použít například následující kód:

import json

from httplib2 import Http

from oauth2client.client import SignedJwtAssertionCredentials

from apiclient.discovery import build

# Change these variables to fit your case

client_email = 'your service account here'

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

Ovládání přístupu do úložiště Google Cloud Storage

Přehledy dostupné v úložišti Google Cloud Storage používají stejná omezení přístupu, jaká řídí přístup k datům ve službě Play Console. To znamená, že uživatelé, kteří mají přístup do určitých oblastí účtu Play Console, mají přístup k odpovídajícím přehledům ve službě Google Cloud Storage.

Vlastníci účtů mohou oprávnění jednotlivých uživatelů kdykoliv aktualizovat.

Pokud chcete zobrazit hromadné přehledy, vaše oprávnění Zobrazení informací o aplikaci musí být nastaveno na hodnotu Globální.
Pokud chcete stahovat finanční přehledy, vaše oprávnění Zobrazit finanční údaje musí být nastaveno na hodnotu Globální.

Příkazy a formáty souborů pro podrobné přehledy

Selhání a chyby ANR

Od května 2018 již nelze stahovat podrobné přehledy selhání a chyb ANR.

Recenze

Příkaz

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

Formát souboru

Pole	Formát	Volitelné	Příklady a poznámky
Název balíčku	Textový řetězec	NE	`com.company.app`
Kód verze aplikace	Celé číslo	ANO	Pouze soubory APK v produkční verzi
Název verze aplikace	Textový řetězec	ANO
Jazyk recenzenta	Řetězec – dvoupísmenná zkratka ISO 639-1	ANO	`en`
Zařízení	Textový řetězec	ANO	`hammerhead`
Datum a čas recenze	ISO_8601 včetně času, časové pásmo UTC	NE	`2014-06-19T19:12:32Z`
Čas odeslání recenze od počátku epochy	Celé číslo, milisekundy od začátku epochy	NE
Datum a čas poslední aktualizace recenze	ISO_8601 včetně času, časové pásmo UTC	ANO	`2014-06-19T19:12:32Z`
Poslední aktualizace recenze od počátku epochy	Celé číslo, milisekundy od začátku epochy	ANO
Hodnocení hvězdičkami	Celé číslo (v intervalu 1 až 5)	NE
Název recenze	Řetězec v místním jazyce recenzenta (bez zalomení řádků)	ANO
Zkontrolovat text	Řetězec v místním jazyce recenzenta (bez zalomení řádků)	ANO
Datum a čas odpovědi developera	ISO_8601 včetně času, časové pásmo UTC	ANO	`2014-06-19T19:12:32Z`
Odpověď developera od začátku epochy	Celé číslo, milisekundy od začátku epochy	ANO
Text odpovědi vývojáře	Řetězec (bez zalomení řádků a s odstraněním prázdných znaků)	ANO
Odkaz narecenze	Textový řetězec	ANO	`https://play.google.com/apps/publish/?dev_acc=<...>#ReviewPlace:id=<..>`

Příklad

Pokud chcete z úložiště přehledů s ID pubsite_prod_rev_0123456789 stáhnout všechny přehledy vygenerované v roce 2014 pro aplikaci s názvem balíčku „com.example.app“, příkaz bude následující:

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

Finanční přehledy

Odhadované prodeje

Při vytváření automatických přehledů doporučujeme nespoléhat se na počet sloupců v souborech CSV.

Informace

Pomocí přehledu odhadovaných prodejů můžete zobrazit informace (s nízkou latencí) o prodeji aplikací, produktů v aplikacích nebo předplatného. Přehled obsahuje celkové částky, které zaplatili kupující a ze kterých nejsou strženy daně ani odečteny poplatky Googlu.

Tento přehled můžete využít ke statistickým účelům nebo analýze trendů, ale nedoporučujeme ho pro účetní účely. Pro ty je vhodnější přehled Příjmy.

Možná si všimnete, že mezi informacemi v tomto přehledu a vašimi příjmy je rozdíl. Důvodů je několik. Přehled odhadovaných prodejů například nezohledňuje srážkové daně a zpětná zúčtování. Tento přehled obsahuje částky, které kupující zaplatili v místní měně, a neobsahuje částky převedené na měnu, ve které přijímáte platby.

Příkaz

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

Příklad

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

Formát souboru

Pole	Formát	Volitelné	Příklady a poznámky
Číslo objednávky	Textový řetězec	Ne	`GPA.1234-1234-1234-12345` Identifikátory objednávek předplatného obsahují na konci číslo cyklu obnovení (například první obnovení je `GPA.1234-1234-1234-12345..0`, druhé obnovení je `GPA.1234-1234-1234-12345..1` atd.)
Datum naúčtování objednávky	Textový řetězec	Ne	`2016-11-30` Datum objednávky podle časového pásma UTC (ve formátu RRRR-MM-DD).
Časové razítko naúčtování objednávky	Celé číslo	Ne	`1480507200` Časové razítko UNIX pořízené ve chvíli, kdy byla objednávka uživateli naúčtována. Měřeno v sekundách od začátku epochy.
Finanční stav	Textový řetězec	Ne	`účtováno, vrácení platby, částečné vrácení platby` apod. Pokud vrátíte celou platbu za objednávku poté, co jste již vrátili její část: Částečné vrácení platby bude zobrazena na samostatném řádku. V úplném vrácení platby bude uveden zbývající zůstatek
Model zařízení	Textový řetězec	Ne	`mako` apod. Model zařízení Android použitý k nákupu. V případě objednávek předplatného se tento údaj týká zařízení použitého k prvnímu nákupu.
Název produktu	Textový řetězec	Ne	`mince, měsíční předplatné` apod. Název produktu uvedený vývojářem. Zobrazen v jazyce kupujícího.
ID produktu	Textový řetězec	Ne	`com.example.app` Název balíčku aplikace, ve které byl produkt prodán.
Typ produktu	Textový řetězec	Ne	`placená aplikace,` `předplatné, položka v aplikaci`
ID SKU	Textový řetězec	Ne	`treasure_chest_for_new_users` Jedinečný identifikátor produktu stanovený vývojářem.
Měna prodeje	Textový řetězec	Ne	`CZK, EUR, THB` apod.
Cena položky	Celé číslo	Ne	`12,345.67` Zobrazeno v místní měně kupujícího. Znak „,“ slouží jako oddělovač tisíců.
Vybraná daň	Celé číslo	Ano	`12,345.67` V místní měně kupujícího. Znak „,“ slouží jako oddělovač tisíců.
Účtovaná částka	Celé číslo	Ne	`12,345.67` V místní měně kupujícího. Jedná se o součet ceny položky a vybraných daní. Znak „,“ slouží jako oddělovač tisíců.
Město kupujícího	Textový řetězec	Ano	`Boston, Toronto` apod. Vyplněno pouze u prodejů, u nichž jste registrovaným obchodníkem.
Stát kupujícího	Textový řetězec	Ano	`MA, ON` apod.
PSČ kupujícího	Textový řetězec	Ano	`02140, M5B 1L6` apod. Vyplněno pouze u prodejů, u nichž jste registrovaným obchodníkem.
Země kupujícího	Textový řetězec	Ne	`US, CA` apod.
ID základního tarifu	Textový řetězec	Ano	`týden` ID základního tarifu předplatného. Vyplňuje se pouze pro předplatná. Další informace
ID nabídky	Textový řetězec	Ano	`spring-offer` ID nabídky předplatného. Vyplňuje se pouze pro předplatná. Další informace
ID skupiny	Celé číslo	Ano	`1234567891234567890` Jedinečné ID přidělené při vytvoření skupiny účtů vývojářů. Další informace
Vhodné pro první milion USD	Textový řetězec	Ano	`Ano,` `Ne` Vyplní se pouze v případě, že je nastavena skupina účtů vývojářů. Další informace
ID promo akce	Řetězec	Ano	`PP.C2fy7Ns0/+e2w, PP.P2fy7Ns0/+e2w, pouze použité body` Vyplněno pouze u prodejů souvisejících s body Play. Předpony „PP.C“ a „PP.P“ definují objednávky týkající se kupónů a promoakcí na produkty v aplikaci. Zobrazují se také objednávky, ze které byly body utraceny přímo. Další informace
Hodnota kupónu	Celé číslo	Ano	`3,00` Zobrazeno v místní měně kupujícího. Znak „,“ slouží jako oddělovač tisíců. Vyplněno pouze u prodejů souvisejících s kupóny programu Play Points. Další informace
Sleva	Celé číslo	Ano	`45, 55, 70` Sleva v procentech se používá k určení úspory, kterou uživatel získá, když utratí body Play a ne peníze. Vyplněno pouze u prodejů souvisejících s body Play. Další informace
ID vybraných produktů	Celé číslo	Ano	`1234567891234567890` Jedinečný identifikátor je uveden, když vývojář vytvoří vybraný produkt. Další informace
ID cenového experimentu	Textový řetězec	Ano	`5697329857888256(varianta B)` ID cenového experimentu a experimentální skupina

Příjmy

Při vytváření automatických přehledů doporučujeme nespoléhat se na počet sloupců v souborech CSV.

Informace

Přehled příjmů vás informuje o vašich platbách a transakcích. Každý řádek přehledu představuje jeden typ transakce, například když zákazníkovi naúčtujete peníze nebo Googlu zaplatíte poplatek, a obsahuje původní částku i částku v převedené měně.

Přehledy příjmů obsahují transakce z předchozího měsíce. Platbu obdržíte několik týdnů poté, co bude přehled příjmů k dispozici.

Přehled příjmů se generuje jednou za měsíc a je obvykle k dispozici do 5. dne následujícího měsíce. Občas se může stát, že společnost Google opraví nesprávné výpočty a vaše příjmy upraví. Pokud k tomu dojde, budeme vás kontaktovat, abychom vás informovali o problému a vytvořili další soubor Příjmy, který bude obsahovat pouze opravené transakce pro účely vašich záznamů.

Poznámky:

Poplatky za službu Google jsou teď viditelné pro všechny transakce bez ohledu na to, zda je Google registrovaným obchodníkem u prodaných produktů.
Přehled příjmů nezahrnuje vrácené platby.
Pro transakce v rámci přehledu příjmů je každý měsíc vygenerován jeden soubor.
Tchajwanská srážková daň se vyplácí měsíc před tím, než se objeví v přehledech

Příkaz

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

Příklad

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

Formát souboru

Pole	Formát	Volitelné	Příklady a poznámky
Popis	Textový řetězec	Ne	`GPA.1234-1234-1234-12345` Identifikátory objednávek předplatného obsahují na konci číslo cyklu obnovení (například první obnovení je `GPA.1234-1234-1234-12345..0`, druhé obnovení je `GPA.1234-1234-1234-12345..1` atd.)
Datum transakce	Textový řetězec	Ne	`Nov 30, 2016` Datum objednávky podle časového pásma PDT (ve formátu MMM DD, RRRR). Časové razítko transakce může obsahovat následující měsíc, protože jsou vytvářeny podle časového razítka.
Čas transakce	Textový řetězec	Ne	`12:00:00 PDT`
Typ daně	Textový řetězec	Ano	`Third-party tax` U nedaňových položek prázdné.
Typ transakce	Textový řetězec	Ne	`Charge, Google fee, Tax, Charge refund, Google fee refund, Charge rebill, Tax rebill, Google fee rebill, Adjustment.`
Typ vrácení platby	Textový řetězec	Ano	`Full, Partial` Refundace, při nichž byla kupujícímu vyplacena celá částka nákupu, budou označeny jako Full. Částečné refundace částky zaplacené uživatelem budou označeny „Partial“.
Název produktu	Textový řetězec	Ne	`mince, měsíční předplatné` apod. Název produktu uvedený vývojářem. Zobrazeno v jazyce kupujícího.
ID produktu	Textový řetězec	Ne	`com.example.app` Název balíčku aplikace, ve které byl produkt prodán.
Typ produktu	Celé číslo	Ne	`0,1` Slouží k označení typu prodaného produktu. „0“ označuje prodej placené aplikace, „1“ označuje prodej produktu v aplikaci nebo předplatného.
ID SKU	Textový řetězec	Ne	`treasure_chest_for_new_users` Jedinečný identifikátor produktu stanovený vývojářem.
Hardware	Textový řetězec	Ne	`mako` apod. Model zařízení Android použitý k nákupu. V případě objednávek předplatného se tento údaj týká modelu použitého k prvnímu nákupu.
Země kupujícího	Textový řetězec	Ne	`US, CA` apod.
Stát kupujícího	Textový řetězec	Ano	`MA, ON` apod.
PSČ kupujícího	Textový řetězec	Ano	`02140, M5B 1L6` apod.
Měna kupujícího	Textový řetězec	Ne	`CZK, EUR, THB` apod.
Částka (měna kupujícího)	Celé číslo	Ne	`12345.67` Celková částka v příslušném řádku faktury před převodem měny.
Směnný kurz měny	Celé číslo	Ne	`0.56789` Směnný kurz použitý při převodu částek kupujících na částky k vyplacení v měně obchodníka.
Měna obchodníka	Textový řetězec	Ne	`CZK, EUR, THB` apod. Měna, na kterou byla převedena objednávka. Jedná se o místní měnu, ve které dostáváte platby.
Částka (měna obchodníka)	Celé číslo	Ne	`12345.67` Celková částka v příslušném řádku faktury po převodu měny.
ID základního tarifu	Textový řetězec	Ano	`týden` ID základního tarifu předplatného. Vyplňuje se pouze pro předplatná. Další informace
ID nabídky	Textový řetězec	Ano	`spring-offer` ID nabídky předplatného. Vyplňuje se pouze pro předplatná. Další informace
ID skupiny	Celé číslo	Ano	`1234567891234567890` Jedinečné ID přidělené při vytvoření skupiny účtů vývojářů. Další informace
Vhodné pro první milion USD	Textový řetězec	Ano	`Ano,` `Ne` Vyplní se pouze v případě, že je nastavena skupina účtů vývojářů. Další informace
Poplatek za služby (%)	Celé číslo	Ano	`15`, `30`
Popis poplatku	Textový řetězec	Ano	`PŘEDPLATNÉ` Podrobnosti o výpočtu poplatku za služby Google.
ID promo akce	Řetězec	Ano	`PP.C_x0a08trvC1, PP.PdYfn342Ox10, pass-QbTfn350O810. Play Points a Play Pass` Vyplňuje se pouze u prodejů souvisejících s programem Play Points a předplatným Play Pass. Předpony „PP.C“ a „PP.P“ definují objednávky týkající se kupónů Play Points a promoakcí na produkty v aplikaci. Zobrazují se také objednávky, ze které byly body Play utraceny přímo. Předpona „pass“ definuje objednávky, kdy uživatelé použili poukazy, které byly poskytnuty v rámci předplatného Play Pass.

Fakturace

Při vytváření automatických přehledů doporučujeme nespoléhat se na počet sloupců v souborech CSV.

Informace

Pokud jste se zaregistrovali do programů alternativní fakturace nebo externích nabídek a nahlásili jste transakce na Google Play, můžete pomocí přehledu fakturace zjistit své transakce a poplatky za služby Google, které vám byly fakturovány.

Přehled fakturace obsahuje transakce z předchozího měsíce v jednom souboru CSV. Obsahuje rozdělení poplatku uživatele, poplatku za služby Google a daně (pokud je účtována) na jednotlivé transakce. Informace, jako je procento poplatku za služby a směnný kurz, vám pomůžou pochopit, jak se počítá částka poplatku za služby na faktuře.

Poznámka:

Přehled fakturace se generuje jednou za měsíc a je obvykle k dispozici do 5. dne následujícího měsíce.
Položky poplatků Googlu nebo daně zaokrouhlené na nulu ve fakturační měně jsou z přehledu vyloučeny.

Příkaz

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

Příklad

Pokud chcete z úložiště přehledů s ID pubsite_prod_rev_0123456789 stáhnout všechny přehledy vygenerované v roce 2024, příkaz bude následující:

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

Formát souboru

Datum transakce podle tichomořského časového pásma.

Pole	Formát	Volitelné	Příklady a poznámky
ID faktury	Textový řetězec	Ne	`1234567890` ID, které odpovídá číslu uvedenému na faktuře.
Program	Textový řetězec	Ano	`Fakturace podle výběru uživatelů, pouze alternativní fakturace, externí nabídky` Nastaveno pouze u řádků poplatků Googlu.
Externí ID transakce	Textový řetězec	Ne	`com.example.app:1a2b3c4e5f`
Datum transakce	Textový řetězec	Ne	`1. července 2024` Datum transakce podle tichomořského časového pásma.
Časové razítko transakce	Celé číslo	Ne	`1719849600` Časové razítko UNIX transakce. Měřeno v sekundách od začátku epochy.
Typ transakce	Textový řetězec	Ne	`Platba uživatele, poplatek Googlu, daň, vrácení platby uživatele, vrácení poplatku Googlu, vrácení daně, částečné vrácení platby uživatele, částečné vrácení poplatku Googlu, částečné vrácení daně`
Typ daně	Textový řetězec	Ano	`DPH` Nastaveno pouze pro daňové řádky.
Typ SKU	Textový řetězec	Ne	`Produkt v aplikaci, předplatné`
ID balíčku	Textový řetězec	Ne	`com.example.app` Název balíčku aplikace, ve které byl produkt prodán.
Země prodeje	Textový řetězec	Ne	`CZ, KR apod.`
Cena položky bez daně (měna prodeje)	Desetinné číslo	Ano	`12,34` Cena produktu v měně akce bez daně. Nastavte pouze u řádků poplatků uživatelů.
Měna prodeje	Textový řetězec	Ne	`CZK, KRW apod.` Místní měna kupujícího.
Splatná částka (měna prodeje)	Desetinné číslo	Ano	`1,23 nebo -1,23` Dlužná částka v měně prodeje. Nastaveno pouze pro řádky poplatku Googlu a daně. Kladné pro částku k zaúčtování a záporné pro částky k vrácení nebo částečnému vrácení.
Směnný kurz měny	Desetinné číslo	Ne	`1,076` Směnný kurz použitý při převodu splatné částky z měny prodeje na fakturační měnu.
Fakturační měna	Textový řetězec	Ne	`CZK, EUR apod.`
Dlužná částka (fakturační měna)	Desetinné číslo	Ano	`1,32` Dlužná částka ve fakturační měně. Nastaveno pouze pro řádky poplatku Googlu a daně. Kladné pro částku k zaúčtování a záporné pro částky k vrácení nebo částečnému vrácení.
ID skupiny	Celé číslo	Ano	`1234567891234567890` Jedinečné ID přidělené při vytvoření skupiny účtů vývojářů. Další informace
Vhodné pro první milion USD	Textový řetězec	Ano	`Ano, Ne` Vyplní se pouze v případě, že je nastavena skupina účtů vývojářů. Další informace
Poplatek za služby (%)	Celé číslo	Ano	`11, 26 atd.`
Popis poplatku	Textový řetězec	Ano	`SUBSCRIPTIONS, MEDIA_PARTNERSHIPS atd.` Podrobnosti o výpočtu poplatku za služby Google.

Objednávky placené zůstatkem služby Play Korea

Informace

Pokud jste obchodník v Jižní Koreji, který má na základě platných právních předpisů povinnost vystavovat pokladní stvrzenky, nebo pokud jste se k vydávání pokladních stvrzenek dobrovolně zaregistrovali, musíte za nákupy placených aplikací nebo produktů v aplikaci uskutečněných pomocí dárkových karet Google Play v korejských wonech (KRW) vystavit na požádání pokladní stvrzenku.

Přehled objednávek placených zůstatkem služby Play Korea obsahuje prodeje placené zůstatkem služby Play uskutečněné v korejských wonech, pro účely odeslání pokladní stvrzenky uživateli.

Poznámka: Uživatelé mohou peníze do zůstatku služby Play přidat z různých zdrojů včetně propagačního kreditu od Googlu nebo našich partnerů. Před vystavením pokladní stvrzenky je důležité zajistit, aby uživatel do zůstatku přidal prostředky prostřednictvím hotovostního nástroje (například dárkové karty).

Příkaz

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

Příklad

Pokud chcete z úložiště přehledů s ID pubsite_prod_rev_0123456789 stáhnout všechny přehledy vygenerované v roce 2018 pro aplikaci s názvem balíčku „com.example.app“, příkaz bude následující:

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

Formát souboru

Pole	Formát	Volitelné	Příklady a poznámky
Číslo objednávky	Celé číslo	Ne	`GPA.1234-1234-1234-12345` Identifikátory objednávek předplatného obsahují na konci číslo cyklu obnovení (například první obnovení je `GPA.1234-1234-1234-12345..0`, druhé obnovení je `GPA.1234-1234-1234-12345..1` atd.)
Datum naúčtování objednávky	Textový řetězec	Ne	`2016-11-30` Datum objednávky podle časového pásma UTC (ve formátu RRRR-MM-DD).
Finanční stav	Textový řetězec	Ne	`Charged, Refund apod.`
Výše vkladu do zůstatku Play	Textový řetězec	Ne	`12,345.67` Částka transakce.
Měna zůstatku Play	Textový řetězec	Ne	`KRW` V případě přehledů objednávek placených pomocí služby Play Korea se vždy jedná o korejský won (KRW).
Časové razítko naúčtování objednávky	Celé číslo	Ne	`1480507200` Časové razítko UNIX pořízené ve chvíli, kdy byla objednávka uživateli naúčtována. Měřeno v sekundách od začátku epochy.

Odběry

Odpovědi na průzkum zrušení

Příkaz

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

Formát souboru

Pole	Formát	Volitelné	Příklady a poznámky
Datum zrušení	Textový řetězec	Ne	`2016-11-30`
ID SKU	Textový řetězec	Ano	`treasure_chest_for_new_users` Jedinečný identifikátor produktu stanovený vývojářem.
Země	Textový řetězec	Ne	`US, CA apod.`
Reakce:	Textový řetězec	Ne

Příkazy a formáty souborů pro souhrnné přehledy

Statistiky

Instalace

Příkaz

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

Formát souboru

Pole	Formát	Volitelné	Příklad
Datum	RRRR-mm-dd	NE	`2014-06-19`
Název balíčku	Textový řetězec	NE	`com.my.app`
Zařízení (nebo jakákoli jiná podporovaná dimenze)	Textový řetězec	ANO	`hammerhead`
Současný počet instalací (zařízení)	Celé číslo	NE
Instalace v aktivních zařízeních	Celé číslo	NE
Denní počet instalací (zařízení)	Celé číslo	NE
Denní počet odinstalací (zařízení)	Celé číslo	NE
Denní počet aktualizací (zařízení)	Celé číslo	NE
Současný počet instalací (uživatelé)	Celé číslo	NE
Celkový počet instalací (uživatelé)	Celé číslo	NE
Denní počet instalace (uživatelé)	Celé číslo	NE
Denní počet odinstalací (uživatelé)	Celé číslo	NE

Podporované dimenze

Dimenze	Název souboru
Kód verze aplikace	`..._app_version.csv`
Operátor	`..._carrier.csv`
Země	`..._country.csv`
Zařízení	`..._device.csv`
Jazyk	`..._language.csv`
Verze operačního systému Android	`..._os_version.csv`

Příklad

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

Selhání

Poznámka: Od ledna 2018 přehledy obsahují data z nového zdroje dat a shodují se s údaji na stránce Statistiky u příslušné aplikace. V exportech z období před lednem 2018 jsou dostupná pouze data z předchozího zdroje dat.

Příkaz

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

Formát souboru

Pole	Formát	Volitelné	Příklad
Datum	RRRR-mm-dd	NE	`2014-06-19`
Název balíčku	Textový řetězec	NE	`com.my.app`
Zařízení (nebo jakákoli jiná podporovaná dimenze)	Textový řetězec	ANO	`hammerhead`
Selhání za den	Celé číslo	NE
Chyby ANR za den	Celé číslo	NE

Podporované dimenze

Dimenze	Název souboru
Kód verze aplikace	`..._app_version.csv`
Zařízení	`..._device.csv`
Verze operačního systému Android	`..._os_version.csv`

Příklad

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

Hodnocení

Příkaz

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

Formát souboru

Pole	Formát	Volitelné	Příklad
Datum	RRRR-mm-dd	NE	`2014-06-19`
Název balíčku	Textový řetězec	NE	`com.my.app`
Zařízení (nebo jakákoli jiná podporovaná dimenze)	Textový řetězec	ANO	`hammerhead`
Průměrné denní hodnocení	%.2f	ANO
Celkové průměrné hodnocení	%.2f	Ano	`4.16`

Podporované dimenze

Dimenze	Název souboru
Kód verze aplikace	`..._app_version.csv`
Operátor	`..._carrier.csv`
Země	`..._country.csv`
Zařízení	`..._device.csv`
Jazyk	`..._language.csv`
Verze operačního systému Android	`..._os_version.csv`

Příklad

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

Odběry

Příkaz

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

Formát souboru

Pole	Formát	Volitelné	Příklady a poznámky
Datum	RRRR–MM–DD	NE	`2022-01-01` Datum objednávky podle časového pásma UTC (ve formátu RRRR-MM-DD)
Název balíčku	Textový řetězec	NE	`com.example.app`
ID produktu	Textový řetězec	NE	`Premium access`
Země	Textový řetězec	NE	`US, CA apod.`
Nové předplatné	Číslo	NE	`1234`
Zrušená předplatná	Číslo	NE	`1234`
Aktivní předplatná	Číslo	NE	`1234`
ID základního tarifu	Textový řetězec	NE	`weekly`
ID nabídky	Textový řetězec	NE	`spring-offer`

Poznámka: Další informace ohledně statistik nových, zrušených a aktivních předplatných naleznete v článku Kontrola údajů o tržbách a kupujících vaší aplikace.

Podporované dimenze

Dimenze	Název souboru
Země	`..._country.csv`

Akvizice uživatelů

Přehledy Ponechané instalace a Kupující poskytují programatický přístup k datům starého přehledu akvizice. Tento export byl nahrazen novým programatickým exportem, který zahrnuje data pro stránky Analýza obchodu a Analýza konverzí ve službě Play Console. Je k dispozici od března 2021.

Staré přehledy byly v říjnu 2021 odstraněny.

Další informace najdete v článku Jak lze stáhnout údaje o akvizicích?

Poznámka: Přehled Odběratelé není od listopadu 2019 podporován. Další informace najdete v článku o zdrojích a metrikách akvizice.

Ponechané instalace (starý export – k dispozici do srpna 2021)

Příkaz

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

Formát souboru

Pole	Formát	Volitelné	Příklady a poznámky
Datum	RRRR-mm-dd	NE	Datum, kdy uživatel navštívil váš záznam v obchodu Poznámka: Přidání unikátních návštěvníků záznamu v obchodu za několik dnů bude mít za následek vyšší počet návštěvníků záznamu v obchodu, než jaký bude uveden v týdenním nebo měsíčním zobrazení kohorty. Týdenní a měsíční zobrazení kohorty započítávají každého návštěvníka jednou, i když záznam v obchodu navštíví opakovaně.
Acquisition Channel	Textový řetězec	ANO	`Organic, Google Ads, UTM-Tagged` K dispozici pro dimenzi Kanál akvizice Poznámka: Kanál „Obchod Play (organické)“ je součtem dimenzí „Vyhledávání v Obchodu Play (organické)“ a „Procházení Obchodu Play (organické)“. Pokud chcete zabránit tomu, aby v tomto přehledu byli návštěvníci započítáváni dvakrát, ignorujte buď řádek s celkovým údajem „Obchod Play (organické)“, nebo řádky pro vyhledávání a procházení.
Země	Textový řetězec	ANO	K dispozici pro dimenze Země a Země (Obchod Play, organické)
UTM source/campaign	Textový řetězec	ANO	K dispozici pro dimenzi Sledované kanály (UTM)
Keyword	Textový řetězec	ANO	`Příklad: „hry“` K dispozici pro dimenzi Vyhledávání v Obchodu Play (organické)
Návštěvníci záznamu v obchodu	Celé číslo	NE
Installers	Celé číslo	NE
Visitor-to-Installer conversion rate	Desetinné číslo	NE
Median Visitor to Installer conversion rate benchmark	Desetinné číslo	ANO	Od srpna 2019 se vyplňuje. Aktualizovaná sada srovnávacích hodnot, která používá nový výpočet, je k dispozici na stránce Přehledy akvizic. Další informace najdete v sekci Porovnání konverzního poměru se srovnávacími aplikacemi v rámci návštěvnosti Obchodu Play.
Installers retained for 1 day	Celé číslo	NE
Installer-to-1 day retention rate	Desetinné číslo	NE
Installers retained for 7 days	Celé číslo	NE
Installer-to-7 days retention rate	Desetinné číslo	NE
Instalující udržení 15 dní	Celé číslo	NE
Poměr instalujících po 15 dnech	Desetinné číslo	NE
Installers retained for 30 days	Celé číslo	NE
Installer-to-30 days retention rate	Desetinné číslo	NE

Podporované dimenze

Dimenze	Název souboru
Kanál akvizice*	`..._channel.csv`
Země	`..._country.csv`
Země (Obchod Play, organické)	`..._play_country.csv`
Vyhledávání v Obchodu Play (organické)	`..._play_search.csv`
Sledované kanály (UTM)	`..._utm_tagged.csv`

* Poznámka: Kanál „Obchod Play (organické)“ je součtem dimenzí „Vyhledávání v Obchodu Play (organické)“ a „Procházení Obchodu Play (organické)“. Pokud chcete zabránit tomu, aby v tomto přehledu byli návštěvníci započítáváni dvakrát, ignorujte buď řádek s celkovým údajem „Obchod Play (organické)“, nebo řádky pro vyhledávání a procházení.

Od června 2019 již není podporována dimenze Vyhledávání Google (organické).

Výkon obchodu (nový export – k dispozici od března 2021)

Názvy souborů CSV

Každý dostupný soubor CSV obsahuje data pro jeden měsíc a způsob rozdělení. Soubory CSV mají strukturované názvy, které udávají rok, měsíc a typ rozdělení přehledu podle následujícího vzorce:

Formát názvu souboru: store_performance_[package_name]_[yyyyMM]_[breakdown].csv

Poznámky:

Název balíčku bude v názvu souboru uveden ve stávající podobě se všemi speciálními znaky („.“ nebo „_“).
yyyyMM představuje rok a měsíc, například 202101.

Příkaz

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

Formát souboru

Pole	Formát	Volitelné	Příklad	Popis
Datum	RRRR-mm-dd	NE	`2021-01-01`	Datum, kdy uživatel navštívil váš záznam v obchodu
Název balíčku	Textový řetězec	NE	`com.example.app`	Název balíčku obsahujícího data přehledu
Země/oblast	Textový řetězec	NE	`Spojené království`	Země nebo oblast, kde je účet Google uživatele zaregistrován
Zdroj návštěvnosti	Textový řetězec	NE	`Vyhledávání na Google Play`	Jak se uživatel dostal na váš záznam v obchodu: Vyhledávání na Google Play Odkazující zdroje třetích stran Průzkum obsahu na Google Play Poznámka: Může být `Other`, pokud hodnota nedosáhne určitého minimálního limitu
Hledaný výraz	Textový řetězec	ANO	`obchod s aplikacemi`	Výraz, který uživatel vyhledával před tím, než přešel na váš záznam v obchodu. Je k dispozici pouze pro vyhledávání na Google Play. Poznámka: Může být `Other`, pokud hodnota nedosáhne určitého minimálního limitu
Zdroj systému UTM	Textový řetězec	ANO	`google`	Hodnota parametru adresy URL utm_source v přímých odkazech na váš záznam v obchodu. Je k dispozici pouze pro odkazy třetích stran Poznámka: Může být `Other`, pokud hodnota nedosáhne určitého minimálního limitu
Kampaň systému UTM	Textový řetězec	ANO	`kampaň`	Hodnota parametru adresy URL utm_campaign URL v přímých odkazech na váš záznam v obchodu. Je k dispozici pouze pro odkazy třetích stran. Poznámka: Může být `Other`, pokud hodnota nedosáhne určitého minimálního limitu
Akvizice ze záznamu v obchodu	Celé číslo	NE	`10`	Počet uživatelů, kteří navštívili váš záznam v obchodu a nainstalovali si aplikaci, kterou v té době neměli nainstalovanou v žádném jiném zařízení
Návštěvníci záznamu v obchodu	Celé číslo	NE	`100`	Počet uživatelů, kteří navštívili váš záznam v obchodu a v té době aplikaci neměli nainstalovanou v žádném ze svých zařízení
Konverzní poměr záznamu v obchodu	Desetinné číslo	NE	`0,1`	Procento návštěvníků záznamu v obchodu, kteří si nainstalovali vaši aplikaci Poznámka: Nezahrnuje návštěvy a instalace uživatelů, kteří už mají aplikaci nainstalovanou v jiném zařízení

Dostupná struktura rozdělení

K dispozici jsou následující typy rozdělení:

Název rozdělení Pole v každém souboru CSV (v uvedeném pořadí):

Název rozdělení	Pole v každém souboru CSV (v uvedeném pořadí):
`země` Příklad názvu souboru: `store_performance_com.example.app_202012_country.csv`	Datum, Název balíčku, Země, Akvizice ze záznamu v obchodu, Návštěvníci záznamu v obchodu, Konverzní poměr záznamu v obchodu
`traffic_source` Příklad názvu souboru: `store_performance_com.example.app_202012_traffic_source.csv`	Datum, Název balíčku, Zdroj návštěvnosti, Vyhledávací dotaz, Zdroj systému UTM, Kampaň systému UTM, Akvizice ze záznamu v obchodu, Návštěvníci záznamu v obchodu, Konverzní poměr záznamu v obchodu

země

Příklad názvu souboru:

store_performance_com.example.app_202012_country.csv

Datum, Název balíčku, Země, Akvizice ze záznamu v obchodu, Návštěvníci záznamu v obchodu, Konverzní poměr záznamu v obchodu

traffic_source

Příklad názvu souboru:

store_performance_com.example.app_202012_traffic_source.csv

Datum, Název balíčku, Zdroj návštěvnosti, Vyhledávací dotaz, Zdroj systému UTM, Kampaň systému UTM, Akvizice ze záznamu v obchodu, Návštěvníci záznamu v obchodu, Konverzní poměr záznamu v obchodu

Schéma escapování

Všechny dvojité uvozovky zdvojte. (" -> "")
Pokud buňka obsahuje tabulátory, nové řádky, dvojité uvozovky nebo čárky, dejte buňku do dvojitých uvozovek. (... -> "...")

Příklad

Pokud chcete z úložiště přehledů s ID pubsite_prod_rev_0123456789 stáhnout všechny přehledy vygenerované v roce 2020 pro aplikaci s názvem balíčku com.example.app, příkaz bude následující:

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

Kupující (7 dní po instalaci – k dispozici do srpna 2021)

Příkaz

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

Formát souboru

Pole	Formát	Volitelné	Příklady a poznámky
Datum	RRRR-mm-dd	NE	Datum, kdy uživatel navštívil váš záznam v obchodu Poznámka: Přidání unikátních návštěvníků záznamu v obchodu za několik dnů bude mít za následek vyšší počet návštěvníků záznamu v obchodu, než jaký bude uveden v týdenním nebo měsíčním zobrazení kohorty. Týdenní a měsíční zobrazení kohorty započítávají každého návštěvníka jednou, i když záznam v obchodu navštíví opakovaně.
Acquisition Channel	Textový řetězec	ANO	`Organic, Google Ads, UTM-Tagged` K dispozici pro dimenzi Kanál akvizice Poznámka: Kanál „Obchod Play (organické)“ je součtem dimenzí „Vyhledávání v Obchodu Play (organické)“ a „Procházení Obchodu Play (organické)“. Pokud chcete zabránit tomu, aby v tomto přehledu byli návštěvníci započítáváni dvakrát, ignorujte buď řádek s celkovým údajem „Obchod Play (organické)“, nebo řádky pro vyhledávání a procházení.
Země	Textový řetězec	ANO	K dispozici pro dimenze Země a Země (Obchod Play, organické)
UTM source/campaign	Textový řetězec	ANO	K dispozici pro dimenzi Sledované kanály (UTM)
Keyword	Textový řetězec	ANO	`Příklad: „hry“` K dispozici pro dimenzi Vyhledávání v Obchodu Play (organické)
Návštěvníci záznamu v obchodu	Celé číslo	NE
Installers	Celé číslo	NE
Konverzní poměr návštěv a instalujících	Desetinné číslo	NE
Median Visitor to Installer conversion rate benchmark	Desetinné číslo	ANO	Od srpna 2019 se vyplňuje. Aktualizovaná sada srovnávacích hodnot, která používá nový výpočet, je k dispozici na stránce Přehledy akvizic. Další informace najdete v sekci Porovnání konverzního poměru se srovnávacími aplikacemi v rámci návštěvnosti Obchodu Play.
Buyers	Celé číslo	NE
Installer to Buyer conversion rate	Desetinné číslo	NE
Repeat Buyers	Celé číslo	NE
Installer to Repeat Buyer conversion rate	Desetinné číslo	NE
Buyer to Repeat Buyer conversion rate	Celé číslo	NE

Podporované dimenze

Dimenze	Název souboru
Kanál akvizice*	`..._channel.csv`
Země	`..._country.csv`
Země (Obchod Play, organické)	`..._play_country.csv`
Vyhledávání v Obchodu Play (organické)	`..._play_search.csv`
Sledované kanály (UTM)	`..._utm_tagged.csv`

Od června 2019 již není podporována dimenze Vyhledávání Google (organické).

Pomohly vám tyto informace?

Jak bychom článek mohli vylepšit?

Stažení a export měsíčních přehledů

Typy přehledů

Stažení přehledů

Stažení přehledů z úložiště Google Cloud Storage

Vyhledání identifikátoru URI úložiště Google Cloud Storage

Krok 1: Vytvoření servisního účtu

Krok 2: Přidání servisního účtu do služby Play Console

Krok 3: Načtení přehledů pomocí volání rozhraní API

Ovládání přístupu do úložiště Google Cloud Storage

Příkazy a formáty souborů pro podrobné přehledy

Selhání a chyby ANR

Recenze

Příkaz

Formát souboru

Příklad

Finanční přehledy

Informace

Příkaz

Příklad

Formát souboru

Informace

Příkaz

Příklad

Formát souboru

Informace

Příkaz

Formát souboru

Informace

Příkaz

Formát souboru

Odběry

Příkaz

Formát souboru

Příkazy a formáty souborů pro souhrnné přehledy

Statistiky

Příkaz

Formát souboru

Podporované dimenze

Příklad

Příkaz

Formát souboru

Podporované dimenze

Příklad

Příkaz

Formát souboru

Podporované dimenze

Příklad

Příkaz

Formát souboru

Podporované dimenze

Akvizice uživatelů

Příkaz

Formát souboru

Podporované dimenze

Názvy souborů CSV

Příkaz

Formát souboru

Dostupná struktura rozdělení

Příkaz

Formát souboru

Podporované dimenze

Pomohly vám tyto informace?

Potřebujete další pomoc?

Vyzkoušejte tyto další kroky: