בדיקת השילוב של ספריית החיובים ב-Google Play

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

בוחני רישיונות

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

היתרונות של שימוש בבודקים מורשים:

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

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

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

כדי לאשר את החשבון שדרכו מתבצעת הרכישה, צריך להרחיב את תיבת הדו-שיח של הרכישה. שימו לב לנקודות הבאות:

  • חשבונות הבדיקה צריכים להיות במכשיר Android של הבודק.
  • אם במכשיר יש יותר מחשבון אחד, הרכישה מתבצעת באמצעות החשבון שממנו הורדה האפליקציה.
  • אם האפליקציה לא הורדה באף אחד מהחשבונות, הרכישה מתבצעת באמצעות החשבון הראשון.

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

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

  1. מפרסמים את האפליקציה במסלול הפצה לבדיקה. שימו לב: אחרי שמפרסמים אפליקציה במסלול הפצה לבדיקה, יכול להיות שיחלפו כמה שעות עד שהאפליקציה תהיה זמינה לבודקים.
  2. מוודאים שכל בודק מצטרף לבדיקה של האפליקציה. בכתובת ה-URL של ההצטרפות לבדיקה, הבודקים רואים הסבר על המשמעות של להיות בודק, וגם קישור להצטרפות.

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

Play Billing Lab

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

בעזרת Play Billing Lab אפשר לבצע את הפעולות הבאות במהלך הבדיקות:

מרכז הבקרה של Play Billing Lab
איור 2. מרכז הבקרה של Play Billing Lab.

בדיקת מוצרים בחיוב חד-פעמי

בדיקת מוצרים מתכלים

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

  • רכישה מוצלחת שבה המשתמש מקבל פריט. אם אתם משתמשים בבודק רישיונות, אתם יכולים להשתמש באמצעי התשלום Test instrument, always approves.
  • רכישה שבה לא הצלחנו לחייב את אמצעי התשלום, והמשתמש לא אמור לקבל את הפריט. אם אתם משתמשים בבודק רישיונות, אתם יכולים להשתמש באמצעי התשלום כלי בדיקה, אף פעם לא יאושר.
  • מוודאים שאפשר לרכוש את הפריטים כמה פעמים.

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

בדיקת מוצרים שאינם מתכלים

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

בדיקת רכישות בהמתנה

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

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

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

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

    בדיקת רכישה באמצעות כרטיס בדיקה איטי מאושר
    איור 4. בודקים רכישה באמצעות כרטיס לבדיקה איטי שאושר.

מידע נוסף זמין במאמר טיפול בעסקאות בהמתנה.

בדיקת ביטולים של חיובים שהמשתמשים יזמו

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

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

    בדיקה של ביטולים ביוזמת המשתמש
    איור 5. בודקים רכישה באמצעות כרטיס בדיקה שהתשלום בו מאושר ואז מתבצע החזר.

בדיקת תכונות שספציפיות למינוי

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

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

תקופות חידוש

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

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

תקופת המינוי של סביבת הייצור בדיקת חידוש מינוי
שבוע אחד 5 דקות
חודש אחד 5 דקות
‫3 חודשים 10 דקות
חצי שנה 15 דקות
שנה אחת ‫30 דקות

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

Feature תקופת הבדיקה
השהיית חשבון 10 דקות
תקופת ניסיון בחינם 3 דקות
תקופת חסד 5 דקות
תקופת מחיר ההיכרות זהה לתקופת הבדיקה של המינוי
השהיה (חודש אחד) 5 דקות
השהיה (2 חודשים) 10 דקות
השהיה (3 חודשים) 15 דקות
תקופת ההסכמה לעליית מחיר

(רלוונטי רק לאזור קוריאה הדרומית (KR))
3 דקות
אישור רכישה 5 דקות

האצת המעבר בין מצבי המינוי

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

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

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

חשוב לדעת:

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

תקופות ניסיון

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

