‫Sidekick در «بازی‌های Play»

«داشبورد کمکی بازی‌های Play» یک رونهاد است که با ارائه مستقیم محتوا و پیشنهادهای مرتبط به بازیکنان، به آن‌ها کمک می‌کند در بازی شما بمانند.

  • با ویدیوهای رسمی و محتواسازان، بازیکنان را در بازی‌تان نگه دارید تا بازیکنان بتوانند بدون عوض کردن برنامه‌ها، راهنماها، راهنمای گام‌به‌گام، و جاری‌سازی‌های زنده را پیدا کنند.
  • افزایش درآمدزایی با تبدیل امتیاز در لحظه، پیشنهادهای با بودجه Play، و کوپن‌های Pass.
  • شیوه بازی پاداش‌دار با زنجیره‌های بازی، مأموریت‌ها، و تعاملات نمایه ادغام‌شده.
  • تعامل عمیق‌تر با محتوا و ویدیوها.
‹Sidekick در «بازی‌های Play»› با ویژگی‌های دردسترس.
داشبورد کمکی «بازی‌های Play» (برای بزرگ کردن کلیک کنید).

ویژگی‌ها

ویژگی‌های دردسترس در Sidekick بسته به بازی، وضعیت ادغام «خدمات بازی‌های Google Play»، و ثبت‌نام در Play Points متفاوت خواهد بود. بازیکنان می‌توانند منتظر ویژگی‌های زیر باشند:

  • ابزارهای کاربردی بازی: نماگرفت، ضبط صفحه‌نمایش، «جاری‌سازی زنده YouTube»، و «مزاحم نشوید».
  • موفقیت‌ها: به پیاده‌سازی موفقیت‌ها نیاز دارد.
  • زنجیره‌های بازی: زنجیره‌های بازی.
  • تبدیل اعتبار Play Points.
  • افزایش‌دهنده‌ها و کوپن‌های Play Points: برای توسعه‌دهندگان ثبت‌نام‌شده در Play Points دردسترس است.
  • مزایا و پیشنهادهای ویژه Play Pass.
  • مأموریت‌ها: مأموریت‌ها برای توسعه‌دهندگان Quest ثبت‌نام‌شده دردسترس است.
  • ویدیوهای رسمی و محتواساز: Sidekick ویدیوهایی را که اضافه می‌کنید نشان می‌دهد. برای اطلاعات بیشتر درباره نحوه افزودن ویدیو در «فروشگاه Play» و Sidekick، به به‌نمایش گذاشتن برنامه با ویدیوهای YouTube در Google Play مراجعه کنید.

الزامات نرم‌افزاری و سخت‌افزاری

برای دسترسی به Sidekick، بازیکنان به موارد زیر نیاز دارند:

  • تلفن همراه با Android 13 یا بالاتر.
  • بازیکنان باید یک نمایه بازیکن داشته باشند.
  • بازی باید از «فروشگاه Play» نصب شده باشد.

امتحان کردن Sidekick

برای فعال کردن Sidekick برای بازی‌تان، این مراحل را دنبال کنید:

روشن کردن Sidekick به‌طور پیش‌فرض برای بازی شما

برای آزمایش نسخه‌های پیش‌انتشار بازی‌تان با Sidekick و جمع‌آوری بازخورد هدفمند، یک نسخه پخش آزمایشی داخلی یا بسته در «کنسول Play» ایجاد کنید. توجه داشته باشید که اگرچه آزمایش در دسته آزمایشی بتا بسته مقایسه مستقیمی برای سنجه‌های عملکرد ارائه نمی‌دهد، اما همچنان روشی معتبر برای آزمایش عملکردی پایه ادغام Sidekick شما است.

