Play Games Sidekick

Play Games Sidekick היא שכבת-על שעוזרת לשחקנים להישאר במשחק שלכם, כי היא מספקת להם תוכן ומבצעים רלוונטיים ישירות.

• שומרים את השחקנים במשחק באמצעות סרטונים רשמיים וסרטונים של יוצרים, כדי שהשחקנים יוכלו למצוא מדריכים, הסברים מפורטים ושידורים חיים בלי לעבור בין אפליקציות.
• מונטיזציה מוגברת עם המרת נקודות בזמן אמת, מבצעים במימון Play ושוברי הנחה למנויי Pass.
• משחקים מתגמלים עם רצפים משולבים, קווסטים ואינטראקציות בפרופיל.
• מעורבות עמוקה יותר עם תוכן וסרטונים.

תכונות

התכונות הזמינות ב-Sidekick משתנות בהתאם למשחק, בהתאם למצב השילוב של Google Play Games Services ולהרשמה ל-Play Points. השחקנים יכולים לצפות לתכונות הבאות:

• כלי גיימינג: צילום מסך, הקלטת מסך, שידור חי ב-YouTube ומצב 'נא לא להפריע'.
• הישגים: נדרשת הטמעה של הישגים.
• רצפים של משחקים: רצפים של משחקים.
• המרת נקודות Play לקרדיט.
• בוסטרים ושוברי Play Points: זמינים למפתחים שרשומים לתוכנית Play Points.
• הטבות ומבצעים של Play Pass
• קווסטים: קווסטים זמינים למפתחי Quest שנרשמו.
• סרטונים רשמיים וסרטונים של יוצרים: Sidekick מציג את הסרטונים שאתם מוסיפים. מידע נוסף על הוספת סרטונים ב-חנות Play וב-Sidekick זמין במאמר מקשרים סרטוני YouTube ב-Google Play כדי להציג את האפליקציה למשתמשים.

דרישות תוכנה וחומרה

כדי לגשת ל-Sidekick, השחקנים צריכים:

• טלפון נייד עם Android מגרסה 13 ואילך.

• לשחקנים צריך להיות פרופיל ב-Play Games.
• המשחק צריך להיות מותקן מחנות Play.

רוצה לנסות את Sidekick?

כדי להפעיל את חלונית המשחקים במשחק:

הפעלה של Sidekick כברירת מחדל במשחק

כדי לבדוק גרסאות של המשחק לפני ההשקה באמצעות Sidekick ולאסוף משוב ממוקד, צריך ליצור גרסת בדיקה פנימית או גרסת בדיקה בקבוצה מוגדרת ב-Play Console. שימו לב: למרות שבדיקה במסלול בטא סגור לא מאפשרת השוואה ישירה של מדדי הביצועים, היא עדיין שיטה תקפה לבדיקה פונקציונלית בסיסית של השילוב שלכם עם Sidekick.

אחרי שתסיימו את הבדיקה עם קבוצה קטנה יותר של עמיתים או משתמשים מהימנים, תוכלו להרחיב את הבדיקה ולהפוך אותה להפצה פתוחה.

1. ב-Play Console, מגדירים גרסה לבדיקה פנימית או לבדיקה בקבוצה מוגדרת.
2. כדי להוסיף את Play Games Sidekick לקובץ AAB, בוחרים באפשרות תצוגת Sidekick מופעלת כברירת מחדל.
3. מבצעים את הבדיקה.
4. כשהכול מוכן, מפרסמים את הגרסה לסביבת הייצור. מידע נוסף זמין במאמר בנושא הכנת הפצה בשלבים.

השחקנים יכולים להיכנס בכל שלב להגדרות המשתמש בחנות Play ולקבוע אם להציג או להסתיר את Sidekick.

בדיקה בטוחה של Sidekick

כשמשלבים את Sidekick, חשוב לוודא ששכבת-העל משתלבת בצורה חלקה במשחק, שחוויית השחקן נשארת עקבית ושאין השפעה שלילית על מדדים מרכזיים כמו תקינות המשחק (קריסות/ANR), מעורבות והכנסות. כדי ליצור בסיס להשוואה של הביצועים לפני השקה מלאה, מומלץ להשתמש בהשקה מדורגת של 5%.

המדריך הזה לבדיקות מאפשר לכם להריץ השוואה מקבילה בסביבת הייצור, וכך לצמצם את הסיכון ולאמת את הצלחת השילוב.

