چند محصول برای محصولات یک بار مصرف

این سند توضیح می دهد که چگونه می توانید برنامه خود را با ویژگی چند محصولی Play Billing Library (PBL) ادغام کنید.

ویژگی چند محصول برای محصول یکبار مصرف (OTP) به شما امکان می دهد چندین محصول یک بار مصرف را در یک واحد ترکیب کنید. سپس این محصولات همراه را می توان خریداری، صورتحساب و مدیریت جمعی کرد. همچنین می‌توانید برای این OTPهای همراه پیشنهادات تخفیف ایجاد کنید تا خرید محصول را تشویق کنید.

ملاحظات

هنگام ایجاد بسته‌های محصول یک‌بار مصرف، به نکات زیر توجه کنید:

• نمی‌توانید در یک بسته محصول یک‌بار مصرف اشتراک داشته باشید.
• شما نمی توانید ترکیبی از محتوای دیجیتال و خدمات را در یک بسته محصول یکبار مصرف داشته باشید.
• محصولات یکبار مصرف همراه باید برای دانلود فوری در دسترس باشند. برای مثال، یک بسته محصول یک‌بار مصرف نمی‌تواند خرید پیش‌سفارشی داشته باشد، زیرا برای دانلود فوری در دسترس نیست.
• چند محصول برای محصولات یک بار مصرف، گزینه خرید اجاره را پشتیبانی نمی کند.

با کتابخانه صورت‌حساب Play یکپارچه شوید

این بخش فرض می‌کند که شما با مراحل اولیه یکپارچه‌سازی PBL مانند افزودن وابستگی PBL به برنامه خود ، مقداردهی اولیه BillingClient و اتصال به Google Play آشنا هستید. این بخش بر جنبه های یکپارچه سازی PBL که مختص خریدهای OTP چند محصولی است تمرکز دارد.

یک جریان خرید راه اندازی کنید

برای راه اندازی جریان خرید برای محصولات یکبار مصرف چند محصول، مراحل زیر را انجام دهید:

1. با استفاده از روش QueryProductDetailsParams.Builder.setProductList ، یک لیست محصول با تمام محصولات یکبار مصرف ایجاد کنید.

2. همه محصولات یکبار مصرف خود را با استفاده از روش BillingClient.queryProductDetailsAsync واکشی کنید.

   نمونه زیر نحوه واکشی همه محصولات یکبار مصرف خود را نشان می دهد:

   جاوا

   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 جزئیات یک جریان خرید را مشخص می کند.

   نمونه زیر نحوه راه‌اندازی جریان صورت‌حساب برای خرید OTP چند محصولی را نشان می‌دهد:

   جاوا

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

فرآیند خرید

پردازش خریدهای OTP چند محصولی مانند خریدهای تک موردی موجود است که در ادغام کتابخانه صورت‌حساب Google Play در برنامه شما توضیح داده شده است. تنها تفاوت این است که شما باید برای همه محصولات به جای یک مورد برای خریدهای OTP چند محصولی، حق اعطا کنید تا کاربر بتواند با یک خرید، چندین حق دریافت کند. یک خرید OTP چند محصولی، چندین مورد را برمی‌گرداند که با استفاده از Purchase.getProducts() در کتابخانه صورت‌حساب Google Play و سپس لیست lineItems در purchases.products.get API برنامه‌نویس Google Play قابل بازیابی هستند.

اعلان‌های بی‌درنگ توسعه‌دهندگان

فیلد sku در RTDN برای خریدهای OTP چند محصولی ارائه نشده است. خریدهای OTP چند محصولی نشان دهنده بیش از یک محصول است. بنابراین، می‌توانید از APIهای برنامه‌نویس Play برای دریافت داده‌های خرید استفاده کنید و همه موارد موجود در آن را ببینید.

بازپرداخت

در خرید OTP چند محصولی، کاربران نمی‌توانند برای کالاهای جداگانه درخواست بازپرداخت کنند و شما نیز نمی‌توانید برای کالاهای جداگانه بازپرداخت کنید. با این حال، درخواست و صدور بازپرداخت برای کل خرید OTP چند محصولی مجاز است. اگر خرید OTP چند محصولی را برای یک کاربر لغو می کنید، تمام حقوق مربوط به خرید لغو می شود.

گزارشگری مالی و تطبیق

از گزارش درآمد استفاده کنید تا خریدهای OTP چند محصولی فعال خود را با Google Payoffs و تراکنش‌ها در Play تطبیق دهید. هر مورد خط تراکنش یک شناسه سفارش دارد. برای خرید OTP چند محصولی، گزارش‌های درآمد و فروش تخمینی شامل ردیف‌های جداگانه (با همان شناسه سفارش) برای هر تراکنش مانند هزینه، کارمزد، مالیات و بازپرداخت برای هر کالای مربوطه می‌شود.

برای داشبوردهای موجود در Play Console:

• آمار درآمد ارائه شده در بخش گزارش مالی کنسول به تفکیک محصولات تفکیک شده است.

• مدیریت سفارش، خریدهای OTP چند محصولی را منعکس می‌کند و فهرست‌های جزئی از آنچه خریداری شده را نشان می‌دهد. از مدیریت سفارش، می توانید خرید کاربر را لغو، لغو یا به طور کامل بازپرداخت کنید.