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

במאמר הזה מוסבר איך לשלב את האפליקציה עם התכונה 'מספר מוצרים' של ספריית החיוב ב-Google 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 לכל מוצר חד-פעמי.

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

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

   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);

עיבוד רכישות

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

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

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

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

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

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

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

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

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

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