Typy raportów
Raporty szczegółoweRaporty szczegółowe zawierają informacje dotyczące poszczególnych zdarzeń:
- Opinie
- Finanse: szacunkowa sprzedaż, zarobki, nagrody za obejrzenie reklamy wideo i płatności z salda w koreańskim Sklepie Play
Raporty zbiorcze zawierają skonsolidowane dane (średnie wartości, wyniki dzienne itd.) dotyczące statystyk aplikacji:
- Statystyki: instalacje, awarie, oceny i subskrypcje.
- Pozyskani użytkownicy: utrzymani użytkownicy, którzy zainstalowali aplikację, kupujący (7 dni po instalacji) i subskrybenci.
Pobieranie raportów
- Otwórz Konsolę Play.
- Kliknij Pobieranie raportów
i wybierz Opinie, Statystyki lub Finanse.
- W sekcji „Wybierz aplikację” wpisz i wybierz nazwę swojej aplikacji.
- Wybierz rok i miesiąc raportu, który chcesz pobrać.
i wybierz Opinie, Statystyki lub Finanse.Uwaga: raporty finansowe zawierają informacje o wszystkich aplikacjach na Twoim koncie.
Pobieranie raportów z Google Cloud Storage
Raporty są dostępne w Google Cloud Storage. Są one tworzone codziennie i gromadzone w generowanych raz w miesiącu plikach CSV. Raporty są przechowywane w prywatnym zasobniku Google Cloud Storage przeznaczonym dla Twojego konta dewelopera w Google Play.
Możesz uzyskać dostęp do raportów w Google Cloud Storage, używając przeglądarki lub automatycznie przy użyciu narzędzia gsutil. Możesz też użyć innych narzędzi, by uzyskać automatyczny dostęp do swojego zasobnika Cloud Storage.
Wskazówka: jeśli chcesz importować raporty z Google Cloud Storage do BigQuery, musisz zmienić kodowanie plików CSV z UTF-16 na UTF-8.
Znajdowanie identyfikatora URI obiektu w Google Cloud Storage
Możesz skopiować identyfikator URI obiektu w Google Cloud Storage, klikając przycisk Skopiuj identyfikator URI obiektu w Cloud Storage obok odpowiedniego nagłówka sekcji na stronach Pobieranie raportów.
Identyfikator URI obiektu w Cloud Storage zaczyna się od pubsite_prod_rev (np. pubsite_prod_rev_01234567890987654321).
- Zainstaluj narzędzie gsutil.
- Pamiętaj, aby uwierzytelnić swoje konto przy użyciu konta, które ma dostęp do Konsoli Play.
- Jeśli używasz narzędzia gsutil po raz pierwszy i nie masz żadnych innych projektów skonfigurowanych w Google Cloud Storage, to gdy podczas konfiguracji pojawi się prośba o podanie identyfikatora projektu, możesz wpisać nazwę swojej aplikacji.
- Aby znaleźć identyfikator zasobnika raportów, kliknij przycisk Skopiuj identyfikator URI obiektu w Cloud Storage obok odpowiedniego nagłówka sekcji na stronach Pobieranie raportów.
- Identyfikator URI obiektu w Cloud Storage zaczyna się od
pubsite_prod_rev(np.pubsite_prod_rev_01234567890987654321).
- Identyfikator URI obiektu w Cloud Storage zaczyna się od
- Aby pobrać raporty, użyj polecenia
gsutil cp.- Dodatkowe polecenia ułatwiające dostęp do raportów znajdziesz w dokumentacji narzędzia gsutil.
Raporty są uporządkowane w katalogach o nazwach odpowiadających typom raportów. Nazwy plików CSV zawierają typ raportu, nazwę pakietu, okres oraz wymiary (jeśli takie dane są dostępne).
Krok 1. Utwórz konto usługi
- Otwórz Google Developers Console.
- Jeśli masz już projekt, wybierz go z menu. Jeśli nie masz projektów na liście lub chcesz utworzyć nowy, kliknij Utwórz projekt.
- Kliknij ikonę Menu
> Uprawnienia > Konta usługi > Utwórz konto usługi.
- Postępuj zgodnie z instrukcjami na ekranie, a potem kliknij Utwórz.
- Skopiuj wyświetlony adres e-mail.
- Przykład:
nazwaKonta@project.iam.gserviceaccount.com
- Przykład:
> Uprawnienia > Konta usługi > Utwórz konto usługi.Krok 2. Dodaj konto usługi w Konsoli Play
- Otwórz Konsolę Play.
- Kliknij Ustawienia
> Konta i uprawnienia użytkowników > Zaproś nowego użytkownika.
- Wklej lub wpisz adres e-mail powiązany z kontem usługi.
- Wybierz uprawnienia odpowiednio do potrzebnych typów raportów.
- Wskazówka: przeczytaj artykuł Dodawanie użytkowników konta dewelopera i zarządzanie uprawnieniami, aby dowiedzieć się więcej o różnych poziomach dostępu użytkowników i o możliwościach, jakie dają poszczególne uprawnienia.
- Kliknij Dodaj użytkownika. Konto usługi zostanie dodane do konta.
> Konta i uprawnienia użytkowników > Zaproś nowego użytkownika.Krok 3. Pobierz raporty za pomocą wywołania interfejsu API
- Zainstaluj bibliotekę klienta interfejsu API w wybranym języku programowania.
- Skonfiguruj kod wykonujący wywołanie interfejsu API, aby korzystać z uwierzytelniania
OAuth2w trybie serwer-serwer oraz aby żądać uprawnień do zakresuOAuth2(https://www.googleapis.com/auth/devstorage.read_only). - Wysyłaj uwierzytelnione wywołania interfejsu API, aby pobierać raporty.
Jeśli do pobierania raportów chcesz użyć języka Python, przejrzyj przykładowy kod:
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://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()
Kontrolowanie dostępu do Google Cloud Storage
Raporty dostępne w Google Cloud Storage są objęte tymi samymi ograniczeniami dostępu co dane w Konsoli Play. Oznacza to, że użytkownicy kont z dostępem do określonych sekcji konta w Konsoli Play mają dostęp do odpowiadających tym sekcjom raportów w Google Cloud Storage.
Właściciele konta mogą zmienić uprawnienia użytkowników w każdej chwili.
- Aby można było uzyskać dostęp do raportów zbiorczych, uprawnienie „Wyświetlanie informacji o aplikacji” musi być ustawione na „Globalne”.
- Aby można było pobierać raporty finansowe, uprawnienie „Wyświetlanie danych finansowych” musi być ustawione na „Globalne”.
Raporty szczegółowe – polecenia i formaty plików
Awarie i błędy ANR
Od maja 2018 roku nie można pobierać szczegółowych raportów o awariach i błędach ANR.
Opinie
Polecenie
gs://[developer_bucket_id]/reviews/reviews_[package_name]_YYYYMM.csv
Format pliku
| Pole | Format | Opcjonalne | Przykłady i uwagi |
|---|---|---|---|
| Nazwa pakietu | Ciąg znaków | NIE | com.company.app |
| Kod wersji aplikacji | Liczba całkowita | TAK | Tylko produkcyjne pakiety APK |
| Nazwa wersji aplikacji | Ciąg znaków | TAK | |
| Język recenzenta | Ciąg znaków – kod ISO 639-1 – skrót 2-literowy | TAK | pl |
| Urządzenie | Ciąg znaków | TAK | hammerhead |
| Data i godzina przesłania opinii | Kod ISO_8601 zawierający godzinę w strefie czasowej UTC | NIE | 2014-06-19T19:12:32Z |
| Czas przesłania opinii w milisekundach od początku epoki | Liczba całkowita, milisekundy od początku epoki | NIE | |
| Data i godzina ostatniej aktualizacji opinii | Kod ISO_8601 zawierający godzinę w strefie czasowej UTC | TAK | 2014-06-19T19:12:32Z |
| Czas ostatniej aktualizacji opinii w milisekundach od początku epoki | Liczba całkowita, milisekundy od początku epoki | TAK | |
| Liczba gwiazdek | Liczba całkowita (między 1 a 5) | NIE | |
| Tytuł opinii | Tekst w lokalnym języku recenzenta (z ucinaniem nowych wierszy) | TAK | |
| Tekst opinii | Tekst w lokalnym języku recenzenta (z ucinaniem nowych wierszy) | TAK | |
| Data i godzina odpowiedzi dewelopera | Kod ISO_8601 zawierający godzinę w strefie czasowej UTC | TAK | 2014-06-19T19:12:32Z |
| Czas odpowiedzi dewelopera w milisekundach od początku epoki | Liczba całkowita, milisekundy od początku epoki | TAK | |
| Tekst odpowiedzi dewelopera | Tekst (z ucinaniem nowych wierszy i kompresowaniem odstępów) | TAK | |
| Link opinii | Ciąg znaków | TAK | https://play.google.com/apps/publish/?dev_acc=<...>#ReviewPlace:id=<..> |
Przykład
Jeśli chcesz pobrać wszystkie raporty z identyfikatorem zasobnika raportów pubsite_prod_rev_0123456789 wygenerowane w 2014 roku dla aplikacji, której nazwa pakietu to „com.example.app”, polecenie będzie wyglądać tak:
gsutil cp -r gs://pubsite_prod_rev_0123456789/reviews/reviews_com.example.app_2014* /your/local/directoryRaporty finansowe
Szacunkowa sprzedażW przypadku zautomatyzowanych raportów lepiej nie polegać na liczbie kolumn w plikach CSV.
Informacje
Raport o szacunkowej sprzedaży może być przydatny do sprawdzania aktualnych informacji o sprzedaży aplikacji, produktu w aplikacji lub subskrypcji. Raport zawiera kwotę zapłaconą przez kupujących bez odliczenia podatków i opłat pobieranych przez Google od łącznej sumy.
Ten raport może dostarczyć przydatnych danych statystycznych, ale nie zalecamy używania ich w celach księgowych. W tym celu lepiej korzystać z Raportu o zarobkach.
Dane przedstawione w tym raporcie i Twoje rzeczywiste zarobki mogą się z wielu powodów różnić. Szacunkowy raport sprzedaży nie uwzględnia na przykład potrącanych podatków ani obciążeń zwrotnych. Raport zawiera kwoty zapłacone przez kupujących w ich walucie lokalnej. Nie zawiera kwot przeliczonych na walutę używaną do wypłaty.
Polecenie
gs://[developer_bucket_id]/sales/salesreport_YYYYMM.zip
Przykład
Jeśli chcesz pobrać wszystkie raporty z identyfikatorem zasobnika raportów pubsite_prod_rev_0123456789 wygenerowane w 2014 roku dla aplikacji, której nazwa pakietu to „com.example.app”, polecenie będzie wyglądać tak:
gsutil cp -r gs://pubsite_prod_rev_0123456789/sales/salesreport_2014* /your/local/directory
Format pliku
| Pole | Format | Opcjonalne | Przykłady i uwagi |
|---|---|---|---|
|
Numer zamówienia |
Ciąg znaków |
Nie |
Identyfikatory zamówień subskrypcji zawierają na końcu numer cyklu odnowienia (np. pierwsze odnowienie to |
|
Data obciążenia za zamówienie |
Ciąg znaków |
Nie |
Data zamówienia podana zgodnie ze strefą czasową UTC (w formacie RRRR-MM-DD). |
|
Sygnatura czasowa obciążenia za zamówienie |
Liczba całkowita |
Nie |
Sygnatura czasowa UNIX momentu obciążenia użytkownika płatnością za zamówienie. Mierzona w sekundach od początku epoki. |
|
Stan płatności |
Ciąg znaków |
Nie |
Jeśli w pełni zwrócisz środki po przyznaniu częściowego ich zwrotu:
|
|
Model urządzenia |
Ciąg znaków |
Nie |
Model urządzenia z Androidem, które posłużyło do dokonania zakupu. W przypadku zamówień subskrypcji odnosi się do urządzenia użytego do pierwotnego zakupu. |
|
Nazwa produktu |
Ciąg znaków |
Nie |
Nazwa produktu określona przez dewelopera. Wyświetlana jest w języku kupującego. |
|
Identyfikator produktu |
Ciąg znaków |
Nie |
Nazwa pakietu aplikacji, w której sprzedano produkt. |
|
Rodzaj produktu |
Ciąg znaków |
Nie |
|
|
Identyfikator SKU |
Ciąg znaków |
Nie |
Określony przez dewelopera unikalny identyfikator produktu. |
|
Waluta sprzedaży |
Ciąg znaków |
Nie |
|
|
Cena produktu |
Liczba całkowita |
Nie |
Wyświetlana w lokalnej walucie kupującego. Tysiące są rozdzielane przecinkiem „,”. |
|
Pobrane podatki |
Liczba całkowita |
Tak |
W lokalnej walucie kupującego. Tysiące są rozdzielane przecinkiem „,”. |
|
Kwota obciążenia |
Liczba całkowita |
Nie |
W lokalnej walucie kupującego. To suma ceny produktu i pobranych podatków. Tysiące są rozdzielane przecinkiem „,”. |
|
Miejscowość kupującego |
Tekst |
Tak |
Informacja podawana tylko w przypadku zarejestrowanych sprzedawców. |
|
Stan/region kupującego |
Ciąg znaków |
Tak |
|
|
Kod pocztowy kupującego |
Ciąg znaków |
Tak |
Informacja podawana tylko w przypadku zarejestrowanych sprzedawców. |
|
Kraj kupującego |
Ciąg znaków |
Nie |
|
|
Identyfikator abonamentu podstawowego |
Ciąg znaków |
Tak |
Identyfikator abonamentu podstawowego. Wartość jest podawana tylko w przypadku subskrypcji. Więcej informacji |
|
Identyfikator oferty |
Ciąg znaków |
Tak |
Identyfikator oferty. Wartość jest podawana tylko w przypadku subskrypcji. Więcej informacji |
| Identyfikator grupy | Liczba całkowita | Tak |
Unikalny identyfikator jest podawany podczas tworzenia grupy kont dewelopera. Więcej informacji |
| Kwalifikujący się pierwszy milion USD | Ciąg znaków | Tak |
Pole wypełnione tylko wtedy, gdy skonfigurowana jest grupa kont dewelopera. Więcej informacji |
| Identyfikator promocji | Ciąg znaków | Tak |
|
| Wartość kuponu | Liczba całkowita | Tak |
Wyświetlana w lokalnej walucie kupującego. Tysiące są rozdzielane przecinkiem „,”. Informacja podawana tylko w przypadku sprzedaży związanej z kuponami w Play Points. Więcej informacji |
| Obniżona cena | Liczba całkowita | Tak |
Obniżona cena (%) używana do określenia, ile użytkownik zaoszczędził, wydając punkty Play w porównaniu z wydawaniem pieniędzy. Informacja podawana tylko w przypadku sprzedaży związanej z Play Points. Więcej informacji |
|
Identyfikator polecanych produktów |
Liczba całkowita |
Tak |
Unikalny identyfikator jest podawany, gdy deweloper tworzy polecany produkt. Więcej informacji |
W przypadku zautomatyzowanych raportów lepiej nie polegać na liczbie kolumn w plikach CSV.
Informacje
Raport o zarobkach zawiera informacje o wypłatach i transakcjach. Każdy wiersz odpowiada typowi transakcji, na przykład są w nim dane, które odpowiadają obciążeniu klienta środkami lub opłacie pobieranej przez Google (z pierwotną i przeliczoną kwotą).
Raporty o zarobkach uwzględniają transakcje z poprzedniego miesiąca. Wypłata następuje kilka tygodni po udostępnieniu raportu o zarobkach.
Raport o zarobkach jest generowany raz na miesiąc i zwykle jest dostępny 5. dnia kolejnego miesiąca. Czasami Google może wprowadzać korekty zarobków, aby poprawić błędne obliczenia. Jeśli tak się stanie, skontaktujemy się z Tobą, aby poinformować Cię o problemie i utworzyć dodatkowy plik Zarobki zawierający tylko skorygowane transakcje.
Uwagi:
- Opłaty Google są teraz widoczne w przypadku wszystkich transakcji – niezależnie od tego, czy Google jest zarejestrowanym sprzedawcą tych produktów.
- Raport o zarobkach nie obejmuje obciążeń zwrotnych.
- Co miesiąc generowany jest 1 plik dla raportu o zarobkach z transakcji.
- Podatek u źródła w Tajwanie jest wypłacany w miesiącu poprzedzającym miesiąc, w którym jest uwzględniony w raporcie.
Polecenie
gs://[developer_bucket_id]/earnings/earnings_YYYYMM.zip
Przykład
Jeśli chcesz pobrać wszystkie raporty z identyfikatorem zasobnika raportów pubsite_prod_rev_0123456789 wygenerowane w 2014 roku dla aplikacji, której nazwa pakietu to „com.example.app”, polecenie będzie wyglądać tak:
gsutil cp -r gs://pubsite_prod_rev_0123456789/earnings/earnings_2014* /your/local/directory
Format pliku
| Pole | Format | Opcjonalne | Przykłady i uwagi |
|---|---|---|---|
|
Opis |
Ciąg znaków |
Nie |
Unikalny identyfikator przypisany do tego zamówienia. Identyfikatory zamówień subskrypcji zawierają na końcu numer cyklu odnowienia. |
|
Data transakcji |
Ciąg znaków |
Nie |
Data zamówienia (czasu pacyficznego) podana w formacie MMM DD, RRRR. Sygnatura czasowa transakcji może obejmować następny miesiąc, ponieważ raporty są generowane według sygnatury czasowej wydania. |
|
Godzina transakcji |
Ciąg znaków |
Nie |
|
|
Rodzaj podatku |
Ciąg znaków |
Tak |
Brak w przypadku wierszy bez uwzględnienia podatku. |
|
Typ transakcji |
Ciąg znaków |
Nie |
|
|
Typ zwrotu środków |
Ciąg znaków |
Tak |
Zwroty środków, w przypadku których kupujący otrzymał pełną wydaną kwotę, są oznaczone jako „Pełny”. Zwroty części środków z kwoty wydanej przez użytkownika są oznaczone jako „Częściowy”. |
|
Nazwa produktu |
Ciąg znaków |
Nie |
Nazwa produktu określona przez dewelopera. Widoczna w języku kupującego. |
|
Identyfikator produktu |
Ciąg znaków |
Nie |
Nazwa pakietu aplikacji, w której sprzedano produkt. |
|
Rodzaj produktu |
Liczba całkowita |
Nie |
Wskazuje rodzaj sprzedanego produktu. „0” oznacza sprzedaż płatnej aplikacji. „1” oznacza sprzedaż produktu w aplikacji lub subskrypcji. |
|
Identyfikator SKU |
Ciąg znaków |
Nie |
Określony przez dewelopera unikalny identyfikator produktu. |
|
Sprzęt |
Ciąg znaków |
Nie |
Model urządzenia z Androidem, które posłużyło do dokonania zakupu. W przypadku zamówień subskrypcji odnosi się do modelu użytego do pierwotnego zakupu. |
|
Kraj kupującego |
Ciąg znaków |
Nie |
|
|
Stan/region kupującego |
Ciąg znaków |
Tak |
|
|
Kod pocztowy kupującego |
Ciąg znaków |
Tak |
|
|
Waluta kupującego |
Ciąg znaków |
Nie |
|
|
Kwota (waluta kupującego) |
Liczba całkowita |
Nie |
Łączna kwota na fakturze przed przeliczeniem walut. |
|
Kurs wymiany walut |
Liczba całkowita |
Nie |
Kurs walut użyty podczas przeliczania kwot zapłaconych przez kupujących na kwoty wypłat w walucie sprzedawcy. |
| Waluta sprzedawcy | Ciąg znaków | Nie |
Waluta, na którą przeliczono zamówienie. Waluta lokalna, w której sprzedawca otrzymuje wypłatę. |
| Kwota (waluta sprzedawcy) | Liczba całkowita | Nie |
Łączna kwota na fakturze po przeliczeniu walut. |
|
Identyfikator abonamentu podstawowego |
Ciąg znaków |
Tak |
Identyfikator abonamentu podstawowego. Wartość jest podawana tylko w przypadku subskrypcji. Więcej informacji |
|
Identyfikator oferty |
Ciąg znaków |
Tak |
Identyfikator oferty. Wartość jest podawana tylko w przypadku subskrypcji. Więcej informacji |
| Identyfikator grupy | Liczba całkowita | Tak |
Unikalny identyfikator jest podawany podczas tworzenia grupy kont dewelopera. Więcej informacji |
| Kwalifikujący się pierwszy milion USD | Ciąg znaków | Tak |
Pole wypełnione tylko wtedy, gdy skonfigurowana jest grupa kont dewelopera. Więcej informacji |
|
Opłata za obsługę (%) |
Liczba całkowita |
Tak |
|
| Opis opłaty | Ciąg znaków | Tak |
Szczegóły obliczania opłaty za obsługę przez Google. |
| Identyfikator promocji | Ciąg znaków | Tak |
|
Informacje
Sprzedawcy, którzy zgodnie z przepisami i prawem obowiązującymi w Korei Południowej zobowiązani są do wystawiania potwierdzeń zapłaty lub dobrowolnie zarejestrowali się do ich wystawiania, muszą na żądanie kupujących wystawiać potwierdzenia zapłaty za zakupy płatnych aplikacji lub produktów w aplikacji dokonane przy użyciu kart podarunkowych Google Play z wartością wyrażoną w wonie koreańskim (KRW).
Raport o płatnościach z salda w koreańskim Sklepie Play zawiera saldo Google Play w wonach koreańskich. Na jego podstawie wystawiane są potwierdzenia zapłaty, które następnie wysyła się użytkownikom.
Uwaga: użytkownicy mogą doładowywać saldo Play z wielu źródeł, w tym za pomocą kwot promocyjnych od Google lub od naszych partnerów. Przed wystawieniem potwierdzenia zapłaty należy się upewnić, że użytkownik dodał środki do salda przy użyciu odpowiednika gotówki (na przykład karty podarunkowej).
Polecenie
gs://[developer_bucket_id]/play_balance_krw/play_balance_krw_YYYYMM.zip
Przykład
Jeśli chcesz pobrać wszystkie raporty z identyfikatorem zasobnika raportów pubsite_prod_rev_0123456789 wygenerowane w 2018 roku dla aplikacji, której nazwa pakietu to com.example.app, polecenie będzie wyglądać tak:
gsutil cp -r gs://pubsite_prod_rev_0123456789/play_balance_krw/play_balance_krw_2018* /your/local/directory
Format pliku
| Pole | Format | Opcjonalne | Przykłady i uwagi |
|---|---|---|---|
|
Numer zamówienia |
Liczba całkowita |
Nie |
Identyfikatory zamówień subskrypcji zawierają na końcu numer cyklu odnowienia (np. pierwsze odnowienie to |
|
Data obciążenia za zamówienie |
Ciąg znaków |
Nie |
Data zamówienia podana zgodnie ze strefą czasową UTC (w formacie RRRR-MM-DD). |
|
Stan płatności |
Ciąg znaków |
Nie |
|
|
Kwota płatności z salda Play |
Ciąg znaków |
Nie |
Kwota transakcji. |
| Waluta salda Play | Ciąg znaków | Nie | KRWW raportach o płatnościach z salda w koreańskim Sklepie Play jest to zawsze won koreański (KRW). |
| Sygnatura czasowa obciążenia za zamówienie | Liczba całkowita | Nie | 1480507200
Sygnatura czasowa UNIX momentu obciążenia użytkownika płatnością za zamówienie. Mierzona w sekundach od początku epoki. |
Subskrypcje
Odpowiedzi w ankiecie na temat anulowaniaPolecenie
gs://[developer_bucket_id]/subscriptions/cancellations/freeform_[package_name].csv
Format pliku
| Pole | Format | Opcjonalne | Przykłady i uwagi |
|---|---|---|---|
| Data anulowania | Ciąg znaków | Nie | 2016-11-30 |
| Identyfikator SKU | Ciąg znaków | Tak | treasure_chest_for_new_usersOkreślony przez dewelopera unikalny identyfikator produktu. |
| Kraj | Ciąg znaków | Nie | US, CA itp. |
| Odpowiedź | Ciąg znaków | Nie |
Raporty zbiorcze – polecenia i formaty plików
Statystyki
InstalacjePolecenie
gs://[developer_bucket_id]/stats/installs/installs_[package_name]_yyyyMM_[dimension].csv
Format pliku
| Pole | Format | Opcjonalne | Przykład |
|---|---|---|---|
| Data | RRRR-MM-DD | NIE | 2014-06-19 |
| Nazwa pakietu | Ciąg znaków | NIE | com.my.app |
| Urządzenie (lub dowolny inny obsługiwany wymiar) | Ciąg znaków | TAK | hammerhead |
| Obecna liczba instalacji (urządzenia) | Liczba całkowita | NIE | |
| Instalacje na aktywnych urządzeniach | Liczba całkowita | NIE | |
| Dzienna liczba instalacji (urządzenia) | Liczba całkowita | NIE | |
| Dzienna liczba odinstalowań (urządzenia) | Liczba całkowita | NIE | |
| Dzienna liczba uaktualnień (urządzenia) | Liczba całkowita | NIE | |
| Obecna liczba instalacji (użytkownicy) | Liczba całkowita | NIE | |
| Łączna liczba instalacji (użytkownicy) | Liczba całkowita | NIE | |
| Dzienna liczba instalacji (użytkownicy) | Liczba całkowita | NIE | |
| Dzienna liczba odinstalowań (użytkownicy) | Liczba całkowita | NIE |
Obsługiwane wymiary
| Wymiar | Nazwa pliku |
|---|---|
| Kod wersji aplikacji | ..._app_version.csv |
| Operator | ..._carrier.csv |
| Kraj | ..._country.csv |
| Urządzenie | ..._device.csv |
| Język | ..._language.csv |
| Wersja systemu operacyjnego Android | ..._os_version.csv |
Przykład
Jeśli chcesz pobrać wszystkie raporty z identyfikatorem zasobnika raportów pubsite_prod_rev_0123456789 wygenerowane w 2014 roku dla aplikacji, której nazwa pakietu to „com.example.app”, polecenie będzie wyglądać tak:
gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/installs/installs_com.example.app_2014* /your/local/directory Uwaga: od stycznia 2018 roku eksportowane dane uwzględniają także informacje z nowego źródła i odpowiadają informacjom na stronie Statystyki w szczegółach aplikacji. Eksportowanie danych sprzed stycznia 2018 roku obejmuje tylko dane z poprzedniego źródła.
Polecenie
gs://[developer_bucket_id]/stats/crashes/crashes_[package_name]_yyyyMM_[dimension].csv
Format pliku
| Pole | Format | Opcjonalne | Przykład |
|---|---|---|---|
| Data | RRRR-MM-DD | NIE | 2014-06-19 |
| Nazwa pakietu | Ciąg znaków | NIE | com.my.app |
| Urządzenie (lub dowolny inny obsługiwany wymiar) | Ciąg znaków | TAK | hammerhead |
| Dzienna liczba awarii | Liczba całkowita | NIE | |
| Dzienna liczba błędów ANR | Liczba całkowita | NIE |
Obsługiwane wymiary
| Wymiar | Nazwa pliku |
|---|---|
| Kod wersji aplikacji | ..._app_version.csv |
| Urządzenie | ..._device.csv |
| Wersja systemu operacyjnego Android | ..._os_version.csv |
Przykład
Jeśli chcesz pobrać wszystkie raporty z identyfikatorem zasobnika raportów pubsite_prod_rev_0123456789 wygenerowane w 2014 roku dla aplikacji, której nazwa pakietu to „com.example.app”, polecenie będzie wyglądać tak:
gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/crashes/crashes_com.example.app_2014* /your/local/directory Polecenie
gs://[developer_bucket_id]/stats/ratings/ratings_[package_name]_yyyyMM_[dimension].csv
Format pliku
| Pole | Format | Opcjonalne | Przykład |
|---|---|---|---|
| Data | RRRR-MM-DD | NIE | 2014-06-19 |
| Nazwa pakietu | Ciąg znaków | NIE | com.my.app |
| Urządzenie (lub dowolny inny obsługiwany wymiar) | Ciąg znaków | TAK | hammerhead |
| Dzienna średnia ocena | %.2f | TAK | |
| Łączna średnia ocena | %.2f | Tak | 4.16 |
Obsługiwane wymiary
| Wymiar | Nazwa pliku |
|---|---|
| Kod wersji aplikacji | ..._app_version.csv |
| Operator | ..._carrier.csv |
| Kraj | ..._country.csv |
| Urządzenie | ..._device.csv |
| Język | ..._language.csv |
| Wersja systemu operacyjnego Android | ..._os_version.csv |
Przykład
Jeśli chcesz pobrać wszystkie raporty z identyfikatorem zasobnika raportów pubsite_prod_rev_0123456789 wygenerowane w 2014 roku dla aplikacji, której nazwa pakietu to „com.example.app”, polecenie będzie wyglądać tak:
gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/ratings/ratings_com.example.app_2014* /your/local/directoryPolecenie
gs://[developer_bucket_id]/financial-stats/subscriptions/subscriptions_[package_name]_[product_id]_yyyyMM_[dimension].csv
Format pliku
| Pole | Format | Opcjonalne | Przykłady i uwagi |
|---|---|---|---|
| Data | RRRR-MM-DD | NIE |
Data zamówienia podana zgodnie ze strefą czasową UTC (w formacie RRRR-MM-DD) |
| Nazwa pakietu | Ciąg znaków | NIE | com.example.app |
| Identyfikator produktu | Ciąg znaków | NIE | Dostęp premium |
| Kraj | Ciąg znaków | NIE |
|
| Nowe subskrypcje | Liczba | NIE | 1234 |
| Anulowane subskrypcje | Liczba | NIE | 1234 |
| Aktywne subskrypcje | Liczba | NIE | 1234 |
| Identyfikator abonamentu podstawowego | Ciąg znaków | NIE | co tydzień |
| Identyfikator oferty | Ciąg znaków | NIE | oferta-wiosenna |
Uwaga: aby uzyskać więcej informacji o nowych, anulowanych i aktywnych subskrypcjach, przejrzyj dane o kupujących i przychodach z aplikacji.
Obsługiwane wymiary
| Wymiar | Nazwa pliku |
|---|---|
| Kraj | ..._country.csv |
Pozyskiwanie użytkowników
Raporty o utrzymanych użytkownikach, którzy zainstalowali aplikację, oraz o kupujących zapewniają zautomatyzowany dostęp do danych z poprzedniej wersji raportu o pozyskiwaniu. Ten eksport został zastąpiony nowym eksportem zautomatyzowanym, który zawiera dane ze stron Analiza pozyskania w Sklepie i Analiza konwersji w Konsoli Play. Funkcja jest dostępna od marca 2021 roku.
Stare raporty zostały usunięte w październiku 2021 roku.
Sekcja Jak można pobrać dane o pozyskiwaniu? zawiera więcej informacji na ten temat.
Uwaga: od listopada 2019 roku raport Subskrybenci nie jest już obsługiwany. Aby dowiedzieć się więcej, przeczytaj artykuł o danych i źródłach pozyskiwania.
Utrzymani użytkownicy, którzy zainstalowali aplikację (stary eksport – dostępny do sierpnia 2021 roku)Polecenie
gs://[developer_bucket_id]/acquisition/retained_installers/retained_installers_[package_name]_yyyyMM_[dimension].csv
Format pliku
| Pole | Format | Opcjonalne | Przykłady i uwagi |
|---|---|---|---|
| Data | RRRR-MM-DD | NIE |
Data, kiedy użytkownik wszedł na stronę z informacjami o aplikacji. Uwaga: dodanie unikalnych użytkowników, którzy odwiedzili stronę aplikacji w Sklepie w okresie kilku dni, sprawi, że liczba tych użytkowników będzie wyższa niż ta podana w widoku kohorty tygodniowej lub miesięcznej. W widoku kohorty tygodniowej lub miesięcznej każdy użytkownik liczony jest tylko raz, nawet jeśli odwiedzi stronę kilka razy. |
| Sposób pozyskania | Ciąg znaków | TAK |
Widoczne dla wymiaru „Sposób pozyskania”. Uwaga: kanał „Sklep Play (bezpłatne)” to suma wymiarów „Wyszukiwanie bezpośrednio w Sklepie Play” i „Przeglądanie bezpośrednio w Sklepie Play”. Aby uniknąć podwójnego zliczania wizyt w tym raporcie, zignoruj wiersz „Sklep Play (bezpłatne)” albo wiersze dotyczące wyszukiwania i przeglądania. |
| Kraj | Ciąg znaków | TAK | Widoczne dla wymiarów „Kraj” i „Kraj (Sklep Play, bezpłatne)”. |
| Źródło monitora UTM/kampania | Ciąg znaków | TAK |
Widoczne dla wymiaru „Śledzone kanały (UTM)”. |
| Słowo kluczowe | Ciąg znaków | TAK |
Widoczne dla wymiaru „Wyszukiwanie w Sklepie Play (bezpłatne)” |
| Użytkownicy, którzy odwiedzili stronę aplikacji w Sklepie | Liczba całkowita | NIE | |
| Zainstalowali | Liczba całkowita | NIE | |
| Współczynnik konwersji odwiedzających na instalujących | Wartość dziesiętna | NIE | |
| Mediana porównawcza współczynnika konwersji odwiedzających na instalujących | Wartość dziesiętna | TAK |
Niewypełniane od sierpnia 2019 r. Na stronie Raporty dotyczące pozyskania dostępny jest zaktualizowany zestaw testów porównawczych wykorzystujący nowe obliczenia. Więcej informacji znajdziesz w sekcji Porównanie współczynnika konwersji w ramach grupy porównawczej w przypadku ruchu w Sklepie Play. |
| Zainstalowali i nie usunęli przez 1 dzień | Liczba całkowita | NIE | |
| Współczynnik instalujących, którzy nie usunęli aplikacji przez 1 dzień | Wartość dziesiętna | NIE | |
| Zainstalowali i nie usunęli przez 7 dni | Liczba całkowita | NIE | |
| Współczynnik instalujących, którzy nie usunęli aplikacji przez 7 dni | Wartość dziesiętna | NIE | |
| Zainstalowali i nie usunęli przez 15 dni | Liczba całkowita | NIE | |
| Współczynnik instalujących, którzy nie usunęli aplikacji przez 15 dni | Wartość dziesiętna | NIE | |
| Zainstalowali i nie usunęli przez 30 dni | Liczba całkowita | NIE | |
| Współczynnik instalujących, którzy nie usunęli aplikacji przez 30 dni | Wartość dziesiętna | NIE |
Obsługiwane wymiary
| Wymiar | Nazwa pliku |
|---|---|
| Sposób pozyskania* | …_channel.csv |
| Kraj | ..._country.csv |
| Kraj (Sklep Play, bezpłatne) | …_play_country.csv |
| Wyszukiwanie bezpośrednio w Sklepie Play | …_play_search.csv |
| Śledzone kanały (UTM) | ..._utm_tagged.csv |
* Uwaga: pozycja „Sklep Play (bezpłatne)” to suma wymiarów „Wyszukiwanie bezpośrednio w Sklepie Play” i „Przeglądanie bezpośrednio w Sklepie Play”. Aby uniknąć podwójnego zliczania wizyt w tym raporcie, zignoruj wiersz „Sklep Play (bezpłatne)” albo wiersze dotyczące wyszukiwania i przeglądania.
Od czerwca 2019 roku wymiar Wyszukiwanie w Google (bezpłatne) nie jest już obsługiwany.
Nazwy plików CSV
Każdy dostępny plik CSV zawiera dane z 1 miesiąca oraz podział. Pliki CSV mają uporządkowane nazwy odzwierciedlające obejmowany rok, miesiąc i podział raportu, tworzone według tego wzoru:
Format nazwy pliku: store_performance_[package_name]_[yyyyMM]_[breakdown].csv
Uwagi:
- Nazwa pakietu zostanie uwzględniona w nazwie pliku w niezmienionej postaci, łącznie z ewentualnymi znakami specjalnymi („
.” lub „_”). yyyyMMoznacza rok i miesiąc, np.202101.
Polecenie
gs://[developer_bucket_id]/stats/store_performance/store_performance_[package_name]_[yyyyMM]_[breakdown].csv
Format pliku
| Pole | Format | Opcjonalne | Przykład | Opis |
|---|---|---|---|---|
| Data | RRRR-MM-DD | NIE | 2021-01-01 |
Data, kiedy użytkownik wszedł na stronę z informacjami o aplikacji. |
| Nazwa pakietu | Ciąg znaków | NIE | com.example.app |
Nazwa pakietu zawierającego dane z raportu. |
| Kraj/region | Ciąg znaków | NIE | UK |
Kraj lub region, w którym jest zarejestrowane konto Google użytkownika. |
| Źródło wizyt | Ciąg znaków | NIE | Google Play search |
Sposób dotarcia użytkownika do Twojej strony z informacjami o aplikacji:
Uwaga: może przyjmować wartość |
| Wyszukiwane hasło | Ciąg znaków | TAK | app store |
Hasło wyszukane przez użytkownika, zanim otworzył Twoją stronę z informacjami o aplikacji (tylko w przypadku wyszukiwania w Google Play). Uwaga: może przyjmować wartość |
| Źródło UTM | Ciąg znaków | TAK | google |
Wartość parametru URL utm_source w precyzyjnych linkach prowadzących do informacji o aplikacji (tylko w przypadku zewnętrznych witryn odsyłających). Uwaga: może przyjmować wartość |
| Kampania UTM | Ciąg znaków | TAK | campaign |
Wartość parametru URL utm_campaign w precyzyjnych linkach prowadzących do informacji o aplikacji (tylko w przypadku zewnętrznych witryn odsyłających). Uwaga: może przyjmować wartośćInne, jeśli nie osiągnie określonych minimalnych progów. |
| Pozyskania ze strony z informacjami o aplikacji | Liczba całkowita | NIE | 10 |
Liczba użytkowników, którzy odwiedzili stronę z informacjami o aplikacji i zainstalowali Twoją aplikację w czasie, gdy nie mieli jej zainstalowanej na żadnym ze swoich urządzeń. |
| Użytkownicy, którzy odwiedzili stronę aplikacji w Sklepie | Liczba całkowita | NIE | 100 |
Liczba użytkowników, którzy odwiedzili stronę z informacjami o aplikacji, gdy nie mieli jej jeszcze zainstalowanej na żadnym ze swoich urządzeń. |
| Współczynnik konwersji strony z informacjami o aplikacji | Wartość dziesiętna | NIE | 0,1 |
Odsetek użytkowników, którzy odwiedzili stronę aplikacji w Sklepie i zainstalowali aplikację. Uwaga: nie obejmuje odwiedzin ani instalacji u użytkowników, którzy mają już aplikację zainstalowaną na innym urządzeniu. |
Dostępna struktura podziału
Dostępne są takie podziały:
| Nazwa podziału | Pola w każdym pliku CSV (w kolejności): |
|---|---|
|
Przykładowa nazwa pliku:
|
Data, Nazwa pakietu, Kraj, Pozyskania ze strony z informacjami o aplikacji, Użytkownicy, którzy odwiedzili stronę aplikacji w Sklepie, Współczynnik konwersji strony z informacjami o aplikacji |
|
Przykładowa nazwa pliku:
|
Data, Nazwa pakietu, Źródło wizyt, Wyszukiwane hasło, Źródło UTM, Kampania UTM, Pozyskania ze strony z informacjami o aplikacji, Użytkownicy, którzy odwiedzili stronę aplikacji w Sklepie, Współczynnik konwersji strony z informacjami o aplikacji |
Schemat zmiany znaczenia
- Podwajaj cudzysłowy podwójne (
"->""). - Jeśli komórka zawiera znaki tabulacji, znaki nowego wiersza, cudzysłowy podwójne lub przecinki, umieść ją w podwójnym cudzysłowie (
...->"...").
Przykład
Jeśli chcesz pobrać wszystkie raporty z identyfikatorem zasobnika raportów pubsite_prod_0123456789 wygenerowane w 2020 roku dla aplikacji, której nazwa pakietu to com.example.app, polecenie będzie wyglądać tak:
gsutil cp -r gs://pubsite_prod_0123456789/stats/store_performance/store_performance_com.example.app_2020* /your/local/directory
Polecenie
gs://[developer_bucket_id]/acquisition/buyers_7d/buyers_7d_[package_name]_yyyyMM_[dimension].csv
Format pliku
| Pole | Format | Opcjonalne | Przykłady i uwagi |
|---|---|---|---|
| Data | RRRR-MM-DD | NIE |
Data, kiedy użytkownik wszedł na stronę z informacjami o aplikacji. Uwaga: dodanie unikalnych użytkowników, którzy odwiedzili stronę aplikacji w Sklepie w okresie kilku dni, sprawi, że liczba tych użytkowników będzie wyższa niż ta podana w widoku kohorty tygodniowej lub miesięcznej. W widoku kohorty tygodniowej lub miesięcznej każdy użytkownik liczony jest tylko raz, nawet jeśli odwiedzi stronę kilka razy. |
| Sposób pozyskania | Ciąg znaków | TAK |
Widoczne dla wymiaru „Sposób pozyskania”. Uwaga: kanał „Sklep Play (bezpłatne)” to suma wymiarów „Wyszukiwanie bezpośrednio w Sklepie Play” i „Przeglądanie bezpośrednio w Sklepie Play”. Aby uniknąć podwójnego zliczania wizyt w tym raporcie, zignoruj wiersz „Sklep Play (bezpłatne)” albo wiersze dotyczące wyszukiwania i przeglądania. |
| Kraj | Ciąg znaków | TAK | Widoczne dla wymiarów „Kraj” i „Kraj (Sklep Play, bezpłatne)”. |
| Źródło monitora UTM/kampania | Ciąg znaków | TAK | Widoczne dla wymiaru „Śledzone kanały (UTM)”. |
| Słowo kluczowe | Ciąg znaków | TAK |
Widoczne dla wymiaru „Wyszukiwanie w Sklepie Play (bezpłatne)” |
| Użytkownicy, którzy odwiedzili stronę aplikacji w Sklepie | Liczba całkowita | NIE | |
| Zainstalowali | Liczba całkowita | NIE | |
| Współczynnik konwersji odwiedzających na instalujących | Wartość dziesiętna | NIE | |
| Mediana porównawcza współczynnika konwersji odwiedzających na instalujących | Wartość dziesiętna | TAK |
Niewypełniane od sierpnia 2019 r. Na stronie Raporty dotyczące pozyskania dostępny jest zaktualizowany zestaw testów porównawczych wykorzystujący nowe obliczenia. Więcej informacji znajdziesz w sekcji Porównanie współczynnika konwersji w ramach grupy porównawczej w przypadku ruchu w Sklepie Play. |
| Kupujący | Liczba całkowita | NIE | |
| Współczynnik konwersji instalujących na kupujących | Wartość dziesiętna | NIE | |
| Kupili kolejny raz | Liczba całkowita | NIE | |
| Współczynnik konwersji instalujących na kupujących kolejny raz | Wartość dziesiętna | NIE | |
| Współczynnik konwersji kupujących na kupujących kolejny raz | Liczba całkowita | NIE |
Obsługiwane wymiary
| Wymiar | Nazwa pliku |
|---|---|
| Sposób pozyskania* | …_channel.csv |
|
Kraj |
..._country.csv |
|
Kraj (Sklep Play, bezpłatne) |
…_play_country.csv |
| Wyszukiwanie bezpośrednio w Sklepie Play | …_play_search.csv |
| Śledzone kanały (UTM) | ..._utm_tagged.csv |
* Uwaga: pozycja „Sklep Play (bezpłatne)” to suma wymiarów „Wyszukiwanie bezpośrednio w Sklepie Play” i „Przeglądanie bezpośrednio w Sklepie Play”. Aby uniknąć podwójnego zliczania wizyt w tym raporcie, zignoruj wiersz „Sklep Play (bezpłatne)” albo wiersze dotyczące wyszukiwania i przeglądania.
Od czerwca 2019 roku wymiar Wyszukiwanie w Google (bezpłatne) nie jest już obsługiwany.