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

این سند نحوه ادغام برنامه شما با ویژگی چند محصولی کتابخانه پرداخت Play (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:

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

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