הישגים

קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

שליחת משוב

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

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

מאפיינים

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

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

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

מדינה

ההישגים יכולים להיות באחד משלושה מצבים שונים:

• המשמעות של הסטטוס מוסתר היא שהפרטים על ההישג מוסתרים מהשחקן. שירותי 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 עוקבים אחרי נקודות ה-XP שכל שחקן צבר, ושולחים התראה לאפליקציית Google Play Games כשהשחקן צבר מספיק נקודות כדי 'לעלות רמה'. השחקנים יכולים לראות את הרמה ואת היסטוריית הנקודות שלהם בדף הפרופיל באפליקציית Google Play Games.

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

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

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

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

הוספת הישגים

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

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

יצירת הישג

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

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

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

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

1. ב-Google Play Console, בוחרים משחק.
2. בדף Play Games Services – Achievements (צמיחה > שירותי Play Games > הגדרה וניהול > Achievements), בוחרים באפשרות Add achievements.

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

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

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

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

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

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

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

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

עריכת הישג

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

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

ביטול עריכה

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

מחיקת הישג

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

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

איך מאפסים הישג

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

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

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

צריך ליצור את הסמלים כקובצי PNG,‏ JPEG או JPG בגודל 512 על 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 גם בשם Achievement1 ב-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, פותחים את הכרטיסייה Achievements (הישגים) של המשחק ובוחרים הישג קיים.
  2. בדף הפרטים של ההישגים, בוחרים בכרטיסייה של השפה שהוספתם קודם בכרטיסייה פרטי המשחק.
  3. בדף הפרטים של ההסמכה בשפה הזו, עורכים את הטופס עם התרגומים של ההסמכה.
  4. לוחצים על Save כדי לשמור את פרטי ההסמכה המתורגמים.

הטמעות של לקוחות

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

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