تنزيل وتصدير التقارير الشهرية

يمكنك استخدام Play Console لتنزيل تقارير شهرية عن تطبيقات معيّنة لمساعدتك في تتبُّع أداء تطبيقك والتعرّف عليه.

أنواع التقارير

التقارير التفصيلية

تتضمّن التقارير التفصيلية بيانات عن أحداث فردية:

المراجعات
التقارير المالية: المبيعات المقدّرة والأرباح والهدايا وتمويل الرصيد على 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).
استخدِم الأمر 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)

إذا كنت قد استخدمت 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.

المراجعات

الأمر

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

تنسيق الملف

الحقل	التنسيق	اختياري	أمثلة وملاحظات
اسم الحزمة	سلسلة	لا	`com.company.app`
رمز إصدار التطبيق	عدد صحيح	نعم	حِزم APK للإصدار فقط
اسم إصدار التطبيق	سلسلة	نعم
لغة المُراجع	سلسلة: اختصار من حرفين وفقًا لمعيار ISO 639-1	نعم	`en`
الجهاز	سلسلة	نعم	`hammerhead`
تاريخ ووقت إرسال المراجعة	ISO_8601، بما في ذلك الوقت والمنطقة الزمنية حسب التوقيت العالمي المتَّفق عليه (UTC)	لا	`2014-06-19T19:12:32Z`
وقت إرسال المراجعة بالميلي ثانية منذ بداية الحقبة	عدد صحيح يُحسَب بالمللي ثانية منذ تاريخ بدء حساب الفترة	لا
تاريخ آخر تعديل على المراجعة ووقته	ISO_8601، بما في ذلك الوقت والمنطقة الزمنية حسب التوقيت العالمي المتَّفق عليه (UTC)	نعم	`2014-06-19T19:12:32Z`
عدد وحدات المللي ثانية التي مرّت على آخر تعديل للمراجعة منذ تاريخ بدء حساب الفترة	عدد صحيح يُحسَب بالمللي ثانية منذ تاريخ بدء حساب الفترة	نعم
تقييم بالنجوم	عدد صحيح (بين 1 و5)	لا
عنوان المراجعة	سلسلة، باللغة المحلية للمُراجع (إزالة السطور الجديدة)	نعم
نص المراجعة	سلسلة، باللغة المحلية للمُراجع (إزالة السطور الجديدة)	نعم
تاريخ ووقت ردّ المطوِّر	ISO_8601، بما في ذلك الوقت والمنطقة الزمنية حسب التوقيت العالمي المتَّفق عليه (UTC)	نعم	`2014-06-19T19:12:32Z`
عدد وحدات المللي ثانية التي استغرقتها ردود المطوِّر منذ بدء حساب الفترة	عدد صحيح يُحسَب بالمللي ثانية منذ تاريخ بدء حساب الفترة	نعم
نص ردّ المطوِّر	سلسلة (إزالة السطور الجديدة باقتضاب المسافة البيضاء)	نعم
رابط المراجعة	سلسلة	نعم	`https://play.google.com/apps/publish/?dev_acc=<...>#ReviewPlace:id=<..>‎`

مثال

إذا كنت تريد تنزيل جميع التقارير التي تم إنشاؤها في عام 2014 من معرّف حزمة التقارير pubsite_prod_rev_0123456789 لتطبيقك الذي يحمل اسم الحزمة com.example.app، يمكنك استخدام الأمر التالي:

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

التقارير المالية

المبيعات المُقدّرة

ننصح بعدم الاعتماد على عدد الأعمدة في ملفات CSV عند إعداد التقارير المبرمَجة.

لمحة

يمكنك استخدام تقرير المبيعات المُقدّرة لعرض معلومات وقت الاستجابة البطيئة المتعلّقة بمبيعات التطبيق أو المنتجات أو الاشتراكات داخل التطبيق. يتضمّن هذا التقرير المبلغ الذي يدفعه المشترون، ولا تُخصَم الضرائب أو الرسوم التي تقرِّرها Google من القيم الإجمالية.

يمكنك استخدام هذا التقرير في الإحصاءات أو تحليل المؤشرات، ولكن لا يُنصح به في تدوين سجلات الاستخدام. أو يمكنك الاطّلاع على تقرير الأرباح.

قد تلاحظ اختلافات بين هذا التقرير والأرباح التي حقَّقتها، ويرجع ذلك إلى عدد من الأسباب. على سبيل المثال، لا يأخذ تقرير المبيعات المُقدّرة الضرائب المقتطعة أو المبالغ المردودة بعين الاعتبار. ويتضمّن هذا التقرير مبالغ التي يدفعها المشترين بعملتهم المحلية، ولا يحتوي على المبالغ المحوّلة بعملة العائد.

الأمر

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

مثال

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

تنسيق الملف