پس‌از اینکه با گروه کوچک‌تری از همکاران یا کاربران مورداعتماد آزمایش کردید، می‌توانید آزمایش را به نسخه پخش باز گسترش دهید.

  1. در «کنسول Play»، نسخه پخش آزمایش داخلی یا بسته راه‌اندازی کنید.
  2. برای افزودن Sidekick در «بازی‌های Play» به دسته برنامه‌تان، Sidekick به‌طور پیش‌فرض روشن است را انتخاب کنید.
  3. آزمایش را انجام دهید.
  4. وقتی آماده شد، ساخت را در دسته هدف تولید منتشر کنید. برای اطلاعات بیشتر، به آماده‌سازی نسخه پخش به‌صورت مرحله‌ای مراجعه کنید.

بازیکنان می‌توانند رؤیت‌پذیری Sidekick را هر زمان که بخواهند ازطریق تنظیمات کاربر در «فروشگاه Play» مدیریت کنند.

‫Sidekick به‌طور پیش‌فرض روشن است
افزودن Sidekick در «بازی‌های Play» به بازی شما.

Sidekick را به‌طور ایمن آزمایش کنید

هنگام ادغام Sidekick، مطمئن شوید که رونهاد به‌طور یکپارچه در بازی شما ادغام می‌شود، تجربه بازیکن را به‌طور مداوم حفظ می‌کند، و تأثیر منفی بر سنجه‌های کلیدی مانند سلامت بازی (خرابی‌ها/ANR)، تعامل، و درآمد نمی‌گذارد. برای ایجاد خط مبنای عملکرد قبل‌از راه‌اندازی کامل، از عرضه محدود ۵٪ استفاده کنید.

این کتاب راهنمای آزمایش به شما امکان می‌دهد مقایسه‌ای هم‌زمان در محیط تولیدتان اجرا کنید و ضمن تأیید موفقیت ادغام، ریسک را به‌حداقل برسانید.

دفترچه راهنمای عرضه محدود ۵٪

با انتشار Sidekick برای بخش کوچک و کنترل‌شده‌ای از مخاطبان، می‌توانید با ردیابی سنجه‌ها درمقابل نسخه جدید بازی‌تان، تأثیر آن را جدا کنید.

  • آماده‌سازی نسخه پخش: کیت توسعه نرم‌افزار Sidekick را در بازی‌تان ادغام کنید و ساخت نسخه پخش جدیدی را آماده کنید.
  • شروع عرضه گام‌به‌گام: ساخت جدیدتان را در دسته هدف «تولید» بااستفاده از عرضه گام‌به‌گام ۵٪ در «کنسول Google Play» منتشر کنید. این کار باعث می‌شود ادغام Sidekick برای بخش کوچکی از پایگاه بازیکنان شما به‌صورت هم‌زمان نمایش داده شود.
  • جداسازی براساس نسخه برنامه: مطمئن شوید که ابزارهای تجزیه‌وتحلیل شما به‌گونه‌ای پیکربندی شده‌اند که داده‌ها را به‌طور خاص برای نسخه برنامه‌ای که حاوی ادغام Sidekick است فیلتر کنند.

پایش عملکرد و سنجه‌ها

درطول عرضه گام‌به‌گام ۵٪، عملکرد بازی‌تان را پایش کنید و بااستفاده از ترکیبی از «کنسول Google Play» و راه‌اندازی تجزیه‌وتحلیل خودتان، مطمئن شوید سنجه‌های اصلی‌تان پایدار باقی می‌مانند. هنگام نظارت بر عرضه محدود، روی موارد زیر تمرکز کنید:

  • پیگیری تعامل و پایداری بازی: از «کنسول Google Play» استفاده کنید تا مطمئن شوید معیارهای کلیدی Android (مانند نرخ خرابی و ANR) و سنجه‌های تعامل بازیکن برای نسخه جدید برنامه پایدار باقی می‌مانند.
  • ثبات درآمد را پیگیری کنید: درآمد و سنجه‌های خرید درون‌برنامه‌ای را بااستفاده از زیرساخت تجزیه‌وتحلیل موجودتان، مثل Google Analytics یا ابزارهای داخلی «هوش کسب‌وکار» (BI)، به‌دقت پایش کنید. گروه ۵ درصدی را که به Sidekick دسترسی دارد با بقیه ترافیک تولیدتان مقایسه کنید تا مطمئن شوید درآمدزایی اصلی‌تان پایدار می‌ماند.

