Beberapa opsi pembelian dan penawaran untuk produk sekali beli

Dokumen ini menjelaskan secara mendetail integrasi produk sekali beli (OTP) Anda dengan Play Billing Library. Dokumen ini menjelaskan lebih lanjut cara mengintegrasikan berbagai opsi pembelian dan penawaran yang terkait dengan produk sekali beli Anda.

Anda dapat mengonfigurasi beberapa opsi pembelian dan penawaran untuk produk sekali beli. Misalnya, Anda dapat mengonfigurasi opsi pembelian dan penawaran praorder untuk produk sekali beli yang sama.

Prasyarat

Untuk mengonfigurasi beberapa penawaran untuk produk sekali beli, Anda harus menggunakan queryProductDetailsAsync() API. API querySkuDetailsAsync() yang tidak digunakan lagi tidak didukung. Untuk mengetahui informasi tentang cara menggunakan queryProductDetailsAsync() dan versi launchBillingFlow() yang menggunakan ProductDetailsParams sebagai input, lihat langkah-langkah migrasi.

Meminta detail produk

Jika Anda telah mengonfigurasi beberapa penawaran atau opsi pembelian untuk produk sekali beli, objek ProductDetails yang ditampilkan oleh metode queryProductDetailsAsync() dapat memiliki lebih dari satu opsi pembelian dan (atau) sewa yang tersedia per produk sekali beli. Untuk mendapatkan daftar semua penawaran yang memenuhi syarat untuk setiap objek ProductDetails, gunakan metode getOneTimePurchaseOfferDetailsList(). Hanya penawaran dan opsi pembelian yang memenuhi syarat bagi pengguna yang akan ditampilkan sebagai bagian dari daftar ini. Kode Anda dalam metode onProductDetailsResponse() harus menangani penawaran yang ditampilkan.

Mulai alur penagihan

Untuk memulai permintaan pembelian dari aplikasi Anda, panggil metode launchBillingFlow() dari thread utama aplikasi Anda. Metode ini mengambil referensi ke objek BillingFlowParams yang berisi objek ProductDetails yang relevan dan diperoleh dari panggilan queryProductDetailsAsync(). Untuk membuat objek BillingFlowParams, gunakan class BillingFlowParams.Builder. Perhatikan bahwa Anda harus menetapkan token penawaran yang sesuai dengan penawaran yang dipilih oleh pengguna saat membuat objek BillingFlowParams.

Contoh berikut menunjukkan cara meluncurkan alur pembelian untuk produk sekali beli dengan beberapa penawaran:

Java

    
// An activity reference from which the billing flow will launch.
Activity activity = ...;
ImmutableList<ProductDetailsParams> productDetailsParamsList =
    ImmutableList.of(
        ProductDetailsParams.newBuilder()
             // retrieve a value for &quot;productDetails&quot; by calling queryProductDetailsAsync()
            .setProductDetails(productDetails)
            // to get an offer token, call
            // ProductDetails.getOneTimePurchaseOfferDetailsList() for a list of offers
            // that are available to the user
            .setOfferToken(selectedOfferToken)
            .build()
    );
BillingFlowParams billingFlowParams = BillingFlowParams.newBuilder()
    .setProductDetailsParamsList(productDetailsParamsList)
    .build();
// Launch the billing flow
BillingResult billingResult = billingClient.launchBillingFlow(activity, billingFlowParams);
    
    

offerToken dapat ditemukan sebagai bagian dari OneTimePurchaseOfferDetails. Saat menampilkan penawaran kepada pengguna, pastikan Anda mengonfigurasi parameter alur penagihan dengan token penawaran yang benar yang bisa Anda dapatkan dari metode oneTimePurchaseOfferDetails.getOfferToken().

Penawaran dan opsi pembelian

Opsi pembelian memungkinkan Anda menentukan cara pemberian hak kepada pengguna, harganya, dan wilayah tempat produk tersedia. Satu produk dapat memiliki beberapa opsi pembelian, yang dapat menunjukkan tempat dan cara Anda menjual produk.