الحقل	التنسيق	اختياري	أمثلة وملاحظات
رقم الطلب	سلسلة	لا	`GPA.1234-1234-1234-12345` ينتهي مُعرّف طلب الاشتراك برقم دورة التجديد (على سبيل المثال، أول دورة تجديد هي `GPA.1234-1234-1234-12345..0` وثاني دورة تجديد هي `GPA.1234-1234-1234-12345..1` وهكذا).
تاريخ تحصيل رسوم الطلب	سلسلة	لا	`2016-11-30` يستند تاريخ هذا الطلب إلى المنطقة الزمنية حسب التوقيت العالمي المتَّفق عليه (بالتنسيق YYYY-MM-DD (يوم-شهر-سنة)).
الطابع الزمني لتحصيل رسوم الطلب	عدد صحيح	لا	`1480507200` الطابع الزمني لنظام التشغيل UNIX عند تحصيل رسوم الطلب من المستخدِم، ويُقاس بالثواني منذ بداية الحقبة.
الحالة المالية	سلسلة	لا	`تحصيل الرسوم وردّ الأموال وردّ جزء من الأموال` وما إلى ذلك إذا تم ردّ الأموال المدفوعة في أحد الطلبات بالكامل بعد إصدار عملية ردّ جزء من الأموال، يحدث ما يلي: يظهر الجزء المُسترَد من الأموال في سطر منفصل. يعرض سطر الأموال المُستردَّة بالكامل الرصيد المتبقي.
طراز الجهاز	سلسلة	لا	`mako`، وما إلى ذلك. طراز جهاز Android المستخدَم لإجراء عملية الشراء. وفي ما يتعلّق بطلبات الاشتراك، يشير هذا الحقل إلى الجهاز المستخدَم في عملية الشراء الأصلية.
عنوان المنتج	سلسلة	لا	`العملات المعدنية والاشتراك الشهري` وما إلى ذلك تمثّل هذه السمة اسم المنتج الذي حدّده المطوِّر. ويتم عرضها بلغة المشتري.
معرّف المنتج	سلسلة	لا	`com.example.app` اسم حزمة التطبيق حيث تم بيع المنتج.
نوع المنتج	سلسلة	لا	`تطبيق مدفوع` `أو اشتراك أو تطبيق مضمّن`
معرّف رمز التخزين التعريفي	سلسلة	لا	`treasure_chest_for_new_users` معرّف فريد للمنتج يحدّده المطوِّر
عملة البيع	سلسلة	لا	`دولار أمريكي ويورو وبات تايلاندي` وما إلى ذلك
سعر السلعة	عدد صحيح	لا	`12,345.67` يظهر بالعملة المحلية للمشتري مع استخدام علامة "," للآلاف
الضرائب المُحصَّلة	عدد صحيح	نعم	`12,345.67` بالعملة المحلية للمشتري مع استخدام علامة "," للآلاف
المبلغ المحصَّل	عدد صحيح	لا	`12,345.67` بالعملة المحلية للمشتري. هذا المبلغ هو مجموع سعر السلعة والضرائب المُحصَّلة. يُكتب المبلغ مع استخدام فاصلة الآلاف ",".
مدينة المشتري	سلسلة	نعم	`بوسطن وتورونتو` وما إلى ذلك تتم تعبئة هذا الحقل فقط للمبيعات التي تجريها بصفتك الجهة المسؤولة عن معالجة الدفعات.
ولاية أو محافظة المشتري	سلسلة	نعم	`ماساتشوستس وأونتاريو` وما إلى ذلك
الرمز البريدي للمشتري	سلسلة	نعم	`02140 وM5B 1L6` وما إلى ذلك تتم تعبئة هذا الحقل فقط للمبيعات التي تجريها بصفتك الجهة المسؤولة عن معالجة الدفعات.
بلد المشتري	سلسلة	لا	`الولايات المتحدة وكندا` وما إلى ذلك
معرّف الخطة الأساسية	سلسلة	نعم	`أسبوعية` معرّف الاشتراك في الخطة الأساسية. لا تتم تعبئة هذا الحقل إلا للاشتراكات. تعرّف على مزيد من المعلومات.
معرّف العرض الترويجي	سلسلة	نعم	`عرض ترويجي في موسم الربيع` معرّف العرض الترويجي للاشتراك. لا تتم تعبئة هذا الحقل إلا للاشتراكات. تعرّف على مزيد من المعلومات.
معرّف المجموعة	عدد صحيح	نعم	`1234567891234567890` يتم منح المعرّف الفريد عند إنشاء مجموعة حسابات مطوِّرين. تعرّف على مزيد من المعلومات.
أول مليون دولار أمريكي مؤهَّل	سلسلة	نعم	`نعم،` `لا` لا تتم تعبئة هذا الحقل إلا عند إعداد مجموعة حسابات المطوّرين. تعرّف على مزيد من المعلومات.
معرّف العرض الترويجي	سلسلة	نعم	`PP.C2fy7Ns0/+e2w،‏ PP.P2fy7Ns0/+e2w، النقاط المستخدَمة فقط` لا تتم تعبئة هذا الحقل إلا للمبيعات المرتبطة ببرنامج Play Points. تشير البادئتان "PP.C" و"PP.P" إلى الطلبات التي تتضمّن القسائم والعروض الترويجية للمنتجات داخل التطبيق على التوالي. يتم أيضًا عرض الطلبات المستخدَمة فيها نقاط Play Points مباشرةً. تعرّف على مزيد من المعلومات.
قيمة القسيمة	عدد صحيح	نعم	`3.00` تظهر القيمة بالعملة المحلية للمشتري. يُكتب المبلغ مع استخدام فاصلة الآلاف ",". لا تتم تعبئة هذا الحقل إلا للمبيعات المرتبطة بقسائم برنامج Play Points. تعرّف على مزيد من المعلومات.
معدّل الخصم	عدد صحيح	نعم	`45, 55, 70` معدّل الخصم المئوي الذي يحدد ما وفره المستخدِم من أصل المال المنفَّق من خلال استخدام نقاط Play Points. لا تتم تعبئة هذا الحقل إلا للمبيعات المرتبطة ببرنامج Play Points. تعرّف على مزيد من المعلومات.
معرّف المنتجات المعروضة	عدد صحيح	نعم	`1234567891234567890` يتم منح المعرّف الفريد عندما ينشئ المطوّر منتجًا معروضًا. تعرّف على مزيد من المعلومات.
معرّف تجربة الأسعار	سلسلة	نعم	`5697329857888256(المتغير ب)` معرّف تجربة الأسعار ومجموعة التجربة

الأرباح

We recommend that you don’t rely on the number of columns in the CSV files for your automated reports.

لمحة

