لوحة المساعدة في "ألعاب Google Play"

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

  • يمكنك تشجيع اللاعبين على مواصلة اللعب من خلال الفيديوهات الرسمية وفيديوهات صنّاع المحتوى، ما يتيح لهم العثور على الأدلة والإرشادات وأحداث البث المباشر بدون الحاجة إلى التبديل بين التطبيقات.
  • زيادة تحقيق الربح من خلال استبدال النقاط في الوقت الفعلي، والعروض المموَّلة من Google Play، وقسائم Play Pass.
  • اللعب مقابل مكافآت من خلال سلاسل الانتصارات المتتالية والمهام والتفاعلات مع الملفات الشخصية المدمجة
  • تفاعل أعمق مع المحتوى والفيديوهات
Sidekick في "ألعاب Play" مع الميزات المتاحة
Sidekick في "ألعاب 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 أو إصدار أحدث

تجربة Sidekick

لتفعيل Sidekick في لعبتك، اتّبِع الخطوات التالية:

تفعيل Sidekick تلقائيًا في لعبتك

يمكنك إنشاء إصدار داخلي أو اختبار مغلق في Play Console لاختبار نسخ الإصدارات التجريبية من لعبتك باستخدام Sidekick وجمع ملاحظات لتحقيق الهدف المطلوب. يُرجى العِلم أنّه على الرغم من أنّ الاختبار في مسار إصدار تجريبي مغلق لا يقدّم مقارنة مباشرة لمقاييس الأداء، فإنّه يظل طريقة صالحة لإجراء اختبار وظيفي أساسي لدمج Sidekick.

وبعد اختبار هذه النُسخ من خلال مجموعة من الزملاء أو المستخدمين الأقل عددًا والموثوق بهم، يمكنك توسيع النطاق ليتضمّن اختبارًا مفتوحًا.

  1. في Play Console، أعِدّ إصدارًا للاختبار الداخلي أو المغلق.
  2. لإضافة Sidekick في "ألعاب Play" إلى حِزمة تطبيقك، اختَر ميزة Sidekick مفعّلة تلقائيًا.
  3. أجرِ الاختبارات.
  4. بعد الانتهاء، يمكنك طرح الإصدار العلني. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إعداد إصدار على مراحل.

يمكن للّاعبين التحكّم في ظهور نافذة Sidekick في أي وقت من خلال إعدادات المستخدم في "متجر Play".

ميزة Sidekick مفعّلة تلقائيًا
إضافة Sidekick في "ألعاب Play" إلى لعبتك

اختبار Sidekick بأمان

عند دمج Sidekick، تأكَّد من أنّ النافذة المرافِقة تندمج بسلاسة في لعبتك، وتحافظ على تجربة متّسقة للاعبين، ولا تؤثّر سلبًا في المقاييس الرئيسية، مثل سلامة اللعبة (الأعطال أو أخطاء ANR) والتفاعل والإيرادات. لتحديد مستوى أداء أساسي قبل الإطلاق الكامل، استخدِم طرحًا على مراحل بنسبة %5.

يتيح لك دليل الاختبار هذا إجراء مقارنة متزامنة في بيئة التشغيل الفعلي، ما يقلل من المخاطر أثناء التحقق من نجاح عملية الدمج.

دليل الطرح على مراحل بنسبة %5

من خلال إتاحة Sidekick لشريحة صغيرة ومحدّدة من جمهورك، يمكنك عزل تأثيرها من خلال تتبُّع المقاييس مقارنةً بإصدار لعبتك الجديد.

  • إعداد الإصدار: ادمج حزمة Sidekick SDK في لعبتك وأعِدّ بنية إصدار جديدة.
  • بدء طرح على مراحل: انشر الإصدار الجديد في قناة الإصدار العلني باستخدام طرح على مراحل بنسبة %5 في Google Play Console. يتيح ذلك عرض Sidekick المدمج لشريحة صغيرة من قاعدة اللاعبين في الوقت الفعلي.
  • العزل حسب إصدار التطبيق: تأكَّد من ضبط أدوات الإحصاءات لفلترة البيانات خصيصًا لإصدار التطبيق الذي يتضمّن دمج Sidekick.

