Raporttityypit
Yksityiskohtaiset raportitYksityiskohtaiset raportit sisältävät tietoja yksittäisistä tapahtumista:
- Arvostelut
- Talous: myyntiarvio, tulot, palkitut tuotteet ja Korean Play-saldon käyttö
Koontiraportit sisältävät sovellusten tilastoista koottuja tietoja (keskiarvoja, päivittäisiä yhteismääriä jne.):
- Tilastot: asennukset, kaatumiset, arviot ja tilaukset
- Käyttäjien osto- ja muu toiminta: sovelluksen asentaneet ja pitäneet käyttäjät, ostajat (7 päivää asentamisen jälkeen) ja tilaajat
Raporttien lataaminen
- Avaa Play Console.
- Valitse Lataa raportteja ja Arvostelut, Tilastot tai Talous.
- Kirjoita ja valitse sovelluksesi nimi Valitse sovellus ‑kohdassa.
- Valitse ajanjakso, jota koskevan raportin haluat ladata.
Huom. Talousraportit kattavat kaikki tilisi sovellukset.
Raporttien lataaminen Google Cloud Storagesta
Raportit ovat saatavilla Google Cloud Storagesta. Raportit luodaan päivittäin ja kerätään kuukausittaisiin CSV-tiedostoihin. Niitä säilytetään Google Play ‑kehittäjätilisi yksityisessä Google Cloud Storage ‑ryhmässä.
Voit tarkastella raportteja Google Cloud Storagen kautta selaimellasi tai ohjelmallisesti gsutilin avulla. Cloud Storage -ryhmää voi käyttää ohjelmallisesti myös muiden työkalujen avulla.
Vinkki: Jos haluat tuoda raportteja Google Cloud Storagesta BigQueryyn, CSV-tiedostot on muunnettava UTF-16
-muodosta UTF-8
-muotoon.
Google Cloud Storagen URI:n löytäminen
Voit kopioida Google Cloud Storagen URI:n klikkaamalla Kopioi Cloud Storagen URI ‑painiketta asianomaisen osion otsikon vierestä Lataa raportteja ‑sivuilta.
Cloud Storagen URI:n alussa on pubsite_prod_rev
(esimerkki: pubsite_prod_rev_01234567890987654321
).
- Asenna gsutil-työkalu.
- Muista käyttää todentamiseen tiliä, jolla on oikeus käyttää Play Consolea.
- Jos käytät gsutilia ensimmäistä kertaa etkä ole lisännyt Google Cloud Storageen muita projekteja, voit kirjoittaa sovelluksen nimen, kun sinulta pyydetään projektin tunnusta käyttöönoton aikana.
- Löydät raportoinnin ryhmätunnuksen klikkaamalla Kopioi Cloud Storagen URI ‑painiketta asianomaisen osion otsikon vierestä Lataa raportteja ‑sivuilta.
- Cloud Storagen URI:n alussa on
pubsite_prod_rev
(esimerkki:pubsite_prod_rev_01234567890987654321
).
- Cloud Storagen URI:n alussa on
- Lataa raportit
gsutil cp
‑komennon avulla.- Gsutil-työkalun dokumentaatiossa on lisää komentoja, jotka auttavat raporttiesi käsittelyssä.
Raportit järjestellään raporttityypin mukaan nimettyihin hakemistoihin. CSV-tiedostonimet sisältävät raportin tyypin, paketin nimen, ajanjakson sekä kategorian (jos saatavilla).
Vaihe 1: Luo palvelutili
- Avaa Google Developers Console.
- Jos olet jo luonut projektin, valitse haluamasi projekti avattavasta valikosta. Jos et ole vielä luonut projektia tai haluat luoda uuden, valitse Luo projekti.
- Valitse valikkokuvake > Käyttöoikeudet > Palvelutilit > Luo palvelutili.
- Seuraa ohjeita näytöllä ja valitse Luo.
- Kopioi sinulle luotu sähköpostiosoite.
- Esimerkki:
accountName@project.iam.gserviceaccount.com
- Esimerkki:
Vaihe 2: Lisää palvelutili Play Consoleen
- Avaa Play Console.
- Valitse Asetukset > Käyttäjätilit ja käyttöoikeudet > Kutsu uusi käyttäjä.
- Kirjoita tai liitä kenttään palvelutiliisi yhdistetty sähköpostiosoite.
- Valitse luvat sen mukaan, minkälaisia raportteja tarvitaan.
- Vinkki: Artikkelista Käyttäjien lisääminen kehittäjätilille ja käyttöoikeuksien hallitseminen saat tietoja käyttäjien eri pääsyoikeustasoista ja eri lupien myötä myönnettävistä oikeuksista.
- Valitse Lisää käyttäjä. Palvelutilisi yhdistetään konsolitiliisi.
Vaihe 3: Nouda raportit sovellusliittymäkutsulla
- Asenna käyttämäsi ohjelmointikielen API asiakaskirjasto.
- Määritä sovellusliittymäkutsun tekevä koodi käyttämään palvelintenvälistä
OAuth2
-todennusta ja pyytämäänOAuth2
-käyttöoikeuksia (https://www.googleapis.com/auth/devstorage.read_only). - Nouda raportit todennetuilla sovellusliittymäkutsuilla.
Tässä on esimerkki koodista, jos raportit noudetaan Pythonilla:
import json
from httplib2 import Http
from oauth2client.client import SignedJwtAssertionCredentials
from apiclient.discovery import build
# Anna seuraaville muuttujille tilanteeseesi sopivat arvot.
client_email = 'anna palvelutilisi sähköpostiosoite'
json_file = 'palvelutilin luomisen yhteydessä saamasi json-tiedoston polku'
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()
Google Cloud Storagen pääsyoikeuksien hallinta
Google Cloud Storagessa ja Play Consolessa saatavilla oleviin raportteihin sovelletaan samoja pääsyoikeusrajoituksia. Tilin käyttäjä, jolla on pääsyoikeus tiettyihin Play Console ‑tilin osioihin, voi siis päästä vastaaviin raportteihin myös Google Cloud Storagessa.
Tilien omistajat voivat muokata yksittäisten käyttäjien käyttöoikeuksia milloin tahansa.
- Joukkoraporttien käyttäminen edellyttää yleistä Katsele sovelluksen tietoja ‑käyttöoikeutta.
- Talousraporttien lataaminen edellyttää yleistä Katsele taloustietoja ‑lupaa.
Yksityiskohtaisten raporttien komennot ja tiedostomuodot
Kaatumiset ja ANR:t
Vuoden 2018 toukokuusta alkaen yksityiskohtaisten kaatumis- ja ANR-raporttien luominen ei ole enää mahdollista.
Arvostelut
Komento
gs://[developer_bucket_id]/reviews/reviews_[package_name]_YYYYMM.csv
Tiedostomuoto
Kenttä | Muoto | Valinnainen | Esimerkkejä ja huomioita |
---|---|---|---|
Paketin nimi | Merkkijono | EI | com.company.app |
Sovellusversion koodi | Kokonaisluku | KYLLÄ | Vain APK-tiedostojen tuotantoversiot |
Sovellusversion nimi | Merkkijono | KYLLÄ | |
Arvostelijan kieli | Merkkijono – ISO 639-1 kaksikirjaiminen lyhenne | KYLLÄ | en |
Laite | Merkkijono | KYLLÄ | hammerhead |
Arvostelun lähetyspäivämäärä ja -aika | ISO_8601, mukaan lukien aika, UTC-aikavyöhyke | EI | 2014-06-19T19:12:32Z |
Arvostelun lähetysaika, millisekunteina alkukohdan jälkeen | Kokonaisluku, millisekunteina alkukohdan jälkeen | EI | |
Arvostelun viimeisimmän päivityksen päivämäärä ja aika | ISO_8601, mukaan lukien aika, UTC-aikavyöhyke | KYLLÄ | 2014-06-19T19:12:32Z |
Arvostelun viimeisimmän päivityksen aika, millisekunteina alkukohdan jälkeen | Kokonaisluku, millisekunteina alkukohdan jälkeen | KYLLÄ | |
Tähtiarvio | Kokonaisluku (1–5) | EI | |
Arvostelun otsikko | Merkkijono, arvostelijan paikallisella kielellä (rivinvaihdot poistettu) | KYLLÄ | |
Arvostelun teksti | Merkkijono, arvostelijan paikallisella kielellä (rivinvaihdot poistettu) | KYLLÄ | |
Kehittäjän vastauksen päivämäärä ja aika | ISO_8601, mukaan lukien aika, UTC-aikavyöhyke | KYLLÄ | 2014-06-19T19:12:32Z |
Kehittäjän vastauksen aika, millisekunteina alkukohdan jälkeen | Kokonaisluku, millisekunteina alkukohdan jälkeen | KYLLÄ | |
Kehittäjän vastauksen teksti | Merkkijono (rivinvaihdot poistettu ja välilyönnit pakattu) | KYLLÄ | |
Arvostelulinkki | Merkkijono | KYLLÄ | https://play.google.com/apps/publish/?dev_acc=<...>#ReviewPlace:id=<..> |
Esimerkki
Jos haluat esimerkiksi ladata kaikki sovelluksesta com.example.app (pakettinimi) vuonna 2014 luodut raportit raporttiryhmästä pubsite_prod_rev_0123456789
, komento on seuraava:
gsutil cp -r gs://pubsite_prod_rev_0123456789/reviews/reviews_com.example.app_2014* /your/local/directory
Talousraportit
MyyntiarvioSuosittelemme, että et luota CSV-tiedostojen sarakkeiden määrään automatisoiduissa raporteissa.
Tietoa
Myyntiarvioraportista näet lähes reaaliaikaisia tietoja sovelluksesta, sovelluksen sisäisestä tuotteesta tai tilausmyynnistä. Raportti sisältää ostajien maksaman määrän eikä veroja tai Google-maksuja ole vähennetty kokonaissummista.
Voit käyttää tätä raporttia analyysin tai trendianalyysin luomiseen, mutta sitä ei suositella kirjanpitotarkoituksiin. Tutustu sen sijaan tuloraporttiin.
Saatat huomata eroja tämän raportin lukujen ja varsinaisten tulojesi välillä useista syistä. Myyntiarvioraportissa ei oteta huomioon esimerkiksi ennakonpidätyksiä tai takaisinperintöjä. Tämä raportti sisältää ostajien maksamat summat paikallisessa valuutassa eikä muunnettuja summia maksuvaluutassasi.
Komento
gs://[ryhmätunnus]/sales/salesreport_YYYYMM.zip
Esimerkki
Jos haluat esimerkiksi ladata kaikki sovelluksesta com.example.app (pakettinimi) vuonna 2014 luodut raportit raporttiryhmästä pubsite_prod_rev_0123456789
, komento on seuraava:
gsutil cp -r gs://pubsite_prod_rev_0123456789/sales/salesreport_2014* /your/local/directory
Tiedostomuoto
Kenttä | Muoto | Valinnainen | Esimerkkejä ja huomioita |
---|---|---|---|
Tilausnumero |
Merkkijono |
Ei |
Tilaustunnusten lopussa on uusimisjakson numero (esim. ensimmäinen uusiminen on |
Tilauksen veloituspäivä |
Merkkijono |
Ei |
Tilauksen päivämäärä UTC-aikavyöhykkeellä (muodossa VVVV-KK-PP). |
Tilauksen veloituksen aikaleima |
Kokonaisluku |
Ei |
UNIX-aikaleima hetkeltä, kun tilaus veloitettiin käyttäjältä. Mitataan sekunneissa alkukohdan jälkeen. |
Maksun tila |
Merkkijono |
Ei |
Jos hyvität tilauksen kokonaan osittaisen hyvityksen jälkeen:
|
Laitteen malli |
Merkkijono |
Ei |
Android-laitemalli, jolla ostos tehtiin. Tilauksissa tämä tarkoittaa alkuperäiseen ostoon käytettyä laitetta. |
Tuotteen nimi |
Merkkijono |
Ei |
Kehittäjän määrittämä tuotenimi. Näytetään ostajan kielellä. |
Tuotteen tunnus |
Merkkijono |
Ei |
Sen sovelluksen pakettinimi, jossa tuote myytiin. |
Tuotetyyppi |
Merkkijono |
Ei |
|
SKU ID |
Merkkijono |
Ei |
Kehittäjän määrittämä yksilöllinen tuotetunnus. |
Myyntivaluutta |
Merkkijono |
Ei |
|
Tuotteen hinta |
Kokonaisluku |
Ei |
Näkyy ostajan paikallisessa valuutassa. Tuhaterottimena käytetään pilkkua (,). |
Perityt verot |
Kokonaisluku |
Kyllä |
Ostajan paikallisessa valuutassa. Tuhaterottimena käytetään pilkkua (,). |
Laskutettu summa |
Kokonaisluku |
Ei |
Ostajan paikallisessa valuutassa. Tämä on tuotteen hinnan ja siitä kerättyjen verojen yhteissumma. Tuhaterottimena käytetään pilkkua (,). |
Ostajan kaupunki |
Merkkijono |
Kyllä |
Käytetään vain myynneissä, joissa sinä olet vastuullinen myyjä. |
Ostajan alue |
Merkkijono |
Kyllä |
|
Ostajan postinumero |
Merkkijono |
Kyllä |
Käytetään vain myynneissä, joissa sinä olet vastuullinen myyjä. |
Ostajan maa |
Merkkijono |
Ei |
|
Peruspaketin tunnus |
Merkkijono |
Kyllä |
Tilauksen peruspaketin tunnus. Käytetään vain tilauksiin. Lue lisää |
Tarjouksen tunnus |
Merkkijono |
Kyllä |
Tilauksen tarjoustunnus. Käytetään vain tilauksiin. Lue lisää |
Ryhmän tunnus | Kokonaisluku | Kyllä |
Yksilöllinen tunnus annetaan kehittäjätiliryhmän luomisen yhteydessä. Lue lisää. |
Oikeutus ensimmäisen miljoonan dollarin osalta | Merkkijono | Kyllä |
Päivitetään vain, kun kehittäjätiliryhmä on luotu. Lue lisää |
Kampanjatunnus | Merkkijono | Kyllä |
|
Kupongin arvo | Kokonaisluku | Kyllä |
Näkyy ostajan paikallisessa valuutassa. Tuhaterottimena käytetään pilkkua (,). Käytetään vain Play Points ‐kuponkeihin liittyvään myyntiin. Lue lisää |
Alennettu hinta | Kokonaisluku | Kyllä |
Alennusprosentti (%), jolla määritetään käyttäjän Play-pisteissä säästämä summa verrattuna rahan käyttöön. Käytetään vain Play Pointsiin liittyvään myyntiin. Lue lisää |
Esiinnostettavan tuotteen tunnus |
Kokonaisluku |
Kyllä |
Yksilöllinen tunnus annetaan, kun kehittäj luo esiinnostettavan tuotteen. Lue lisää |
Suosittelemme, että et luota CSV-tiedostojen sarakkeiden määrään automatisoiduissa raporteissa.
Tietoa
Tuloraportin avulla saat paremman kuvan maksuista ja tapahtumista. Raportin jokaisella rivillä on tapahtumatyyppi, esim. kun veloitat asiakkaalta rahaa tai maksat Googlelle maksun, sekä alkuperäiset ja muunnetut rahasummat.
Tuloraportit sisältävät edellisen kuukauden tapahtumat. Saat maksun useita viikkoja sen jälkeen, kun tuloraportti tulee saataville.
Tuloraportti luodaan kerran kuukaudessa ja on yleensä saatavilla seuraavan kuun 5. päivään mennessä. Google voi toisinaan tehdä oikaisuja tuloihisi laskuvirheiden korjaamiseksi. Tällaisissa tapauksissa ilmoitamme sinulle ongelmasta ja luomme ylimääräisen tulotiedoston, joka sisältää vain oikaistut tapahtumat omaa kirjanpitoasi varten.
Huomioitavaa
- Google-maksut näkyvät nyt kaikille tapahtumille riippumatta siitä, onko Google myytyjen tuotteiden kauppias.
- Tuloraportti ei sisällä takaisinveloituksia.
- Kuukausittaisten tapahtumien tuloraporttia varten luodaan yksi tiedosto.
- Taiwanin ennakonpidätys maksetaan edellisen kuukauden aikana siitä lähtien, kun se ilmoitetaan
Komento
gs://[ryhmätunnus]/earnings/earnings_YYYYMM.zip
Esimerkki
Jos haluat esimerkiksi ladata kaikki sovelluksesta com.example.app (pakettinimi) vuonna 2014 luodut raportit raporttiryhmästä pubsite_prod_rev_0123456789
, komento on seuraava:
gsutil cp -r gs://pubsite_prod_rev_0123456789/earnings/earnings_2014* /your/local/directory
Tiedostomuoto
Kenttä | Muoto | Valinnainen | Esimerkkejä ja huomioita |
---|---|---|---|
Kuvaus |
Merkkijono |
Ei |
Tilaukselle annettu yksilöllinen tunnus. Tilaustunnusten lopussa on uusimisen jaksonumero. |
Tapahtuman päiväys |
Merkkijono |
Ei |
Tilauksen päivämäärä Tyynenmeren aikavyöhykkeellä (muodossa KKK PP, VVVV). Huomaa, että tapahtuman aikaleimaan saatetaan tallentaa seuraava kuukausi, koska raportit luodaan myöntämisen aikaleiman perusteella. |
Tapahtuman ajankohta |
Merkkijono |
Ei |
|
Verotyyppi |
Merkkijono |
Kyllä |
Tämä on tyhjä verottamattomien rivien kohdalla. |
Tapahtumatyyppi |
Merkkijono |
Ei |
|
Hyvitystyyppi |
Merkkijono |
Kyllä |
Hyvitykset, joissa ostajalle hyvitetään kaikki maksetut kulut, merkitään täysiksi (full). Hyvitykset, joissa käyttäjälle hyvitetään osa maksusummasta, merkitään osittaisiksi (partial). |
Tuotteen nimi |
Merkkijono |
Ei |
Kehittäjän määrittämä tuotenimi. Näytetään ostajan kielellä. |
Tuotteen tunnus |
Merkkijono |
Ei |
Sen sovelluksen pakettinimi, jossa tuote myytiin. |
Tuotetyyppi |
Kokonaisluku |
Ei |
Käytetään myytyjen tuotteiden tyypin tunnistamiseen. 0 tarkoittaa maksullisen sovelluksen myyntiä, 1 tarkoittaa sovelluksen sisäisen tuotteen tai tilauksen myyntiä. |
SKU-tunnus |
Merkkijono |
Ei |
Kehittäjän määrittämä yksilöllinen tuotetunnus. |
Laitteisto |
Merkkijono |
Ei |
Android-laitemalli, jolla ostos tehtiin. Tilauksissa tämä tarkoittaa alkuperäiseen ostoon käytettyä mallia. |
Ostajan maa |
Merkkijono |
Ei |
|
Ostajan alue |
Merkkijono |
Kyllä |
|
Ostajan postinumero |
Merkkijono |
Kyllä |
|
Ostajan valuutta |
Merkkijono |
Ei |
|
Summa (ostajan valuutta) |
Kokonaisluku |
Ei |
Tämän laskurivin kokonaissumma ennen valuuttamuunnosta. |
Valuutan muunnoskurssi |
Kokonaisluku |
Ei |
Valuutan muunnoskurssi, jota käytetään ostajan maksamien summien muuntamiseen kauppiaan valuuttaan. |
Kauppiaan valuutta | Merkkijono | Ei |
Valuutta, johon tilaus muunnetaan. Tämä on paikallinen valuutta, jolla sinulle maksetaan. |
Summa (kauppiaan valuutta) | Kokonaisluku | Ei |
Tämän laskurivin kokonaissumma valuuttamuunnoksen jälkeen. |
Peruspaketin tunnus |
Merkkijono |
Kyllä |
Tilauksen peruspaketin tunnus. Käytetään vain tilauksiin. Lue lisää |
Tarjouksen tunnus |
Merkkijono |
Kyllä |
Tilauksen tarjoustunnus. Käytetään vain tilauksiin. Lue lisää |
Ryhmän tunnus | Kokonaisluku | Kyllä |
Yksilöllinen tunnus annetaan kehittäjätiliryhmän luomisen yhteydessä. Lue lisää. |
Oikeutus ensimmäisen miljoonan dollarin osalta | Merkkijono | Kyllä |
Päivitetään vain, kun kehittäjätiliryhmä on luotu. Lue lisää |
Palvelumaksu (%) |
Kokonaisluku |
Kyllä |
|
Maksun kuvaus | Merkkijono | Kyllä |
Tiedot, jotka on ilmoitettu Googlen palvelumaksun laskemista varten. |
Kampanjatunnus | Merkkijono | Kyllä |
|
Tietoja
Jos olet kauppias, jonka tulee Etelä-Korean lakien ja sääntöjen mukaan antaa ostoksista kuitti, tai jos olet itse rekisteröitynyt antamaan kuitteja, sinun on ostajan pyynnöstä lähetettävä kuitti maksullisen sovelluksen tai sovelluksen sisäisen tuotteen ostoksesta, joka on tehty Google Play ‑lahjakortilla Korean woneissa (KRW).
Korean Play-saldon käyttöraportti sisältää Play-saldomyynnit, jotka on tehty Korean woneilla, jotta käyttäjälle voidaan lähettää kuitti.
Huom. Käyttäjät voivat lisätä Play-saldoa useista lähteistä, mukaan lukien Googlen tai sen kumppaneiden tarjoushyvitysten kautta. Ennen kuitin lähettämistä on tärkeää varmistaa, että käyttäjä lisäsi saldoonsa rahaa vastaavalla maksuvälineellä (esim. lahjakortilla).
Komento
gs://[developer_bucket_id]/play_balance_krw/play_balance_krw_YYYYMM.zip
Esimerkki
Jos haluat esimerkiksi ladata kaikki sovelluksesta com.example.app (pakettinimi) vuonna 2018 luodut raportit raporttiryhmästä pubsite_prod_rev_0123456789
, komento on seuraava:
gsutil cp -r gs://pubsite_prod_rev_0123456789/play_balance_krw/play_balance_krw_2018* /your/local/directory
Tiedostomuoto
Kenttä | Muoto | Valinnainen | Esimerkkejä ja huomioita |
---|---|---|---|
Tilausnumero |
Kokonaisluku |
Ei |
Tilaustunnusten lopussa on uusimisjakson numero (esim. ensimmäinen uusiminen on |
Tilauksen veloituspäivä |
Merkkijono |
Ei |
Tilauksen päivämäärä UTC-aikavyöhykkeellä (muodossa VVVV-KK-PP). |
Maksun tila |
Merkkijono |
Ei |
|
Play-saldon käyttösumma |
Merkkijono |
Ei |
Tapahtuman summa. |
Play-saldon valuutta | Merkkijono | Ei | KRW Korean Play-saldon käyttöraporteissa tämä on aina Korean won (KRW). |
Tilauksen veloituksen aikaleima | Kokonaisluku | Ei | 1480507200
UNIX-aikaleima hetkeltä, kun tilaus veloitettiin käyttäjältä. Mitataan sekunneissa alkukohdan jälkeen. |
Tilaukset
Peruutuskyselyn vastauksetKomento
gs://[ryhmätunnus]/subscriptions/cancellations/freeform_[pakettinimi].csv
Tiedostomuoto
Kenttä | Muoto | Valinnainen | Esimerkkejä ja huomioita |
---|---|---|---|
Perumispäivä | Merkkijono | Ei | 2016-11-30 |
SKU-tunnus | Merkkijono | Kyllä | treasure_chest_for_new_users Kehittäjän määrittämä yksilöllinen tuotetunnus. |
Maa | Merkkijono | Ei | US, CA jne. |
Vastaus | Merkkijono | Ei |
Koontiraporttien komennot ja tiedostomuodot
Tilastot
AsennuksetKomento
gs://[ryhmätunnus]/stats/installs/installs_[pakettinimi]_yyyyMM_[kategoria].csv
Tiedostomuoto
Kenttä | Muoto | Valinnainen | Esimerkki |
---|---|---|---|
Päivämäärä | VVVV-kk-pp | EI | 2014-06-19 |
Paketin nimi | Merkkijono | EI | com.my.app |
Laite (tai muu tuettu kategoria) | Merkkijono | KYLLÄ | hammerhead |
Nykyiset asennukset laitteiden mukaan | Kokonaisluku | EI | |
Asennukset aktiivisille laitteille | Kokonaisluku | EI | |
Päivittäiset asennukset laitteiden mukaan | Kokonaisluku | EI | |
Päivittäiset poistot laitteiden mukaan | Kokonaisluku | EI | |
Päivittäiset päivitykset laitteiden mukaan | Kokonaisluku | EI | |
Nykyiset asennukset käyttäjien mukaan | Kokonaisluku | EI | |
Asennukset yhteensä käyttäjien mukaan | Kokonaisluku | EI | |
Päivittäiset asennukset käyttäjien mukaan | Kokonaisluku | EI | |
Päivittäiset asennuksien poistot käyttäjien mukaan | Kokonaisluku | EI |
Tuetut kategoriat
Kategoria | Tiedostonimi |
---|---|
Sovellusversion koodi | ..._app_version.csv |
Operaattori | ..._carrier.csv |
Maa | ..._country.csv |
Laite | ..._device.csv |
Kieli | ..._language.csv |
Android-käyttöjärjestelmän versio | ..._os_version.csv |
Esimerkki
Jos haluat esimerkiksi ladata kaikki sovelluksesta com.example.app (pakettinimi) vuonna 2014 luodut raportit raporttiryhmästä pubsite_prod_rev_0123456789
, komento on seuraava:
gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/installs/installs_com.example.app_2014* /your/local/directory
Huom. Tammikuusta 2018 alkaen vietävää dataa otetaan uudesta datalähteestä, ja se vastaa sovelluksesi Tilastotiedot-sivun tietoja. Vuoden 2018 tammikuuta edeltävältä ajalta voidaan viedä vain edellisestä datalähteestä peräisin olevaa dataa.
Komento
gs://[ryhmätunnus]/stats/crashes/crashes_[pakettinimi]_yyyyMM_[kategoria].csv
Tiedostomuoto
Kenttä | Muoto | Valinnainen | Esimerkki |
---|---|---|---|
Päivämäärä | VVVV-kk-pp | EI | 2014-06-19 |
Paketin nimi | Merkkijono | EI | com.my.app |
Laite (tai muu tuettu kategoria) | Merkkijono | KYLLÄ | hammerhead |
Päivittäiset kaatumiset | Kokonaisluku | EI | |
Päivittäiset ANR:t | Kokonaisluku | EI |
Tuetut kategoriat
Kategoria | Tiedostonimi |
---|---|
Sovellusversion koodi | ..._app_version.csv |
Laite | ..._device.csv |
Android-käyttöjärjestelmän versio | ..._os_version.csv |
Esimerkki
Jos haluat esimerkiksi ladata kaikki sovelluksesta com.example.app (pakettinimi) vuonna 2014 luodut raportit raporttiryhmästä pubsite_prod_rev_0123456789
, komento on seuraava:
gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/crashes/crashes_com.example.app_2014* /your/local/directory
Komento
gs://[ryhmätunnus]/stats/ratings/ratings_[pakettinimi]_yyyyMM_[kategoria].csv
Tiedostomuoto
Kenttä | Muoto | Valinnainen | Esimerkki |
---|---|---|---|
Päivämäärä | VVVV-kk-pp | EI | 2014-06-19 |
Paketin nimi | Merkkijono | EI | com.my.app |
Laite (tai muu tuettu kategoria) | Merkkijono | KYLLÄ | hammerhead |
Päivittäinen keskimääräinen arvio | %.2f | KYLLÄ | |
Keskimääräinen kokonaisarvio | %.2f | Kyllä | 4.16 |
Tuetut kategoriat
Kategoria | Tiedostonimi |
---|---|
Sovellusversion koodi | ..._app_version.csv |
Operaattori | ..._carrier.csv |
Maa | ..._country.csv |
Laite | ..._device.csv |
Kieli | ..._language.csv |
Android-käyttöjärjestelmän versio | ..._os_version.csv |
Esimerkki
Jos haluat esimerkiksi ladata kaikki sovelluksesta com.example.app (pakettinimi) vuonna 2014 luodut raportit raporttiryhmästä pubsite_prod_rev_0123456789
, komento on seuraava:
gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/ratings/ratings_com.example.app_2014* /your/local/directory
Komento
gs://[kehittäjän_ryhmätunnus]/financial-stats/subscriptions/subscriptions_[pakettinimi]_[tuotteen_tunnus]_yyyyMM_[kategoria].csv
Tiedostomuoto
Kenttä | Muoto | Valinnainen | Esimerkkejä ja huomioita |
---|---|---|---|
Päivämäärä | VVVV-KK-PP | EI |
Tilauksen päivämäärä UTC-aikavyöhykkeellä (muodossa VVVV-KK-PP) |
Paketin nimi | Merkkijono | EI | com.example.app |
Tuotteen tunnus | Merkkijono | EI | Premium access |
Maa | Merkkijono | EI |
|
Uudet tilaukset | Numero | EI | 1234 |
Peruutetut tilaukset | Numero | EI | 1234 |
Aktiiviset tilaukset | Numero | EI | 1234 |
Peruspaketin tunnus | Merkkijono | EI | weekly |
Tarjouksen tunnus | Merkkijono | EI | spring-offer |
Huom. Saat lisää tilastotietoja uusista, peruutetuista ja voimassa olevista tilauksista tutustumalla sovelluksesi tuotto- ja ostajadataan.
Tuetut kategoriat
Kategoria | Tiedostonimi |
---|---|
Maa | ..._country.csv |
Käyttäjien osto- ja muu toiminta
Säilytettyjen asentajien ja ostajien raportit antavat ohjelmallisen pääsyoikeuden vanhan hankintaraportin dataan. Tämä vienti on korvattu uudellaohjelmallisella viennillä, joka sisältää dataa Play Consolen Kaupan analyysi- ja Konversioanalyysi-sivuilta. Se tuli saataville maaliskuussa 2021.
Vanhat raportit poistettiin lokakuussa 2021.
Lue lisätietoja artikkelista Voinko ladata hankintadataa?
Huom. Tilaajat-raporttia ei tueta marraskuusta 2019 alkaen. Lue lisää hankinnan lähteistä ja mittareista.
Sovelluksen asentaneet ja pitäneet (vanha vienti – saatavilla elokuuhun 2021 asti)Komento
gs://[ryhmätunnus]/acquisition/retained_installers/retained_installers_[pakettinimi]_yyyyMM_[kategoria].csv
Tiedostomuoto
Kenttä | Muoto | Valinnainen | Esimerkkejä ja huomioita |
---|---|---|---|
Päivämäärä | VVVV-kk-pp | EI |
Tietosivulla käynnin päivämäärä Huom. Yksittäisten tietosivulla käyneiden lisääminen usealta päivältä johtaa suurempaan tietosivun kävijämäärään kuin viikoittaisessa tai kuukausittaisessa kohorttinäkymässä. Viikoittaisessa ja kuukausittaisessa kohorttinäkymässä jokainen kävijä lasketaan vain kerran useista käynneistä huolimatta. |
Hankintakanava | Merkkijono | KYLLÄ |
Esillä Hankintakanava-kategoriassa Huom. Play Kauppa (orgaaninen) ‑kanava koostuu Haku Play Kaupasta (orgaaninen) ‑kanavan ja Selailu Play Kaupassa (orgaaninen) ‑kanavan kävijöistä. Jotta raportissa ilmoitettuja kävijöitä ei lasketa mukaan kahdesti, jätä joko Play Kauppa (orgaaninen) ‑rivi tai sekä haku- että selailurivi huomioimatta. |
Maa | Merkkijono | KYLLÄ | Esillä Maa- ja Maa (Play Kaupan orgaaninen) ‑kategorioissa |
UTM:n lähde/kampanja | Merkkijono | KYLLÄ |
Esillä Seuratut kanavat (UTM) ‑kategoriassa |
Avainsana | Merkkijono | KYLLÄ |
Esillä Haku Play Kaupasta (orgaaninen) ‑kategoriassa |
Tietosivulla käyneet | Kokonaisluku | EI | |
Asentajat | Kokonaisluku | EI | |
Kävijöistä asentajiksi siirtyneiden käyttäjien konversioprosentti | Desimaaliluku | EI | |
Asentajiksi siirtyneiden kävijöiden konversioprosentin mediaanivertailuarvo | Desimaaliluku | KYLLÄ |
Ei käytössä elokuusta 2019 alkaen. Uuden laskutavan mukaiset päivitetyt vertailuarvot ovat saatavilla Hankintaraportit-sivulla. Lisätietoja on artikkelissa Play Kauppa ‑liikenteen konversioprosenttien vertaisvertailu. |
1 päivän säilytetyt asentajat | Kokonaisluku | EI | |
Säilytysprosentti, asentaja – 1 päivä | Desimaaliluku | EI | |
7 päivää säilytetyt asentajat | Kokonaisluku | EI | |
Säilytysprosentti, asentaja – 7 päivää | Desimaaliluku | EI | |
15 päivää säilytetyt asentajat | Kokonaisluku | EI | |
Säilytysprosentti, asentaja – 15 päivää | Desimaaliluku | EI | |
30 päivää säilytetyt asentajat | Kokonaisluku | EI | |
Säilytysprosentti, asentaja – 30 päivää | Desimaaliluku | EI |
Tuetut kategoriat
Kategoria | Tiedostonimi |
---|---|
Hankintakanava* | ..._channel.csv |
Maa | ..._country.csv |
Maa (Play Kaupan orgaaninen) | ..._play_country.csv |
Haku Play Kaupasta (orgaaninen) | ..._play_search.csv |
Seuratut kanavat (UTM) | ..._utm_tagged.csv |
Huom. Play Kauppa (orgaaninen) ‑kanava koostuu Haku Play Kaupasta (orgaaninen) ‑kanavan ja Selailu Play Kaupassa (orgaaninen) ‑kanavan kävijöistä. Jotta raportissa ilmoitettuja kävijöitä ei lasketa mukaan kahdesti, jätä joko Play Kauppa (orgaaninen) ‑rivi tai sekä haku- että selailurivi huomioimatta.
Kesäkuusta 2019 alkaen Google Haku (orgaaninen) ‑kategoriaa ei enää tueta.
CSV-nimet
Jokainen saatavilla oleva CSV-tiedosto sisältää dataa yhdeltä kuukaudelta ja erittelystä. CSV:ille annetaan strukturoidut nimet, jotka ilmaisevat niiden kattaman vuoden, kuukauden ja raportin erittelyn alla olevan mallin mukaan:
Tiedostonimien malli: store_performance_[package_name]_[yyyyMM]_[breakdown].csv
Huomioitavaa:
- Pakettinimi sisältyy tiedostonimeen sellaisenaan siihen kuuluvien mahdollisten erikoismerkkien kanssa ("
.
" tai "_
"). yyyyMM
edustaa vuotta ja kuukautta, esimerkiksi202101
.
Komento
gs://[developer_bucket_id]/stats/store_performance/store_performance_[package_name]_[yyyyMM]_[breakdown].csv
Tiedostomuoto
Kenttä | Muoto | Valinnainen | Esimerkki | Kuvaus |
---|---|---|---|---|
Päivämäärä | VVVV-kk-pp | EI | 2021-01-01 |
Tietosivulla käynnin päivämäärä |
Paketin nimi | Merkkijono | EI | com.example.app |
Raportin datan omistavan paketin nimi |
Maa/alue | Merkkijono | EI | Iso-Britannia |
Maa tai alue, johon käyttäjän Google-tili on rekisteröity |
Liikenteen lähde | Merkkijono | EI | Haku Google Playsta |
Miten käyttäjä tuli sovelluksen tietosivulle:
Huom. Voi olla |
Hakutermi | Merkkijono | KYLLÄ | sovelluskauppa |
Käyttäjän hakema termi ennen sovelluksen tietosivulle siirtymistä. Käytettävissä vain Google Playn haussa. Huom. Voi olla |
UTM-lähde | Merkkijono | KYLLÄ | Google |
Sovelluksen tietosivulle johtavissa täsmälinkeissä oleva utm_source-URL-parametri. Käytettävissä vain kolmannen osapuolen suosituksella Huom. Voi olla |
UTM-kampanja | Merkkijono | KYLLÄ | kampanja |
Sovelluksen tietosivulle johtavissa täsmälinkeissä oleva utm_campaign-URL-parametri. Käytettävissä vain kolmannen osapuolen suosituksella. Huom. Voi ollaMuu jos tämä arvo ei yllä tiettyihin minimikynnyksiin |
Tietosivun hankinnat | Kokonaisluku | EI | 10 |
Sellaisten käyttäjien määrä, jotka kävivät tietosivullasi, asensivat sovelluksesi ja joilla ei ollut sitä asennettuna millään muulla laitteella asennushetkellä |
Tietosivulla käyneet | Kokonaisluku | EI | 100 |
Sellaisten käyttäjien määrä, jotka kävivät tietosivullasi ja joilla ei ollut sovellustasi asennettuna millään laitteella |
Tietosivun konversioprosentti | Desimaaliluku | EI | 0,1 |
Niiden tietosivulla käyneiden käyttäjien prosenttiosuus, jotka asensivat sovelluksesi Huom.Tämä ei sisällä käyntejä tai asennuksia käyttäjiltä, joilla on jo sovelluksesi asennettuna toisella laitteella |
Saatavilla oleva erittelyn rakenne
Seuraavat erittelyt ovat saatavilla:
Erittelyn nimi | Kentät jokaisessa CVS:ssä (järjestyksessä): |
---|---|
Tiedostonimen esimerkki:
|
Päivämäärä, pakettinimi, maa, sovelluksen tietosivun hankinnat, tietosivulla käyneet, sovelluksen tietosivun konversioprosentti |
Tiedostonimen esimerkki:
|
Päivämäärä, pakettinimi, liikenteen lähde, hakutermi, UTM-lähde, UTM-kampanja, sovelluksen tietosivun hankinnat, tietosivulla käyneet, sovelluksen tietosivun konversioprosentti |
Vaihtamisen tavat
- Kaksinkertaista kaikki kaksinkertaiset lainausmerkit (
"
->""
) - Jos solu sisältää sarkaimia, rivinvaihtomerkkejä, kaksinkertaisia lainausmerkkejä tai pilkkuja, lisää kaksinkertaiset lainausmerkit solun ympärille. (
...
->"..."
)
Esimerkki
Jos haluat esimerkiksi ladata kaikki sovelluksesta com.example.app
(pakettinimi) vuonna 2020 luodut raportit raporttiryhmästä pubsite_prod_rev_0123456789
, komento on seuraava:
gsutil cp -r gs://pubsite_prod_0123456789/stats/store_performance/store_performance_com.example.app_2020* /your/local/directory
Komento
gs://[ryhmätunnus]/acquisition/buyers_7d/buyers_7d_[pakettinimi]_yyyyMM_[kategoria].csv
Tiedostomuoto
Kenttä | Muoto | Valinnainen | Esimerkkejä ja huomioita |
---|---|---|---|
Päivämäärä | VVVV-kk-pp | EI |
Tietosivulla käynnin päivämäärä Huom. Yksittäisten tietosivulla käyneiden lisääminen usealta päivältä johtaa suurempaan tietosivun kävijämäärään kuin viikoittaisessa tai kuukausittaisessa kohorttinäkymässä. Viikoittaisessa ja kuukausittaisessa kohorttinäkymässä jokainen kävijä lasketaan vain kerran useista käynneistä huolimatta. |
Hankintakanava | Merkkijono | KYLLÄ |
Esillä Hankintakanava-kategoriassa Huom. Play Kauppa (orgaaninen) ‑kanava koostuu Haku Play Kaupasta (orgaaninen) ‑kanavan ja Selailu Play Kaupassa (orgaaninen) ‑kanavan kävijöistä. Jotta raportissa ilmoitettuja kävijöitä ei lasketa mukaan kahdesti, jätä joko Play Kauppa (orgaaninen) ‑rivi tai sekä haku- että selailurivi huomioimatta. |
Maa | Merkkijono | KYLLÄ | Esillä Maa- ja Maa (Play Kaupan orgaaninen) ‑kategorioissa |
UTM:n lähde/kampanja | Merkkijono | KYLLÄ | Esillä Seuratut kanavat (UTM) ‑kategoriassa |
Avainsana | Merkkijono | KYLLÄ |
Esillä Haku Play Kaupasta (orgaaninen) ‑kategoriassa |
Tietosivulla käyneet | Kokonaisluku | EI | |
Asentajat | Kokonaisluku | EI | |
Kävijöistä asentajiksi siirtyneiden käyttäjien konversioprosentti | Desimaaliluku | EI | |
Asentajiksi siirtyneiden kävijöiden konversioprosentin mediaanivertailuarvo | Desimaaliluku | KYLLÄ |
Ei käytössä elokuusta 2019 alkaen. Uuden laskutavan mukaiset päivitetyt vertailuarvot ovat saatavilla Hankintaraportit-sivulla. Lisätietoja on artikkelissa Play Kauppa ‑liikenteen konversioprosenttien vertaisvertailu. |
Ostajat | Kokonaisluku | EI | |
Asentajista ostajiksi siirtyneiden käyttäjien konversioprosentti | Desimaaliluku | EI | |
Toistuvasti ostavat | Kokonaisluku | EI | |
Asentajista toistuviksi ostajiksi siirtyneiden käyttäjien konversioprosentti | Desimaaliluku | EI | |
Ostajista toistuviksi ostajiksi siirtyneiden käyttäjien konversioprosentti | Kokonaisluku | EI |
Tuetut kategoriat
Kategoria | Tiedostonimi |
---|---|
Hankintakanava* | ..._channel.csv |
Maa |
..._country.csv |
Maa (Play Kaupan orgaaninen) |
..._play_country.csv |
Haku Play Kaupasta (orgaaninen) | ..._play_search.csv |
Seuratut kanavat (UTM) | ..._utm_tagged.csv |
Huom. Play Kauppa (orgaaninen) ‑kanava koostuu Haku Play Kaupasta (orgaaninen) ‑kanavan ja Selailu Play Kaupassa (orgaaninen) ‑kanavan kävijöistä. Jotta raportissa ilmoitettuja kävijöitä ei lasketa mukaan kahdesti, jätä joko Play Kauppa (orgaaninen) ‑rivi tai sekä haku- että selailurivi huomioimatta.
Kesäkuusta 2019 alkaen Google Haku (orgaaninen) ‑kategoriaa ei enää tueta.