Google Play mendukung opsi pembelian berikut untuk produk sekali beli:

  • Opsi pembelian
  • Opsi pembelian sewa

Penawaran mengacu pada skema harga yang dapat Anda buat untuk produk sekali beli. Misalnya, Anda dapat membuat penawaran diskon untuk produk sekali beli.

Google Play mendukung penawaran pembelian berikut untuk produk sekali beli:

  • Penawaran praorder (hanya didukung untuk opsi pembelian beli)
  • Penawaran diskon (didukung untuk opsi pembelian dan penyewaan)

Opsi pembelian

Opsi pembelian beli mewakili pembelian langsung produk sekali beli standar. Objek ini memiliki kolom legacyCompatible opsional, yang menunjukkan apakah opsi pembelian ini akan tersedia di alur Library Layanan Penagihan Play yang lebih lama (versi 7 atau lebih lama) yang tidak mendukung model baru. Untuk kompatibilitas mundur, setidaknya satu opsi pembelian beli harus ditandai sebagai kompatibel dengan versi sebelumnya.

Langkah-langkah untuk mengintegrasikan opsi pembelian dan penyewaan dengan PBL adalah sama. Untuk memahami cara mengintegrasikan opsi pembelian dengan PBL, lihat Mengintegrasikan opsi pembelian sewa dengan PBL.

Opsi pembelian sewa

Opsi pembelian sewa memungkinkan pengguna mengakses produk sekali beli selama jangka waktu tertentu. Anda dapat menentukan periode sewa dan masa berlakunya. Dokumen ini menjelaskan langkah-langkah untuk mengintegrasikan opsi pembelian sewa dengan Play Billing Library (PBL).

Mengintegrasikan opsi pembelian sewa dengan PBL

Bagian ini menjelaskan cara mengintegrasikan opsi pembelian sewa dengan Play Billing Library (PBL). Panduan ini mengasumsikan bahwa Anda sudah memahami langkah-langkah integrasi PBL awal seperti, menambahkan dependensi PBL ke aplikasi Anda, melakukan inisialisasi BillingClient, dan menghubungkan ke Google Play. Bagian ini berfokus pada aspek integrasi PBL yang khusus untuk opsi pembelian sewa.

Untuk mengonfigurasi produk yang tersedia untuk disewa, Anda harus menggunakan layanan monetization.onetimeproducts baru Play Developer API atau UI Konsol Play. Untuk menggunakan layanan ini, Anda dapat memanggil REST API secara langsung, atau menggunakan library klien Java.

Meluncurkan alur pembelian untuk opsi sewa

