«معیارهای کلیدی Android» به Google کمک می‌کند کیفیت برنامه‌های Android را در Google Play بهبود دهد. وقتی کاربری اجازه می‌دهد، دستگاه Android او سنجه‌های کیفیت برنامه مثل پایداری، عملکرد، مصرف باتری، و مشکلات اجازه را ردیابی می‌کند. Google Play این داده‌ها را جمع‌آوری می‌کند، و می‌توانید ازطریق داشبورد معیارهای کلیدی Android در کنسول Play و ازطریق Google Play Developer Reporting API به آن‌ها دسترسی داشته باشید.
توسعه‌دهندگان باید «معیارهای کلیدی Android» را برای بهبود تجربه کاربر، به‌ویژه معیارهای کلیدی اصلی، پایش کنند: میزان خرابی مشهود برای کاربر، میزان خطای ANR مشهود برای کاربر، قفل‌های بیداری جزئی بیش‌ازحد، مصرف حافظه، و مصرف حافظه بیت‌مپ.
معیارهای کلیدی اصلی و رفتارهای بد
معیارهای کلیدی اصلی برنامه‌تان بر نمایان بودن برنامه‌تان در Google Play تأثیر می‌گذارد. علاوه‌بر معیارهای کلیدی اصلی، «معیارهای کلیدی Android» درباره مواردی مثل «بهینه‌سازی کد DEX» که نیاز به توجه دارند و ممکن است بر نمایان بودن برنامه‌تان در Google Play تأثیر بگذارند به شما هشدار می‌دهد. نرخ خرابی مشهود برای کاربر و نرخ خطای ANR مشهود برای کاربر دارای آستانه عملکرد بد کلی و آستانه عملکرد بد به‌ازای هر دستگاه هستند.
«تکرار مفرط قفل‌های بیداری جزئی» فقط آستانه عملکرد بد کلی دارد و «مصرف مفرط باتری» در Wear OS آستانه عملکرد بد کلی و به‌ازای هر مدل ساعت دارد.
سنجه استفاده از حافظه برای هر سطح RAM دستگاه و وضعیت برنامه آستانه‌های متفاوتی دارد و برای برنامه‌ها و بازی‌ها متفاوت است. استفاده از حافظه بیت‌مپ در سطوح مختلف RAM دستگاه یکسان است، اما برای هر وضعیت برنامه آستانه‌های متفاوتی دارد.
پرسشگان
«نشانگرهای حیاتی اصلی» چیست؟
«معیارهای کلیدی اصلی» مهم‌ترین سنجه‌ها در «معیارهای کلیدی Android» هستند و بر نمایان بودن برنامه‌تان در Google Play تأثیر می‌گذارند. معیارهای کلیدی اصلی عبارت‌اند از:
پایداری: نرخ خرابی مشهود برای کاربر و نرخ خطای ANR مشهود برای کاربر برای همه برنامه‌ها.
باتری: قفل‌های بیداری جزئی بیش‌ازحد برای همه برنامه‌ها، و مصرف باتری بیش‌ازحد برای برنامه‌های صفحه ساعت.
حافظه: استفاده از حافظه (مبادله + RSS ناشناس) و استفاده از حافظه بیت‌مپ برای همه برنامه‌های تلفن همراه.
آستانه‌های رفتار بد چیست؟
پایداری و اطلاعات حیاتی باتری
|
آستانه رفتار بد برای بیشینه‌سازی نمایان بودن عنوانتان در Google Play، لطفاً آن را زیر این آستانه‌ها نگه دارید. |
|||
|---|---|---|---|
| کلی (میانگین در همه دستگاه‌ها) | براساس مدل تلفن | برای هر مدل ساعت | |
| میزان خرابی درک‌شده توسط کاربر | ۱٫۰۹٪ | ٪۸ | ٪۴ |
| میزان خطای ANR مشهود برای کاربر | ۰٫۴۷٪ | ٪۸ | ۵٪ |
| مصرف بیش‌ازحد باتری | ٪۱ | - | ٪۱ |
| تکرار مفرط قفل‌های بیداری جزئی | ۵٪ | - | - |
علائم حیاتی حافظه
برنامه‌ها
|
آستانه رفتار بد برای بیشینه‌سازی نمایان بودن عنوانتان در Google Play، لطفاً آن را زیر این آستانه‌ها نگه دارید. |
|||||
|---|---|---|---|---|---|
| RAM فیزیکی (محدوده کل حافظه) |
وضعیت برنامه | ||||
| پیش‌نما | سرویس‌های محسوس برای کاربر | پس‌زمینه | در حافظه پنهان | ||
| استفاده از حافظه (مبادله + RSS ناشناس) | ۰ تا ۴ گیگابایت (۰ تا ۳۲۰۰ مگابایت) |
- | - | - | - |
| ۴ گیگابایت (۳۲۰۰ تا ۴۸۰۰ مگابایت) |
۲٫۰۰ گیگابایت | ۱٫۰۰ گیگابایت | ۱٫۰۰ گیگابایت | - | |
| ۶ گیگابایت (۴۸۰۰ - ۶۸۰۰ مگابایت) |
۲٫۲۵ گیگابایت | ۱٫۲۵ گیگابایت | ۱٫۲۵ گیگابایت | - | |
| ۸ گیگابایت (۶۸۰۰ - ۹۲۱۶ مگابایت) |
۲٫۲۵ گیگابایت | ۱.۵۰ گیگابایت | ۱.۵۰ گیگابایت | - | |
| ۱۲ گیگابایت (۹۲۱۶ - ۱۴۳۳۶ مگابایت) |
۳٫۲۵ گیگابایت | ۱٫۷۵ گیگابایت | ۱٫۷۵ گیگابایت | - | |
| ۱۶ گیگابایت (۱۴۳۳۶ - ۱۸۴۳۲ مگابایت) |
۴٫۲۵ گیگابایت | ۲٫۰۰ گیگابایت | ۲٫۰۰ گیگابایت | - | |
| ۱۶ گیگابایت + (بیشتر از ۱۸۴۳۲ مگابایت) |
- | - | - | - | |
| استفاده از حافظه بیت‌مپ | - | - | ۲۰۰ مگابایت | ۲۰۰ مگابایت | ۴۰۰ مگابایت |
بازی‌ها
|
آستانه رفتار بد برای بیشینه‌سازی نمایان بودن عنوانتان در Google Play، لطفاً آن را زیر این آستانه‌ها نگه دارید. |
|||||
|---|---|---|---|---|---|
| RAM فیزیکی (محدوده کل حافظه) |
وضعیت برنامه | ||||
| پیش‌نما | سرویس‌های محسوس برای کاربر | پس‌زمینه | در حافظه پنهان | ||
| استفاده از حافظه (مبادله + RSS ناشناس) | ۰ تا ۴ گیگابایت (۰ تا ۳۲۰۰ مگابایت) |
- | - | - | - |
| ۴ گیگابایت (۳۲۰۰ تا ۴۸۰۰ مگابایت) |
۲٫۲۵ گیگابایت | ۲٫۰۰ گیگابایت | ۲٫۰۰ گیگابایت | - | |
| ۶ گیگابایت (۴۸۰۰ - ۶۸۰۰ مگابایت) |
۲٫۷۵ گیگابایت | ۲٫۵۰ گیگابایت | ۲٫۵۰ گیگابایت | - | |
| ۸ گیگابایت (۶۸۰۰ - ۹۲۱۶ مگابایت) |
۳٫۵۰ گیگابایت | ۲٫۷۵ گیگابایت | ۲٫۷۵ گیگابایت | - | |
| ۱۲ گیگابایت (۹۲۱۶ - ۱۴۳۳۶ مگابایت) |
۴.۰۰ گیگابایت | ۳.۲۰ گیگابایت | ۳.۲۰ گیگابایت | - | |
| ۱۶ گیگابایت (۱۴۳۳۶ - ۱۸۴۳۲ مگابایت) |
۵٫۰۰ گیگابایت | ۳٫۵۰ گیگابایت | ۳٫۵۰ گیگابایت | - | |
| ۱۶ گیگابایت + (بیشتر از ۱۸۴۳۲ مگابایت) |
- | - | - | - | |
| استفاده از حافظه بیت‌مپ | - | - | ۲۰۰ مگابایت | ۲۰۰ مگابایت | ۴۰۰ مگابایت |
بهینه‌سازی کد DEX
|
آستانه رفتار بد
برای بیشینه‌سازی نمایان بودن عنوان در Google Play، لطفاً آن را بالاتر از این آستانه‌ها نگه دارید. |
||
|---|---|---|
| معیارها | الزام | حداقل آستانه |
| برنامه‌های دارای کد DEX بیشتر از ۱۰ مگابایت | بهینه‌سازی، مبهم‌سازی، و کوچک‌سازی | ٪۲۵ |
| بازی‌های دارای کد DEX بیشتر از ۵۰ مگابایت | بهینه‌سازی، مبهم‌سازی، و کوچک‌سازی | ٪۲۵ |
«معیارهای کلیدی اصلی» چگونه بر نمایان بودن عنوان من در Play تأثیر می‌گذارد؟
اگر برنامه یا بازی‌تان از آستانه رفتار بد فراتر برود، Play ممکن است نمایان بودن عنوان شما را کاهش دهد. Play ممکن است هشداری در فهرستگان فروشگاهتان به کاربران نشان دهد.
آیا امکان دارد هم رفتار بد مبتنی بر هر دستگاه و هم رفتار بد کلی داشته باشم؟ یا یکی را دارد و دیگری را ندارد؟ در این صورت چه کاری باید انجام دهم؟
بله، همه ترکیب‌ها امکان‌پذیر است. برای بهبود کیفیت برنامه، خرابی‌ها و خطاهای ANR را که بر اکثر کاربران تأثیر می‌گذارند برطرف کنید. برای کیفیت بهتر در دستگاه‌های خاص، بزرگ‌ترین گروه‌های خرابی و خطای ANR را در آن دستگاه‌ها برطرف کنید. اگر هر دو مشکل را دارید، ابتدا روی بزرگ‌ترین دسته‌های کلی خرابی و ANR تمرکز کنید.
برای رفع مشکلات فنی به کمک نیاز دارم. از کجا شروع کنم؟
منابع زیر ارائه شده است تا به شما کمک کند بفهمید «معیارهای کلیدی Android» چگونه مشکلات فنی را در برنامه یا بازی‌تان ردیابی می‌کند، و می‌توانید برای دریافت راهنمایی کلی درباره تشخیص و اصلاح، به پرداختن به مشکلات رایج عملکرد مراجعه کنید.
معیارهای کلیدی اصلی وب:
میزان خطای ANR مشهود برای کاربر
میزان خرابی مشهود برای کاربر
مصرف بیش‌ازحد باتری
قفل‌های بیداری جزئی مفرط
استفاده از حافظه (مبادله + RSS ناشناس)
استفاده از حافظه بیت‌مپ
همه علائم حیاتی دیگر:
بیدار شدن‌های مفرط
قفل‌های بیداری جزئی گیرکرده
اسکن‌های Wi-Fi پس‌زمینه مفرط
استفاده مفرط از شبکه پس‌زمینه
زمان راه‌اندازی برنامه
پردازش کند
جلسه‌های آهسته
بستن ناشی از کمبود حافظه (LMK)
رد درخواست‌های اجازه
نمی‌خواهم با رفتارهای بد یا هشدارهای فهرستگان فروشگاه غافلگیر شوم. چگونه می‌توانم از این موضوع پیشی بگیرم؟
Play از داده‌های ۲۸ روز گذشته برای ارزیابی کیفیت برنامه‌تان استفاده می‌کند. «معیارهای کلیدی Android» درباره هر مشکلی که در این دوره زمانی پیش می‌آید به شما هشدار می‌دهد.
- به‌طور منظم واسط کاربر را بررسی کنید یا از Reporting API برای ادغام داده‌ها در گردش کارتان استفاده کنید.
- برای مشکلات، هشدارهای ایمیلی را در «کنسول Play» راه‌اندازی کنید.
- «معیارهای کلیدی Android» مشکلات نوظهور را پرچم‌گذاری می‌کند—مشکلاتی که بیش‌از ۷ روز است دستگاه‌ها را تحت‌تأثیر قرار داده است و باعث ازکارافتادگی و خطای ANR می‌شود. این کار به شما ۲۱ روز فرصت می‌دهد تا به آن‌ها رسیدگی کنید.
دستگاه‌های زیادی با رفتار بد دارم. چگونه می‌توانم این فهرست را درک کنم؟
گاهی اوقات، مشکلات سخت‌افزاری یا نرم‌افزاری دستگاه باعث نرخ خطای بالا می‌شود. «نشانگرهای Android» شما را از پیوندهای احتمالی بین نرخ خطای بالا و مواردی مثل RAM، نسخه Android، و نوع پردازنده مطلع می‌کند. همچنین می‌توانید خودتان بااستفاده از «دسترسی» و «دستگاه‌ها» در «کنسول Play» این پیوندها را بررسی کنید.
«معیارهای کلیدی Android» همچنین دسترسی سریع به اطلاعات کلیدی دستگاه، مثل تعداد کاربران، درآمد، رده‌بندی‌ها، و مرورها را فراهم می‌کند. این اطلاعات در پانل کناری نشان داده می‌شود، بنابراین لازم نیست از صفحه کنونی‌تان خارج شوید.
اگر مشکلی را در دستگاهی برطرف کنم، چه مدت طول می‌کشد تا هشدارها دیگر نمایش داده نشوند؟
Play شاخص‌های کلیدی عملکرد برنامه شما را به‌صورت روزانه بااستفاده از میانگین ۲۸ روزه بررسی می‌کند. وقتی این میانگین بهبود یابد، هشدارهای «معیارهای کلیدی Android» ناپدید می‌شوند. اگر سیستم Play بهبود را تشخیص دهد، هشدارهای فهرستگان فروشگاه ممکن است سریع‌تر برداشته شوند.
اگر نتوانم مشکل را برطرف کنم یا نخواهم این کار را انجام دهم چه می‌شود؟
مطمئن شوید که هزینه‌ها و فرصت‌های ازدست‌رفته ناشی از تجربه کاربری ضعیف مداوم را سنجیده‌اید. عملکرد بد به کاربران فعلی آسیب می‌رساند و جذب کاربران جدید را دشوارتر می‌کند. اگر رفع مشکلات در دستگاه‌های خاص عملی نیست، هدف‌یابی دستگاه و قوانین کنارگذاری را بازنگری کنید.
چرا تعداد و نرخ مشکلات «معیارهای کلیدی Android» با تعداد و نرخ مشکلاتی که از راهکار خود یا راهکارهای شخص ثالث دیگر می‌بینم مطابقت ندارد؟
«معیارهای کلیدی Android» منبع اصلی Play برای کیفیت فنی برنامه است. تعداد مشکلات و نرخ‌ها ممکن است به دلایل مختلفی با منابع دیگر متفاوت باشد:
- داده‌های «معیارهای کلیدی Android» از سیستم Android می‌آید و شامل رویدادهایی است که کیت‌های توسعه نرم‌افزار آن‌ها را نمی‌بینند، مثل:
- خرابی‌های قبل‌از مقداردهی اولیه کیت توسعه نرم‌افزار
- خطاهای ANR قبل‌از Android 12
- «نشانگرهای حیاتی Android» فقط مشکلات دستگاه‌های دارای گواهینامه و برنامه‌های نصب‌شده از Google Play را محاسبه می‌کند.
- «معیارهای کلیدی Android» فقط از داده‌های کاربرانی استفاده می‌کند که با هم‌رسانی داده‌ها موافقت کرده‌اند.
- برای محافظت از حریم خصوصی کاربر، فقط درصورتی داده‌ها را نشان می‌دهیم که داده‌های کافی برای تهیه گزارش‌های ناشناس داشته باشیم.
- نرخ‌های مشکل ممکن است به‌صورت متفاوتی محاسبه شوند. «معیارهای کلیدی Android» مشکلات را به‌ازای هر کاربر فعال روزانه نشان می‌دهد.
- برای مثال، Crashlytics تعداد مشکلات را در هر جلسه برنامه محاسبه می‌کند. اگر کاربری در یک روز سه بار بازی کند و یک بار با خرابی مواجه شود، «نشانگرهای حیاتی Android» نرخ خرابی ۱۰۰٪ را نشان می‌دهد، درحالی‌که Crashlytics نرخ خرابی ۳۳٪ را نشان می‌دهد.
برای کسب اطلاعات بیشتر درباره نحوه جمع‌آوری داده‌ها، مرکز راهنمایی «کنسول Play» را ببینید.
آیا می‌توانم اطلاعات آماری ANR و خرابی‌هایم را در IDE ببینم؟
بله، از Android Studio Meerkat، هنگام مشاهده گزارش‌ها در «اطلاعات آماری کیفیت برنامه»، روی برگه «اطلاعات آماری» کلیک کنید. Gemini خلاصه‌ای از خرابی ارائه می‌دهد، اطلاعات آماری تولید می‌کند، و به مستندات مفید پیوند می‌دهد. اگر به Gemini اجازه دسترسی به زمینه کد محلی را هم بدهید، Gemini می‌تواند نتایج دقیق‌تر، گام‌های بعدی مرتبط، و پیشنهادهای کد ارائه دهد. این کار به شما کمک می‌کند زمان صرف‌شده برای تشخیص و حل مشکلات را کاهش دهید. برای کسب اطلاعات بیشتر، به اسناد «استودیو Android» مراجعه کنید.
جلسه کاربر چیست و چه زمانی شروع و پایان می‌یابد؟
جلسه کاربر به‌عنوان مجموع فعالیت استفاده‌ای که در یک دوره ۲۴ ساعته رخ می‌دهد تعریف می‌شود. دوره ۲۴ ساعته برای همه سنجه‌های «معیارهای کلیدی Android» جمع‌آوری‌شده از نیمه‌شب به وقت اقیانوس آرام (PT) شروع می‌شود. اگر فعالیت استفاده‌ای در برنامه برای آن روز ضبط نشده باشد، جلسه‌ای ضبط نمی‌شود.