הישגים

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

במאמר הטמעות של לקוחות מוסבר איך להטמיע הישגים בפלטפורמה.

מאפיינים

כדי להבין איך ההישגים פועלים, כדאי להכיר כמה מהמאפיינים שמשויכים אליהם.

האלמנטים הבסיסיים האלה משויכים לכל הישג:

• ‫Id היא מחרוזת ייחודית שנוצרת על ידי Google Play Console. המזהה הייחודי הזה ישמש אתכם כהפניה להישג בלקוחות המשחק.
• Name (שם) הוא שם קצר של ההישג (לדוגמה, "Pieman"). הערך יכול לכלול עד 100 תווים.
• תיאור הוא תיאור תמציתי של ההישג. בדרך כלל התיאור הזה מסביר לשחקן איך להשיג את ההישג (לדוגמה, "לאפות פאי מרנג לימון לפני השקיעה"). הערך יכול לכלול עד 500 תווים.
• סמל הוא סמל מרובע שמשויך להישג. בקטע הנחיות לגבי סמלים מפורטות שיטות מומלצות ליצירת סמלי הישגים.
• סדר הרשימה הוא הסדר שבו ההישגים הנעולים מופיעים כששחקן צופה בהישגים שמשויכים למשחק שלכם. אפשר להוסיף אותם בכל סדר שרוצים. ההישגים שנפתחו מופיעים בראש הרשימה לפי סדר ההשגה שלהם.

מדינה

ההישגים יכולים להיות באחד משלושת הסטטוסים הבאים:

• הישג מוסתר הוא הישג שהפרטים שלו מוסתרים מהשחקן. שירות המשחקים של Play Games מספק תיאור וסמל גנריים של placeholder להישג בזמן שהוא במצב מוסתר. מומלץ להסתיר הישג אם הוא מכיל ספוילר שלא רוצים לחשוף על המשחק מוקדם מדי (לדוגמה, "מגלים שהיית רוח כל הזמן!").
• הישג שנחשף הוא הישג שהשחקן יודע עליו, אבל עדיין לא הרוויח אותו. רוב ההישגים מתחילים במצב גלוי.
• השגת מטרה במשחק שנפתחה פירושה שהשחקן השיג אותה בהצלחה. אפשר לזכות בהישג גם במצב אופליין. כשהמשחק מתחבר לאינטרנט, הוא מסתנכרן עם Play Games Services כדי לעדכן את הסטטוס של ההישג ל'בוטל הנעילה'.

הישגים מצטברים

אפשר להגדיר את ההישגים כהישגים רגילים או כהישגים מצטברים. בדרך כלל, כדי להשיג הישג מצטבר, השחקן צריך להתקדם בהדרגה לאורך תקופה ארוכה. כשהשחקן מתקדם לקראת ההישג המצטבר, אתם יכולים לדווח על ההתקדמות החלקית של השחקן ל-Play Games Services.

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

הישגים מצטברים הם הישגים שמתקבלים על סמך פעולות חוזרות במשחק, וההתקדמות לא יכולה להימחק או להתאפס מתוך המשחק. לדוגמה, ההישג 'ניצחון ב-50 משחקים' עומד בדרישות של הישג מצטבר. לדוגמה, המשימה 'לנצח ב-3 משחקים ברציפות' לא תתאים, כי ההתקדמות של השחקן תתאפס אם הוא יפסיד במשחק. גם ההנחיה 'יש לך 5,000 צ'יפים של פוקר' לא תעמוד בדרישות, כי שחקן יכול לזכות בצ'יפים ולשחק איתם. במקרה של שני ההישגים האחרונים, אתם צריכים לעקוב אחרי מצב הניצחונות הרצופים של השחקן או אחרי סך הצ'יפים שלו, ולבטל את הנעילה של ההישגים הרגילים כשהשחקן משיג אותם.

כשיוצרים הישג מצטבר, צריך להגדיר את המספר הכולל של השלבים שנדרשים כדי לבטל את הנעילה שלו (המספר הזה צריך להיות בין 2 ל-10,000). ככל שהמשתמש מתקדם לקראת ביטול הנעילה של ההישג, צריך לדווח ל-Play Games Services על מספר השלבים הנוספים שהמשתמש השלים. אחרי שמספר השלבים הכולל מגיע לערך של ביטול הנעילה, ההישג נפתח (גם אם הוא היה מוסתר). אין צורך לשמור את ההתקדמות המצטברת של המשתמש.

נקודות

לכל הישג יש ערך נקודות שמשויך אליו. הניקוד של השחקן צריך להיות כפולה של 5, והניקוד הכולל של כל ההישגים במשחק לא יכול להיות יותר מ-1,000 (אבל יכול להיות פחות). בנוסף, כל הישג יכול להניב עד 200 נקודות.