Untuk meluncurkan alur pembelian penawaran sewa, lakukan langkah-langkah berikut:

  1. Ambil metadata opsi pembelian sewa menggunakan metode ProductDetails.oneTimePurchaseOfferDetails.getRentalDetails().

    Contoh berikut menunjukkan cara mendapatkan metadata pembelian sewa:

    Java

    billingClient.queryProductDetailsAsync(
    queryProductDetailsParams,
    new ProductDetailsResponseListener() {
      public void onProductDetailsResponse(
          BillingResult billingResult, QueryProductDetailsResult productDetailsResult) {
        // check billingResult
        // …
        // process productDetailsList returned by QueryProductDetailsResult
        for (ProductDetails productDetails : productDetailsResult.getProductDetailsList()) {
          for (OneTimePurchaseOfferDetails oneTimePurchaseOfferDetails :
              productDetails.getOneTimePurchaseOfferDetailsList()) {
            // Checks if the offer is a rent purchase option.
            if (oneTimePurchaseOfferDetails.getRentalDetails() != null) {
              // process the returned RentalDetails
              OneTimePurchaseOfferDetails.RentalDetails rentalDetails =
                  oneTimePurchaseOfferDetails.getRentalDetails();
              // Get rental period in ISO 8601 format.
              String rentalPeriod = rentalDetails.getRentalPeriod();
              // Get rental expiration period in ISO 8601 format, if present.
              if (rentalDetails.getRentalExpirationPeriod() != null) {
                String rentalExpirationPeriod = rentalDetails.getRentalExpirationPeriod();
              }
              // Get offer token
                String offerToken = oneTimePurchaseOfferDetails.getOfferToken();
              // Get the associated purchase option ID
              if (oneTimePurchaseOfferDetails.getPurchaseOptionId() != null) {
                String purchaseOptionId = oneTimePurchaseOfferDetails.getPurchaseOptionId();
              }
            }
          }
        }
      }
    });
  2. Mulai alur penagihan.

    Untuk memulai permintaan pembelian dari aplikasi Anda, panggil metode launchBillingFlow() dari thread utama aplikasi Anda. Metode ini mengambil referensi ke objek BillingFlowParams yang berisi objek ProductDetails yang relevan dan diperoleh dari panggilan queryProductDetailsAsync(). Untuk membuat objek BillingFlowParams, gunakan class BillingFlowParams.Builder. Perhatikan bahwa Anda harus menetapkan token penawaran yang sesuai dengan penawaran yang dipilih oleh pengguna saat membuat objek BillingFlowParams. Jika pengguna memenuhi syarat untuk opsi pembelian sewa, mereka akan menerima penawaran dengan RentalDetails dan offerId di queryProductDetailsAsync().

    Contoh berikut menunjukkan cara meluncurkan alur penagihan:

    Kotlin

    // An activity reference from which the billing flow will be launched.
    val activity : Activity = ...;
    
    val productDetailsParamsList = listOf(
        BillingFlowParams.ProductDetailsParams.newBuilder()
            // retrieve a value for "productDetails" by calling queryProductDetailsAsync()
            .setProductDetails(productDetails)
            // Get the offer token:
            // a. For one-time products, call ProductDetails.getOneTimePurchaseOfferDetailsList()
            // for a list of offers that are available to the user.
            // b. For subscriptions, call ProductDetails.subscriptionOfferDetails()
            // for a list of offers that are available to the user.
            .setOfferToken(selectedOfferToken)
            .build()
    )
    
    val billingFlowParams = BillingFlowParams.newBuilder()
        .setProductDetailsParamsList(productDetailsParamsList)
        .build()
    
    // Launch the billing flow
    val billingResult = billingClient.launchBillingFlow(activity, billingFlowParams)

    Java

    // An activity reference from which the billing flow will be launched.
    Activity activity = ...;
    
    ImmutableList<ProductDetailsParams> productDetailsParamsList =
        ImmutableList.of(
            ProductDetailsParams.newBuilder()
                 // retrieve a value for "productDetails" by calling queryProductDetailsAsync()
                .setProductDetails(productDetails)
                // Get the offer token:
                // a. For one-time products, call ProductDetails.getOneTimePurchaseOfferDetailsList()
                // for a list of offers that are available to the user.
                // b. For subscriptions, call ProductDetails.subscriptionOfferDetails()
                // for a list of offers that are available to the user.
                .setOfferToken(selectedOfferToken)
                .build()
        );
    
    BillingFlowParams billingFlowParams = BillingFlowParams.newBuilder()
        .setProductDetailsParamsList(productDetailsParamsList)
        .build();
    
    // Launch the billing flow
    BillingResult billingResult = billingClient.launchBillingFlow(activity, billingFlowParams);

    offerToken dapat ditemukan sebagai bagian dari OneTimePurchaseOfferDetails. Saat menampilkan penawaran kepada pengguna, pastikan Anda mengonfigurasi parameter alur penagihan dengan token penawaran yang benar yang bisa Anda dapatkan dari metode oneTimePurchaseOfferDetails.getOfferToken().

Penawaran praorder

Praorder memungkinkan Anda menyiapkan produk sekali beli untuk dibeli sebelum item dirilis. Saat pengguna melakukan praorder produk Anda, mereka setuju untuk membayar item tersebut saat produk dirilis, kecuali jika pengguna membatalkan praorder sebelum tanggal rilis. Pada tanggal rilis, pembeli akan ditagih dan Play akan memberi tahu mereka melalui email bahwa item telah dirilis.

Dokumen ini menjelaskan langkah-langkah untuk mengintegrasikan penawaran pembelian praorder dengan Play Billing Library (PBL).