يحتوي تقرير الأرباح على معلومات حول العائد والمعاملات. ويمثّل كل سطر في التقرير نوعًا من المعاملات، مثل تحصيل رسوم من العميل أو دفع رسوم لشركة Google، بالإضافة إلى المبالغ الأصلية والمحوّلة.

تتضمّن تقارير الأرباح معاملات من الشهر السابق. وستتمكّن من تلقّي العائد بعد عدّة أسابيع من توفُّر تقرير الأرباح.

يتم إنشاء تقرير الأرباح مرة واحدة في الشهر، ويكون متاحًا عادةً بحلول اليوم الخامس من الشهر الذي يليه. في بعض الأحيان، قد تعدّل Google أرباحك من أجل تصحيح الأخطاء الحسابية. وفي هذه الحالة، سنتواصل معك لإبلاغك بهذا التعديل وسننشئ ملفًا إضافيًا للأرباح يحتوي على المعاملات التي تمت تسويتها فقط، لتحتفظ به في سجلّاتك.

ملاحظات:

ستظهر الرسوم التي تفرضها Google مقابل كل معاملة، بغض النظر عما إذا كانت Google هي الجهة المسؤولة عن معالجة الدفعات للمنتجات المباعة.
لا يتضمّن تقرير الأرباح حالات ردّ المبالغ المدفوعة.
يتم إنشاء ملف واحد يتضمّن تقرير الأرباح للمعاملات كل شهر.
يتم دفع الضريبة المقتطعة في تايوان في الشهر السابق لتاريخ الإبلاغ عنها.

الأمر

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

مثال

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

تنسيق الملف

الحقل	التنسيق	اختياري	أمثلة وملاحظات
الوصف	سلسلة	لا	`GPA.1234-1234-1234-12345` تشتمل معرّفات طلبات الاشتراك على رقم دورة التجديد في النهاية (على سبيل المثال، تكون أول دورة تجديد `GPA.1234-1234-1234-12345..0` وثاني دورة تجديد `GPA.1234-1234-1234-12345..1` وهكذا).
تاريخ المعاملة	سلسلة	لا	`‫30 تشرين الثاني/نوفمبر 2016` يستند تاريخ هذا الطلب إلى المنطقة الزمنية حسب توقيت المحيط الهادئ (بالتنسيق MMM DD،‏ YYYY). وتجدر الإشارة إلى أنّ الطابع الزمني للمعاملة قد يسجِِّل الشهر التالي لأنّ التقارير يتم إنشاؤها حسب الطابع الزمني للإصدار.
وقت المعاملة	سلسلة	لا	`12:00:00 بعد الظهر بتوقيت المحيط الهادئ`
نوع الضريبة	سلسلة	نعم	`ضريبة الجهة الخارجية` تكون سطور الحقل فارغة عند عدم وجود ضريبة.
نوع العملية	سلسلة	لا	`تحصيل رسوم، رسوم Google، ضريبة، ردّ قيمة الرسوم، ردّ قيمة رسوم Google، إعادة إصدار فاتورة الرسوم، إعادة إصدار فاتورة الضريبة، إعادة إصدار فاتورة رسوم Google، تسوية`
نوع ردّ الأموال	سلسلة	نعم	`كامل أو جزئي` سيتم وضع علامة "كامل" على عمليات ردّ الأموال التي تم فيها ردّ الأموال بالكامل إلى المشتري. وسيتم وضع علامة "جزئي" على عمليات ردّ الأموال التي تم فيها ردّ جزء من مبلغ دفعه المستخدم.
عنوان المنتج	سلسلة	لا	`العملات المعدنية والاشتراك الشهري` وما إلى ذلك تمثّل هذه السمة اسم المنتج الذي حدّده المطوّر. ويتم عرضها بلغة المشتري.
معرّف المنتج	سلسلة	لا	`com.example.app` اسم حزمة التطبيق حيث تم بيع المنتج.
نوع المنتج	عدد صحيح	لا	`0,1` يُستخدَم لتحديد نوع المنتج المباع. يمثّل الرقم "0" بيع تطبيق مدفوع، بينما يمثّل الرقم "1" بيع منتج أو اشتراك داخل التطبيق.
معرّف رمز التخزين التعريفي	سلسلة	لا	`treasure_chest_for_new_users` معرّف فريد للمنتج يحدّده المطوِّر
الأجهزة	سلسلة	لا	`mako`، وما إلى ذلك طراز جهاز Android المستخدَم لإجراء عملية الشراء. في ما يتعلّق بطلبات الاشتراك، يشير هذا الحقل إلى طراز الجهاز المستخدَم في عملية الشراء الأصلية.
بلد المشتري	سلسلة	لا	`الولايات المتحدة وكندا` وما إلى ذلك
ولاية أو محافظة المشتري	سلسلة	نعم	`ماساتشوستس وأونتاريو` وما إلى ذلك
الرمز البريدي للمشتري	سلسلة	نعم	`02140 وM5B 1L6` وما إلى ذلك
عملة المشتري	سلسلة	لا	`دولار أمريكي ويورو وبات تايلاندي` وما إلى ذلك
المبلغ (عملة المشتري)	عدد صحيح	لا	`12345.67` المبلغ الإجمالي لسطر الفاتورة هذا قبل تحويل العملة.
سعر تحويل العملات	عدد صحيح	لا	`0.56789` سعر الصرف المستخدَم عند تحويل مبالغ المشترين إلى مبالغ العائدات بعملة التاجر
عملة التاجر	سلسلة	لا	`دولار أمريكي ويورو وبات تايلاندي` وما إلى ذلك العملة التي تم تحويل قيمة الطلب إليها. وهذه هي العملة المحلية التي يتم الدفع بها.
المبلغ (عملة التاجر)	عدد صحيح	لا	`12345.67` المبلغ الإجمالي لسطر الفاتورة هذا بعد تحويل العملة
معرّف الخطة الأساسية	سلسلة	نعم	`أسبوعية` معرّف الاشتراك في الخطة الأساسية. لا تتم تعبئة هذا الحقل إلا للاشتراكات. مزيد من المعلومات.
معرّف العرض الترويجي	سلسلة	نعم	`عرض الربيع الترويجي` معرّف العرض الترويجي للاشتراك. لا تتم تعبئة هذا الحقل إلا للاشتراكات. مزيد من المعلومات.
معرّف المجموعة	عدد صحيح	نعم	`1234567891234567890` يتم منح المعرّف الفريد عند إنشاء مجموعة حسابات مطوِّرين. مزيد من المعلومات.
أول مؤهَّل للحصول على مليون دولار أمريكي	سلسلة	نعم	`نعم،` `لا` لا تتم تعبئة هذا الحقل إلا عند إعداد مجموعة حسابات مطوِّرين. مزيد من المعلومات.
النسبة المئوية لرسوم الخدمة	عدد صحيح	نعم	`15`، `30`
وصف الرسوم	سلسلة	نعم	`الاشتراكات` التفاصيل المقدمة لحساب رسوم خدمة Google
معرّف العرض الترويجي	سلسلة	نعم	`PP.C_x0a08trvC1, PP.PdYfn342Ox10, pass-QbTfn350O810. مستخدَم في برنامج Play Points وخدمة Play Pass` لا تتم تعبئة هذا الحقل إلا للمبيعات المرتبطة ببرنامج Play Points وخدمة Play Pass. تشير البادئتان "PP.C" و"PP.P" إلى الطلبات التي تتضمّن قسائم برنامج Play Points والعروض الترويجية للمنتجات داخل التطبيق على التوالي. يتم أيضًا عرض الطلبات المستخدَمة فيها نقاط Play Points مباشرةً. تشير البادئة "pass" إلى الطلبات التي طبَّق عليها المستخدمون القسائم التي حصلوا عليها ضِمن اشتراكهم في خدمة Play Pass.