מעקב אחר נקודות ניסיון מצטבר (XP)

שחקנים יכולים לעלות רמות בפרופיל המשחק שלהם כשהם משיגים הישגים במשחקים שמופעלים ב-Play Games. על כל נקודה שמשויכת להישג, השחקן מקבל 100 נקודות ניסיון (XP) כשהוא משיג את ההישג הזה. במילים אחרות:

XP for an achievement = 100 * (point value for the achievement)

שירותי Play Games עוקבים אחרי נקודות הניסיון שכל שחקן צובר ושולחים התראה לאפליקציית Google Play Games כשהשחקן צובר מספיק נקודות כדי לעלות לרמה הבאה. השחקנים יכולים לראות את הרמה שלהם ואת היסטוריית הנקודות שלהם בדף הפרופיל באפליקציית Google Play Games.

הישגים מינימליים

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

הישגים מקסימליים

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

הוספת הישגים

יש שתי דרכים ליצור הישגים בפעם הראשונה באמצעות Google Play Console:

• יצירת הישג: מוסיפים הגדרות ומטא-נתונים לכל הישג בנפרד.
• ייבוא הישגים: ייבוא הגדרות ומטא-נתונים אחרים של כמה הישגים בבת אחת.

יצירת הישג

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

1. ב-Google Play Console, בוחרים משחק.
2. בדף שירותי המשחקים של Play – הישגים (צמיחה > שירותי המשחקים של Play > הגדרה וניהול > הישגים), בוחרים באפשרות יצירת הישג.
3. בדף הוספת הישגים, ממלאים את הטופס.
4. לוחצים על שמירה כטיוטה.
5. אחרי שיוצרים הישג, צריך לפרסם את המשחק.

הוספת עוד הישגים

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

1. ב-Google Play Console, בוחרים משחק.
2. בדף שירותי המשחקים של Play – הישגים (צמיחה > שירותי המשחקים של Play > הגדרה וניהול > הישגים), לוחצים על הוספת הישגים.

ייבוא ההישגים

כדי להוסיף כמה הישגים למשחק בבת אחת:

1. יוצרים קובץ ZIP שמכיל את ההישגים.
2. מעלים את הקובץ.

מידע נוסף על קובץ ה-ZIP זמין במאמר הנחיות לגבי קובץ ZIP.

כדי לייבא הישגים:

1. ב-Google Play Console, בוחרים משחק.
2. בדף Play Games Services - Achievements (צמיחה > Play Games Services > הגדרה וניהול > הישגים), בוחרים באפשרות ייבוא הישגים.
3. בדף ייבוא הישגים, לוחצים על העלאה.
4. בוחרים את קובץ ה-zip להעלאה.
5. לוחצים על שמירה כטיוטה.
6. אחרי שמייבאים הישגים, צריך לפרסם את המשחק.

פרסם את המשחק שלך

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

עריכת הישג

כדי לערוך הישג שכבר יצרתם, בוחרים את ההישג בכרטיסייה הישגים ב-Google Play Console. בשלב הזה, יוצג לכם אותו הטופס שבו השתמשתם כשבחרתם את ההישג, ותוכלו לערוך את השדות לפי הצורך.

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

ביטול עריכה

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

מחיקת הישג

אחרי פרסום ההישג, אי אפשר למחוק אותו.

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

איפוס הישג

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

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

הנחיות לגבי סמלים

הסמלים צריכים להיות בפורמט PNG, ‏ JPEG או JPG, במידות ‎512 x 512 פיקסלים. אתם צריכים לשלוח לנו רק את הסמל של ההישג שלא נעול. המערכת תיצור באופן אוטומטי גרסת גווני אפור לסמל שיוצג. לכן, מומלץ להוסיף לסמלי ההישגים אלמנטים צבעוניים, כדי שהמשתמשים יוכלו להבחין בין הישגים שנחשפו לבין הישגים שנפתחו.

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

אותו סמל משמש בכל הלוקאלים, ולכן לא מומלץ לכלול טקסט או תוכן מותאם לשוק המקומי בסמל.

הנחיות לגבי קובצי ZIP

אפשר לייבא כמה הישגים בבת אחת באמצעות קובץ ZIP. בטבלה מפורטים שמות הקבצים המדויקים שבהם צריך להשתמש בקובץ ה-ZIP:

דרישות לגבי קובץ ה-ZIP:

• אין ספריות משנה.
• שמות קבצים ייחודיים.
• אפשר להעלות רק קובצי CSV,‏ PNG,‏ JPEG או JPG.
• קובצי ה-CSV לא יכולים לכלול שורת כותרת.
• כל קובץ צריך להיות קטן מ-1MB.
• קובץ ה-ZIP לא יכול להכיל יותר מ-203 קבצים.
• הגודל הכולל של קובץ ה-ZIP צריך להיות קטן מ-200MB.

