זיהוי ומשלוח של פריטים מתוך האפליקציה

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

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

1. לוחצים על Play Points.	1. לוחצים על הכרטיסייה שימוש כדי לראות את הפריטים.	2. בוחרים פריט ולוחצים על שימוש בנקודות כדי להשלים את הרכישה.	3. מקבלים את הפריט.

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

לפני שמתחילים

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

דרישות לגבי העברת נתונים

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

זמן אספקה

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

הודעה על מסירה

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

זהו פורמט ההודעה הנדרש:

• הודעה ברורה שהפריט התקבל.

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

• אם יש פריטים דומים עם ערכים שונים, שם הפריט צריך לכלול גם את הערך הנכון של הפריט.

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

דוגמה להודעה:

"הפריט התקבל! קיבלת עכשיו 100 אבני חן עם Play Points. Continue".

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

זיהוי פריטים שהתקבלו מחוץ למשחק

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

הצגת אישור מסירה

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

עדכונים למנועי משחקים ספציפיים

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

• אם המשחק שלכם מבוסס על Unity, מומלץ לבדוק אם הטמעת הרכישות מתוך האפליקציה שבה אתם משתמשים כבר תומכת במבצעים של Play Points.

• אם המשחק שלכם מבוסס על Cocos2d-x או על Unreal Engine ‏ (C/C++‎), סביר להניח שתצטרכו לכתוב את קוד ה-JNI שקורא לממשקי Java API מקוד ה-C/C++‎.

שיטות מומלצות לשימוש בצד השרת

בקטע הזה מפורטות שיטות מומלצות לשימוש בצד השרת במבצעים של Play Points:

• אם אתם קוראים ל-Purchases.products: get בשרת שלכם, צריך לבדוק אם אתם צריכים לטפל בפריטים להחלפה ב-Play ובמוצרים אחרים מתוך האפליקציה בנפרד, על סמך הערכים של productId.

• אם אתם משתמשים ב-Inappproducts: list בשרת שלכם, אתם צריכים לבדוק אם אתם צריכים להפריד בין פריטים להחלפת תגמולים ב-Play לבין מוצרים אחרים בתוך האפליקציה לפי ערכי productId.

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

  • הפניה:
    • מאבק בהונאה ובניצול לרעה
    • שיטות מומלצות לשימוש במזהים ייחודיים
  • מטמיעים אימות חתימה בצד השרת.
  • מוודאים שהערכים של purchaseToken ושל orderId הם ייחודיים ושלא נעשה בהם שימוש בעבר.

פתרון בעיות

בקטע הזה מפורטות המלצות לתרחישים שיכולים להוביל לפניות של לקוחות.

כמה חשבונות משתמש

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

פריטים חסרים או שהמשלוח שלהם מתעכב

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