Mengintegrasikan penawaran praorder dengan PBL

Bagian ini menjelaskan cara mengintegrasikan penawaran praorder dengan Play Billing Library (PBL). Panduan ini mengasumsikan bahwa Anda sudah memahami langkah-langkah integrasi PBL awal seperti, menambahkan dependensi PBL ke aplikasi Anda, melakukan inisialisasi BillingClient, dan menghubungkan ke Google Play. Bagian ini berfokus pada aspek integrasi PBL yang khusus untuk penawaran praorder.

Meluncurkan alur pembelian untuk penawaran praorder

Untuk meluncurkan alur pembelian untuk penawaran praorder, lakukan langkah-langkah berikut:

  1. Ambil metadata penawaran praorder menggunakan metode ProductDetails.oneTimePurchaseOfferDetails.getPreorderDetails(). Contoh berikut menunjukkan cara mendapatkan metadata penawaran praorder:

    Java

    billingClient.queryProductDetailsAsync(
    queryProductDetailsParams,
    new ProductDetailsResponseListener() {
      public void onProductDetailsResponse(
          BillingResult billingResult, QueryProductDetailsResult productDetailsResult) {
        // check billingResult
        // …
        // process productDetailsList returned by QueryProductDetailsResult
        for (ProductDetails productDetails : productDetailsResult.getProductDetailsList()) {
          for (OneTimePurchaseOfferDetails oneTimePurchaseOfferDetails :
              productDetails.getOneTimePurchaseOfferDetailsList()) {
            // Checks if the offer is a preorder offer.
            if (oneTimePurchaseOfferDetails.getPreorderDetails() != null) {
              // process the returned PreorderDetails
              OneTimePurchaseOfferDetails.PreorderDetails preorderDetails =
                  oneTimePurchaseOfferDetails.getPreorderDetails();
              // Get preorder release time in millis.
              long preorderReleaseTimeMillis = preorderDetails.getPreorderReleaseTimeMillis();
              // Get preorder presale end time in millis.
              long preorderPresaleEndTimeMillis = preorderDetails.getPreorderPresaleEndTimeMillis();
              // Get offer ID
                String offerId = oneTimePurchaseOfferDetails.getOfferId();
              // Get the associated purchase option ID
              if (oneTimePurchaseOfferDetails.getPurchaseOptionId() != null) {
                String purchaseOptionId = oneTimePurchaseOfferDetails.getPurchaseOptionId();
              }
            }
          }
        }
      }
    });

  2. Mulai alur penagihan.

    Untuk memulai permintaan pembelian dari aplikasi Anda, panggil metode launchBillingFlow() dari thread utama aplikasi Anda. Metode ini mengambil referensi ke objek BillingFlowParams yang berisi objek ProductDetails yang relevan dan diperoleh dari panggilan queryProductDetailsAsync(). Untuk membuat objek BillingFlowParams, gunakan BillingFlowParams.Builder class. Perhatikan bahwa Anda harus menetapkan token penawaran yang sesuai dengan penawaran yang dipilih oleh pengguna saat membuat objek BillingFlowParams. Jika pengguna memenuhi syarat untuk penawaran praorder, mereka akan menerima penawaran dengan PreorderDetails dan offerId dalam metode queryProductDetailsAsync().

    Contoh berikut menunjukkan cara meluncurkan alur penagihan:

    Java

    // An activity reference from which the billing flow will launch.
    Activity activity = ...;
    ImmutableList productDetailsParamsList =
        ImmutableList.of(
        ProductDetailsParams.newBuilder()
             // retrieve a value for "productDetails" by calling queryProductDetailsAsync()
            .setProductDetails(productDetails)
            // to get an offer token, call
            // ProductDetails.getOneTimePurchaseOfferDetailsList() for a list of offers
            // that are available to the user
            .setOfferToken(selectedOfferToken)
            .build()
    );
    BillingFlowParams billingFlowParams = BillingFlowParams.newBuilder()
    .setProductDetailsParamsList(productDetailsParamsList)
    .build();
    // Launch the billing flow
    BillingResult billingResult = billingClient.launchBillingFlow(activity, billingFlowParams);

    offerToken dapat ditemukan sebagai bagian dari OneTimePurchaseOfferDetails. Saat menampilkan penawaran kepada pengguna, pastikan Anda mengonfigurasi parameter alur penagihan dengan token penawaran yang benar yang bisa Anda dapatkan dari metode oneTimePurchaseOfferDetails.getOfferToken().