وقتی مطمئن شدید که «داشبورد کمکی» درطول عرضه گام‌به‌گام ۵٪ با موفقیت درآمد، تعامل، و پایداری شما را تکمیل می‌کند، می‌توانید با اطمینان انتشار را به ۱۰۰٪ بازیکنان خود افزایش دهید.

مدیریت رؤیت‌پذیری Sidekick در دستگاه برای آزمایش کردن

وقتی نسخه پخش در «کنسول Play» برای آزمونگران شما دردسترس قرار گرفت، این مراحل را دنبال کنید تا گزینه‌های توسعه‌دهنده «فروشگاه Play» را در دستگاه فعال کنید:

  1. برنامه «فروشگاه Google Play» را باز کنید.
  2. روی نماد نمایه خود تک‌ضرب بزنید و سپس روی تنظیمات تک‌ضرب بزنید.
  3. روی منو درباره تک‌ضرب بزنید.
  4. روی نسخه «فروشگاه Play» ۷ بار تک‌ضرب بزنید تا پیام You are now a developer! را ببینید. با این کار، گزینه‌های توسعه‌دهندگان در دستگاهتان فعال می‌شود.
  5. روی موارد کلی و سپس گزینه‌های توسعه‌دهندگان تک‌ضرب بزنید.
  6. داشبورد کمکی «بازی‌های Play» را روشن کنید.
  7. به بازی‌تان بروید تا Sidekick را ببینید.
کلید روشن کردن «داشبورد کمکی بازی‌های Play» در برنامه «فروشگاه Google Play».
کلید روشن کردن «داشبورد کمکی Google Play Games» در برنامه «فروشگاه Google Play» (برای بزرگ کردن کلیک کنید).

پیکربندی نقطه ورودی پیش‌فرض Sidekick

به‌طور پیش‌فرض، نقطه ورودی Sidekick به لبه انتهایی منطقی (سمت راست میانی صفحه‌نمایش) متصل است و به‌صورت عمودی در مرکز قرار دارد (با کمی انحراف پیش‌فرض) در هر دو جهت عمودی و افقی. در حالت پیمایش ۳دکمه‌ای، نقطه ورود به طرف مقابل نوار پیمایش منتقل می‌شود.

می‌توانید موقعیت نقطه ورودی پیش‌فرض را با مشخص کردن موقعیت ترجیحی در فایل منبع XML که در فایل AndroidManifest.xml بااستفاده از گزینه‌های زیر ارجاع داده شده است لغو کنید:

  • موقعیت دقیق: موقعیت دقیق نقطه ورودی را به‌صورت درصد در فایل منبع XML مشخص کنید.
  • موقعیت ترازشده با لبه: موقعیت نقطه ورودی ترازشده با لبه را در فایل منبع XML مشخص کنید.

اگر بازیکن درطول بازی به‌صورت دستی نقطه ورود را بکشد و جابه‌جا کند، موقعیت انتخابی او در جلسه‌های بازی حفظ می‌شود و بر پیکربندی XML پیش‌فرض سفارشی اولویت دارد.

پیکربندی موقعیت دقیق نقطه ورودی

برای پیکربندی کردن موقعیت دقیق نقطه ورودی Sidekick برای بازی‌تان، این مراحل را دنبال کنید:

  1. در فایل AndroidManifest.xml، عنصر <meta-data> زیر را به عنصر <application> اضافه کنید:

    <manifest>
  <application>
   <meta-data
   android:name="com.google.android.finsky.deku.OVERLAY_CONFIG"
   android:resource="@xml/XML_RESOURCE_FILE"/>
  </application>
</manifest>

  2. مکان نقطه ورودی را در XML_RESOURCE_FILE مشخص کنید.

    نمونه فایل (res/xml/XML_RESOURCE_FILE.xml):

    <?xml version="1.0" encoding="utf-8"?>