الفوترة باستخدام الفواتير

We recommend that you don’t rely on the number of columns in the CSV files for your automated reports.

نبذة

إذا كنت مسجّلاً في برامج نظام الفوترة البديل أو العروض الترويجية الخارجية، وأبلغت Google Play بالمعاملات، يمكنك استخدام تقرير "الفوترة باستخدام الفواتير" لمعرفة معاملاتك ورسوم الخدمة المستحقة التي تُحصّلها منك Google.

يتضمّن تقرير "الفوترة باستخدام الفواتير" معاملات من الشهر السابق في "ملف CSV" واحد. يقدّم التقرير لكل معاملة تفاصيل رسوم المستخدم ورسوم خدمة Google ومبلغ الضريبة، إن وُجد. كما ترد فيه معلومات، مثل النسبة المئوية لرسوم الخدمة وسعر تحويل العملات للمساعدة في فهم كيفية احتساب مبلغ فاتورة رسوم الخدمة.

ملاحظة:

يتم إنشاء تقرير "الفوترة باستخدام الفواتير" مرة واحدة في الشهر، ويكون متاحًا بحلول اليوم الخامس من الشهر الذي يليه.
يُستبعد من التقرير أسطر الضرائب أو رسوم Google التي تم تقريبها إلى الصفر بعملة الفوترة.

الأمر

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

مثال

إذا كنت تريد تنزيل جميع التقارير التي تم إنشاؤها في عام 2024 من رقم تعريف حزمة التقارير pubsite_prod_rev_0123456789، يمكنك استخدام الأمر التالي:

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

تنسيق الملف

تاريخ المعاملة وفقًا لتوقيت المحيط الهادئ

الحقل	التنسيق	اختياري	أمثلة وملاحظات
رقم تعريف الفاتورة	سلسلة	لا	`1234567890` رقم تعريف مطابق للرقم المعروض في فاتورتك
البرنامج	سلسلة	نعم	`الفوترة حسب اختيار المستخدم ونظام فوترة بديل فقط والعروض الترويجية الخارجية` يُضبط لأسطر رسوم Google فقط.
معرّف المعاملة الخارجي	سلسلة	لا	`com.example.app:1a2b3c4e5f`
تاريخ المعاملة	سلسلة	لا	`‫1 يوليو 2024` تاريخ المعاملة وفقًا لتوقيت المحيط الهادئ
الطابع الزمني للمعاملة	عدد صحيح	لا	`‫1719849600` طابع UNIX الزمني للمعاملة، ويُقاس بالثواني منذ بدء حساب الفترة.
نوع العملية	سلسلة	لا	`رسوم المستخدم، رسوم Google، الضريبة، ردّ رسوم المستخدم، ردّ رسوم Google، ردّ الضريبة، ردّ جزء من رسوم المستخدم، ردّ جزء من رسوم Google، ردّ جزء من الضريبة`
نوع الضريبة	سلسلة	نعم	`ضريبة القيمة المضافة (VAT)/ضريبة السلع والخدمات (GST)` يُضبط لأسطر الضريبة فقط.
نوع رمز التخزين التعريفي	سلسلة	لا	`منتج داخل التطبيق، اشتراك`
رقم تعريف الحزمة	سلسلة	لا	`com.example.app` اسم حزمة التطبيق حيث تم بيع المنتج
بلد البيع	سلسلة	لا	`الولايات المتحدة وكوريا الجنوبية وما إلى ذلك`
سعر المنتج بدون احتساب الضريبة (عملة البيع)	رقم عشري	نعم	`12.34` سعر المنتج بعملة البيع بدون احتساب الضريبة، يُضبط لأسطر رسوم المستخدم فقط.
عملة البيع	سلسلة	لا	`الدولار الأمريكي والوون الكوري وما إلى ذلك` العملة المحلية للمشتري
المبلغ المستحق (عملة البيع)	رقم عشري	نعم	`‫1.23 أو ‎-1.23` المبلغ المستحق بعملة البيع، يُضبط فقط لأسطر رسوم Google وأسطر الضريبة. تكون القيمة موجبة للمبلغ الذي تم تحصيله وسالبة لمبالغ ردّ الأموال أو ردّ جزء من الأموال.
سعر تحويل العملات	رقم عشري	لا	`‫1.076` سعر الصرف المستخدَم عند تحويل المبلغ المستحق من عملة البيع إلى عملة الفوترة
عملة الفوترة	سلسلة	لا	`الدولار الأمريكي واليورو وما إلى ذلك`
المبلغ المستحق (عملة الفوترة)	رقم عشري	نعم	`1.32‫` المبلغ المستحق بعملة الفوترة، يُضبط فقط لأسطر رسوم Google وأسطر الضريبة. تكون القيمة موجبة للمبلغ الذي تم تحصيله وسالبة لمبالغ ردّ الأموال أو ردّ جزء من الأموال.
معرّف المجموعة	عدد صحيح	نعم	`1234567891234567890` يتم منح المعرّف الفريد عند إنشاء مجموعة حسابات مطوِّرين. مزيد من المعلومات
أول مليون دولار أمريكي مؤهَّل	سلسلة	نعم	`نعم، لا` لا تتم تعبئة هذا الحقل إلا عند إعداد مجموعة حسابات المطوّرين. مزيد من المعلومات
النسبة المئوية لرسوم الخدمة	عدد صحيح	نعم	`‫11، 26، وما إلى ذلك`
وصف الرسوم	سلسلة	نعم	`الاشتراكات وأعمال الشراكة الإعلامية وما إلى ذلك` التفاصيل المقدّمة لحساب رسوم "خدمات Google"

