الحصول على إحصاءات حول استخدام التطبيق
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكنك الحصول على مقاييس بطاقة بيانات التطبيق والمستخدمين والتثبيت من "إحصاءات Google" وحزمة تطوير البرامج (SDK) في Google Workspace Marketplace.
الحصول على إحصاءات بيانات بطاقة بيانات المتجر من "إحصاءات Google"
لمراقبة كيفية تفاعل المستخدمين مع بطاقة بيانات تطبيقك باستخدام "إحصاءات Google"، عليك الموافقة على استخدام "إحصاءات Google 4". يمكنك بعد ذلك منح مستخدمين آخرين إذن الوصول إلى إحصاءات بطاقة بيانات التطبيق ومراجعتها.
الاشتراك في "إحصاءات Google 4"
في Google Cloud Console، انتقِل إلى القائمة
menu> واجهات برمجة التطبيقات والخدمات >
Google Workspace Marketplace SDK.
الانتقال إلى صفحة حزمة تطوير البرامج (SDK) في Google Workspace Marketplace
انقروا على علامة التبويب الإحصاءات.
للاطّلاع على مقاييس إضافية، انقر على الاشتراك في "إحصاءات Google".
بعد الموافقة، يتم استبدال زر الموافقة بأدوات "إحصاءات Google".
منح المستخدمين إذن الوصول إلى بيانات "إحصاءات Google"
في مشروع Google Cloud الخاص بتطبيقك، وافِق على الحصول على إذن الوصول marketer إلى موقع "إحصاءات Google 4" المملوك من Google. للاطّلاع على التعليمات، يُرجى الانتقال إلى مقالة إدارة أذونات الوصول والقيود المفروضة على البيانات.
يتطلّب ذلك إذن editor للوصول إلى مشروع تطبيقك على Google Cloud.
في Google Cloud Console، انتقِل إلى القائمة
menu> واجهات برمجة التطبيقات والخدمات >
Google Workspace Marketplace SDK.
الانتقال إلى صفحة حزمة تطوير البرامج (SDK) في Google Workspace Marketplace
انقروا على علامة التبويب الإحصاءات.
في قسم "إحصاءات Google"، أدخِل المستخدمين الذين تريد منحهم إذن marketerالوصول إلى بيانات بطاقة بيانات تطبيقك.
العثور على مقاييس التطبيق في "إحصاءات Google"
تتضمّن "إحصاءات Google" المعلومات التالية:
- عدد الزوّار الذين اطّلعوا على بطاقة بيانات تطبيقك لفترة زمنية محدّدة لا يتم احتساب الزيارة إلا إذا نقر الزائر على بطاقة بيانات تطبيقك للاطّلاع على التفاصيل.
- التوزيع الجغرافي للزوّار
- طريقة وصول الزوّار إلى بطاقة بيانات تطبيقك، مثلاً من خلال "بحث Google"
- متوسط الوقت المستغرَق في عرض بطاقة بيانات تطبيقك
- أحداث التثبيت التي يتم إنشاؤها عندما يبدأ المستخدمون في تثبيت تطبيقك وينتهون من ذلك. تتيح لك هذه الأحداث تحديد عدد المرات التي تم فيها إلغاء عملية التثبيت وعدد عمليات التثبيت التي تم إكمالها بمرور الوقت.
للعثور على معلومات التثبيت في "إحصاءات Google"، ابحث باستخدام معلومات الحدث التالية:
| أحداث التثبيت |
| عند بدء تثبيت التطبيق |
category=workspace_MARKETPLACE
action=START_INSTALL |
| عند اكتمال عملية تثبيت التطبيق |
category=workspace_MARKETPLACE
action=FINISH_INSTALL |
الحصول على إحصاءات بطاقة بيانات التطبيق في حزمة تطوير البرامج (SDK) في Google Workspace Marketplace
للحصول على إحصاءات حول بطاقة بيانات المتجر مباشرةً من Google Cloud Console، اتّبِع الخطوات التالية:
في Google Cloud Console، انتقِل إلى القائمة
menu> واجهات برمجة التطبيقات والخدمات >
Google Workspace Marketplace SDK.
الانتقال إلى صفحة حزمة تطوير البرامج (SDK) في Google Workspace Marketplace
انقروا على علامة التبويب الإحصاءات.
تتوفّر المعلومات التالية:
| نوع البيانات |
الوصف |
|
عمليات التثبيت من النطاق
|
عدد النطاقات التي تم تثبيت تطبيقك عليها. على سبيل المثال، إذا ثبَّت مشرف altostrat.com تطبيقك لـ 500 مستخدم، وثبَّت مشرف examplepetstore.com تطبيقك لـ 30 مستخدمًا، سيكون عدد عمليات التثبيت على النطاقَين هو نطاقَين.
|
|
عمليات تثبيت على الأجهزة
|
عدد المستخدمين الذين ثبَّتوا تطبيقك وفعّلوه. على سبيل المثال، إذا ثبَّت مشرف altostrat.com تطبيقك لـ 500 مستخدم، وثبَّت مشرف examplepetstore.com تطبيقك لـ 30 مستخدم، سيكون عدد عمليات تثبيت الترخيص 530 ترخيصًا.
|
|
عمليات التثبيت الفردية للمستخدمين النهائيين
|
عدد المستخدمين الذين ثبَّتوا تطبيقك مباشرةً، ولا يشمل هذا العدد عمليات التثبيت التي أجراها مشرفو النطاق. على سبيل المثال، إذا ثبَّت مشرف نطاق altostrat.com تطبيقك لـ 500 مستخدم، وثبَّت 25 مستخدمًا فرديًا من نطاق examplepetstore.com تطبيقك، سيكون عدد عمليات التثبيت الفردية من قِبل المستخدمين النهائيين هو 25.
|
|
مرات الظهور اليومية للتطبيق
|
عدد الزيارات في اليوم إلى بطاقة بيانات تطبيقك في Google Workspace Marketplace تتم إعادة ضبط العدد في منتصف الليل بتوقيت غرينتش -7
(أمريكا/لوس أنجلوس).
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-01 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-01 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eGain insights into app listing performance, user engagement, and installation metrics through Google Analytics and the Google Workspace Marketplace SDK.\u003c/p\u003e\n"],["\u003cp\u003eOpt-in to Google Analytics 4 to access detailed app listing analytics, including visitor demographics, traffic sources, and install event tracking.\u003c/p\u003e\n"],["\u003cp\u003eThe Google Workspace Marketplace SDK provides data on domain and seat installs, offering a view of your app's reach and user base.\u003c/p\u003e\n"],["\u003cp\u003eConnect your app with a licensing or billing server to manage monetization and track app installations and removals using the Google Workspace Marketplace API.\u003c/p\u003e\n"]]],["App metrics, including listing views and installs, are available via Google Analytics and the Google Workspace Marketplace SDK. To access listing analytics in Google Analytics, opt-in to Google Analytics 4 and grant `marketer` access to other users. Google Analytics provides data on visitor counts, geography, traffic sources, and install events. The Marketplace SDK provides data such as domain installs, seat installs, and individual user installs directly. The API `LicenseNotification` collection tracks app installations and removals from domains, which can be integrated with your billing server.\n"],null,["# Get analytics about app usage\n\nYou can get app listing, user, and installation metrics from\nGoogle Analytics and the Google Workspace Marketplace SDK.\n\nGet app listing analytics from Google Analytics\n-----------------------------------------------\n\nTo monitor how users interact with your app listing with\nGoogle Analytics, you must opt-in to Google Analytics 4. Then\nyou can give other users access and review app listing analytics.\n\n### Opt in to Google Analytics 4\n\n1. In the Google Cloud console, go to **Menu\n menu\\\u003e APIs \\& Services \\\u003e\n Google Workspace Marketplace SDK**.\n\n [Go to the Google Workspace Marketplace SDK page](https://console.cloud.google.com/apis/api/appsmarket-component.googleapis.com)\n2. Click the **Analytics** tab.\n\n3. To view additional metrics, click **Opt in to Google Analytics**.\n\nAfter you opt in, the opt-in button is replaced with Google Analytics\ntools.\n\n### Give users access to Google Analytics data\n\n1. In your app's Google Cloud project, opt in to get `marketer` access to the\n Google-owned Analytics 4 property. For instructions, see [Access and\n data-restriction\n management](https://support.google.com/analytics/answer/9305587#zippy=%2Cgoogle-analytics).\n Requires `editor` access to your app's Google Cloud project.\n\n2. In the Google Cloud console, go to **Menu\n menu\\\u003e APIs \\& Services \\\u003e\n Google Workspace Marketplace SDK**.\n\n [Go to the Google Workspace Marketplace SDK page](https://console.cloud.google.com/apis/api/appsmarket-component.googleapis.com)\n3. Click the **Analytics** tab.\n\n4. In the Google Analytics section, enter the users you want to have\n `marketer` access to your app listing data.\n\n### Find app metrics in Google Analytics\n\nGoogle Analytics includes the following information:\n\n- How many visitors have viewed your app listing for a specific time period. A visit is only counted if the visitor clicks on your app listing to view the details.\n- The geographic distribution of visitors.\n- How visitors reach your app listing, for example, from a Google Search.\n- The average time spent viewing your app listing.\n- Install events that are created when users start and finish installing your app. These events let you determine how often an install process was aborted and how many installs were completed over time.\n\nTo find install information in Google Analytics, search using the\nfollowing event information:\n\n| Install events ||\n|--------------------------------------------------|----------------------------------------------------------|\n| When an install of the application is started. | `category=workspace_MARKETPLACE` `action=START_INSTALL` |\n| When an install of the application is completed. | `category=workspace_MARKETPLACE` `action=FINISH_INSTALL` |\n\nGet app listing analytics in the Google Workspace Marketplace SDK\n-----------------------------------------------------------------\n\nTo get app listing analytics directly from the Google Cloud console:\n\n1. In the Google Cloud console, go to **Menu\n menu\\\u003e APIs \\& Services \\\u003e\n Google Workspace Marketplace SDK**.\n\n [Go to the Google Workspace Marketplace SDK page](https://console.cloud.google.com/apis/api/appsmarket-component.googleapis.com)\n2. Click the **Analytics** tab.\n\nThe following information is available:\n\n| Data type | Description |\n|----------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Domain installs** | The number of domains that have installed your app. For example, if the administrator of altostrat.com installs your app for 500 users and the administrator of examplepetstore.com installs your app for 30 users, the domain installs count is two domains. |\n| **Seat installs** | The number of users that have your app installed and enabled. For example, if the administrator for altostrat.com installs your app for 500 users and the administrator for examplepetstore.com installs your app for 30 users, the seat installs count is 530 seats. |\n| **Individual end user installs** | The number of users that have directly installed your app. The individual end user install count doesn't include installs made by domain administrators. For example, if the administrator for altostrat.com installs your app for 500 users and 25 individual users from examplepetstore.com install your app, the individual end user install count is 25. |\n| **Daily app impressions** | The number of visits per day to your app listing in Google Workspace Marketplace. The count resets at midnight GMT-7 (America/Los Angeles). |"]]