Penawaran diskon

Bagian ini menjelaskan cara mengonfigurasi penawaran diskon untuk produk sekali beli Anda.

Ada empat parameter berbeda yang dapat Anda konfigurasi dalam penawaran diskon produk satu kali:

  • Harga penawaran yang didiskon: Menentukan detail tentang diskon persentase atau harga absolut dari harga asli.

  • Kelayakan Negara atau Wilayah: Menentukan ketersediaan penawaran produk sekali beli di suatu negara atau wilayah.

  • Batas pembelian (opsional): Memungkinkan Anda menentukan berapa kali pengguna dapat menukarkan penawaran yang sama. Jika pengguna melebihi batas pembelian, pengguna tidak akan memenuhi syarat untuk penawaran tersebut.

  • Waktu terbatas (opsional): Menentukan jangka waktu penawaran tersedia. Di luar periode waktu tersebut, penawaran tidak memenuhi syarat untuk pembelian.

Mengambil informasi harga penawaran diskon

Untuk penawaran diskon, Anda dapat mengambil persentase diskon atau diskon absolut yang ditawarkan.

Contoh 1: Mengambil diskon persentase penawaran yang didiskon

Contoh berikut menunjukkan cara mendapatkan harga penuh asli penawaran diskon dan persentase diskonnya. Perhatikan bahwa informasi diskon persentase hanya ditampilkan untuk penawaran yang didiskon.

Java

billingClient.queryProductDetailsAsync(
    queryProductDetailsParams,
    new ProductDetailsResponseListener() {
      public void onProductDetailsResponse(
          BillingResult billingResult, QueryProductDetailsResult productDetailsResult){
        // check billingResult
        // …
        // process productDetailsList returned by QueryProductDetailsResult
        for (ProductDetails productDetails : productDetailsResult.getProductDetailsList()) {
          for (OneTimePurchaseOfferDetails oneTimePurchaseOfferDetails :
              productDetails.getOneTimePurchaseOfferDetailsList()) {
            long discountedOfferPriceMicros =
                oneTimePurchaseOfferDetails.getPriceAmountMicros();
            // process the returned fullPriceMicros and percentageDiscount.
            if (oneTimePurchaseOfferDetails.getFullPriceMicros() != null) {
              long fullPriceMicros = oneTimePurchaseOfferDetails.getFullPriceMicros();
            }
            if (oneTimePurchaseOfferDetails.getDiscountDisplayInfo() != null) {
              long percentageDiscount =
                  oneTimePurchaseOfferDetails
                      .getDiscountDisplayInfo()
                      .getPercentageDiscount();
            }
            // …
          }
        }
      }
    });
    
Contoh 2: Mengambil diskon mutlak penawaran yang didiskon

Contoh berikut menunjukkan cara mendapatkan harga penuh asli penawaran diskon dan diskon mutlaknya dalam mikro. Perhatikan bahwa informasi diskon absolut dalam mikro hanya ditampilkan untuk penawaran diskon. Diskon mutlak atau diskon persentase harus ditentukan untuk penawaran diskon.

Java

billingClient.queryProductDetailsAsync(
    queryProductDetailsParams,
    new ProductDetailsResponseListener() {
      public void onProductDetailsResponse(
          BillingResult billingResult, QueryProductDetailsResult productDetailsResult) {
        // check billingResult
        // …
        // process productDetailsList returned by QueryProductDetailsResult
        for (ProductDetails productDetails : productDetailsResult.getProductDetailsList()) {
          for (OneTimePurchaseOfferDetails oneTimePurchaseOfferDetails :
              productDetails.getOneTimePurchaseOfferDetailsList()) {
            long discountedOfferPriceMicros =
                oneTimePurchaseOfferDetails.getPriceAmountMicros();
            // process the returned fullPriceMicros and absolute DiscountAmountMicros.
            if (oneTimePurchaseOfferDetails.getFullPriceMicros() != null) {
              long fullPriceMicros = oneTimePurchaseOfferDetails.getFullPriceMicros();
            }
            if (oneTimePurchaseOfferDetails.getDiscountDisplayInfo() != null) {
              long discountAmountMicros =
                  oneTimePurchaseOfferDetails
                      .getDiscountDisplayInfo()
                      .getDiscountAmount()
                      .getDiscountAmountMicros();
            }
            // …
          }
        }
      }
    });
    