<deku-config>
   <!-- Entrypoint default position overrides -->
   <!-- Anchored to RIGHT edge, 25% down from top -->
   <default-entrypoint-position orientation="portrait" horizontal-position="RIGHT" vertical-position-percent="25" />

   <!-- Anchored to LEFT edge, vertically centered at 50% -->
   <default-entrypoint-position orientation="landscape" horizontal-position="LEFT" vertical-position-percent="50" />

   <!-- Extensible: Add new configuration fields here as needed -->
</deku-config>

برچسب <default-entrypoint-position> از مشخصه‌های زیر پشتیبانی می‌کند:

  • ‫orientation: جهت صفحه‌نمایش برای پیکربندی. مقادیر پشتیبانی‌شده:
    • landscape
    • portrait
  • ‫horizontal-position: لبه افقی صفحه‌نمایش برای لنگر کردن نقطه ورودی. مقادیر پشتیبانی‌شده:
    • LEFT
    • RIGHT

  • vertical-position-percent: مقدار عددی در محدوده 0 تا 100 (برای مثال، "25" یا "50") که جایگاه عمودی را به‌عنوان درصدی از ارتفاع پنجره بازی از بالا مشخص می‌کند. برای مثال، "25" نقطه ورودی را ۲۵٪ پایین‌تر از لبه بالایی قرار می‌دهد و "50" آن را به‌صورت عمودی در مرکز قرار می‌دهد. مقادیری که در محدوده ۰ تا ۱۰۰ نیستند روی نزدیک‌ترین حد تنظیم می‌شوند.

    نقطه ورودی همیشه حاشیه کوچکی از لبه‌های بالا و پایین صفحه را حفظ می‌کند و به‌طور خودکار جابه‌جا می‌شود تا با بریدگی دوربین یا شکاف نمایشگر هم‌پوشانی نداشته باشد. درنتیجه، 0 نقطه ورودی را نزدیک لبه بالایی و 100 آن را نزدیک لبه پایینی قرار می‌دهد.

این مقادیر نشان‌دهنده موقعیت‌های فیزیکی در صفحه‌نمایش است. برای مثال، LEFT نقطه ورودی را به لبه چپ صفحه‌نمایش متصل می‌کند، حتی زمانی که دستگاه روی چیدمان راست‌به‌چپ (RTL) تنظیم شده باشد.

قوانین بازگشت و تقدم

برای پیکربندی موقعیت دقیق، مشخصه‌های orientation، horizontal-position، و vertical-position-percent را در برچسب <default-entrypoint-position> مشخص کنید:

  • اگر horizontal-position و vertical-position-percent هر دو معتبر باشند، بر مشخصه value در همان برچسب اولویت دارند.
  • اگر مشخصه‌های horizontal-position یا vertical-position-percent وجود نداشته باشند یا نامعتبر باشند، نقطه ورود از مشخصه value (درصورت وجود) استفاده می‌کند.
  • اگر مشخصه value نیز وجود نداشته باشد یا نامعتبر باشد، نقطه ورود به موقعیت پیش‌فرض برمی‌گردد.

پیکربندی موقعیت نقطه ورودی ترازشده با لبه

برای پیکربندی کردن موقعیت نقطه ورودی Sidekick ترازشده با لبه برای بازی‌تان، این مراحل را دنبال کنید:

  1. در فایل AndroidManifest.xml، عنصر <meta-data> زیر را به عنصر <application> اضافه کنید:

    <manifest>
 <application>
  <meta-data
  android:name="com.google.android.finsky.deku.OVERLAY_CONFIG"
  android:resource="@xml/XML_RESOURCE_FILE"/>
 </application>

</manifest>

  2. مکان نقطه ورودی را در XML_RESOURCE_FILE مشخص کنید.

    نمونه فایل (res/xml/XML_RESOURCE_FILE.xml):

    <?xml version="1.0" encoding="utf-8"?>