הפלייבוק להשקה מדורגת של 5%

אם תשיקו את Sidekick לפלח קטן ומבוקר של הקהל, תוכלו לבודד את ההשפעה שלו על ידי מעקב אחרי מדדים בהשוואה לגרסה החדשה של המשחק.

• הכנת הגרסה: משלבים את Sidekick SDK במשחק ומכינים גרסת ייצור חדשה.
• מתחילים השקה מדורגת: מפרסמים את הגרסה החדשה במסלול לסביבת הייצור באמצעות השקה מדורגת של 5% ב-Google Play Console. כך תוכלו לחשוף את השילוב של Sidekick לחלק קטן מבסיס השחקנים שלכם בזמן אמת.
• בידוד לפי גרסת האפליקציה: צריך לוודא שכלי הניתוח מוגדרים כך שיסננו את הנתונים באופן ספציפי לגרסת האפליקציה שמכילה את השילוב של Sidekick.

מעקב אחרי ביצועים ומדדים

במהלך ההשקה המדורגת ל-5% מהמשתמשים, כדאי לעקוב אחרי הביצועים של המשחק ולוודא שמדדי הליבה נשארים יציבים. לשם כך, אפשר להשתמש בשילוב של Google Play Console והגדרות הניתוח שלכם. כשעוקבים אחרי השקה מדורגת, חשוב להתמקד בנקודות הבאות:

• מעקב אחרי רמת העניין והיציבות של המשחק: כדאי להשתמש ב-Google Play Console כדי לוודא שמדדי תפקוד האפליקציה ב-Android (כמו שיעורי קריסות ומקרי ANR) ומדדי רמת העניין של השחקנים נשארים יציבים בגרסה החדשה של האפליקציה.
• מעקב אחר עקביות ההכנסות: כדאי לעקוב מקרוב אחרי מדדי ההכנסות והרכישות מתוך האפליקציה באמצעות תשתית הניתוח הקיימת, כמו Google Analytics או כלי הבינה העסקית (BI) הפנימיים. כדי לוודא שהמונטיזציה העיקרית שלכם נשארת יציבה, כדאי להשוות בין קבוצת המשתמשים של 5% שיש להם גישה ל-Sidekick לבין שאר תנועת הגולשים בסביבת הייצור.

אחרי שתוודאו שחלונית המשחקים משפרת את ההכנסות, את רמת המעורבות ואת היציבות של המשחק במהלך השקת הגרסה הראשונית (canary) ל-5% מהשחקנים, תוכלו להמשיך בביטחון ולהשיק את המשחק ל-100% מהשחקנים.

איך קובעים אם רוצים לראות את ה-Sidekick במכשיר לצורך בדיקה

אחרי שהגרסה תהיה זמינה לבודקים ב-Play Console, פועלים לפי השלבים הבאים כדי להפעיל את אפשרויות המפתחים בחנות Play במכשיר:

1. פותחים את האפליקציה של חנות Google Play.
2. מקישים על סמל הפרופיל ואז על הגדרות.
3. מקישים על התפריט מידע.
4. מקישים על גרסת חנות Play 7 פעמים עד שמופיעה ההודעה You are now a developer!. הפעולה הזו תפעיל את האפשרויות למפתחים במכשיר.
5. מקישים על כללי ואז על אפשרויות למפתחים.
6. מפעילים את האפשרות Play Games Sidekick.
7. נכנסים למשחק כדי לראות את Sidekick.

הגדרת נקודת הכניסה ל-Sidekick כברירת מחדל

כברירת מחדל, נקודת הכניסה של Sidekick מעוגנת לקצה הלוגי (הצד הימני של המסך) וממוקמת במרכז האנכי (עם היסט קל כברירת מחדל) גם במצב אנכי וגם במצב אופקי. במקרה של ניווט ב-3 כפתורים, נקודת הכניסה עוברת לצד שממול לסרגל הניווט.

אפשר לשנות את מיקום ברירת המחדל של נקודת הכניסה על ידי ציון מיקום מועדף בקובץ AndroidManifest.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,‏ horizontal-position ו-vertical-position-percent) נדרשים לכל תג <default-entrypoint-position>. אם אחד מהתגים horizontal-position או vertical-position-percent חסר או לא תקין, המערכת מתעלמת מהתג והכיוון הזה חוזר למיקום ברירת המחדל של המערכת.

• ‫orientation: כיוון המסך שרוצים להגדיר. ערכים נתמכים:
  • landscape
  • portrait
