Play Games Sidekick

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

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

תכונות

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

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

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

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

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

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

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

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

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

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

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

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

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

איך בודקים את Sidekick בצורה בטוחה

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

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

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

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

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

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

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

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

אחרי שתוודאו ש-Sidekick משפרת את ההכנסות, את המעורבות ואת היציבות במהלך ההשקה המדורגת ל-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.
המתג להפעלת Play Games Sidekick באפליקציה של חנות Google Play.
המתג להפעלת Play Games Sidekick באפליקציה של חנות Google Play (אפשר ללחוץ כדי להגדיל).

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

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

כדי לשנות את מיקום ברירת המחדל של נקודת הכניסה, אפשר לציין מיקום מועדף בקובץ משאב 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

הגדרת משך הזמן להשהיה של נקודת הכניסה במהלך חוויית השימוש הראשונה (FTUE)

כברירת מחדל, נקודת הכניסה של 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="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 לכל קובצי ה-App Bundle שמעלים

כשיוצרים גרסה ומפעילים את Sidekick כברירת מחדל במשחק, 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 לסביבת הייצור

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

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

שאלות נפוצות

אפשר להוסיף את Sidekick למשחק באמצעות Publishing API?

אתם יכולים להוסיף את Sidekick למשחק גם אם אתם מפרסמים באמצעות Google Play Developer Publishing API. קודם מוסיפים את Sidekick באופן אוטומטי לכל קובצי ה-App Bundle שמעלים, ואז ממשיכים בתהליך הרגיל של פרסום הגרסה. Sidekick יתווסף לקובץ ה-Android App Bundle.

המשחק שלי לא משתמש בקובצי Android App Bundle‏ (AAB). מה עליי לעשות?

‫Sidekick מתווסף למשחקים כשמעלים קובץ Android App Bundle חדש.

אם אתם משתמשים בקובצי APK, הוסיפו את ה-SDK של Sidekick כתלות.

במשחק שלי יש מוצר למניעת שינויים. האם Sidekick תואם לפתרון שלי?

אנחנו עובדים עם חברות מובילות כדי לוודא ש-Sidekick תואם.

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

למה ההישגים לא מופיעים ב-Sidekick?

אם ההישגים לא מופיעים כמו שציפיתם, בדקו את הדברים הבאים:

  • סטטוס טיוטה: הישגים בסטטוס "טיוטה" לא מוצגים ב-Sidekick.
  • תג על הישג: הישגים נעולים גלויים לכל השחקנים רק אם המשחק קיבל תג על הישגים. כדי להשתמש בתכונה הזו, לפחות 100 שחקנים ייחודיים צריכים לבצע קריאות ל-API של ההישגים ב-30 הימים האחרונים.
  • הישגים שהשחקנים הגיעו אליהם: אם המשחק לא קיבל תג, השחקנים רואים את ההישגים שהם כבר הגיעו אליהם.