<deku-config>
  <!-- Entrypoint default position overrides -->
  <default-entrypoint-position orientation="landscape" value="MIDDLE_LEFT" />
  <default-entrypoint-position orientation="portrait" value="TOP_RIGHT" />

  <!-- Extensible: Add new configuration fields here as needed -->
</deku-config>

مقادیر پشتیبانی‌شده برای نقطه ورودی orientation:

  • منظره
  • عمودی

مشخصه value نشان‌دهنده موقعیت‌های فیزیکی روی صفحه‌نمایش است. برای مثال، MIDDLE_LEFT همیشه نقطه ورودی را به لبه چپ صفحه‌نمایش متصل می‌کند، حتی وقتی دستگاه روی چیدمان راست به چپ (RTL) تنظیم شده باشد. مقادیر پشتیبانی‌شده برای موقعیت‌های نقطه ورودی ترازشده با لبه به‌شرح زیر است:

  • وسط چپ
  • وسط راست
  • TOP_LEFT
  • بالا سمت راست
  • پایین سمت چپ
  • پایین سمت راست

پیکربندی مدت زمان به‌تعویق انداختن نقطه ورودی درطول FTUE

به‌طور پیش‌فرض، نقطه ورودی «داشبورد کمکی بازی‌های Google Play» بلافاصله نمایش داده می‌شود. می‌توانید نقطه ورود درون‌بازی را برای مدت‌زمان سفارشی پیکربندی‌شده در XML_RESOURCE_FILE به‌تعویق بیندازید.

وقتی مدت زمان به‌تعویق انداختن تنظیم می‌شود، نقطه ورودی Sidekick درطول اولین تجربه کاربری (FTUE) برای زمان پیکربندی‌شده پنهان می‌شود. پس‌از پایان مدت زمان به‌تعویق انداختن، نقطه ورودی ظاهر می‌شود.

  1. در فایل AndroidManifest.xml، عنصر <meta-data> زیر را به عنصر <application> اضافه کنید:

    <manifest>
 <application>
  <meta-data
  android:name="com.google.android.finsky.deku.OVERLAY_CONFIG"
  android:resource="@xml/XML_RESOURCE_FILE"/>
 </application>

</manifest>

  2. مدت زمان به‌تعویق انداختن را در XML_RESOURCE_FILE مشخص کنید.

    نمونه فایل (res/xml/XML_RESOURCE_FILE.xml):

    <?xml version="1.0" encoding="utf-8"?>
<deku-config>
  <!-- Entrypoint default position overrides -->
  <default-entrypoint-position orientation="landscape" value="MIDDLE_LEFT" />
  <default-entrypoint-position orientation="portrait" value="TOP_RIGHT" />

  <!-- Custom Snooze Period -->
  <snooze duration_seconds="300" />

  <!-- Extensible: Add new configuration fields here as needed -->
</deku-config>

مدت زمان به‌تعویق انداختن سفارشی به ۳۰ دقیقه محدود شده است. اگر مقداری را مشخص کنید که از این آستانه فراتر رود، سیستم به‌طور خودکار به حد ۳۰ دقیقه‌ای پیش‌فرض برمی‌گردد.

افزودن خودکار Sidekick به همه بسته‌های بارگذاری‌شده

وقتی نسخهٔ پخش ایجاد می‌کنید و Sidekick را برای بازی‌تان به‌طور پیش‌فرض روشن می‌کنید، Sidekick به همه بسته‌های برنامه آتی شما اضافه می‌شود.

