Jenis laporan
Laporan terperinciLaporan terperinci termasuk data tentang acara individu:
- Ulasan
- Kewangan: anggaran jualan, pendapatan, produk yang diberikan sebagai ganjaran dan pembiayaan baki Korean Play
Laporan agregat termasuk data gabungan (purata, jumlah harian dan lain-lain) untuk statistik apl:
- Statistik: pemasangan, ranap sistem, rating dan langganan
- Pemerolehan pengguna: pemasang kekal, pembeli (7 hari selepas pemasangan), pelanggan
Muat turun laporan
- Buka Play Console.
- Klik Muat turun laporan
, dan pilih Semakan, Statistik, atau Kewangan.
- Di bawah "Pilih aplikasi", taip dan pilih nama apl anda.
- Pilih tahun dan bulan bagi laporan yang hendak dimuat turun.
Nota: Laporan kewangan termasuk semua apl dalam akaun anda.
Muat turun laporan daripada Storan Awan Google
Laporan tersedia daripada Storan Awan Google. Laporan dihasilkan setiap hari dan dikumpul dalam fail CSV bulanan. Laporan disimpan dalam baldi Storan Awan Google peribadi untuk akaun Pembangun Google Play anda.
Anda boleh mengakses laporan menggunakan Storan Awan Google pada penyemak imbas anda atau melalui pengaturcaraan menggunakan gsutil. Anda juga boleh menggunakan alatan lain untuk mengakses baldi Storan Awan anda melalui pengaturcaraan.
Petua: Jika anda ingin mengimport laporan anda daripada Storan Awan Google ke BigQuery, anda perlu menukar fail CSV daripada UTF-16
kepada UTF-8
.
Cari URI Storan Awan Google anda
Anda boleh menyalin URI Storan Awan Google anda dengan mengklik butang Salin URI Storan Awan di sebelah pengepala bahagian yang serupa pada halaman Muat turun laporan.
URI Storan Awan anda bermula dengan pubsite_prod_rev
(Contohnya, pubsite_prod_rev_01234567890987654321
).
- Pasang alat gsutil.
- Pastikan anda mengesahkan akaun menggunakan akaun yang mempunyai akses kepada Play Console anda.
- Semasa proses persediaan, jika anda menggunakan gsutil buat kali pertama dan tidak mempunyai sebarang projek lain yang dikonfigurasikan dalam Storan Awan Google, anda boleh menaip nama apl anda apabila anda digesa untuk memberikan ID projek.
- Cari ID baldi pelaporan anda dengan mengklik butang Salin URI Storan Awan di sebelah pengepala bahagian yang serupa pada halaman Muat turun laporan.
- URI Storan Awan anda bermula dengan:
pubsite_prod_rev
(Contohnya,pubsite_prod_rev_01234567890987654321
).
- URI Storan Awan anda bermula dengan:
- Gunakan perintah
gsutil cp
untuk memuat turun laporan.- Untuk mengetahui perintah tambahan untuk membantu anda mengakses laporan anda, pergi ke dokumentasi gsutil.
Laporan diatur dalam direktori yang dinamakan mengikut setiap jenis laporan. Nama fail CSV merangkumi jenis laporan, nama pakej, tempoh masa dan dimensi (jika berkenaan).
Langkah 1: Buat akaun perkhidmatan
- Buka Google Developers Console.
- Jika anda sudah mempunyai projek, gunakan menu lungsur untuk memilih projek. Jika anda tiada projek yang tersenarai atau ingin membuat projek baharu, klik Buat projek.
- Pilih ikon Menu
> Kebenaran > Akaun perkhidmatan > Buat akaun perkhidmatan.
- Ikut arahan pada skrin dan pilih Buat.
- Salin alamat e-mel yang disenaraikan.
- Contoh:
[email protected]
- Contoh:
Langkah 2: Tambahkan akaun perkhidmatan pada Play Console
- Buka Play Console.
- Pilih Tetapan
> Akaun & hak pengguna > Undang pengguna baharu.
- Tampal atau taip alamat e-mel yang dikaitkan dengan akaun perkhidmatan anda.
- Pilih kebenaran berdasarkan jenis laporan yang diperlukan.
- Petua: Baca artikel Tambah pengguna akaun pembangun dan urus kebenaran untuk memahami pelbagai tahap akses pengguna dan hak yang diberikan oleh pelbagai kebenaran kepada mereka.
- Klik Tambah pengguna. Akaun perkhidmatan anda akan ditambahkan pada akaun anda.
Langkah 3: Ambil laporan menggunakan panggilan API
- Pasang Pustaka klien API untuk bahasa kod pilihan anda.
- Konfigurasikan kod yang melaksanakan panggilan API untuk menggunakan pengesahan pelayan ke pelayan
OAuth2
dan untuk meminta kebenaran kepada skopOAuth2
(https://googleapis.com/auth/devstorage.read_only). - Keluarkan panggilan API yang disahkan untuk mengambil laporan.
Jika anda menggunakan Python untuk mengambil laporan, berikut ialah contoh 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://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()
Kawal akses kepada Storan Awan Google
Laporan yang tersedia pada Storan Awan Google menggunakan sekatan akses sama yang mengawal akses data dalam Play Console. Ini bermakna pengguna akaun yang mempunyai akses kepada bahagian akaun Play Console akan mempunyai akses kepada laporan yang sepadan di Storan Awan Google.
Pemilik akaun boleh mengemas kini kebenaran untuk pengguna individu pada bila-bila masa.
- Untuk mengakses laporan pukal, kebenaran "Lihat maklumat apl" anda mesti ditetapkan kepada "Global".
- Untuk memuat turun laporan kewangan, kebenaran "Lihat data kewangan" anda mesti ditetapkan kepada "Global".
Perintah dan format fail untuk laporan terperinci
Ranap dan ANR
Mulai Mei 2018, anda tidak boleh memuat turun laporan terperinci untuk ranap sistem dan ANR lagi.
Ulasan
Perintah
gs://[developer_bucket_id]/reviews/reviews_[package_name]_YYYYMM.csv
Format fail
Medan | Format | Pilihan | Contoh dan nota |
---|---|---|---|
Nama Pakej | Rentetan | TIDAK | com.company.app |
Kod Versi Apl | integer | YA | APK pengeluaran sahaja |
Nama Versi Apl | Rentetan | YA | |
Bahasa Pengulas | Rentetan - ISO 639-1 singkatan dua huruf | YA | en |
Peranti | Rentetan | YA | hammerhead |
Tarikh dan Masa Hantar Ulasan | ISO_8601 termasuk masa, zon waktu UTC | TIDAK | 2014-06-19T19:12:32Z |
Milisaat Serahan Ulasan Sejak Epoch | integer, milisaat sejak epoch | TIDAK | |
Tarikh dan Masa Kemas Kini Terakhir Ulasan | ISO_8601 termasuk masa, zon waktu UTC | YA | 2014-06-19T19:12:32Z |
Milisaat Kemas Kini Terakhir Ulasan Sejak Epoch | integer, milisaat sejak epoch | YA | |
Rating Bintang | integer (antara 1 dengan 5) | TIDAK | |
Tajuk Ulasan | Rentetan, dalam bahasa tempatan pengulas (pelucutan baris baharu) | YA | |
Teks Ulasan | Rentetan, dalam bahasa tempatan pengulas (pelucutan baris baharu) | YA | |
Tarikh dan Masa Balasan Pembangun | ISO_8601 termasuk masa, zon waktu UTC | YA | 2014-06-19T19:12:32Z |
Milisaat Balasan Pembangun Sejak Epoch | integer, milisaat sejak epoch | YA | |
Teks Balasan Pembangun | Rentetan (pelucutan baris baharu dan memampatkan ruang putih) | YA | |
Pautan Ulasan | Rentetan | YA | https://play.google.com/apps/publish/?dev_acc=<...>#ReviewPlace:id=<..> |
Contoh
Jika anda mahu memuat turun semua laporan yang dijanakan pada tahun 2014 daripada id baldi laporan pubsite_prod_rev_0123456789
untuk apl anda dengan nama pakej com.example.app, perintah tersebut ialah:
gsutil cp -r gs://pubsite_prod_rev_0123456789/reviews/reviews_com.example.app_2014* /your/local/directory
Laporan kewangan
Anggaran jualanKami mengesyorkan agar anda tidak bergantung pada bilangan lajur dalam fail CSV untuk laporan automatik anda.
Perihal
Anda boleh menggunakan laporan anggaran jualan untuk melihat maklumat berkependaman rendah tentang apl, produk dalam apl atau jualan langganan. Laporan ini mengandungi amaun yang dibayar oleh pembeli dan cukai atau yuran Google tidak ditolak daripada jumlah tersebut.
Anda boleh menggunakan laporan ini untuk analitis atau analisis aliran, tetapi tidak disyorkan untuk perakaunan. Sebaliknya, lihat Laporan pendapatan.
Anda mungkin melihat perbezaan antara laporan ini dan pendapatan anda atas beberapa sebab. Sebagai contoh, laporan anggaran jualan tidak mengambil kira cukai pegangan atau caj balik. Laporan ini mengandungi jumlah yang dibayar oleh pembeli dalam mata wang tempatan mereka dan tidak mengandungi jumlah yang ditukar dalam mata wang bayaran anda.
Perintah
gs://[developer_bucket_id]/sales/salesreport_YYYYMM.zip
Contoh
Jika anda mahu memuat turun semua laporan yang dijanakan pada tahun 2014 daripada id baldi laporan pubsite_prod_rev_0123456789
untuk apl anda dengan nama pakej com.example.app, perintah tersebut ialah:
gsutil cp -r gs://pubsite_prod_rev_0123456789/sales/salesreport_2014* /your/local/directory
Format fail
Medan | Format | Pilihan | Contoh dan nota |
---|---|---|---|
Nombor Pesanan |
Rentetan |
Tidak |
ID pesanan langganan merangkumi nombor kitaran pembaharuan pada penghujung ID (contohnya, pembaharuan pertama ialah |
Tarikh Pesanan Dicaj |
Rentetan |
Tidak |
Tarikh pesanan ini berdasarkan zon waktu UTC (dalam format HH-BB-TTTT). |
Cap masa Pesanan Dicaj |
Integer |
Tidak |
Cap masa UNIX apabila pengguna dikenakan caj untuk pesanan. Diukur dalam saat sejak epoch. |
Status Kewangan |
Rentetan |
Tidak |
Jika anda membayar balik pesanan sepenuhnya selepas mengeluarkan bayaran balik separa:
|
Model Peranti |
Rentetan |
Tidak |
Model peranti Android yang digunakan untuk membuat pembelian. Bagi pesanan langganan, rentetan ini merujuk model peranti yang digunakan semasa pembelian asal. |
Tajuk Produk |
Rentetan |
Tidak |
Nama produk yang ditentukan oleh pembangun. Dipaparkan dalam bahasa pembeli. |
ID Produk |
Rentetan |
Tidak |
Nama pakej apl tempat produk itu dijual. |
Jenis Produk |
Rentetan |
Tidak |
|
ID SKU |
Rentetan |
Tidak |
ID unik produk yang ditentukan oleh pembangun. |
Mata Wang Jualan |
Rentetan |
Tidak |
|
Harga Item |
Integer |
Tidak |
Ditunjukkan dalam mata wang tempatan pembeli. Dengan tanda “,” sebagai pemisah ribu. |
Cukai Dipungut |
Integer |
Ya |
Dalam mata wang tempatan pembeli. Dengan tanda “,” sebagai pemisah ribu. |
Jumlah Dicaj |
Integer |
Tidak |
Dalam mata wang tempatan pembeli. Ini merupakan jumlah harga item dan cukai yang dikutip. Dengan tanda “,” sebagai pemisah ribu. |
Bandar pembeli |
Rentetan |
Ya |
Hanya diisi untuk penjualan apabila anda ialah pedagang atas rekod. |
Negeri pembeli |
Rentetan |
Ya |
|
Poskod Pembeli |
Rentetan |
Ya |
Hanya diisi untuk penjualan apabila anda ialah pedagang atas rekod. |
Negara pembeli |
Rentetan |
Tidak |
|
ID Pelan Asas |
Rentetan |
Ya |
ID pelan asas langganan. Hanya diisi untuk langganan. Ketahui lebih lanjut. |
ID Tawaran |
Rentetan |
Ya |
ID tawaran langganan. Hanya diisi untuk langganan. Ketahui lebih lanjut. |
ID Kumpulan | Integer | Ya |
ID unik diberikan apabila kumpulan akaun pembangun dibuat. Ketahui lebih lanjut. |
1 Juta USD Pertama Layak | Rentetan | Ya |
Diisi hanya apabila kumpulan akaun pembangun disediakan. Ketahui lebih lanjut. |
ID Promosi | Rentetan | Ya |
|
Nilai Kupon | Integer | Ya |
Ditunjukkan dalam mata wang tempatan pembeli. Dengan tanda “,” sebagai pemisah ribu. Hanya diisi untuk penjualan yang berkaitan dengan kupon Play Points. Ketahui lebih lanjut. |
Kadar Diskaun | Integer | Ya |
% kadar diskaun yang digunakan untuk menentukan simpanan yang dibuat oleh pengguna dengan membelanjakan Mata Play berbanding membelanjakan wang. Hanya diisi untuk penjualan yang berkaitan dengan Play Points. Ketahui lebih lanjut. |
ID Produk yang Ditampilkan |
Integer |
Ya |
ID unik diberikan apabila pembangun membuat produk yang ditampilkan. Ketahui lebih lanjut. |
ID Percubaan Harga | Rentetan | Ya |
ID Percubaan Harga dan cabang eksperimen |
Kami mengesyorkan agar anda tidak bergantung pada bilangan lajur dalam fail CSV untuk laporan automatik anda.
Perihal
Anda boleh menggunakan laporan pendapatan untuk memahami bayaran dan transaksi anda. Setiap baris dalam laporan itu mewakili jenis transaksi. Misalnya, apabila anda mengecaj pelanggan atau membayar yuran Google, bersama-sama dengan jumlah asal dan jumlah yang ditukarkan.
Laporan pendapatan mengandungi transaksi daripada bulan sebelumnya. Anda akan menerima bayaran beberapa minggu selepas laporan pendapatan tersedia.
Laporan pendapatan dijana sekali sebulan dan biasanya tersedia menjelang 5hb pada bulan berikutnya. Sekali-sekala, Google mungkin membuat pelarasan pada pendapatan anda untuk membetulkan silap kiraan. Jika perkara ini berlaku, kami akan menghubungi anda untuk memaklumkan tentang masalah itu dan membuat fail Pendapatan tambahan yang mengandungi hanya transaksi terlaras tersebut untuk tujuan rekod anda.
Nota:
- Yuran Google kini boleh dilihat untuk semua transaksi, tanpa mengambil kira sama ada Google ialah Pedagang Atas Rekod untuk produk yang dijual.
- Laporan pendapatan tidak termasuk caj balik.
- Fail tunggal dijana untuk laporan pendapatan bagi transaksi pada setiap bulan.
- Cukai penangguhan Taiwan dibayar pada bulan sebelum cukai tersebut dilaporkan
Perintah
gs://[developer_bucket_id]/earnings/earnings_YYYYMM.zip
Contoh
Jika anda mahu memuat turun semua laporan yang dijanakan dalam tahun 2014 daripada id baldi laporan pubsite_prod_rev_0123456789
untuk apl anda dengan nama pakej com.example.app, perintahnya ialah:
gsutil cp -r gs://pubsite_prod_rev_0123456789/earnings/earnings_2014* /your/local/directory
Format fail
Medan | Format | Pilihan | Contoh dan nota |
---|---|---|---|
Perihalan |
Rentetan |
Tidak |
ID Pesanan (Order ID) langganan merangkumi nombor kitaran pembaharuan pada penghujung (contohnya, pembaharuan pertama ialah |
Tarikh Transaksi |
Rentetan |
Tidak |
Tarikh pesanan ini berdasarkan Zon Waktu Pasifik (dalam format HH BBB TTTT). Harap maklum bahawa cap masa transaksi mungkin mempunyai rekod bulan berikut memandangkan laporan dijana oleh cap masa isu. |
Masa Transaksi |
Rentetan |
Tidak |
|
Jenis Cukai |
Rentetan |
Ya |
Kosongkan baris bukan cukai. |
Jenis Transaksi |
Rentetan |
Tidak |
|
Jenis Bayaran Balik |
Rentetan |
Ya |
Bayaran balik apabila pembeli telah menerima bayaran balik perbelanjaan penuh mereka dan akan ditandakan sebagai 'Penuh'. Bayaran balik untuk sebahagian daripada jumlah pembayaran pengguna akan ditandakan sebagai 'Separa'. |
Tajuk Produk |
Rentetan |
Tidak |
Nama produk yang ditentukan oleh pembangun. Dipaparkan dalam bahasa pembeli. |
ID Produk |
Rentetan |
Tidak |
Nama pakej apl tempat produk itu dijual. |
Jenis Produk |
Integer |
Tidak |
Digunakan untuk mengenal pasti jenis produk yang dijual. '0' mewakili penjualan apl berbayar, '1' mewakili penjualan produk atau langganan dalam apl. |
ID SKU |
Rentetan |
Tidak |
ID unik produk yang ditentukan oleh pembangun. |
Perkakasan |
Rentetan |
Tidak |
Model peranti Android yang digunakan untuk membuat pembelian. Untuk pesanan langganan, rentetan ini merujuk kepada model yang digunakan semasa pembelian asal. |
Negara Pembeli |
Rentetan |
Tidak |
|
Negeri Pembeli |
Rentetan |
Ya |
|
Poskod Pembeli |
Rentetan |
Ya |
|
Mata Wang Pembeli |
Rentetan |
Tidak |
|
Jumlah (Mata Wang Pembeli) |
Integer |
Tidak |
Jumlah amaun untuk baris invois ini sebelum penukaran mata wang. |
Kadar Penukaran Mata Wang |
Integer |
Tidak |
Kadar pertukaran yang digunakan apabila menukarkan amaun pembeli kepada amaun bayaran dalam mata wang pedagang. |
Mata Wang Pedagang | Rentetan | Tidak |
Mata wang yang telah ditukar bagi sesuatu pesanan. Rentetan ini ialah mata wang tempatan yang anda terima. |
Jumlah (Mata Wang Pedagang) | Integer | Tidak |
Jumlah amaun untuk baris invois ini selepas penukaran mata wang. |
ID Pelan Asas |
Rentetan |
Ya |
ID pelan asas langganan. Hanya diisi untuk langganan. Ketahui lebih lanjut. |
ID Tawaran |
Rentetan |
Ya |
ID tawaran langganan. Hanya diisi untuk langganan. Ketahui lebih lanjut. |
ID Kumpulan | Integer | Ya |
ID unik diberikan apabila kumpulan akaun pembangun dibuat. Ketahui lebih lanjut. |
1 Juta USD Pertama Layak | Rentetan | Ya |
Diisi hanya apabila kumpulan akaun pembangun disediakan. Ketahui lebih lanjut. |
Yuran Perkhidmatan % |
Integer |
Ya |
|
Perihalan Yuran | Rentetan | Ya |
Butiran diberikan untuk pengiraan yuran perkhidmatan Google. |
ID Promosi | Rentetan | Ya |
Hanya diisi untuk jualan yang berkaitan dengan Play Points dan Play Pass. Awalan "PP.C" dan "PP.P" mentakrifkan pesanan yang melibatkan kupon Play Points dan promosi produk dalam apl masing-masing. Pesanan yang menggunakan Play Points secara terus juga dipaparkan. Awalan "pass" menentukan pesanan apabila pengguna menggunakan baucar yang disediakan sebagai sebahagian daripada langganan Play Pass mereka. |
Kami mengesyorkan agar anda tidak bergantung pada bilangan lajur dalam fail CSV untuk laporan automatik anda.
Perihal
Jika anda telah mendaftar dalam program pengebilan alternatif atau tawaran luaran dan telah melaporkan transaksi kepada Google Play, anda boleh menggunakan laporan Pengebilan invois untuk memahami transaksi anda dan bayaran yuran perkhidmatan Google yang diinvois kepada anda.
Laporan Pengebilan invois mengandungi transaksi daripada bulan sebelumnya dalam satu fail CSV. Laporan tersebut memberikan pecahan caj pengguna, yuran perkhidmatan Google dan jumlah cukai jika bersesuaian mengikut transaksi. Maklumat seperti peratusan yuran perkhidmatan dan kadar penukaran mata wang disertakan untuk membantu anda memahami cara jumlah invois yuran perkhidmatan dikira.
Nota:
- Laporan pengebilan invois dijana sekali sebulan dan biasanya tersedia menjelang 5hb pada bulan berikutnya.
- Baris yuran Google atau cukai yang digenapkan kepada sifar dalam mata wang pengebilan akan dikecualikan daripada laporan.
Perintah
gsutil cp -r gs://[developer_bucket_id]/invoice_billing_reports/invoice_billing_report_YYYYMM.zip /your/local/directory
Contoh
Jika anda mahu memuat turun semua laporan yang dijana dalam tahun 2024 daripada ID baldi laporan pubsite_prod_rev_0123456789
, perintah yang digunakan ialah:
gsutil cp -r gs://pubsite_prod_rev_0123456789/invoice_billing_reports/invoice_billing_report_2024* /your/local/directory
Format fail
Tarikh transaksi berdasarkan Zon Waktu Pasifik.
Medan | Format | Pilihan | Contoh dan nota |
---|---|---|---|
ID Invois |
Rentetan |
Tidak |
ID yang sejajar dengan nombor yang dipaparkan pada invois anda. |
Program |
Rentetan |
Ya |
Hanya ditetapkan untuk baris yuran Google. |
ID Transaksi Luaran |
Rentetan |
Tidak |
|
Tarikh Transaksi |
Rentetan |
Tidak |
Tarikh transaksi berdasarkan Zon Waktu Pasifik. |
Cap Masa Transaksi |
Integer |
Tidak |
Cap masa UNIX untuk transaksi. Diukur dalam saat sejak epok. |
Jenis Transaksi |
Rentetan |
Tidak |
Caj pengguna, yuran Google, Cukai, Bayaran balik caj pengguna, Bayaran balik yuran Google, Bayaran balik cukai, Bayaran balik separa caj pengguna, Bayaran balik separa yuran Google, Bayaran balik separa cukai |
Jenis Cukai |
Rentetan |
Ya |
Hanya ditetapkan untuk baris cukai. |
Jenis SKU |
Rentetan |
Tidak |
|
ID Pakej |
Rentetan |
Tidak |
Nama pakej apl tempat produk itu dijual. |
Negara Jualan |
Rentetan |
Tidak |
|
Harga Item tidak termasuk Cukai (Mata Wang Jualan) |
Perpuluhan |
Ya |
Harga produk dalam mata wang jualan tidak termasuk cukai. Hanya ditetapkan untuk baris Caj pengguna. |
Mata Wang Jualan |
Rentetan |
Tidak |
Mata wang tempatan pembeli. |
Jumlah Perlu Dibayar (Mata Wang Jualan) |
Perpuluhan |
Ya |
Jumlah perlu dibayar dalam mata wang jualan. Hanya ditetapkan untuk baris yuran Google dan Cukai. Positif untuk jumlah yang dicaj dan negatif untuk jumlah bayaran balik atau bayaran balik separa. |
Kadar Penukaran Mata Wang |
Perpuluhan |
Tidak |
Kadar pertukaran yang digunakan apabila menukar jumlah yang perlu dibayar daripada mata wang jualan kepada mata wang pengebilan. |
Mata Wang Pengebilan |
Rentetan |
Tidak |
|
Jumlah Perlu Dibayar (Mata Wang Pengebilan) |
Perpuluhan |
Ya |
Jumlah perlu dibayar dalam mata wang pengebilan. Hanya ditetapkan untuk baris yuran Google dan Cukai. Positif untuk jumlah yang dicaj dan negatif untuk jumlah bayaran balik atau bayaran balik separa. |
ID Kumpulan |
Integer |
Ya |
ID unik diberikan apabila kumpulan akaun pembangun dibuat. Ketahui lebih lanjut. |
1 Juta USD Pertama Layak |
Rentetan |
Ya |
Diisi hanya apabila kumpulan akaun pembangun disediakan. Ketahui lebih lanjut. |
Yuran Perkhidmatan % |
Integer |
Ya |
|
Perihalan Yuran |
Rentetan |
Ya |
Butiran diberikan untuk pengiraan yuran perkhidmatan Google. |
Perihal
Jika anda ialah pedagang yang perlu mengeluarkan resit tunai di Korea Selatan mengikut kaedah dan peraturan yang bersesuaian atau jika anda secara sukarela telah mendaftar untuk mengeluarkan resit tunai, maka anda mesti mengeluarkan resit tunai bagi pembelian apl berbayar atau pembelian produk dalam apl yang dibuat menggunakan Kad Hadiah Google Play dalam Won Korea (KRW) apabila diminta oleh pembeli apl.
Laporan pembiayaan baki Play Korea mengandungi jualan baki Play yang dibuat dalam Won Korea bagi tujuan menghantar resit tunai kepada pengguna.
Nota: Pengguna boleh menambah baki Play daripada pelbagai sumber, termasuk kredit promosi daripada Google atau rakan kongsi kami. Sebelum mengeluarkan resit tunai, penting untuk memastikan pengguna menambah baki mereka menggunakan tunai yang setara (contohnya, kad hadiah).
Perintah
gs://[developer_bucket_id]/play_balance_krw/play_balance_krw_YYYYMM.zip
Contoh
Jika anda mahu memuat turun semua laporan yang dijana pada tahun 2018 daripada id baldi laporan pubsite_prod_rev_0123456789
untuk apl anda dengan nama pakej com.example.app, perintahnya ialah:
gsutil cp -r gs://pubsite_prod_rev_0123456789/play_balance_krw/play_balance_krw_2018* /your/local/directory
Format fail
Medan | Format | Pilihan | Contoh dan nota |
---|---|---|---|
Nombor Pesanan |
Integer |
Tidak |
ID pesanan langganan merangkumi nombor kitaran pembaharuan pada penghujung (contohnya, pembaharuan pertama ialah |
Tarikh Pesanan Dicaj |
Rentetan |
Tidak |
Tarikh pesanan ini berdasarkan zon waktu UTC (dalam format HH-BB-TTTT). |
Status Kewangan |
Rentetan |
Tidak |
|
Jumlah Pembiayaan Baki Play |
Rentetan |
Tidak |
Jumlah transaksi. |
Mata Wang Baki Play | Rentetan | Tidak | KRW Untuk laporan pembiayaan baki Play Korea, rentetan ini sentiasa dalam Won Korea (KRW). |
Cap masa Pesanan Dicaj | Integer | Tidak | 1480507200
Cap masa UNIX apabila pesanan dicajkan kepada pengguna. Diukur dalam saat sejak epok. |
Langganan
Respons tinjauan pembatalanPerintah
gs://[developer_bucket_id]/subscriptions/cancellations/freeform_[package_name].csv
Format fail
Medan | Format | Pilihan | Contoh dan nota |
---|---|---|---|
Tarikh Pembatalan | Rentetan | Tidak | 30-11-2016 |
ID SKU | Rentetan | Ya | treasure_chest_for_new_users ID unik produk yang ditentukan oleh pembangun. |
Negara | Rentetan | Tidak | US, CA, dll. |
Respons | Rentetan | Tidak |
Perintah dan format fail untuk laporan agregat
Statistik
PemasanganPerintah
gs://[developer_bucket_id]/stats/installs/installs_[package_name]_yyyyMM_[dimension].csv
Format fail
Medan | Format | Pilihan | Contoh |
---|---|---|---|
Tarikh | hh-bb-TTTT | TIDAK | 19-06-2014 |
Nama Pakej | Rentetan | TIDAK | com.my.app |
Peranti (atau mana-mana dimensi lain yang disokong) | Rentetan | YA | hammerhead |
Pemasangan Peranti Semasa | integer | TIDAK | |
Pemasangan pada peranti aktif | integer | TIDAK | |
Pemasangan Peranti Harian | integer | TIDAK | |
Penyahpasangan Peranti Harian | integer | TIDAK | |
Peningkatan Peranti Harian | integer | TIDAK | |
Pemasangan Pengguna Semasa | integer | TIDAK | |
Jumlah Pemasangan Pengguna | integer | TIDAK | |
Pemasangan Pengguna Harian | integer | TIDAK | |
Penyahpasangan Pengguna Harian | integer | TIDAK |
Dimensi yang disokong
Dimensi | Nama fail |
---|---|
Kod Versi Apl | ..._app_version.csv |
Pembawa | ..._carrier.csv |
Negara | ..._country.csv |
Peranti | ..._device.csv |
Bahasa | ..._language.csv |
Versi Android OS | ..._os_version.csv |
Contoh
Jika anda mahu memuat turun semua laporan yang dijana pada tahun 2014 daripada id baldi laporan pubsite_prod_rev_0123456789
untuk apl anda dengan nama pakej com.example.app, perintahnya ialah:
gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/installs/installs_com.example.app_2014* /your/local/directory
Nota: Mulai Januari 2018, eksport merangkumi data daripada sumber data baharu dan sepadan dengan maklumat pada halaman Statistik apl anda. Eksport dari sebelum Januari 2018 tersedia untuk data yang dikumpulkan daripada sumber data sebelum ini sahaja.
Perintah
gs://[developer_bucket_id]/stats/crashes/crashes_[package_name]_yyyyMM_[dimension].csv
Format fail
Medan | Format | Pilihan | Contoh |
---|---|---|---|
Tarikh | hh-bb-TTTT | TIDAK | 19-06-2014 |
Nama Pakej | Rentetan | TIDAK | com.my.app |
Peranti (atau mana-mana dimensi lain yang disokong) | Rentetan | YA | hammerhead |
Ranap Harian | integer | TIDAK | |
ANR Harian | integer | TIDAK |
Dimensi yang disokong
Dimensi | Nama fail |
---|---|
Kod Versi Apl | ..._app_version.csv |
Peranti | ..._device.csv |
Versi Android OS | ..._os_version.csv |
Contoh
Jika anda mahu memuat turun semua laporan yang dijana pada tahun 2014 daripada id baldi laporan pubsite_prod_rev_0123456789
untuk apl anda dengan nama pakej com.example.app, perintahnya ialah:
gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/crashes/crashes_com.example.app_2014* /your/local/directory
Perintah
gs://[developer_bucket_id]/stats/ratings/ratings_[package_name]_yyyyMM_[dimension].csv
Format fail
Medan | Format | Pilihan | Contoh |
---|---|---|---|
Tarikh | hh-bb-TTTT | TIDAK | 19-06-2014 |
Nama Pakej | Rentetan | TIDAK | com.my.app |
Peranti (atau mana-mana dimensi lain yang disokong) | Rentetan | YA | hammerhead |
Penilaian Purata Harian | %.2f | YA | |
Jumlah Penilaian Purata | %.2f | Ya | 4.16 |
Dimensi yang disokong
Dimensi | Nama fail |
---|---|
Kod Versi Apl | ..._app_version.csv |
Pembawa | ..._carrier.csv |
Negara | ..._country.csv |
Peranti | ..._device.csv |
Bahasa | ..._language.csv |
Versi Android OS | ..._os_version.csv |
Contoh
Jika anda mahu memuat turun semua laporan yang dijana pada tahun 2014 daripada id baldi laporan pubsite_prod_rev_0123456789
untuk apl anda dengan nama pakej com.example.app, perintahnya ialah:
gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/ratings/ratings_com.example.app_2014* /your/local/directory
Perintah
gs://[developer_bucket_id]/financial-stats/subscriptions/subscriptions_[package_name]_[product_id]_yyyyMM_[dimension].csv
Format fail
Medan | Format | Pilihan | Contoh dan nota |
---|---|---|---|
Tarikh | HH-BB-TTTT | TIDAK |
Tarikh pesanan ini berdasarkan zon waktu UTC (dalam format HH-BB-TTTT) |
Nama Pakej | Rentetan | TIDAK | com.example.app |
ID Produk | Rentetan | TIDAK | Akses Premium |
Negara | Rentetan | TIDAK |
|
Langganan Baharu | Nombor | TIDAK | 1234 |
Langganan Dibatalkan | Nombor | TIDAK | 1234 |
Langganan Aktif | Nombor | TIDAK | 1234 |
ID Pelan Asas | Rentetan | TIDAK | mingguan |
ID Tawaran | Rentetan | TIDAK | tawaran musim bunga |
Nota: Untuk mendapatkan maklumat lanjut tentang statistik langganan baharu, dibatalkan dan aktif, pergi ke semak data hasil dan pembeli apl anda.
Dimensi yang disokong
Dimensi | Nama fail |
---|---|
Negara | ..._country.csv |
Pemerolehan Pengguna
Laporan Pemasang Kekal dan Pembeli memberikan akses programatik kepada data untuk laporan pemerolehan lama. Eksport ini telah digantikan dengan eksport programatik baharu, yang termasuk data untuk halaman Analisis gedung dan Analisis penukaran dalam Play Console. Laporan tersedia pada bulan Mac 2021.
Laporan lama telah dialih keluar pada bulan Oktober 2021.
Pastikan anda membaca Bagaimanakah cara memuat turun data pemerolehan? untuk mengetahui lebih lanjut.
Nota: Laporan Pelanggan tidak lagi disokong mulai bulan November 2019. Untuk mengetahui lebih lanjut, pastikan anda membaca tentang sumber dan metrik pemerolehan.
Pemasang Kekal (Eksport lama – tersedia hingga bulan Ogos 2021)Perintah
gs://[developer_bucket_id]/acquisition/retained_installers/retained_installers_[package_name]_yyyyMM_[dimension].csv
Format fail
Medan | Format | Pilihan | Contoh dan nota |
---|---|---|---|
Tarikh | hh-bb-TTTT | TIDAK |
Tarikh pengguna melawati penyenaraian gedung anda Nota: Menambahkan Pelawat Penyenaraian Gedung unik dalam beberapa hari akan menghasilkan jumlah Pelawat Penyenaraian Gedung yang lebih tinggi berbanding dengan yang anda lihat dalam paparan kohort mingguan atau bulanan. Paparan kohort mingguan dan bulanan mengira setiap pelawat sekali, walaupun mereka melawat berbilang kali. |
Saluran Pemerolehan | Rentetan | YA |
Ada untuk dimensi "Saluran pemerolehan" Nota: "Saluran Play Store (organik)" adalah jumlah "carian Play Store (organik)" dan "semak imbas Play Store (organik)". Untuk mengelakkan pengunjung dihitung dua kali dalam laporan ini, abaikan jumlah baris "Play Store (organik)" atau kedua-dua baris carian dan semak imbas. |
Negara | Rentetan | YA | Ada untuk dimensi "Negara" dan "Negara (organik Play Store)" |
Sumber/kempen UTM | Rentetan | YA |
Ada untuk dimensi "Saluran dijejaki (UTM)" |
Kata kunci | Rentetan | YA |
Ada untuk "Carian Play Store (organik)" |
Pelawat Penyenaraian Gedung | Integer | TIDAK | |
Pemasang | Integer | TIDAK | |
Kadar penukaran Pelawat kepada Pemasang | Perpuluhan | TIDAK | |
Penanda aras kadar penukaran median Pelawat kepada Pemasang | Perpuluhan | YA |
Tidak diisi bermula pada bulan Ogos 2019. Set penanda aras yang dikemaskinikan, yang menggunakan pengiraan baharu, tersedia pada halaman laporan Pemerolehan. Untuk mengetahui lebih lanjut, pastikan anda membaca, Perbandingan apl setara kadar penukaran untuk trafik Play Store. |
Pemasang kekal selama 1 hari | Integer | TIDAK | |
Kadar pengekalan Pemasang hingga 1 hari | Perpuluhan | TIDAK | |
Pemasang kekal selama 7 hari | Integer | TIDAK | |
Kadar pengekalan Pemasang hingga 7 hari | Perpuluhan | TIDAK | |
Pemasang kekal selama 15 hari | Integer | TIDAK | |
Kadar pengekalan Pemasang hingga 15 hari | Perpuluhan | TIDAK | |
Pemasang kekal selama 30 hari | Integer | TIDAK | |
Kadar pengekalan Pemasang hingga 30 hari | Perpuluhan | TIDAK |
Dimensi yang disokong
Dimensi | Nama fail |
---|---|
Saluran pemerolehan * | ..._channel.csv |
Negara | ..._country.csv |
Negara (organik Play Store) | ..._play_country.csv |
Carian Play Store (organik) | ..._play_search.csv |
Saluran dijejaki (UTM) | ..._utm_tagged.csv |
* Nota: Saluran "Play Store (organik)" ialah jumlah "carian Play Store (organik)" dan "semak imbas Play Store (organik)". Untuk mengelakkan pengunjung dihitung dua kali dalam laporan ini, abaikan jumlah baris "Play Store (organik)" atau kedua-dua baris carian dan semak imbas.
Dimensi Google Search (organik) tidak disokong lagi bermula pada bulan Jun 2019.
Nama CSV
Setiap fail CSV yang tersedia mengandungi data selama sebulan dan pecahan. CSV diberikan nama berstruktur yang menggambarkan pecahan tahun, bulan dan laporan yang dilitupi oleh fail tersebut, menurut corak yang berikut:
Format nama fail: store_performance_[package_name]_[yyyyMM]_[breakdown].csv
Nota:
- Nama pakej akan disertakan dalam nama fail seperti sedia ada, dengan mana-mana aksara khas, jika ada ("
.
" atau "_
"). yyyyMM
mewakili tahun dan bulan, cth.202101
.
Perintah
gs://[developer_bucket_id]/stats/store_performance/store_performance_[package_name]_[yyyyMM]_[breakdown].csv
Format fail
Medan | Format | Pilihan | Contoh | Perihalan |
---|---|---|---|---|
Tarikh | hh-bb-TTTT | TIDAK | 01-01-2021 |
Tarikh pengguna melawati penyenaraian gedung anda |
Nama pakej | Rentetan | TIDAK | com.example.app |
Nama pakej yang memiliki data laporan |
Negara/rantau | Rentetan | TIDAK | UK |
Negara atau rantau tempat akaun Google pengguna didaftarkan |
Sumber trafik | Rentetan | TIDAK | Carian Google Play |
Cara pengguna mendapatkan penyenaraian gedung anda:
Nota: Boleh jadi |
Istilah carian | Rentetan | YA | gedung apl |
Istilah yang dicari oleh pengguna sebelum menavigasi ke penyenaraian gedung anda. Tersedia untuk carian Google Play sahaja. Nota: Boleh jadi |
Sumber UTM | Rentetan | YA | google |
Nilai parameter URL utm_source dalam pautan dalam pada penyenaraian gedung anda. Tersedia untuk rujukan pihak ketiga sahaja Nota: Boleh jadi |
Kempen UTM | Rentetan | YA | kempen |
Nilai parameter URL utm_campaign dalam pautan dalam pada penyenaraian gedung anda. Tersedia untuk rujukan pihak ketiga sahaja. Nota: Boleh jadiLain-lain jika nilai ini tidak mencapai ambang minimum tertentu |
Pemerolehan penyenaraian gedung | Integer | TIDAK | 10 |
Bilangan pengguna yang telah melawati penyenaraian gedung anda dan memasang apl anda dan pengguna ini tidak memasang apl anda pada mana-mana peranti lain pada masa itu |
Pelawat penyenaraian gedung | Integer | TIDAK | 100 |
Bilangan pengguna yang telah melawati penyenaraian gedung anda, namun belum memasang apl anda pada mana-mana peranti mereka |
Kadar penukaran penyenaraian gedung | Perpuluhan | TIDAK | 0.1 |
Peratusan pelawat penyenaraian gedung yang memasang apl anda Nota: Tidak termasuk lawatan atau pemasangan daripada pengguna yang sudah memasang apl anda pada peranti lain |
Struktur pecahan yang tersedia
Pecahan yang berikut tersedia:
Nama pecahan | Medan dalam setiap CSV (dalam tertib): |
---|---|
Contoh nama fail:
|
Tarikh, Nama pakej, Negara, Pemerolehan penyenaraian gedung, Pelawat penyenaraian gedung, Kadar penukaran penyenaraian gedung |
Contoh nama fail:
|
Tarikh, Nama pakej, Sumber trafik, Istilah carian, Sumber UTM, Kempen UTM, Pemerolehan penyenaraian gedung, Pelawat penyenaraian gedung, Kadar penukaran penyenaraian gedung |
Lupakan skim
- Gandakan sebarang tanda petikan. (
"
->""
) - Jika sel mengandungi mana-mana tab, baris baharu, tanda petikan atau koma, letakkan tanda petikan di sekitar sel. (
...
->"..."
)
Contoh
Jika anda mahu memuat turun semua laporan yang dijana pada tahun 2020 daripada ID baldi laporan pubsite_prod_0123456789
untuk apl anda dengan nama pakej com.example.app
, perintah untuk perkara itu ialah
gsutil cp -r gs://pubsite_prod_0123456789/stats/store_performance/store_performance_com.example.app_2020* /your/local/directory
Perintah
gs://[developer_bucket_id]/acquisition/buyers_7d/buyers_7d_[package_name]_yyyyMM_[dimension].csv
Format fail
Medan | Format | Pilihan | Contoh dan nota |
---|---|---|---|
Tarikh | hh-bb-TTTT | TIDAK |
Tarikh pengguna melawati penyenaraian gedung anda Nota: Menambahkan Pelawat Penyenaraian Gedung unik dalam beberapa hari akan menghasilkan jumlah Pelawat Penyenaraian Gedung yang lebih tinggi berbanding dengan yang anda lihat dalam paparan kohort mingguan atau bulanan. Paparan kohort mingguan dan bulanan mengira setiap pelawat sekali, walaupun mereka melawat berbilang kali. |
Saluran Pemerolehan | Rentetan | YA |
Ada untuk dimensi "Saluran pemerolehan" Nota: "Saluran Play Store (organik)" adalah jumlah "carian Play Store (organik)" dan "semak imbas Play Store (organik)". Untuk mengelakkan pengunjung dihitung dua kali dalam laporan ini, abaikan jumlah baris "Play Store (organik)" atau kedua-dua baris carian dan semak imbas. |
Negara | Rentetan | YA | Ada untuk dimensi "Negara" dan "Negara (organik Play Store)" |
Sumber/kempen UTM | Rentetan | YA | Ada untuk dimensi "Saluran dijejaki (UTM)" |
Kata kunci | Rentetan | YA |
Ada untuk "Carian Play Store (organik)" |
Pelawat Penyenaraian Gedung | Integer | TIDAK | |
Pemasang | Integer | TIDAK | |
Kadar penukaran Pelawat kepada Pemasang | Perpuluhan | TIDAK | |
Penanda aras kadar penukaran median Pelawat kepada Pemasang | Perpuluhan | YA |
Tidak diisi bermula pada bulan Ogos 2019. Set penanda aras yang dikemas kini, yang menggunakan pengiraan baharu, tersedia pada halaman laporan Pemerolehan. Untuk mengetahui lebih lanjut, pastikan anda membaca, Perbandingan apl setara kadar penukaran untuk trafik Play Store. |
Pembeli | Integer | TIDAK | |
Kadar penukaran Pemasang kepada Pembeli | Perpuluhan | TIDAK | |
Pembeli Berulang | Integer | TIDAK | |
Kadar penukaran Pemasang kepada Pembeli Berulang | Perpuluhan | TIDAK | |
Kadar penukaran Pembeli kepada Pembeli Berulang | Integer | TIDAK |
Dimensi yang disokong
Dimensi | Nama fail |
---|---|
Saluran pemerolehan * | ..._channel.csv |
Negara |
..._country.csv |
Negara (organik Play Store) |
..._play_country.csv |
Carian Play Store (organik) | ..._play_search.csv |
Saluran dijejaki (UTM) | ..._utm_tagged.csv |
* Nota: Saluran "Play Store (organik)" ialah jumlah "carian Play Store (organik)" dan "semak imbas Play Store (organik)". Untuk mengelakkan pengunjung dihitung dua kali dalam laporan ini, abaikan jumlah baris "Play Store (organik)" atau kedua-dua baris carian dan semak imbas.
Dimensi Google Search (organik) tidak disokong lagi bermula pada bulan Jun 2019.