تمويل رصيد Play في كوريا

نبذة

إذا كنت تاجرًا مطالَبًا بإصدار إيصالات نقدية في كوريا الجنوبية بموجب القواعد واللوائح التنظيمية السارية أو إذا تطوّعت بالتسجيل لإصدار إيصالات نقدية، عليك في هذه الحالة إصدار إيصالات نقدية عند طلب مشتري التطبيق الحصول على تطبيق مدفوع أو إجراء عمليات شراء لمنتجات داخل التطبيق باستخدام بطاقات هدايا 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

تنسيق الملف

الحقل	التنسيق	اختياري	أمثلة وملاحظات
رقم الطلب	عدد صحيح	لا	`GPA.1234-1234-1234-12345` تشتمل معرّفات طلبات الاشتراك على رقم دورة التجديد في نهاية المدة (على سبيل المثال، تكون أول دورة تجديد `GPA.1234-1234-1234-12345..0` وثاني دورة تجديد `GPA.1234-1234-1234-12345..1` وهكذا).
تاريخ تحصيل رسوم الطلب	سلسلة	لا	`2016-11-30` يستند تاريخ هذا الطلب إلى المنطقة الزمنية حسب التوقيت العالمي المنسَّق (بالتنسيق YYYY-MM-DD).
الحالة المالية	سلسلة	لا	`تحصيل الرسوم وردّ الأموال وما إلى ذلك`
مبلغ التمويل من الرصيد في Play	سلسلة	لا	`12,345.67` مبلغ العملية
عملة الرصيد في 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`

مثال

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`