مراقبة الأداء والمقاييس

أثناء الطرح على مراحل بنسبة %5، راقِب أداء لعبتك وتأكَّد من ثبات مقاييسك الأساسية باستخدام مزيج من Google Play Console وإعدادات الإحصاءات الخاصة بك. عند مراقبة عملية الطرح على مراحل، ركِّز على ما يلي:

  • تتبُّع التفاعل واستقرار اللعبة: استخدِم Google Play Console للتأكّد من أنّ "مؤشرات Android الحيوية" (مثل نِسب الأعطال وأخطاء ANR) ومقاييس تفاعل اللاعبين تظل مستقرة في إصدار التطبيق الجديد.
  • تتبُّع اتساق الإيرادات: يمكنك مراقبة إيراداتك ومقاييس عمليات الشراء داخل التطبيق عن كثب باستخدام البنية الأساسية الحالية للإحصاءات، مثل "إحصاءات Google" أو أدوات ذكاء الأعمال (BI) الداخلية. قارِن بين مجموعة المستخدمين التي تبلغ نسبتها %5 والتي يمكنها الوصول إلى Sidekick وبقية زيارات الإصدار العلني لضمان استقرار تحقيق الربح الأساسي.

بعد التأكّد من أنّ Sidekick يساهم بنجاح في زيادة إيراداتك وتفاعلك واستقرارك خلال مرحلة الطرح بنسبة %5، يمكنك المضي قدمًا بثقة لزيادة نسبة الطرح إلى %100 من اللاعبين.

إدارة ظهور Sidekick على جهازك لأغراض الاختبار

بعد أن يصبح الإصدار متاحًا للمختبِرين في Play Console، اتّبِع الخطوات التالية لتفعيل خيارات المطوّرين في "متجر Google Play" على الجهاز:

  1. افتح تطبيق "متجر Google Play".
  2. انقر على رمز ملفك الشخصي، ثم على الإعدادات.
  3. انقر على قائمة لمحة.
  4. انقر على إصدار "متجر Google Play" 7 مرات إلى أن تظهر الرسالة You are now a developer!. يؤدي ذلك إلى تفعيل خيارات المطوّرين على جهازك.
  5. انقر على الإعدادات العامة ثم على خيارات المطوّرين.
  6. فعِّل لوحة المساعدة في "ألعاب Play".
  7. انتقِل إلى لعبتك لترى Sidekick يظهر.
مفتاح التبديل لتفعيل ميزة "لوحة المساعدة" في تطبيق "متجر Google Play"
مفتاح التبديل لتفعيل ميزة "Sidekick في ألعاب Play" على تطبيق "متجر Google Play" (انقر لتكبير الصورة).

ضبط نقطة الدخول التلقائية إلى Sidekick

By default, the Sidekick entry point is anchored to the logical end edge (the MIDDLE_RIGHT side of the screen) and is vertically centered (with a slight default offset) in both portrait and landscape orientations. في وضع "التنقّل باستخدام ثلاثة أزرار"، تنتقل نقطة الدخول إلى الجانب المقابل لشريط التنقّل.

يمكنك إلغاء موضع نقطة الدخول التلقائي من خلال تحديد موضع مفضّل في ملف موارد 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" نقطة الدخول على مسافة %25 من الحافة العلوية، بينما يضعها "50" في المنتصف عموديًا. يتم ضبط القيم التي لا تقع ضمن النطاق من 0 إلى 100 على أقرب حدّ.

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

  • MIDDLE_LEFT
  • MIDDLE_RIGHT
  • TOP_LEFT
  • TOP_RIGHT
  • BOTTOM_LEFT
  • BOTTOM_RIGHT

ضبط مدة تأجيل نقطة الدخول أثناء تجربة المستخدم لأول مرة

تظهر نقطة الدخول إلى Sidekick في "ألعاب 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>