הפורמט של הקובץ AchievementsMetadata.csv

קובץ AchievementsMetadata.csv מכיל את המטא-נתונים של כל הישג. היא צריכה לכלול את המידע כערכים מופרדים בפסיקים בסדר הבא:

    Name,Description,Incremental value,Steps Needed,Initial State,Points,List Order

השדות האלה מתוארים בטבלה הבאה:

AchievementsMetadata.csv דרישות לגבי הקובץ:

• כל שורה צריכה להכיל שבעה ערכים. אם רוצים להשמיט ערך, משאירים את השדה ריק.
• השדות Name ו-Description משמשים כמקום ברירת המחדל.
• השדה Name צריך להיות ייחודי לכל ההישגים.
• השדות הבאים לא יכולים להכיל פסיקים: Name ו-Description.

קובץ AchievementsMetadata.csv לדוגמה:

  Achievement1,Achievement One,True,100,Hidden,5,20
  Achievement2,Achievement Two,False,,Revealed,10,30

הפורמט של הקובץ AchievementsLocalizations.csv

קובץ AchievementsLocalizations.csv הוא קובץ אופציונלי שמגדיר את כל הנתונים שנדרשים כדי לתאר כל הישג למשתמשים באזורים שונים. ההישגים מתורגמים בהתאם ללוקאלים שצוינו במשחק.

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

   Name, Localized name, Localized description, locale

השדות האלה מתוארים בטבלה הבאה:

AchievementsLocalizations.csv דרישות לגבי הקובץ:

• שמות ההישגים במשחק צריכים להיות ייחודיים בכל לוקאל. לדוגמה, אם משחק תומך באזורים en-US ו-fr-FR, אפשר לקרוא להישג בשם Achievement1 באזור en-US וגם באזור fr-FR.
• כל שורה צריכה להכיל ארבעה ערכים. אם רוצים להשמיט את הערך של Localized description, משאירים אותו ריק.

קובץ AchievementsLocalizations.csv לדוגמה:

Achievement1,Achievement One,This is the description of achievement one in English.,en-US
Achievement1,Achievement Un,Voici la description de l'achievement un en français.,fr-FR
Achievement2,Achievement Two,Description of achievement two.,en-US
Achievement2,Logro Dos,Descripción del logro dos.,es-ES
Achievement3,Achievement Three,,en-US
Achievement3,Erfolg Drei,,de-DE

הפורמט של AchievementsIconMappings.csv

קובץ AchievementsIconMappings.csv הוא קובץ אופציונלי שמשמש למיפוי ההישגים שלכם עם הסמל שצוין. היא צריכה לכלול את המידע כערכים מופרדים בפסיקים בסדר הבא:

Name, icon filename

השדות האלה מתוארים בטבלה הבאה:

AchievementsIconMappings.csv דרישות לגבי הקובץ:

• כל שורה צריכה להכיל שני ערכים.
• קובצי סמלים יכולים להיות רק בפורמט PNG או JPEG.

קובץ AchievementsIconMappings.csv לדוגמה:

Valid Achievement,valid-achievement-icon.png
Incremental Achievement,incremental-achievement-icon.jpeg
No Description,no-description-icon.png
Hidden Initial State,hidden-initial-state-icon.png
Large Point Value,large-point-value-icon.jpeg

קובצי סמלים

הסמלים שמופיעים בקובץ AchievementsIconMappings.csv חייבים להיות בארכיון ה-ZIP הנוכחי שמייבאים. מידע נוסף זמין במאמר בנושא הנחיות לגבי סמלים.

הוספת תרגומים להישגים

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

יש שתי דרכים להוסיף תרגומים למשחק:

• אפשר להשתמש באפשרות ייבוא הישגים כדי להעלות תרגומים להרבה הישגים חדשים בבת אחת. אי אפשר להשתמש באפשרות הזו כדי להעלות תרגומים להישגים שכבר קיימים.

• אתם יכולים להוסיף תרגומים לכל הישג במשחק. כדי להוסיף תרגום משלכם לכל הישג:

  1. ב-Google Play Console, פותחים את הכרטיסייה הישגים של המשחק ובוחרים הישג קיים.
  2. בדף הפרטים של ההישגים, בוחרים בכרטיסייה של שפה שהוספתם קודם בכרטיסייה פרטי המשחק.
  3. בדף פרטי ההישג בשפה הזו, עורכים את הטופס עם התרגומים שלכם לאותו הישג.
  4. לוחצים על שמירה כדי לשמור את פרטי ההישג המתורגמים.

הטמעות בצד הלקוח

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

• Android
• Unity
• אינטרנט
• שיטות מומלצות להטמעת הישגים