Mendapatkan jangka waktu yang valid dari penawaran

Anda dapat menggunakan metode OneTimePurchaseOfferDetails.getValidTimeWindow() untuk mendapatkan periode waktu yang valid untuk penawaran. Objek ini berisi waktu mulai dan waktu berakhir jendela waktu dalam milidetik.

Contoh berikut menunjukkan cara mendapatkan jangka waktu penawaran yang valid:

Java

billingClient.queryProductDetailsAsync(
    queryProductDetailsParams,
    new ProductDetailsResponseListener() {
      public void onProductDetailsResponse(
          BillingResult billingResult, QueryProductDetailsResult productDetailsResult) {
        // check billingResult
        // …
        // process productDetailsList returned by QueryProductDetailsResult
        for (ProductDetails productDetails : productDetailsResult.getProductDetailsList()) {
          for (OneTimePurchaseOfferDetails oneTimePurchaseOfferDetails :
              productDetails.getOneTimePurchaseOfferDetailsList()) {
            if (oneTimePurchaseOfferDetails.getValidTimeWindow() != null) {
              // process the returned startTimeMillis and endTimeMillis.
              ValidTimeWindow validTimeWindow =
                  oneTimePurchaseOfferDetails.getValidTimeWindow();
              long startTimeMillis = validTimeWindow.getStartTimeMillis();
              long endTimeMillis = validTimeWindow.getEndTimeMillis();
              // …
            }
          }
        }
      }
    });
    

Jumlah terbatas di tingkat penawaran diskon

Anda dapat menentukan batas jumlah maksimum di tingkat penawaran diskon, yang diterapkan hanya di tingkat penawaran. Berikut adalah contoh untuk mengilustrasikannya:

  1. Screensaver super memiliki 2 penawaran untuk produk screensaver: screensaver opsi pembelian dan screensaver diskon.
    1. Screensaver opsi pembelian tidak memiliki penyiapan jumlah terbatas.
    2. Screensaver diskon memiliki jumlah maksimum tingkat penawaran yang diizinkan ditetapkan ke 3.
  2. Produk screensaver tidak memiliki jumlah maksimum yang diizinkan di tingkat produk, sehingga pengguna dapat membeli produk ini dalam jumlah tak terbatas.
  3. Pengguna memiliki 1 screensaver diskon, dan berencana membeli screensaver lain dengan screensaver diskon tersebut.
  4. Saat mengambil penawaran yang tersedia, LimitedQuantityInfo untuk screensaver opsi pembelian adalah null dan nilai jumlah yang tersisa untuk screensaver diskon adalah 2.

Contoh berikut menunjukkan cara mendapatkan jumlah terbatas di tingkat penawaran diskon:

Java

billingClient.queryProductDetailsAsync(
    queryProductDetailsParams,
    new ProductDetailsResponseListener() {
      public void onProductDetailsResponse(
          BillingResult billingResult, QueryProductDetailsResult productDetailsResult) {
        // check billingResult
        // …
        // process productDetailsList returned by QueryProductDetailsResult
        for (ProductDetails productDetails : productDetailsResult.getProductDetailsList()) {
          for (OneTimePurchaseOfferDetails oneTimePurchaseOfferDetails :
              productDetails.getOneTimePurchaseOfferDetailsList()) {
            if (oneTimePurchaseOfferDetails.getLimitedQuantityInfo() != null) {
              // process the returned maximumQuantity and remainingQuantity.
              LimitedQuantityInfo limitedQuantityInfo =
                  oneTimePurchaseOfferDetails.getLimitedQuantityInfo();
              int maximumQuantity = limitedQuantityInfo.getMaximumQuantity();
              int remainingQuantity = limitedQuantityInfo.getRemainingQuantity();
              // …
            }
          }
        }
      }
    });
    