برای تغییر اینکه Sidekick به‌طور پیش‌فرض برای همه بسته‌های برنامه جدیدی که بارگذاری می‌کنید روشن باشد یا نه، این مراحل را دنبال کنید:

  1. کنسول Play را باز کنید.
  2. بازی انتخاب کنید؛
  3. به آزمایش > تنظیمات پیشرفته بروید.
  4. در برگه داشبورد کمکی بازی‌های Play، یکی از گزینه‌های زیر را انتخاب کنید
    • ‫Sidekick را به‌طور خودکار برای بسته‌های برنامه جدیدی که بارگذاری می‌کنید به‌طور پیش‌فرض روشن کنید.
    • روشن نکردن خودکار Sidekick در حالت پیش‌فرض برای دسته‌های برنامه جدیدی که بارگذاری می‌کنید.
  5. ذخیره تغییرات را انتخاب کنید.

اگر به‌روزرسانی‌های برنامه‌تان به‌ندرت انجام می‌شود، ممکن است Sidekick را به‌طور دوره‌ای برای شما به‌روز کنیم. هرزمان بخواهید می‌توانید بااستفاده از تنظیمات پیشرفته در «کنسول Google Play» از Sidekick انصراف دهید.

ارتقا دادن «داشبورد کمکی» به تولید

اگر نسخهٔ پخشی را که حاوی «داشبورد کمکی» است به نسخهٔ تولید ارتقا دهید، بازیکنان «داشبورد کمکی» را خواهند دید. بازیکنان می‌توانند رؤیت‌پذیری Sidekick را هر زمان که بخواهند ازطریق تنظیمات کاربر در برنامه «فروشگاه Play» مدیریت کنند.

بازی‌هایی که با «داشبورد کمکی» انتشار را تبلیغ می‌کنند، رهنمودهای Level Up را برآورده می‌کنند.

پرسشگان

آیا می‌توانید بااستفاده از Publishing API،‏ Sidekick را به بازی‌تان اضافه کنید؟

حتی اگر بااستفاده از Google Play Developer Publishing API منتشر می‌کنید، می‌توانید Sidekick را به بازی‌تان اضافه کنید. ابتدا، Sidekick را به‌طور خودکار به همه بارگذاری‌های دسته اضافه کنید، و سپس فرایند انتشار عادی‌تان را ادامه دهید. «داشبورد کمکی» به «بسته ترکیبی برنامه Android» شما اضافه خواهد شد.

بازی من از Android App Bundle‏ (AAB) استفاده نمی‌کند، چه کار باید بکنم؟

وقتی بسته ترکیبی برنامه Android جدیدی بارگذاری می‌کنید، «داشبورد کمکی» به بازی‌ها اضافه می‌شود.

اگر از فایل‌های APK استفاده می‌کنید، کیت توسعه نرم‌افزار Sidekick را به‌عنوان وابستگی اضافه کنید.

بازی من از محصول ضددستکاری استفاده می‌کند. آیا Sidekick با راه‌حل من سازگار است؟

ما با شرکت‌های پیشرو همکاری کرده‌ایم تا از سازگاری Sidekick اطمینان حاصل کنیم.

اگر از محصول ضد دستکاری ناسازگار استفاده می‌کنید، کیت توسعه نرم‌افزار Sidekick را به‌عنوان وابستگی به APK خود اضافه کنید. اگر سؤال دیگری دارید، درخواست پشتیبانی کنید.

چرا جایزه‌ها در Sidekick نشان داده نمی‌شوند؟

اگر موفقیت‌ها طبق انتظار نشان داده نمی‌شوند، موارد زیر را بررسی کنید:

  • وضعیت پیش‌نویس: موفقیت‌هایی که در وضعیت «پیش‌نویس» هستند در Sidekick نشان داده نمی‌شوند.
  • نشان جایزه: جایزه‌های قفل‌شده فقط زمانی برای همه بازیکنان قابل‌مشاهده است که بازی نشان جایزه را کسب کرده باشد. برای این کار، حداقل ۱۰۰ بازیکن متمایز باید در ۳۰ روز گذشته با میانای برنامه‌سازی کاربردی (API) موفقیت‌ها تماس گرفته باشند.
  • بازشده: اگر بازی نشانی کسب نکرده باشد، بازیکنان موفقیت‌هایی را که قبلاً باز کرده‌اند می‌بینند.