الحد الأقصى لمدة التأجيل المخصّصة هو 30 دقيقة. إذا حدّدت قيمة تتجاوز هذا الحدّ، سيضبط النظام تلقائيًا الحدّ الأقصى على 30 دقيقة.

إضافة "لوحة المساعدة" تلقائيًا إلى جميع حزم التطبيقات التي يتم تحميلها

عند إنشاء إصدار وتفعيل Sidekick تلقائيًا في لعبتك، تتم إضافة Sidekick إلى جميع حزم التطبيقات المستقبلية.

لتغيير ما إذا كانت ميزة Sidekick مفعَّلة تلقائيًا لجميع حزم التطبيقات الجديدة التي يتم تحميلها، يُرجى اتّباع الخطوات التالية:

  1. افتح Play Console.
  2. اختَر لعبة.
  3. انتقِل إلى الاختبار > الإعدادات المتقدّمة.
  4. في علامة التبويب لوحة المساعدة في "ألعاب Play"، اختَر أيًا مما يلي:
    • تفعيل ميزة Sidekick تلقائيًا في حزم التطبيقات الجديدة التي يتم تحميلها
    • عدم تفعيل ميزة Sidekick تلقائيًا في حزم التطبيقات الجديدة التي يتم تحميلها
  5. انقر على حفظ التغييرات.

إذا كانت تحديثات تطبيقك غير متكررة، قد نحدّث Sidekick بشكل دوري نيابةً عنك. يمكنك إيقاف Sidekick باستخدام الإعدادات المتقدّمة في Google Play Console في أي وقت.

نقل "لوحة المساعدة" إلى مرحلة الإنتاج

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

الألعاب التي تروّج لإصدار باستخدام لوحة المساعدة تستوفي إرشادات Level Up.

الأسئلة الشائعة

هل يمكنك إضافة Sidekick إلى لعبتك باستخدام Publishing API؟

يمكنك إضافة Sidekick إلى لعبتك حتى إذا كنت تنشرها باستخدام واجهة Google Play Developer Publishing API. أولاً، عليك إضافة Sidekick تلقائيًا إلى جميع حزم التطبيقات التي يتم تحميلها، ثم مواصلة عملية الإصدار العادية. ستتم إضافة Sidekick إلى مجموعة حزمات تطبيق Android.

لا تستخدم لعبتي مجموعة حزمات تطبيق Android (AAB)، فماذا أفعل؟

تتم إضافة Sidekick إلى الألعاب عند تحميل مجموعة حزمات تطبيق Android جديدة.

إذا كانت إصداراتك تعتمد على حِزم APK، يمكنك إضافة حزمة تطوير البرامج (SDK) لـ Sidekick كاعتمادية.

تستخدم لعبتي منتجًا لمكافحة التلاعب. هل تتوافق "لوحة المساعدة" مع الحلّ الذي أستخدمه؟

نعمل مع شركات رائدة لضمان توافق Sidekick معها.

إذا كنت تستخدم منتجًا غير متوافق لمكافحة التلاعب، يمكنك إضافة حزمة Sidekick SDK كاعتمادية إلى حزمة APK. إذا كانت لديك أسئلة أخرى، يمكنك طلب الدعم.

لماذا لا تظهر الإنجازات في Sidekick؟

إذا لم تظهر الإنجازات على النحو المتوقّع، يُرجى التحقّق مما يلي:

  • حالة المسودة: لا تظهر الإنجازات في حالة "المسودة" في Sidekick.
  • شارة الإنجازات: لا تظهر الإنجازات المقفلة لجميع اللاعبين إلا إذا حصلت اللعبة على شارة الإنجازات. يتطلّب ذلك أن يكون هناك 100 لاعب فريد على الأقل قد أجروا طلبات إلى واجهة برمجة التطبيقات للإنجازات خلال آخر 30 يومًا.
  • الإنجازات التي تم تحقيقها: إذا لم تحصل اللعبة على شارة، تظهر للاعبين الإنجازات التي حقّقوها.