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

במאמר הזה מוסבר איך לשלב את האפליקציה עם התכונה 'מספר מוצרים' של ספריית החיובים ב-Play‏ (PBL).

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

שיקולים

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

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

שילוב עם ספריית החיובים ב-Play

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

הפעלת תהליך רכישה

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

1. יוצרים רשימת מוצרים שכוללת את כל המוצרים בחיוב חד-פעמי באמצעות השיטה QueryProductDetailsParams.Builder.setProductList.

2. אפשר לאחזר את כל המוצרים בחיוב חד-פעמי באמצעות השיטה BillingClient.queryProductDetailsAsync.

   בדוגמה הבאה אפשר לראות איך מאחזרים את כל המוצרים החד-פעמיים:

   Java

   billingClient.queryProductDetailsAsync(
   queryProductDetailsParams,
   new ProductDetailsResponseListener() {
     public void onProductDetailsResponse(
         BillingResult billingResult, QueryProductDetailsResult productDetailsResult) {
       // check billingResult
       // …
       // process productDetailsList returned by QueryProductDetailsResult
       ImmutableList productDetailsList = productDetailsResult.getProductDetailsList();
       for (ProductDetails productDetails : productDetailsList) {
         for (OneTimePurchaseOfferDetails oneTimePurchaseOfferDetails :
             productDetails.getOneTimePurchaseOfferDetailsList()) {
                // …
         }
       }
     }
   });

3. מגדירים את האובייקט ProductDetails לכל מוצר בחיוב חד-פעמי.

   הערה: כל המוצרים לרכישה חד-פעמית ב-ProductDetails צריכים להיות מאותה אפליקציה.

4. מציינים את פרטי המוצר בחיוב חד-פעמי בשיטה BillingFlowParams.Builder.setProductDetailsParamsList. המחלקות BillingFlowParams מציינות את הפרטים של תהליך הרכישה.

   בדוגמה הבאה מוצג איך להפעיל את תהליך החיוב לרכישת OTP של כמה מוצרים:

   Java

   BillingClient billingClient =
      BillingClient.newBuilder()
       // set other options
       .build();
   // ProductDetails obtained from queryProductDetailsAsync().
   ProductDetails productDetails1 = ...;
   ProductDetails productDetails2 = ...;
   ArrayList productDetailsList = new ArrayList<>();
   productDetailsList.add(productDetails1);
   productDetailsList.add(productDetails2);
   BillingFlowParams billingFlowParams =
   BillingFlowParams.newBuilder()
       .setProductDetailsParamsList(productDetailsList)
       .build();
   billingClient.launchBillingFlow(billingFlowParams);

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

עיבוד רכישות

התהליך של עיבוד רכישות של כמה מוצרים בחיוב חד-פעמי זהה לתהליך של עיבוד רכישות קיימות של פריט יחיד, כפי שמתואר במאמר שילוב ספריית החיובים ב-Google Play באפליקציה. ההבדל היחיד הוא שצריך להעניק הרשאה לכל המוצרים במקום רק לאחד ברכישות של כמה מוצרים בחיוב חד-פעמי, כדי שהמשתמש יוכל לקבל כמה הרשאות ברכישה אחת. רכישת OTP של כמה מוצרים מחזירה כמה פריטים שאפשר לאחזר באמצעות Purchase.getProducts() בספריית החיובים ב-Google Play, ואז את הרשימה lineItems ב-purchases.products.get של ממשק API של Google Play למפתחים.

הודעות בזמן אמת למפתחים

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

החזרים כספיים

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

הערה: הזמנות של כמה מוצרים עם OTP שהוחזר עליהן החזר כספי יהיו זמינות ב-Voided Purchases API וב-RTDN.

דיווח פיננסי והתאמה

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

ללוחות בקרה ב-Play Console:

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

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