أنواع التقارير
التقارير التفصيليةتتضمّن التقارير التفصيلية بيانات عن أحداث فردية:
- المراجعات
- التقارير المالية: المبيعات المقدّرة والأرباح والهدايا وتمويل الرصيد على Play في كوريا
تتضمّن التقارير المجمّعة بيانات موحّدة (المتوسطات والإجماليات اليومية وما إلى ذلك) تخص إحصاءات التطبيق:
- الإحصاءات: عمليات التثبيت والأعطال والتقييمات والاشتراكات
- اكتساب المستخدمين: المستخدمون الذين احتفظوا بالتطبيق مثبّتًا والمشترون (بعد 7 أيام من التثبيت) والمشتركون
تنزيل التقارير
- افتح Play Console.
- انقر على تنزيل التقارير ، ثم اختَر المراجعات أو الإحصاءات أو التقارير المالية.
- ضمن "اختيار تطبيق"، اكتب اسم التطبيق واختَره.
- اختَر السنة والشهر اللذين تريد تنزيل التقرير فيهما.
ملاحظة: تتضمّن التقارير المالية جميع التطبيقات المتوفّرة في حسابك.
تنزيل التقارير من Google Cloud Storage
تتوفّر التقارير من خلال خدمة Google Cloud Storage. ويتم إنشاء التقارير يوميًا وتجميعها في ملفات CSV شهرية. ويتم تخزينها في حزمة خاصة بخدمة Google Cloud Storage لحسابك كمطوِّر على Google Play.
يمكنك الوصول إلى التقارير من خلال خدمة Google Cloud Storage على متصفّحك أو آليًا باستخدام أداة gsutil. ويمكنك أيضًا استخدام أدوات أخرى للوصول إلى حزمة Cloud Storage آليًا.
ملاحظة: إذا كنت تريد استيراد التقارير من Google Cloud Storage إلى BigQuery، عليك تحويل ملفات CSV من UTF-16
إلى UTF-8
.
العثور على معرّف الموارد المنتظم (URI) لخدمة Google Cloud Storage
يمكنك نسخ معرّف الموارد المنتظم (URI) لخدمة Google Cloud Storage من خلال النقر على الزر نسخ معرّف الموارد المنتظم (URI) لخدمة Cloud Storage بجانب عنوان القسم ذي الصلة في صفحات تنزيل التقارير.
يُزوَّد معرّف الموارد المنتظم (URI) لخدمة Cloud Storage ببادئة pubsite_prod_rev
(على سبيل المثال، pubsite_prod_rev_01234567890987654321
).
- ثبِّت أداة gsutil.
- يجب مصادقة حسابك باستخدام حساب تتوفّر له إمكانية الوصول إلى Play Console.
- أثناء عملية الإعداد، يمكنك كتابة اسم تطبيقك عندما يُطلب منك إدخال رقم تعريف المشروع، وذلك إذا كنت تستخدم أداة gsutil لأول مرة ولم تضبط أي مشاريع أخرى في Google Cloud Storage.
- ابحث عن رقم تعريف حزمة إعداد التقارير عن طريق النقر على الزر نسخ معرِّف الموارد المنتظم (URI) لخدمة Cloud Storage بجانب عنوان القسم ذي الصلة في صفحات تنزيل التقارير.
- يُزوَّد معرّف الموارد المنتظم (URI) لخدمة Cloud Storage ببادئة
pubsite_prod_rev
(على سبيل المثال،pubsite_prod_rev_01234567890987654321
).
- يُزوَّد معرّف الموارد المنتظم (URI) لخدمة Cloud Storage ببادئة
- استخدِم الأمر
gsutil cp
لتنزيل التقارير.- من أجل تنفيذ أوامر إضافية لمساعدتك في الوصول إلى تقاريرك، انتقِل إلى وثائق أداة gsutil.
تُنظَّم التقارير في أدلة تحمل اسم كلّ نوع من أنواع التقارير. وتشتمل أسماء ملفات CSV على نوع التقرير واسم الحزمة والفترة الزمنية والسمة (إنْ وُجدت).
الخطوة 1: إنشاء حساب خدمة
- افتح أداة Google Developers Console.
- إذا كان لديك مشروع، استخدِم القائمة المنسدلة لاختيار مشروع. وفي حال لم يكن لديك مشروع مُدرَج أو أردت إنشاء مشروع جديد، انقر على إنشاء مشروع.
- اختَر رمز القائمة > الأذونات > حسابات الخدمة > إنشاء حساب خدمة.
- اتّبِع التعليمات الظاهرة على الشاشة واختَر إنشاء.
- انسخ عنوان البريد الإلكتروني المدرَج.
- مثال:
accountName@project.iam.gserviceaccount.com
- مثال:
الخطوة 2: إضافة حساب الخدمة على Play Console
- افتح Play Console.
- انقر على رمز الإعدادات > حسابات وحقوق المستخدم > دعوة مستخدم جديد.
- الصِق عنوان البريد الإلكتروني المرتبط بحساب الخدمة أو اكتبه.
- اختَر الأذونات استنادًا إلى أنواع التقارير المطلوبة.
- ملاحظة: يمكنك الاطّلاع على مقالة إضافة مستخدمي حساب المطوِّر وإدارة الأذونات للتعرُّف على مختلَف مستويات الوصول المتاحة للمستخدمين والحقوق التي تمنحها لهم الأذونات المختلفة.
- انقر على إضافة مستخدم. وستتم إضافة حساب الخدمة إلى حسابك.
الخطوة 3: استرجاع التقارير باستخدام طلب بيانات من واجهة برمجة التطبيقات
- ثبِّت مكتبة برامج واجهة برمجة التطبيقات من أجل استخدام لغة الرمز البرمجي المفضّلة لديك.
- عليك إعداد الرمز البرمجي الذي ينفّذ طلب بيانات من واجهة برمجة التطبيقات لاستخدام مصادقة
OAuth2
من خادم إلى خادم ولطلب إذن بالوصول إلى نطاقOAuth2
(https://www.googleapis.com/auth/devstorage.read_only ). - عليك إصدار طلبات بيانات من واجهة برمجة التطبيقات التي تمت مصادقتها لاسترجاع التقارير.
إذا كنت قد استخدمت Python لاسترجاع التقارير، إليك مثال على الرمز البرمجي:
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()
التحكُّم في الوصول إلى خدمة Google Cloud Storage
تستخدم التقارير المتوفّرة على Google Cloud Storage حدود الوصول نفسها التي تتحكّم بالوصول إلى البيانات في Play Console. ويعني هذا أنّ مستخدمي الحساب الذين لديهم إذن الوصول إلى أقسام في حساب Play Console يمكنهم الوصول إلى التقارير ذات الصلة في Google Cloud Storage.
يمكن لأصحاب الحسابات تعديل أذونات المستخدمين الفرديين في أي وقت.
- للوصول إلى التقارير المجمّعة، يجب ضبط إذن "عرض معلومات التطبيق" على "عام".
- لتنزيل التقارير المالية، يجب ضبط إذن "عرض البيانات المالية" على "عام".
الأوامر وتنسيقات الملفات التي تخص التقارير التفصيلية
الأعطال و أخطاء ANR
منذ أيار (مايو) 2018، لم يعُد بإمكانك تنزيل التقارير التفصيلية عن الأعطال وأخطاء ANR.
المراجعات
Command
gs://[developer_bucket_id]/reviews/reviews_[package_name]_YYYYMM.csv
File format
Field | Format | Optional | Examples and notes |
---|---|---|---|
Package Name | String | NO | com.company.app |
App Version Code | integer | YES | Production APKs only |
App Version Name | String | YES | |
Reviewer Language | String - ISO 639-1 two-letter abbreviation | YES | en |
Device | String | YES | hammerhead |
Review Submit Date and Time | ISO_8601 including time, UTC timezone | NO | 2014-06-19T19:12:32Z |
Review Submit Millis Since Epoch | integer, milliseconds since epoch | NO | |
Review Last Update Date and Time | ISO_8601 including time, UTC timezone | YES | 2014-06-19T19:12:32Z |
Review Last Update Millis Since Epoch | integer, milliseconds since epoch | YES | |
Star Rating | integer (between 1 and 5) | NO | |
Review Title | String, in the reviewer's local language (stripping newlines) | YES | |
Review Text | String, in the reviewer's local language (stripping newlines) | YES | |
Developer Reply Date and Time | ISO_8601 including time, UTC timezone | YES | 2014-06-19T19:12:32Z |
Developer Reply Millis Since Epoch | integer, milliseconds since epoch | YES | |
Developer Reply Text | String (stripping newlines and compressing whitespace) | YES | |
Review Link | String | YES | https://play.google.com/apps/publish/?dev_acc=<...>#ReviewPlace:id=<..> |
Example
If you want to download all reports generated in 2014 from the report bucket id pubsite_prod_rev_0123456789
for your app with the package name com.example.app, the command is:
gsutil cp -r gs://pubsite_prod_rev_0123456789/reviews/reviews_com.example.app_2014* /your/local/directory
Financial reports
Estimated salesWe recommend that you don’t rely on the number of columns in the CSV files for your automated reports.
About
You can use the estimated sales report to view low latency information about app, in-app product, or subscription sales. This report contains the amount paid by buyers and doesn't deduct taxes or Google fees from the totals.
You can use this report for analytics or trend analysis, but it's not recommended for accounting. Instead, see the Earnings report.
You may notice differences between this report and your earnings for a number of reasons. For example, the estimated sales report doesn't take into account withholding taxes or chargebacks. This report contains amounts paid by buyers in their local currency and doesn't contain converted amounts in your payout currency.
Command
gs://[developer_bucket_id]/sales/salesreport_YYYYMM.zip
Example
If you want to download all reports generated in 2014 from the report bucket id pubsite_prod_rev_0123456789
for your app with the package name com.example.app, the command is:
gsutil cp -r gs://pubsite_prod_rev_0123456789/sales/salesreport_2014* /your/local/directory
File format
Field | Format | Optional | Examples and notes |
---|---|---|---|
Order Number |
String |
No |
Subscription order IDs include the renewal cycle number at the end (for example, the first renewal is |
Order Charged Date |
String |
No |
Date of this order based on the UTC time zone (in YYYY-MM-DD format). |
Order Charged Timestamp |
Integer |
No |
The UNIX timestamp when the order was charged to the user. Measured in seconds since epoch. |
Financial Status |
String |
No |
If you fully refund an order after issuing a partial refund:
|
Device Model |
String |
No |
Android device model used to make the purchase. For subscription orders, this refers to the device used for the original purchase. |
Product Title |
String |
No |
Developer-specified name of the product. Displayed in the buyer's locale. |
Product ID |
String |
No |
Package name of the app where the product was sold. |
Product Type |
String |
No |
|
SKU ID |
String |
No |
Developer-specified unique ID of the product. |
Currency of Sale |
String |
No |
|
Item Price |
Integer |
No |
Shown in the buyer's local currency. With “,” as a thousands separator. |
Taxes Collected |
Integer |
Yes |
In the buyer's local currency. With “,” as a thousands separator. |
Charged Amount |
Integer |
No |
In the buyer's local currency. This is the sum of the item price and taxes collected. With “,” as a thousands separator. |
City of Buyer |
String |
Yes |
Only populated for sales where you are the merchant of record. |
State of Buyer |
String |
Yes |
|
Postcode of Buyer |
String |
Yes |
Only populated for sales where you are the merchant of record. |
Country of Buyer |
String |
No |
|
Base Plan ID |
String |
Yes |
The base plan ID of the subscription. Only populated for subscriptions. Learn more |
Offer ID |
String |
Yes |
The offer ID of the subscription. Only populated for subscriptions. Learn more |
Group ID | Integer | Yes |
Unique ID is given when a developer account group is created. Learn more. |
First USD 1M Eligible | String | Yes |
Populated only when a developer account group is set up. Learn more |
Promotion ID | String | Yes |
|
Coupon Value | Integer | Yes |
Shown in the buyer’s local currency. With “,” as a thousands separator. Only populated for sales related to Play Points coupons. Learn more |
Discount Rate | Integer | Yes |
% discount rate used to specify the saving made by the user by spending Play Points compared to spending money. Only populated for sales related to Play Points. Learn more |
Featured Products ID |
Integer |
Yes |
Unique ID is given when a developer creates a featured product. Learn more |
We recommend that you don’t rely on the number of columns in the CSV files for your automated reports.
About
You can use the earnings report to understand your payout and transactions. Each line in the report represents a type of transaction, like when you charge a customer money or pay Google a fee, along with the original and converted amounts.
Earnings reports contain transactions from the prior month. You'll receive the payout several weeks after the earnings report becomes available.
The earnings report is generated once per month, and is typically available by the 5th of the following month. Occasionally, Google may make adjustments to your earnings to correct miscalculations. If this happens, we'll contact you to inform you of the issue and create an additional Earnings file containing only the adjusted transactions for your records.
Notes:
- Google fees are now visible for all transactions, regardless of whether Google is Merchant of Record for products sold.
- The earnings report does not include chargebacks.
- A single file is generated for the earning report for transactions each month.
- Taiwan withholding tax is paid out in the prior month to when it’s reported
Command
gs://[developer_bucket_id]/earnings/earnings_YYYYMM.zip
Example
If you want to download all reports generated in 2014 from the report bucket id pubsite_prod_rev_0123456789
for your app with the package name com.example.app, the command is:
gsutil cp -r gs://pubsite_prod_rev_0123456789/earnings/earnings_2014* /your/local/directory
File format
Field | Format | Optional | Examples and notes |
---|---|---|---|
Description |
String |
No |
Subscription order IDs include the renewal cycle number at the end (for example, the first renewal is |
Transaction Date |
String |
No |
Date of this order based on the Pacific Time Zone (in MMM DD, YYYY format). Note that the transaction timestamp may have the following month recorded since reports are generated by issue timestamp. |
Transaction Time |
String |
No |
|
Tax Type |
String |
Yes |
Blank for non-tax lines. |
Transaction Type |
String |
No |
|
Refund Type |
String |
Yes |
Refunds where the buyer was reimbursed their full spend will be marked as 'Full'. Refunds for part of a user’s payment amount will be marked as 'Partial'. |
Product Title |
String |
No |
Developer-specified name of the product. Shown in the buyer's locale. |
Product ID |
String |
No |
Package name of the app where the product was sold. |
Product Type |
Integer |
No |
Used to identify the type of product sold. '0' represents the sale of a paid app, '1' represents the sale of an in-app product or subscription. |
SKU ID |
String |
No |
Developer-specified unique ID of the product. |
Hardware |
String |
No |
Android device model used to make the purchase. For subscription orders, this refers to the model used for the original purchase. |
Buyer Country |
String |
No |
|
Buyer State |
String |
Yes |
|
Buyer Postcode |
String |
Yes |
|
Buyer Currency |
String |
No |
|
Amount (Buyer Currency) |
Integer |
No |
Total amount for this invoice line before currency conversion. |
Currency Conversion Rate |
Integer |
No |
Exchange rate used when converting buyer amounts to payout amounts in merchant currency. |
Merchant Currency | String | No |
Currency to which the order was converted. This is the local currency you are paid in. |
Amount (Merchant Currency) | Integer | No |
Total amount for this invoice line after currency conversion. |
Base Plan ID |
String |
Yes |
The base plan ID of the subscription. Only populated for subscriptions. Learn more |
Offer ID |
String |
Yes |
The offer ID of the subscription. Only populated for subscriptions. Learn more |
Group ID | Integer | Yes |
Unique ID is given when a developer account group is created. Learn more. |
First USD 1M Eligible | String | Yes |
Populated only when a developer account group is set up. Learn more |
Service Fee % |
Integer |
Yes |
|
Fee Description | String | Yes |
Detail given for the Google service fee calculation. |
Promotion ID | String | Yes |
|
لمحة
إذا كنت تاجرًا مطالَبًا بإصدار إيصالات نقدية في كوريا الجنوبية بموجب القواعد واللوائح التنظيمية السارية أو إذا تطوّعت بالتسجيل لإصدار إيصالات نقدية، عليك في هذه الحالة إصدار إيصالات نقدية عند طلب مشتري التطبيق الحصول على تطبيق مدفوع أو إجراء عمليات شراء لمنتجات داخل التطبيق باستخدام بطاقات هدايا Google Play بعملة الوون الكوري (KRW).
إنّ تقرير تمويل الرصيد على Play في كوريا يحتوي على المبيعات من رصيد Play التي تم إجراؤها بعملة الوون الكوري بغرض إرسال إيصال نقدي إلى المستخدم.
ملاحظة: يمكن للمستخدمين إضافة رصيد في Play من مصادر متعددة، بما في ذلك الرصيد الترويجي من Google أو شركائنا. وقبل إصدار إيصال نقدي، من المهم التأكد من أنّ المستخدم أضاف قيمة الإيصال إلى رصيده باستخدام معادل نقدي (على سبيل المثال، بطاقة هدايا).
الأمر
gs://[developer_bucket_id]/play_balance_krw/play_balance_krw_YYYYMM.zip
مثال
إذا كنت تريد تنزيل جميع التقارير التي تم إنشاؤها في عام 2018 من معرّف حزمة التقارير pubsite_prod_rev_0123456789
لتطبيقك الذي يحمل اسم الحزمة com.example.app، يمكنك استخدام الأمر التالي:
gsutil cp -r gs://pubsite_prod_rev_0123456789/play_balance_krw/play_balance_krw_2018* /your/local/directory
تنسيق الملف
الحقل | التنسيق | اختياري | أمثلة وملاحظات |
---|---|---|---|
رقم الطلب |
عدد صحيح |
لا |
تشتمل معرّفات طلبات الاشتراك على رقم دورة التجديد في نهاية المدة (على سبيل المثال، تكون أول دورة تجديد |
تاريخ تحصيل رسوم الطلب |
سلسلة |
لا |
يستند تاريخ هذا الطلب إلى المنطقة الزمنية حسب التوقيت العالمي المنسَّق (بالتنسيق YYYY-MM-DD). |
الحالة المالية |
سلسلة |
لا |
|
مبلغ التمويل من الرصيد في Play |
سلسلة |
لا |
مبلغ العملية |
عملة الرصيد في Play | سلسلة | لا | الوون الكوري (KRW) في ما يتعلّق بتقارير تمويل الرصيد على Play في كوريا، يتم استخدام الوون الكوري (KRW). |
الطابع الزمني لتحصيل رسوم الطلب | عدد صحيح | لا | 1480507200
الطابع الزمني لنظام التشغيل UNIX عندما تم تحصيل رسوم الطلب من المستخدم. ويتم قياسه بالثواني منذ تاريخ بدء حساب الفترة. |
الاشتراكات
الردود على استطلاع أسباب الإلغاءالأمر
gs://[developer_bucket_id]/subscriptions/cancellations/freeform_[package_name].csv
تنسيق الملف
الحقل | التنسيق | اختياري | أمثلة وملاحظات |
---|---|---|---|
تاريخ الإلغاء | سلسلة | لا | 2016-11-30 |
معرّف رمز التخزين التعريفي | سلسلة | نعم | treasure_chest_for_new_users معرّف فريد للمنتج يحدّده المطوِّر |
البلد | سلسلة | لا | الولايات المتحدة وكندا وما إلى ذلك |
الردّ | سلسلة | لا |
الأوامر وتنسيقات الملفات التي تخص التقارير المجمَّعة
الإحصاءات
عمليات التثبيتالأمر
gs://[developer_bucket_id]/stats/installs/installs_[package_name]_yyyyMM_[dimension].csv
تنسيق الملف
الحقل | التنسيق | اختياري | مثال |
---|---|---|---|
التاريخ | YYYY-mm-dd | لا | 2014-06-19 |
اسم الحزمة | سلسلة | لا | com.my.app |
الجهاز (أو أي سمة أخرى متوافقة) | سلسلة | نعم | hammerhead |
عمليات التثبيت الحالية على الأجهزة | عدد صحيح | لا | |
عمليات التثبيت على الأجهزة النشطة | عدد صحيح | لا | |
عمليات التثبيت على الأجهزة يوميًا | عدد صحيح | لا | |
عمليات إلغاء التثبيت من الأجهزة يوميًا | عدد صحيح | لا | |
عمليات الترقية على الأجهزة يوميًا | عدد صحيح | لا | |
عمليات التثبيت الحالية التي أجراها المستخدمون | عدد صحيح | لا | |
إجمالي عمليات التثبيت التي أجراها المستخدمون | عدد صحيح | لا | |
عمليات التثبيت التي أجراها المستخدمون يوميًا | عدد صحيح | لا | |
عمليات إلغاء التثبيت التي أجراها المستخدمون يوميًا | عدد صحيح | لا |
السمات المتوافقة
السمة | اسم الملف |
---|---|
رمز إصدار التطبيق | ..._app_version.csv |
مشغِّل شبكة الجوّال | ..._carrier.csv |
البلد | ..._country.csv |
الجهاز | ..._device.csv |
اللغة | ..._language.csv |
إصدار نظام التشغيل Android | ..._os_version.csv |
مثال
إذا كنت تريد تنزيل جميع التقارير التي تم إنشاؤها في عام 2014 من معرّف حزمة التقارير pubsite_prod_rev_0123456789
لتطبيقك الذي يحمل اسم الحزمة com.example.app، يمكنك استخدام الأمر التالي:
gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/installs/installs_com.example.app_2014* /your/local/directory
ملاحظة: منذ كانون الثاني (يناير) 2018، أصبحت عمليات التصدير تتضمّن بيانات من مصدر البيانات الجديد وتتطابق مع المعلومات الواردة في صفحة الإحصاءات على تطبيقك. لا تتوفّر عمليات التصدير قبل كانون الثاني (يناير) 2018 إلا للبيانات المجمَّعة من مصدر البيانات السابق.
الأمر
gs://[developer_bucket_id]/stats/crashes/crashes_[package_name]_yyyyMM_[dimension].csv
تنسيق الملف
الحقل | التنسيق | اختياري | مثال |
---|---|---|---|
التاريخ | YYYY-mm-dd | لا | 2014-06-19 |
اسم الحزمة | سلسلة | لا | com.my.app |
الجهاز (أو أي سمة أخرى متوافقة) | سلسلة | نعم | hammerhead |
حالات التعطُّل اليومية | عدد صحيح | لا | |
أخطاء ANR اليومية | عدد صحيح | لا |
السمات المتوافقة
السمة | اسم الملف |
---|---|
رمز إصدار التطبيق | ..._app_version.csv |
الجهاز | ..._device.csv |
إصدار نظام التشغيل Android | ..._os_version.csv |
مثال
إذا كنت تريد تنزيل جميع التقارير التي تم إنشاؤها في عام 2014 من معرّف حزمة التقارير pubsite_prod_rev_0123456789
لتطبيقك الذي يحمل اسم الحزمة com.example.app، يمكنك استخدام الأمر التالي:
gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/crashes/crashes_com.example.app_2014* /your/local/directory
الأمر
gs://[developer_bucket_id]/stats/ratings/ratings_[package_name]_yyyyMM_[dimension].csv
تنسيق الملف
الحقل | التنسيق | اختياري | مثال |
---|---|---|---|
التاريخ | YYYY-mm-dd | لا | 2014-06-19 |
اسم الحزمة | سلسلة | لا | com.my.app |
الجهاز (أو أي سمة أخرى متوافقة) | سلسلة | نعم | hammerhead |
متوسط التقييم اليومي | 2f.% | نعم | |
إجمالي متوسط التقييم | 2f.% | نعم | 4.16 |
السمات المتوافقة
السمة | اسم الملف |
---|---|
رمز إصدار التطبيق | ..._app_version.csv |
مشغِّل شبكة الجوّال | ..._carrier.csv |
البلد | ..._country.csv |
الجهاز | ..._device.csv |
اللغة | ..._language.csv |
إصدار نظام التشغيل Android | ..._os_version.csv |
مثال
إذا كنت تريد تنزيل جميع التقارير التي تم إنشاؤها في عام 2014 من معرّف حزمة التقارير pubsite_prod_rev_0123456789
لتطبيقك الذي يحمل اسم الحزمة com.example.app، يمكنك استخدام الأمر التالي:
gsutil cp -r gs://pubsite_prod_rev_0123456789/stats/ratings/ratings_com.example.app_2014* /your/local/directory
الأمر
gs://[developer_bucket_id]/financial-stats/subscriptions/subscriptions_[package_name]_[product_id]_yyyyMM_[dimension].csv
تنسيق الملف
الحقل | التنسيق | اختياري | أمثلة وملاحظات |
---|---|---|---|
التاريخ | YYYY-MM-DD | لا |
يستند تاريخ هذا الطلب إلى المنطقة الزمنية حسب التوقيت العالمي المنسَّق (بالتنسيق YYYY-MM-DD). |
اسم الحزمة | سلسلة | لا | com.example.app |
معرّف المنتج | سلسلة | لا | الوصول برسوم إضافية |
البلد | سلسلة | لا |
|
الاشتراكات الجديدة | الرقم | لا | 1234 |
الاشتراكات التي تم إلغاؤها | الرقم | لا | 1234 |
الاشتراكات النشطة | الرقم | لا | 1234 |
معرّف الخطة الأساسية | سلسلة | لا | أسبوعية |
معرّف العرض الترويجي | سلسلة | لا | عرض ترويجي في موسم الربيع |
ملاحظة: لمزيد من المعلومات عن إحصاءات الاشتراكات الجديدة والملغاة والنشطة، انتقِل إلى موضوع مراجعة بيانات الأرباح والمشترين التي تخص تطبيقك.
السمات المتوافقة
السمة | اسم الملف |
---|---|
البلد | ..._country.csv |
User Acquisition
The Retained Installers and Buyers reports provide programmatic access to data for the old acquisition report. This export has been replaced by a new programmatic export, which includes data for the Store analysis and Conversion analysis pages in Play Console. It became available in March 2021.
The old reports were removed in October 2021.
Make sure to read How do I download acquisition data? to know more.
Note: The Subscribers report is no longer supported as of November 2019. To know more, make sure to read about acquisition sources and metrics.
Retained Installers (Old export – available until August 2021)Command
gs://[developer_bucket_id]/acquisition/retained_installers/retained_installers_[package_name]_yyyyMM_[dimension].csv
File format
Field | Format | Optional | Examples and notes |
---|---|---|---|
Date | YYYY-mm-dd | NO |
Date the user visited your store listing Note: Adding unique Store Listing Visitors across several days will result in a higher number of Store Listing Visitors than what you see in weekly or monthly cohort views. Weekly and monthly cohort views count each visitor once, even if they visit multiple times. |
Acquisition Channel | String | YES |
Present for "Acquisition channel" dimension Note: "Play Store (organic)" channel is the sum of "Play Store (organic) search" and "Play Store (organic) browse." To avoid double-counting visitors in this report, ignore either the total "Play Store (organic)" row or both search and browse rows. |
Country | String | YES | Present for "Country" and "Country (Play Store organic)" dimensions |
UTM source/campaign | String | YES |
Present for "Tracked channels (UTM)" dimension |
Keyword | String | YES |
Present for "Play Store Search (organic)" |
Store Listing Visitors | Integer | NO | |
Installers | Integer | NO | |
Visitor-to-Installer conversion rate | Decimal | NO | |
Median Visitor to Installer conversion rate benchmark | Decimal | YES |
Not populated as of August 2019. An updated set of benchmarks, using a new calculation, is available on the Acquisition reports page. To know more, make sure to read, Conversion rate peer comparison for Play Store traffic. |
Installers retained for 1 day | Integer | NO | |
Installer-to-1 day retention rate | Decimal | NO | |
Installers retained for 7 days | Integer | NO | |
Installer-to-7 days retention rate | Decimal | NO | |
Installers retained for 15 days | Integer | NO | |
Installer-to-15 days retention rate | Decimal | NO | |
Installers retained for 30 days | Integer | NO | |
Installer-to-30 days retention rate | Decimal | NO |
Supported dimensions
Dimension | File name |
---|---|
Acquisition channel * | ..._channel.csv |
Country | ..._country.csv |
Country (Play Store organic) | ..._play_country.csv |
Play Store (organic) search | ..._play_search.csv |
Tracked channels (UTM) | ..._utm_tagged.csv |
* Note: The "Play Store (organic)" channel is the sum of "Play Store (organic) search" and "Play Store (organic) browse." To avoid double-counting visitors in this report, ignore either the total "Play Store (organic)" row or both search and browse rows.
The Google Search (organic) dimension is no longer supported as of June 2019.
CSV names
Each CSV file available contains data for one month and a breakdown. CSVs are given structured names that reflect which year, month, and report breakdown they cover, according to the following pattern:
File name format: store_performance_[package_name]_[yyyyMM]_[breakdown].csv
Notes:
- The package name will be included in the file name as is, with any special characters if present ("
.
" or "_
"). yyyyMM
represents the year and month, e.g.202101
.
Command
gs://[developer_bucket_id]/stats/store_performance/store_performance_[package_name]_[yyyyMM]_[breakdown].csv
File format
Field | Format | Optional | Example | Description |
---|---|---|---|---|
Date | YYYY-mm-dd | NO | 2021-01-01 |
Date the user visited your store listing |
Package name | String | NO | com.example.app |
The package name owning the report data |
Country/region | String | NO | UK |
The country or region where the user’s Google account is registered |
Traffic source | String | NO | Google Play search |
How the user got to your store listing:
Note: Can be |
Search term | String | YES | app store |
The term the user searched for before navigating to your store listing. Only available for Google Play search. Note: Can be |
UTM source | String | YES | google |
The value of the utm_source URL parameter in deep links to your store listing. Only available for third-party referrals Note: Can be |
UTM campaign | String | YES | campaign |
The value of the utm_campaign URL parameter in deep links to your store listing. Only available for third-party referrals. Note: Can beOther if this value does not reach certain minimum thresholds |
Store listing acquisitions | Integer | NO | 10 |
The number of users who visited your store listing and installed your app, who didn’t have it installed on any other devices at the time |
Store listing visitors | Integer | NO | 100 |
The number of users who visited your store listing who didn’t already have your app installed on any of their devices |
Store listing conversion rate | Decimal | NO | 0.1 |
The percentage of store listing visitors who installed your app Note: Does not include visits or installs from users who already have your app installed on another device |
Available breakdown structure
The following breakdowns are available:
Breakdown name | Fields in each CSV (in order): |
---|---|
Example file name:
|
Date, Package name, Country, Store listing acquisitions, Store listing visitors, Store listing conversion rate |
Example file name:
|
Date, Package name, Traffic source, Search term, UTM source, UTM campaign, Store listing acquisitions, Store listing visitors, Store listing conversion rate |
Escaping scheme
- Double up any doublequotes. (
"
->""
) - If a cell contains any tabs, newlines, doublequotes, or commas, put doublequotes around the cell. (
...
->"..."
)
Example
If you want to download all reports generated in 2020 from the report bucket id pubsite_prod_0123456789
for you app with the package name com.example.app
, the command is
gsutil cp -r gs://pubsite_prod_0123456789/stats/store_performance/store_performance_com.example.app_2020* /your/local/directory
Command
gs://[developer_bucket_id]/acquisition/buyers_7d/buyers_7d_[package_name]_yyyyMM_[dimension].csv
File format
Field | Format | Optional | Examples and notes |
---|---|---|---|
Date | YYYY-mm-dd | NO |
Date the user visited your store listing Note: Adding unique Store Listing Visitors across several days will result in a higher number of Store Listing Visitors than what you see in weekly or monthly cohort views. Weekly and monthly cohort views count each visitor once, even if they visit multiple times. |
Acquisition Channel | String | YES |
Present for "Acquisition channel" dimension Note: "Play Store (organic)" channel is the sum of "Play Store (organic) search" and "Play Store (organic) browse." To avoid double-counting visitors in this report, ignore either the total "Play Store (organic)" row or both search and browse rows. |
Country | String | YES | Present for "Country" and "Country (Play Store organic)" dimensions |
UTM source/campaign | String | YES | Present for "Tracked channels (UTM)" dimension |
Keyword | String | YES |
Present for "Play Store Search (organic)" |
Store Listing Visitors | Integer | NO | |
Installers | Integer | NO | |
Visitor to Installer conversion rate | Decimal | NO | |
Median Visitor to Installer conversion rate benchmark | Decimal | YES |
Not populated as of August 2019. An updated set of benchmarks, using a new calculation, is available on the Acquisition reports page. To know more, make sure to read, Conversion rate peer comparison for Play Store traffic. |
Buyers | Integer | NO | |
Installer to Buyer conversion rate | Decimal | NO | |
Repeat Buyers | Integer | NO | |
Installer to Repeat Buyer conversion rate | Decimal | NO | |
Buyer to Repeat Buyer conversion rate | Integer | NO |
Supported dimensions
Dimension | File name |
---|---|
Acquisition channel * | ..._channel.csv |
Country |
..._country.csv |
Country (Play Store organic) |
..._play_country.csv |
Play Store (organic) search | ..._play_search.csv |
Tracked channels (UTM) | ..._utm_tagged.csv |
* Note: The "Play Store (organic)" channel is the sum of "Play Store (organic) search" and "Play Store (organic) browse." To avoid double-counting visitors in this report, ignore either the total "Play Store (organic)" row or both search and browse rows.
The Google Search (organic) dimension is no longer supported as of June 2019.