אירועים

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

  • שחקנים משתמשים בפריט מסוים
  • שחקנים מגיעים לרמה מסוימת
  • שחקנים מבצעים פעולה ספציפית במשחק

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

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

שילוב אירועים במשחק

תהליך העבודה הבא מתאר איך להחיל אירועים במשחק:

  1. להגדיר אירועים. כדי להגדיר אירועים חדשים שיתעדו במשחק:
    1. עוברים לדף אירועים של המשחק ב-Google Play Console.
    2. לוחצים על הלחצן Add new event (הוספת אירוע חדש) ומגדירים את מאפייני האירוע.
    3. מפרסמים את הגדרות האירועים לפי השלבים שמפורטים בקטע פרסום השינויים במשחק.
  2. מטמיעים את תהליך תיעוד האירועים במשחק באמצעות ממשקי ה-API של האירועים. לדוגמה, בקוד של Android, צריך להפעיל את השיטה increment של האירועים בכל פעם שהמשחק מזהה אירוע שחשוב לו.

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

מידע בסיסי על אירועים

ממשקי ה-API של האירועים מאפשרים לכם להגדיר ולאסוף מדדי משחק מעניינים, ולהעלות את המדדים האלה ל-Play Games SDK.

אירוע ב-Play Games SDK מכיל את המאפיינים העיקריים הבאים:

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

לדוגמה:

  • 'Zombies Killed'
  • "אבנים אדומות שנאספו"
תיאור תיאור ארוך יותר של האירוע (לדוגמה, 'מספר הפעמים שהשחקן הרג זומבי' או 'המספר הכולל של אבני החן האדומות שהשחקן השמיד והתאמה'). התיאור יכול להכיל עד 500 תווים. הערך הזה משמש את Google Play Console וניתן להציג אותו במשחק.
סוג האירוע

שדה שמצהיר על סוג הנתונים שאחריהם האירוע עוקב. מערכת Google Play Console משתמשת בערך הזה כדי לתמוך בדיווח של Player Analytics.

יש תמיכה בשני סוגי אירועים:

Premium currency source
בוחרים את הסוג הזה לאירועים שמתבצע אחריהם מעקב אחר מקורות של מטבע פרימיום. לדוגמה:
  • "מטבעות זהב שהרווחת"
  • "Emeralds bought"
Premium currency sink
יש לבחור את הסוג הזה לאירועים שמתעדים מקורות נטושים (sinks) או צריכה של מטבע פרימיום. לדוגמה:
  • "Gold coins spent"
  • "באמרלד בשימוש"

סמל סמל מרובע שישויך לאירוע.

איך יוצרים אירוע

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

  1. ב-Google Play Console, לוחצים על הסמל Game services בצד ימין ובוחרים את הרשומה של המשחק.
  2. בוחרים בכרטיסייה אירועים בצד ימין ולוחצים על הלחצן הוספת אירוע.
  3. ממלאים את פרטי האירוע שרוצים ליצור.
  4. לוחצים על שמירה. אם לא יהיו שגיאות, האירוע יועבר לסטטוס 'מוכן לפרסום'. עכשיו אפשר להמשיך לפרסם את השינויים במשחק.

עריכת אירוע

כדי לערוך אירוע שיצרתם:

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

מחיקת אירוע

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

איפוס נתוני האירועים

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

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

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

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