Jika pengguna telah menggunakan penukaran jumlah maksimum untuk penawaran, penawaran tersebut tidak akan ditampilkan oleh metode getOneTimePurchaseOfferDetailsList().

Menghitung batas penukaran

Contoh berikut menunjukkan cara mendapatkan informasi jumlah terbatas pada penawaran diskon tertentu. Anda bisa mendapatkan jumlah maksimum yang diizinkan dan jumlah yang tersisa untuk pengguna saat ini. Perhatikan bahwa fitur jumlah terbatas berlaku untuk penawaran produk sekali beli yang dapat dipakai dan tidak dapat dipakai. Fitur ini hanya didukung di tingkat penawaran.

Google Play menghitung sisa jumlah dengan mengurangi jumlah yang dimiliki pengguna dari jumlah maksimum yang diizinkan yang telah Anda siapkan. Saat menghitung jumlah yang dimiliki pengguna, Google Play mempertimbangkan pembelian yang telah digunakan atau pembelian yang tertunda. Pembelian yang dibatalkan, dikembalikan dananya, atau ditagih balik tidak dihitung dalam jumlah yang dimiliki pengguna. Contoh:

  1. Screensaver super menyiapkan penawaran diskon dengan jumlah maksimum yang diizinkan adalah satu, sehingga pengguna dapat membeli hingga satu screensaver diskon.

  2. Pengguna membeli salah satu screensaver yang didiskon. Jika pengguna kemudian mencoba membeli screensaver kedua yang didiskon, error akan terjadi dan PurchasesUpdatedListener akan mendapatkan kode respons ITEM_UNAVAILABLE.

  3. Pengguna meminta pengembalian dana untuk screensaver yang dibeli dengan diskon awalnya, dan berhasil menerima pengembalian dana. Pengguna mencoba membeli salah satu screensaver yang didiskon, dan pembelian akan berhasil.

Kelayakan negara dan wilayah

Anda dapat memilih negara atau wilayah tempat penawaran opsi pembelian atau penawaran diskon akan tersedia bagi pengguna. Google Play akan mengevaluasi kelayakan pengguna berdasarkan negara Play. Saat Anda mengonfigurasi ketersediaan regional untuk penawaran, penawaran tersebut hanya akan ditampilkan sebagai bagian dari getOneTimePurchaseOfferDetailsList() jika pengguna berada di negara atau wilayah yang ditargetkan. Jika tidak, penawaran tersebut tidak akan menjadi bagian dari daftar penawaran yang ditampilkan saat Anda memanggil queryProductDetailsAsync().

Tag penawaran

Contoh berikut menunjukkan cara mengambil tag penawaran yang terkait dengan penawaran.

Java

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

Pewarisan tag penawaran

Anda dapat menetapkan tag penawaran untuk produk, opsi pembelian, atau penawaran diskon. Penawaran diskon mewarisi tag penawaran dari penawaran opsi pembeliannya. Demikian pula, jika tag penawaran ditentukan di tingkat produk, penawaran opsi pembelian dan penawaran diskon akan mewarisi tag penawaran produk.

Misalnya, Super screensaver memiliki dua penawaran untuk produk screensaver; screensaver opsi pembelian dan screensaver diskon.

  • Screensaver super memiliki tag penawaran produk SSProductTag.
  • Screensaver opsi pembelian memiliki tag penawaran SSPurchaseOptionTag.
  • Screensaver diskon memiliki tag penawaran SSDiscountOfferTag.

Dalam contoh ini, metode oneTimePurchaseOfferDetails.getOfferTagsList() untuk penawaran opsi pembelian menampilkan SSProductTag dan SSPurchaseOptionTag. Untuk penawaran diskon, metode ini menampilkan SSProductTag, SSPurchaseOptionTag, dan SSDiscountOfferTag.