مثال

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`

مثال

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	لا	`2022-01-01` يستند تاريخ هذا الطلب إلى المنطقة الزمنية حسب التوقيت العالمي المنسَّق (بالتنسيق YYYY-MM-DD).
اسم الحزمة	سلسلة	لا	`com.example.app`
معرّف المنتج	سلسلة	لا	`الوصول برسوم إضافية`
البلد	سلسلة	لا	`الولايات المتحدة وكندا وما إلى ذلك`
الاشتراكات الجديدة	الرقم	لا	`1234`
الاشتراكات التي تم إلغاؤها	الرقم	لا	`1234`
الاشتراكات النشطة	الرقم	لا	`1234`
معرّف الخطة الأساسية	سلسلة	لا	`أسبوعية`
معرّف العرض الترويجي	سلسلة	لا	`عرض ترويجي في موسم الربيع`

ملاحظة: لمزيد من المعلومات عن إحصاءات الاشتراكات الجديدة والملغاة والنشطة، انتقِل إلى موضوع مراجعة بيانات الأرباح والمشترين التي تخص تطبيقك.

السمات المتوافقة

السمة	اسم الملف
البلد	`‎..._country.csv`

اكتساب المستخدمين

يوفِّر تقريرا "المستخدمون الذين احتفظوا بالتطبيق مثبّتًا" و"المشترون" إمكانية الوصول الآلي إلى البيانات في تقرير اكتساب المستخدمين القديم. حلّت محلّ عملية التصدير هذه عملية تصدير آلية جديدة تتضمّن بيانات صفحتَي تحليل المتجر وتحليل الإحالات الناجحة في Play Console. وأصبحت متوفرة في آذار (مارس) 2021.

تمت إزالة التقارير القديمة في تشرين الأول (أكتوبر) 2021.

احرص على قراءة موضوع كيف يمكنني تنزيل بيانات اكتساب المستخدمين؟ لمعرفة المزيد من المعلومات.

ملاحظة: لم يعُد تقرير "المشتركون" متوفّرًا منذ تشرين الثاني (نوفمبر) 2019. لمعرفة المزيد من المعلومات، يُرجى الاطّلاع على مصادر اكتساب المستخدمين ومقاييسه.

المستخدمون الذين احتفظوا بالتطبيق مثبّتًا (ميزة التصدير القديمة كانت متوفرة حتى آب/أغسطس 2021)

الأمر

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

تنسيق الملف

الحقل	التنسيق	اختياري	أمثلة وملاحظات
التاريخ	YYYY-mm-dd	لا	تاريخ زيارة المستخدِم لبطاقة بياناتك على المتجر ملاحظة: ستؤدّي إضافة زائرِين فرديين اطّلعوا على بطاقة بيانات المتجر على مدار عدة أيام إلى زيادة عدد هؤلاء الزائرين عن العدد الذي يظهر لك في مشاهدات المجموعة النموذجية الأسبوعية أو الشهرية. وتحتسِب مشاهدات المجموعة النموذجية الأسبوعية والشهرية كلّ زائر مرّة واحدة، حتى إذا زار بطاقة البيانات عدة مرات.
قناة الاكتساب	سلسلة	نعم	`نتائج البحث المجانية أو "إعلانات Google" أو الروابط التي وضع نظام مراقبة الزيارات من Urchin علامة عليها` عرض لسمة "قناة الاكتساب" ملاحظة: تمثل قناة "متجر Play (النتائج المجانية)" مجموع "عمليات البحث (المجانية) في متجر Play" و"عمليات التصفُّح (المجانية) في متجر Play". لتجنّب احتساب عدد الزوّار مرّتين في هذا التقرير، عليك تجاهل إما صف الإجمالي في "متجر Play (النتائج المجانية)" أو صفَي عمليات البحث والتصفُّح معًا.
البلد	سلسلة	نعم	عرض لسمتَي "البلد" و"البلد (النتائج المجانية في متجر Play)"
المصدر أو الحملة بنظام مراقبة الزيارات من Urchin	سلسلة	نعم	عرض لسمة "القنوات التي يتم تتبُّعها (نظام مراقبة الزيارات من Urchin)"
الكلمة الرئيسية	سلسلة	نعم	`مثال: "ألعاب"` عرض لسمة "البحث (النتائج المجانية) في متجر Play"
الزائرون الذين اطّلعوا على بطاقة بيانات المتجر	عدد صحيح	لا
عدد مُثبّتي التطبيق	عدد صحيح	لا
معدل الإحالات الناجحة بحساب نسبة الزائرين إلى مُثبّتي التطبيق	عشري	لا
مقياس أداء متوسط معدّل الإحالات الناجحة بحساب نسبة الزائرين إلى مُثبّتي التطبيق	عشري	نعم	لا تتم تعبئة هذا الحقل منذ آب (أغسطس) 2019. وتتوفّر مجموعة معدّلة من مقاييس الأداء، باستخدام عملية حسابية جديدة، في صفحة "تقارير اكتساب المستخدمين". لمعرفة المزيد من المعلومات، احرص على قراءة موضوع مقارنة التطبيقات المشابهة في معدل الإحالات الناجحة لزيارات "متجر Play".
عدد مُثبّتي التطبيق الذين تم الاحتفاظ بهم لمدة يوم واحد	عدد صحيح	لا
معدل الاحتفاظ بالمستخدمين من خلال حساب عدد مُثبّتي التطبيق لمدة يوم واحد	عشري	لا
عدد مُثبّتي التطبيق الذين تم الاحتفاظ بهم لمدة 7 أيام	عدد صحيح	لا
معدّل الاحتفاظ بمُثبّتي التطبيق لمدة 7 أيام	عشري	لا
عدد مُثبّتي التطبيق الذين تم الاحتفاظ بهم لمدة 15 يومًا	عدد صحيح	لا
معدّل الاحتفاظ بمُثبّتي التطبيق لمدة 15 يومًا	عشري	لا
عدد مُثبّتي التطبيق الذين تم الاحتفاظ بهم لمدة 30 يومًا	عدد صحيح	لا
معدّل الاحتفاظ بمُثبّتي التطبيق لمدة 30 يومًا	عشري	لا

السمات المتوافقة

السمة	اسم الملف
قناة الاكتساب *	`‎..._channel.csv`
البلد	`‎..._country.csv`
البلد (النتائج المجانية في "متجر Play")	`‎..._play_country.csv`
البحث (النتائج المجانية) في "متجر Play"	`‎..._play_search.csv`
القنوات التي يتم تتبُّعها (نظام مراقبة الزيارات من Urchin)	`‎..._utm_tagged.csv`

* ملاحظة: تمثل قناة "متجر Play (النتائج المجانية)" مجموع "عمليات البحث (المجانية) في متجر Play" و"عمليات التصفُّح (المجانية) في متجر Play". ولتجنُّب احتساب عدد الزوّار مرّتين في هذا التقرير، عليك تجاهل إما صف الإجمالي في "متجر Play (النتائج المجانية)" أو صفَي عمليات البحث والتصفُّح معًا.

لم تعُد سمة "بحث Google" (النتائج المجانية) متوفّرة منذ حزيران (يونيو) 2019.

أداء المتجر (تتوفر ميزة التصدير الجديدة في آذار (مارس) 2021)

أسماء ملفات CSV

كل ملف CSV متوفّر يتضمّن بيانات عن شهر واحد ونظرة تفصيلية. وتحمل ملفات CSV أسماءً منظَّمة توضّح السنة والشهر وتصنيف التقارير التي تشملها هذه الملفات، وفقًا للنمط التالي:

تنسيق اسم الملف: store_performance_[package_name]_[yyyyMM]_[breakdown].csv

ملاحظات:

سيتم تضمين اسم الحزمة في اسم الملف كما هو، مع أي رموز خاصة في حال توفّرها ("." أو "_").
يمثل التنسيق yyyyMM الشهر والسنة، مثل 202101.

الأمر

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

تنسيق الملف

الحقل	التنسيق	اختياري	مثال	الوصف
التاريخ	YYYY-mm-dd	لا	`2021-01-01`	تاريخ زيارة المستخدِم لبطاقة بيانات المتجر
اسم الحزمة	سلسلة	لا	`com.example.app`	اسم الحزمة التي تحتوي على بيانات التقرير
البلد أو المنطقة	سلسلة	لا	`المملكة المتحدة`	البلد أو المنطقة التي تم تسجيل حساب المستخدِم على Google فيها
مصدر الزيارات	سلسلة	لا	`البحث في Google Play`	طريقة وصول المستخدِم إلى بطاقة بياناتك على المتجر: البحث في Google Play إحالات من جهات خارجية تصفُّح Google Play ملاحظة: يمكن أن تكون القيمة `غير ذلك` إذا لم تصل هذه القيمة إلى حدّ أدنى معيّن.
عبارة البحث	سلسلة	نعم	`متجر التطبيقات`	العبارة التي بحث عنها المستخدِم قبل الانتقال إلى بطاقة بياناتك على المتجر. وهي ليست متوفّرة إلا للبحث على Google Play. ملاحظة: يمكن أن تكون القيمة `غير ذلك` إذا لم تصل هذه القيمة إلى حدّ أدنى معيّن.
مصدر نظام مراقبة الزيارات من Urchin	سلسلة	نعم	`google`	قيمة مَعلمة عنوان URL لمصدر utm_source في روابط لصفحات معيّنة تؤدي إلى بطاقة بياناتك على المتجر. وهي ليست متوفّرة إلا لإحالات الجهات الخارجية. ملاحظة: يمكن أن تكون القيمة `غير ذلك` إذا لم تصل هذه القيمة إلى حدّ أدنى معيّن.
حملة نظام مراقبة الزيارات من Urchin	سلسلة	نعم	`حملة`	قيمة مَعلمة عنوان URL لحملة utm_campaign في روابط لصفحات معيّنة تؤدي إلى بطاقة بيانات المتجر. وهي ليست متوفّرة إلا لإحالات الجهات الخارجية. ملاحظة: يمكن أن تكون القيمة `غير ذلك` إذا لم تصل هذه القيمة إلى حدّ أدنى معيّن.
عمليات اكتساب المستخدمين من بطاقة بيانات المتجر	عدد صحيح	لا	`10`	عدد المستخدمين الذين زاروا بطاقة بياناتك على المتجر وثبّتوا تطبيقك، ولم يسبق لهم تثبيته على أي من أجهزتهم الأخرى في ذلك الوقت.
الزائرون الذين اطّلعوا على بطاقة بيانات المتجر	عدد صحيح	لا	`100`	عدد المستخدمين الذين زاروا بطاقة بياناتك على المتجر ولم يسبق لهم تثبيت التطبيق على أي من أجهزتهم.
معدل الإحالات الناجحة من بطاقة بيانات المتجر	عشري	لا	`0.1`	النسبة المئوية للزائرين الذين اطّلعوا على بطاقة بيانات المتجر وثبَّتوا تطبيقك ملاحظة: لا تشمل هذه النسبة الزيارات أو عمليات التثبيت من المستخدمين الذين سبق لهم تثبيت تطبيقك على جهاز آخر.

بنية التصنيف المتاحة

تتوفّر التصنيفات التالية:

اسم التصنيف الحقول في كل ملف CSV (بالترتيب):

اسم التصنيف	الحقول في كل ملف CSV (بالترتيب):
`البلد` مثال على اسم الملف: `store_performance_com.example.app_202012_country.csv`	التاريخ، اسم الحزمة، البلد، عمليات اكتساب المستخدمين من خلال بطاقة بيانات المتجر، الزائرون الذين اطّلعوا على بطاقة بيانات المتجر، معدّل الإحالات الناجحة من بطاقة بيانات المتجر
`traffic_source` مثال على اسم الملف: `store_performance_com.example.app_202012_traffic_source.csv`	التاريخ، اسم الحزمة، مصدر الزيارات، عبارة البحث، مصدر نظام مراقبة الزيارات من Urchin، حملة نظام مراقبة الزيارات من Urchin، عمليات اكتساب العملاء من بطاقة بيانات المتجر، الزائرون الذين اطّلعوا على بطاقة بيانات المتجر، معدّل الإحالات الناجحة من بطاقة بيانات المتجر

البلد

مثال على اسم الملف:

store_performance_com.example.app_202012_country.csv

التاريخ، اسم الحزمة، البلد، عمليات اكتساب المستخدمين من خلال بطاقة بيانات المتجر، الزائرون الذين اطّلعوا على بطاقة بيانات المتجر، معدّل الإحالات الناجحة من بطاقة بيانات المتجر

traffic_source

مثال على اسم الملف:

store_performance_com.example.app_202012_traffic_source.csv

التاريخ، اسم الحزمة، مصدر الزيارات، عبارة البحث، مصدر نظام مراقبة الزيارات من Urchin، حملة نظام مراقبة الزيارات من Urchin، عمليات اكتساب العملاء من بطاقة بيانات المتجر، الزائرون الذين اطّلعوا على بطاقة بيانات المتجر، معدّل الإحالات الناجحة من بطاقة بيانات المتجر

الخروج من المخطّط

ضاعِف أيًا من علامتَي الاقتباس. (" -> "")
إذا كانت الخلية تحتوي على أي علامات تبويب أو سطور جديدة أو علامتَي اقتباس أو فواصل، عليك إحاطة الخلية بعلامتَي اقتباس. (... -> "...")

مثال

إذا كنت تريد تنزيل جميع التقارير التي تم إنشاؤها في عام 2020 من معرّف حزمة التقارير pubsite_prod_0123456789 لتطبيقك الذي يحمل اسم الحزمة com.example.app، يمكنك استخدام الأمر التالي:

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

المشترون (بعد مرور 7 أيام على التثبيت. توفّرت تلك الميزة حتى آب (أغسطس) 2021)

الأمر

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

تنسيق الملف

الحقل	التنسيق	اختياري	أمثلة وملاحظات
التاريخ	YYYY-mm-dd	لا	تاريخ زيارة المستخدِم لبطاقة بيانات المتجر ملاحظة: ستؤدّي إضافة زائرِين فرديين اطّلعوا على بطاقة بيانات المتجر على مدار عدة أيام إلى زيادة عدد هؤلاء الزائرين عن العدد الذي يظهر لك في مشاهدات المجموعة النموذجية الأسبوعية أو الشهرية. وتحتسِب مشاهدات المجموعة النموذجية الأسبوعية والشهرية كلّ زائر مرّة واحدة، حتى إذا زار بطاقة البيانات عدة مرات.
قناة الاكتساب	سلسلة	نعم	`نتائج البحث المجانية أو "إعلانات Google" أو الروابط التي وضع نظام مراقبة الزيارات من Urchin علامة عليها` عرض لسمة "قناة الاكتساب" ملاحظة: تمثل قناة "متجر Play (النتائج المجانية)" مجموع "عمليات البحث (المجانية) في متجر Play" و"عمليات التصفُّح (المجانية) في متجر Play". لتجنّب احتساب عدد الزوّار مرّتين في هذا التقرير، عليك تجاهل إما صف الإجمالي في "متجر Play (النتائج المجانية)" أو صفَي عمليات البحث والتصفُّح معًا.
البلد	سلسلة	نعم	عرض لسمتَي "البلد" و"البلد (النتائج المجانية في متجر Play)"
المصدر أو الحملة بنظام مراقبة الزيارات من Urchin	سلسلة	نعم	عرض لسمة "القنوات التي يتم تتبُّعها (نظام مراقبة الزيارات من Urchin)"
الكلمة الرئيسية	سلسلة	نعم	`مثال: "ألعاب"` عرض لسمة "البحث (النتائج المجانية) في متجر Play"
الزائرون الذين اطّلعوا على بطاقة بيانات المتجر	عدد صحيح	لا
عدد مُثبّتي التطبيق	عدد صحيح	لا
معدل الإحالات الناجحة من خلال حساب نسبة الزائرين إلى عدد مُثبّتي التطبيق	عشري	لا
مقياس أداء متوسط معدّل الإحالات الناجحة بحساب نسبة الزائرين إلى مُثبّتي التطبيق	عشري	نعم	لا تتم تعبئة هذا الحقل منذ آب (أغسطس) 2019. وتتوفّر مجموعة معدّلة من مقاييس الأداء، باستخدام عملية حسابية جديدة، في صفحة "تقارير اكتساب المستخدمين". لمعرفة المزيد من المعلومات، احرص على قراءة موضوع مقارنة التطبيقات المشابهة في معدل الإحالات الناجحة لزيارات "متجر Play".
المشترون	عدد صحيح	لا
معدل الإحالات الناجحة من خلال حساب نسبة مُثبّتي التطبيق إلى المشترين	عشري	لا
المشترون المكرَّرون	عدد صحيح	لا
معدل الإحالات الناجحة بحساب نسبة مُثبّتي التطبيق إلى المشترين المكرَّرين	عشري	لا
معدل الإحالات الناجحة بحساب نسبة المشترين إلى المشترين المكرَّرين	عدد صحيح	لا

السمات المتوافقة

السمة	اسم الملف
قناة الاكتساب *	`‎..._channel.csv`
البلد	`‎..._country.csv`
البلد (النتائج المجانية في "متجر Play")	`‎..._play_country.csv`
البحث (النتائج المجانية) في "متجر Play"	`‎..._play_search.csv`
القنوات التي يتم تتبُّعها (نظام مراقبة الزيارات من Urchin)	`‎..._utm_tagged.csv`

لم تعُد سمة "بحث Google" (النتائج المجانية) متوفّرة منذ حزيران (يونيو) 2019.

هل كان ذلك مفيدًا؟

كيف يمكننا تحسينها؟

تنزيل وتصدير التقارير الشهرية

أنواع التقارير

تنزيل التقارير

تنزيل التقارير من Google Cloud Storage

العثور على معرّف الموارد المنتظم (URI) لخدمة Google Cloud Storage

الخطوة 1: إنشاء حساب خدمة

الخطوة 2: إضافة حساب الخدمة على Play Console

الخطوة 3: استرجاع التقارير باستخدام طلب بيانات من واجهة برمجة التطبيقات

التحكُّم في الوصول إلى خدمة Google Cloud Storage

الأوامر وتنسيقات الملفات التي تخص التقارير التفصيلية

الأعطال و أخطاء ANR

المراجعات

الأمر

تنسيق الملف

مثال

التقارير المالية

لمحة

الأمر

مثال

تنسيق الملف

لمحة

الأمر

مثال

تنسيق الملف

نبذة

الأمر

تنسيق الملف

نبذة

الأمر

تنسيق الملف

الاشتراكات

الأمر

تنسيق الملف

الأوامر وتنسيقات الملفات التي تخص التقارير المجمَّعة

الإحصاءات

الأمر

تنسيق الملف

السمات المتوافقة

مثال

الأمر

تنسيق الملف

السمات المتوافقة

مثال

الأمر

تنسيق الملف

السمات المتوافقة

مثال

الأمر

تنسيق الملف

السمات المتوافقة

اكتساب المستخدمين

الأمر

تنسيق الملف

السمات المتوافقة

أسماء ملفات CSV

الأمر

تنسيق الملف

بنية التصنيف المتاحة

الأمر

تنسيق الملف

السمات المتوافقة

هل كان ذلك مفيدًا؟

هل تحتاج إلى مزيد من المساعدة؟

جرِّب الخطوات التالية: