Google Play In-App Reviews API, Google Play In-App Reviews API, Google Play In-App Reviews API
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
Google Play In-App Review API به شما امکان می‌دهد از کاربران بخواهید رتبه‌بندی‌ها و بررسی‌های فروشگاه Play را بدون ناراحتی خروج از برنامه یا بازی خود ارسال کنند.
به طور کلی، جریان بررسی درون برنامه ای (شکل 1 را ببینید) می تواند در هر زمانی در طول سفر کاربر برنامه شما فعال شود. در طول جریان، کاربر این امکان را دارد که برنامه شما را با استفاده از سیستم 1 تا 5 ستاره رتبه بندی کند و یک نظر اختیاری اضافه کند. پس از ارسال، بررسی به فروشگاه Play ارسال می شود و در نهایت نمایش داده می شود.
شکل 1. جریان بررسی درون برنامه ای برای یک کاربر
الزامات دستگاه
بررسی های درون برنامه ای فقط در دستگاه های زیر کار می کنند:
دستگاه‌های Android (تلفن، تبلت و تلویزیون با Google TV) دارای Android نسخه 5.0 (سطح API 21) یا بالاتر که فروشگاه Google Play را نصب کرده‌اند.
دستگاه‌های ChromeOS که فروشگاه Google Play را نصب کرده‌اند.
نیازمندی های کتابخانه Core Play
برای ادغام نظرات درون برنامه ای در برنامه خود، برنامه شما باید از نسخه 1.8.0 یا بالاتر کتابخانه Play Core استفاده کند.
چه زمانی درخواست بررسی درون برنامه ای کنیم
این دستورالعمل ها را دنبال کنید تا به شما کمک کند تصمیم بگیرید چه زمانی از کاربران درخواست بررسی درون برنامه ای کنید:
پس از اینکه کاربر به اندازه کافی برنامه یا بازی شما را برای ارائه بازخورد مفید تجربه کرد، جریان بررسی درون برنامه را فعال کنید.
بیش از حد از کاربر برای بررسی درخواست نکنید. این رویکرد به به حداقل رساندن ناامیدی کاربر و محدود کردن استفاده از API کمک می کند (به بخش سهمیه ها مراجعه کنید).
برنامه شما نباید قبل یا در حین ارائه دکمه یا کارت رتبه‌بندی از کاربر سؤالی بپرسد، از جمله سؤالاتی درباره نظر او (مانند «آیا برنامه را دوست دارید؟») یا سؤالات پیش‌بینی‌کننده (مانند «آیا به این برنامه 5 ستاره امتیاز می‌دهید»).
دستورالعمل های طراحی
هنگام تعیین نحوه ادغام نظرات درون برنامه ای در برنامه، این دستورالعمل ها را دنبال کنید:
کارت را همانطور که هست، بدون دستکاری یا تغییر در طرح موجود به هیچ وجه، از جمله اندازه، کدورت، شکل یا سایر خصوصیات، سطح کنید.
هیچ پوششی در بالای کارت یا اطراف کارت اضافه نکنید.
کارت و پس زمینه کارت باید در بالاترین لایه باشد. هنگامی که کارت ظاهر شد، کارت را به صورت برنامه‌ریزی حذف نکنید. کارت به طور خودکار بر اساس اقدام صریح کاربر یا مکانیزم داخلی Play Store حذف می شود.
سهمیه ها
برای ارائه یک تجربه کاربری عالی، Google Play یک سهمیه زمانی محدود در مورد اینکه هر چند وقت یکبار می‌تواند گفتگوی مرور را به کاربر نشان دهد، اعمال می‌کند. به دلیل این سهمیه، فراخوانی متد launchReviewFlow بیش از یک بار در مدت زمان کوتاه (مثلاً کمتر از یک ماه) ممکن است همیشه یک گفتگو نمایش داده نشود.
از آنجا که سهمیه ممکن است تغییر کند، مهم است که منطق خود را اعمال کنید و بهترین لحظه ممکن را برای درخواست بازبینی هدف قرار دهید. به عنوان مثال، برای فعال کردن API نباید گزینه فراخوانی برای اقدام (مانند یک دکمه) داشته باشید ، زیرا ممکن است کاربر قبلاً سهمیه خود را زده باشد و جریان نمایش داده نخواهد شد و تجربه ای شکسته را به کاربر ارائه می دهد. برای این مورد، کاربر را به فروشگاه Play هدایت کنید.
نظرات درون برنامه ای را در برنامه خود ادغام کنید
با نحوه ادغام نظرات درون برنامه ای در برنامه خود، بسته به محیط توسعه خود آشنا شوید:
با دسترسی یا استفاده از کتابخانه نقدهای درون برنامه Play، با شرایط خدمات کیت توسعه نرم‌افزار Play Core موافقت می‌کنید. قبل از دسترسی به کتابخانه، همه شرایط و خط مشی های قابل اجرا را بخوانید و درک کنید.
ایمنی داده ها
کتابخانه‌های Play Core رابط زمان اجرا برنامه شما با فروشگاه Google Play هستند. به این ترتیب، هنگامی که از Play Core در برنامه خود استفاده می‌کنید، فروشگاه Play فرآیندهای خود را اجرا می‌کند، که شامل مدیریت داده‌ها مطابق با شرایط خدمات Google Play می‌شود. اطلاعات زیر نحوه مدیریت داده‌ها را کتابخانه‌های Play Core برای پردازش درخواست‌های خاص از برنامه شما توضیح می‌دهد.
بررسی های درون برنامه ای
داده های جمع آوری شده در مورد استفاده
داده های وارد شده توسط کاربر (رتبه بندی و بررسی متن آزاد)
هدف از جمع آوری داده ها
داده‌های جمع‌آوری‌شده برای بررسی در فروشگاه Play استفاده می‌شود.
رمزگذاری داده ها
داده ها رمزگذاری شده است.
به اشتراک گذاری داده ها
داده‌های جمع‌آوری‌شده در یک بررسی عمومی در فروشگاه Play استفاده می‌شود یا اگر برنامه در مسیر آزمایشی بسته باشد، داده‌های جمع‌آوری‌شده به‌طور خصوصی با توسعه‌دهنده برنامه به اشتراک گذاشته می‌شود.
حذف داده ها
کاربران می توانند نظرات خود را در حساب Google Play Store یا حساب Google خود حذف کنند.
در حالی که هدف ما شفاف‌سازی تا حد امکان است، شما تنها مسئول تصمیم‌گیری در مورد نحوه پاسخگویی به فرم بخش ایمنی داده‌های Google Play در رابطه با جمع‌آوری، اشتراک‌گذاری و شیوه‌های امنیتی داده‌های کاربر برنامه خود هستید.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-08-08 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-08-08 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Google Play In-App Reviews API\n\nThe Google Play In-App Review API lets you prompt users to submit Play Store\nratings and reviews without the inconvenience of leaving your app or game.\n\nGenerally, the in-app review flow (see figure 1) can be triggered at any time\nthroughout the user journey of your app. During the flow, the user has the\nability to rate your app using the 1 to 5 star system and to add an optional\ncomment. Once submitted, the review is sent to the Play Store and eventually\ndisplayed.\n| **Note:** To protect user privacy and avoid API misuse, there are strict guidelines that your app should follow about [when to request in-app reviews](#when-to-request) and the [design of the review prompt](#design-guidelines).\n\n\n**Figure 1.** In-app review flow for a user\n\n\u003cbr /\u003e\n\nDevice requirements\n-------------------\n\nIn-app reviews only work on the following devices:\n\n- Android devices (phones, tablets, and TVs with Google TV) running Android 5.0 (API level 21) or higher that have the Google Play Store installed.\n- ChromeOS devices that have the Google Play Store installed.\n\nPlay Core library requirements\n------------------------------\n\nTo integrate in-app reviews in your app, your app must use version 1.8.0 or\nhigher of the [Play Core library](/guide/playcore).\n\nWhen to request an in-app review\n--------------------------------\n\nFollow these guidelines to help you decide when to request in-app reviews from\nusers:\n\n- Trigger the in-app review flow after a user has experienced enough of your app or game to provide useful feedback.\n- Don't prompt the user excessively for a review. This approach helps minimize user frustration and limit API usage (see the [section on quotas](#quotas)).\n- Your app shouldn't ask the user any questions before or while presenting the rating button or card, including questions about their opinion (such as \"Do you like the app?\") or predictive questions (such as \"Would you rate this app 5 stars\").\n\nDesign guidelines\n-----------------\n\nFollow these guidelines as you determine how to integrate in-app reviews in your\napp:\n\n- Surface the card as-is, without tampering or modifying the existing design in any way, including size, opacity, shape, or other properties.\n- Don't add any overlay on top of the card or around the card.\n- The card and the card's background should be on the topmost layer. Once the card has surfaced, don't programmatically remove the card. The card is removed automatically based on either the user's explicit action, or an internal Play Store mechanism.\n\nQuotas\n------\n\nTo provide a great user experience, Google Play enforces a time-bound quota on\nhow often a user can be shown the review dialog. Because of this quota, calling\nthe `launchReviewFlow` method more than once during a short period of time (for\nexample, less than a month) might not always display a dialog.\n| **Note:** The specific value of the quota is an implementation detail, and it can be changed by Google Play without any notice.\n\nBecause the quota is subject to change, it's important to apply your own logic\nand target the best possible moment to request a review. For example, **you\nshould not have a call-to-action option (such as a button) to trigger the API**,\nas a user might have already hit their quota and the flow won't be shown,\npresenting a broken experience to the user. For this use case, redirect the user\nto the Play Store instead.\n\nIntegrate in-app reviews in your app\n------------------------------------\n\nLearn how to integrate in-app reviews in your app, depending on your development\nenvironment:\n\n- [Kotlin or Java](/guide/playcore/in-app-review/kotlin-java)\n- [Native (C++)](/guide/playcore/in-app-review/native)\n- [Unity](/guide/playcore/in-app-review/unity)\n- [Unreal Engine](/guide/playcore/in-app-review/unreal-engine)\n\nTerms of service and data safety\n--------------------------------\n\nBy accessing or using the Play In-App Reviews Library, you agree to the [Play\nCore Software Development Kit Terms of Service](/guide/playcore#license). Read and understand all\napplicable terms and policies before accessing the library.\n\nData Safety\n-----------\n\nThe Play Core libraries are your app's runtime interface with the Google Play\nStore. As such, when you use Play Core in your app, the Play Store runs its own\nprocesses, which include handling data as governed by the [Google Play Terms of\nService](https://play.google.com/about/play-terms/index.html). The following information describes how the Play Core\nlibraries handle data to process specific requests from your app.\n\n### In-app Reviews\n\n|----------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Data collected on usage | User-entered data (rating and free-text review) |\n| Purpose of data collection | The data collected is used to leave a review on the Play Store. |\n| Data encryption | Data is encrypted. |\n| Data sharing | The data collected is used in a public review on the Play Store or, if the app is in a closed test track, the data collected is shared privately with the app developer. |\n| Data deletion | Users can delete their reviews in their Google Play Store account or Google Account. |\n\nWhile we aim to be as transparent as possible, you are solely responsible for\ndeciding how to respond to Google Play's data safety section form regarding your\napp's user data collection, sharing, and security practices."]]