• ‫horizontal-position: השוליים האופקיים של המסך שבהם יוצג מיקום הכניסה. ערכים נתמכים:
  • LEFT
  • RIGHT

• ‫vertical-position-percent: ערך מספרי בטווח 0 עד 100 (לדוגמה, "25" או "50") שמציין את המיקום האנכי כאחוז מגובה המסך הזמין מלמעלה. לדוגמה, "25" מציב את נקודת הכניסה במרחק של 25% מהקצה העליון, ו-"50" ממקם אותה במרכז באופן אנכי. ערכים שלא נמצאים בטווח 0-100 מוגדרים כמכסה הקרובה ביותר.

  הפונקציה vertical-position-percent מוחלת על הגובה המלא של חלון המשחק. הסמל של Sidekick תמיד ממוקם במרחק קטן מהקצה העליון והתחתון של המסך, והוא מוזז אוטומטית כדי שלא יהיה חפיפה עם חור למצלמה או עם מגרעת במסך. לכן, 0 ממקם את נקודת הכניסה ליד הקצה העליון ו-100 ממקם אותה ליד הקצה התחתון.

הערכים האלה מייצגים מיקומים פיזיים במסך. לדוגמה, LEFT הגדרת נקודת הכניסה לקצה השמאלי של המסך, גם אם המכשיר מוגדר לפריסה מימין לשמאל (RTL).

אם שחקן גורר וממקם מחדש את נקודת הכניסה באופן ידני במהלך המשחק, המיקום שנבחר נשמר בין סשנים של משחקים ומקבל עדיפות על פני הגדרת ברירת המחדל המותאמת אישית ב-XML.

הגדרת משך ההשהיה של נקודת הכניסה במהלך תהליך ההגדרה הראשוני

כברירת מחדל, נקודת הכניסה של Play Games Sidekick מוצגת באופן מיידי. אפשר להשהות את נקודת הכניסה בתוך המשחק למשך זמן מותאם אישית שהוגדר ב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="portrait" horizontal-position="RIGHT" vertical-position-percent="25" />
     <default-entrypoint-position orientation="landscape" horizontal-position="LEFT" vertical-position-percent="50" />
   
     <!-- Custom Snooze Period -->
     <snooze duration_seconds="300" />
   
     <!-- Extensible: Add new configuration fields here as needed -->
   </deku-config>

משך ההשהיה המותאם אישית מוגבל ל-30 דקות. אם מציינים ערך שגבוה מהסף הזה, המערכת משתמשת אוטומטית בערך ברירת המחדל של 30 דקות.

הוספה אוטומטית של חלונית המשחקים לכל העלאות ה-App Bundle

כשיוצרים גרסה ומפעילים את Sidekick כברירת מחדל במשחק, הוא מתווסף לכל קובצי ה-App Bundle העתידיים.

כדי לשנות את ההגדרה של הפעלת Sidekick כברירת מחדל בכל קובצי ה-App Bundle החדשים שמעלים, פועלים לפי השלבים הבאים:

1. פותחים את Play Console.
2. בוחרים משחק.
3. עוברים אל בדיקות > הגדרות מתקדמות.
4. בכרטיסייה Play Games Sidekick, בוחרים באחת מהאפשרויות הבאות:
   • תצוגת Sidekick תופעל כברירת מחדל בקובצי AAB חדשים שיועלו.
   • תצוגת Sidekick לא תופעל כברירת מחדל בקובצי AAB חדשים שיועלו.
5. לוחצים על שמירת השינויים.

אם אתם לא מעדכנים את האפליקציה לעיתים קרובות, יכול להיות שנעדכן את Sidekick בשבילכם מדי פעם. אתם יכולים לבטל את ההצטרפות ל-Sidekick מתי שתרצו דרך ההגדרות המתקדמות ב-Google Play Console.

קידום של Sidekick לסביבת הייצור

אם תקדמו גרסה שכוללת את Sidekick לסביבת הייצור, השחקנים יראו את Sidekick. השחקנים יכולים להיכנס בכל שלב להגדרות המשתמש באפליקציית חנות Play ולקבוע אם להציג או להסתיר את Sidekick.

משחקים שמקדמים השקה באמצעות חלונית המשחקים עומדים בהנחיות של Level Up.

שליחת משוב

כדי לשלוח משוב על Sidekick, אפשר להשתמש בטופס המשוב.

שאלות נפוצות