בדיקת תקופות ניסיון
איור 7. בודקים מבצעים לתקופת ניסיון.

שינויים במחירים

אפשר גם להשתמש ב-Play Billing Lab ובבודקי רישיונות כדי לבדוק שינויים במחירי המינויים בלי להשפיע על מינויים פעילים אחרים. כך עושים זאת:

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

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

כשמתכננים תקופות בדיקה, חשוב לזכור את השיקולים הבאים:

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

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

תקופת החיוב בפועל של המינוי הבסיסי תקופת חיוב לצורך בדיקה תקופת הודעה לבדיקה (אזורים שבהם נדרשת הסכמה ואזורים שבהם נדרש ביטול הסכמה, עם הודעה של 30 יום) תקופת ההודעה לבדיקה (אזורים שבהם יש אפשרות לביטול ההסכמה ונדרשת הודעה של 60 יום)
שבוע אחד 5 דקות 5 דקות 10 דקות
חודש אחד 5 דקות 5 דקות 10 דקות
‫3 חודשים 10 דקות 3 דקות 6 דקות
חצי שנה 15 דקות 2 דקות 4 דקות
שנה אחת ‫30 דקות 3 דקות 6 דקות

מידע שקשור לעליית מחיר שדורשת הסכמת משתמש יהיה זמין לכם ב-API‏ purchases.subscriptionsv2.get.

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

תזמון ההתראות תקופת ההתראות לבדיקה
ההתראה הראשונה 3 דקות
ההתראה השנייה (האחרונה) דקה אחת

מקרי בדיקה

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

בדיקת עסקאות בהמתנה

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

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

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

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

    בדיקת רכישה באמצעות כרטיס בדיקה איטי מאושר
    איור 10. בודקים רכישה באמצעות כרטיס לבדיקה איטי שאושר.

בדיקת קודי הטבה

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

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

  • כשמזינים את קוד ההטבה בתיבת הדו-שיח של הרכישה שנפתחת בתוך האפליקציה.
  • כשמממשים את קוד ההטבה באפליקציית חנות Google Play.
  • כשמממשים את קוד ההטבה בכתובת https://play.google.com/store באמצעות הלחצן מימוש בסרגל הניווט הימני.

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

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

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

בדיקת חוויית הרכישה באזורים שונים

אתם יכולים לבדוק את חוויית הרכישה באזורים שונים באמצעות האפליקציה Play Billing Lab. כדי להשתמש ב-Play Billing Lab, אתם צריכים להיות בודקי רישיונות. כדי לבדוק את ההגדרה:

  1. רושמים את המשתמש לחיוב באפליקציה כבודק רישיונות.
  2. מתחברים לאפליקציית Play Billing Lab עם אותו משתמש.
  3. בוחרים את המדינה הנדרשת ומחילים את השינוי ב-Play Billing Lab.
  4. מפעילים את תהליך הרכישה באפליקציה שנבדקת.

    בדיקת חוויית הרכישה באזורים שונים
    איור 11. בודקים את חוויית הרכישה באזורים שונים.

Play Billing Lab מאפשר לבדוק את הזכאות האזורית למינוי ואת חוויית המשתמש בכל אזור, בלי קשר למיקום הפיזי שלכם בזמן הבדיקה.

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

אתם יכולים לבדוק את תהליך הרכישה באמצעות אמצעי תשלום אמיתיים בעזרת אפליקציית Android‏ Play Billing Lab.

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

  1. רושמים את המשתמש בחשבון Google כבודק עם רישיון.
  2. מתחברים לאפליקציית Play Billing Lab עם אותו משתמש.
  3. מפעילים אמצעי תשלום אמיתיים באפליקציית Play Billing Lab.
  4. מפעילים מחדש את תהליך הרכישה באפליקציה שנבדקת.

מגבלות הוצאות לאפליקציות שלא פורסמו

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

ב-Google Play יש מגבלות על הפעולות הבאות:

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

המגבלות האלה מתאפסות כל 24 שעות.

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