Mempertahankan pelanggan dengan penawaran retensi

Penawaran retensi membantu Anda mengurangi churn sukarela dengan menampilkan diskon kepada pelanggan saat mereka mencoba membatalkan langganan di Google Play.

Saat pelanggan yang memenuhi syarat mulai membatalkan, Google Play akan menampilkan penawaran retensi yang Anda konfigurasi, seperti "Pertahankan langganan Anda dan dapatkan diskon 50% untuk 2 bulan ke depan". Jika pelanggan menerima penawaran, langganan mereka tidak akan dibatalkan. Harga diskon akan dimulai pada tanggal penagihan berikutnya.

Halaman ini menjelaskan cara kerja penawaran retensi, cara mengonfigurasinya, cara menangani peristiwa yang dihasilkan di backend, dan cara mengujinya.

Sebelum memulai

Sebelum menyiapkan penawaran retensi, pastikan Anda telah melakukan hal berikut:

Karena Google Play menampilkan penawaran retensi di luar aplikasi, Anda tidak perlu mengubah aplikasi atau mengupdate integrasi Google Play Billing Library untuk menggunakannya. Semua pekerjaan integrasi dilakukan di Konsol Google Play dan backend Anda.

Cara kerja penawaran retensi

Penawaran retensi hanya muncul di pengelolaan langganan Google Play: aplikasi Google Play Store dan Google Play di web. Penawaran ini tidak muncul di dalam aplikasi Anda. Google Play Billing Library tidak menampilkan penawaran retensi dalam hasil queryProductDetailsAsync(), sehingga tidak disertakan dalam ProductDetails.getSubscriptionOfferDetails(), dan Anda tidak dapat menjualnya melalui launchBillingFlow(). Jika aplikasi Anda menggunakan deep link untuk mengarahkan pelanggan ke pusat langganan Google Play atau ke langganan tertentu agar mereka dapat mengelola atau membatalkannya, pelanggan tersebut dapat melihat penawaran retensi Anda saat mereka mulai membatalkan langganan di sana.

Langkah-langkah berikut menjelaskan hal yang terjadi saat pelanggan mencoba membatalkan:

  1. Pelanggan membuka langganannya di Google Play dan mulai membatalkannya.
  2. Google Play memeriksa apakah pelanggan memenuhi syarat untuk salah satu penawaran retensi Anda, berdasarkan aturan kelayakan yang Anda tetapkan untuk penawaran, atau apakah Anda menargetkan penawaran kepada pelanggan tersebut.

  3. Jika pelanggan memenuhi syarat, Google Play dapat menampilkan penawaran retensi sebagai alternatif untuk membatalkan. Memenuhi kriteria kelayakan tidak menjamin bahwa penawaran akan muncul, karena Google Play juga melakukan pemeriksaan tingkat platform tambahan, seperti persyaratan kepatuhan regional. Jika Google Play menampilkan penawaran, pelanggan dapat melakukan salah satu tindakan berikut:

    • Menerima penawaran: Pelanggan menerima dengan sekali ketuk. Langganan tetap aktif dan diperpanjang otomatis. Pelanggan tidak akan langsung ditagih; harga diskon berlaku mulai periode penagihan berikutnya.
    • Lanjutkan pembatalan: Pelanggan menolak penawaran dan menyelesaikan alur pembatalan standar. Anda akan menerima notifikasi SUBSCRIPTION_CANCELED seperti biasa. Untuk mengetahui detailnya, lihat Pembatalan.

Jika pelanggan keluar dari alur pembatalan tanpa menerima penawaran atau membatalkan, langganannya tidak akan berubah. Hal ini berlaku untuk aplikasi Google Play Store dan Google Play di web. Melihat penawaran retensi tanpa menyetujuinya tidak akan mengurangi batas klaim penawaran atau memulai periode tunggu antar-penawaran. Google Play memeriksa batas klaim saat menampilkan penawaran dan sekali lagi saat pelanggan menerimanya. Penawaran yang diterima akan dihitung dalam batas klaim saat langganan diperpanjang dengan harga diskon. Periode tunggu antara penawaran dimulai saat periode diskon penawaran retensi sebelumnya pada paket dasar yang sama berakhir. Pelanggan mungkin akan melihat penawaran tersebut lagi saat mencoba membatalkan langganan pada lain waktu, asalkan mereka masih memenuhi syarat.

Transisi paket terjadwal

Saat pelanggan menerima penawaran retensi, Google Play akan memodelkannya sebagai transisi paket terjadwal pada pembelian yang sudah ada milik pelanggan. Hal ini berbeda dengan penggantian yang ditangguhkan, yang memerlukan alur pembelian baru dan membuat token pembelian baru. Dengan penawaran retensi, pelanggan tetap memiliki purchaseToken yang sama, dan hanya persyaratan penagihan mendatang yang berubah.

Saat pelanggan menerima penawaran, Google Play akan melakukan hal berikut:

  • Mengirim RTDN SUBSCRIPTION_PLAN_TRANSITION_UPDATED (21) ke backend Anda.
  • Menambahkan objek planTransitionDetails ke kolom autoRenewingPlan dari item baris yang terpengaruh di resource SubscriptionPurchaseV2.

Untuk mengetahui detail tentang cara menangani peristiwa ini, lihat Menangani peristiwa penawaran retensi di backend.

Persyaratan kelayakan

Langganan dapat menerima penawaran retensi kapan saja sebelum perpanjangan berikutnya, asalkan semua hal berikut terpenuhi:

  • Langganan aktif dan diperpanjang otomatis. Langganan dalam masa tenggang, dalam penangguhan akun, atau dijeda tidak dapat menerima penawaran retensi.
  • Langganan tersebut adalah langganan tunggal. Penawaran retensi tidak didukung untuk langganan dengan add-on.
  • Langganan tidak menggunakan paket dasar cicilan. Paket dasar cicilan tidak memenuhi syarat untuk penawaran retensi.
  • Pembayaran berikutnya adalah harga paket dasar berulang reguler. Jika pelanggan berada dalam fase uji coba gratis atau harga perkenalan, penawaran hanya tersedia selama periode penagihan akhir fase tersebut, saat perpanjangan mendatang dikenai harga reguler.
  • Pelanggan tidak berada dalam periode penagihan diskon dari penawaran retensi yang diterima sebelumnya. Pelanggan yang berada dalam fase diskon penawaran retensi tidak dapat mengklaim penawaran retensi lain hingga langganan diperpanjang dengan harga paket dasar reguler.
  • Langganan tidak memiliki transisi paket terjadwal yang tertunda. Langganan dapat memiliki maksimal satu transisi paket terjadwal yang tertunda, yang merupakan objek planTransitionDetails dalam status IN_PROGRESS. Misalnya, pelanggan yang telah menerima penawaran retensi yang belum berlaku tidak dapat menerima penawaran lain.
  • Langganan tidak memiliki perubahan harga yang belum dikonfirmasi.
  • Harga diskon penawaran retensi kurang dari atau sama dengan harga perpanjangan paket dasar berikutnya untuk pelanggan.
  • Pelanggan memenuhi aturan kelayakan yang Anda konfigurasi untuk penawaran. Untuk penawaran retensi per pengguna, Anda mengaktifkan penargetan untuk langganan dengan metode activateOfferTargeting.

Mengonfigurasi penawaran retensi

Anda dapat membuat penawaran retensi di Konsol Google Play atau menggunakan Google Play Developer API. Setiap penawaran retensi menggunakan salah satu mode penargetan berikut:

  • Penargetan berbasis aturan: Google Play memutuskan pelanggan mana yang memenuhi syarat, berdasarkan aturan kelayakan yang Anda tetapkan, seperti durasi minimum langganan berbayar.
  • Penargetan per pengguna: Backend Anda menentukan pelanggan mana yang dapat melihat penawaran dengan menargetkannya ke langganan tertentu.

Paket dasar dapat memiliki lebih dari satu penawaran retensi aktif di negara atau wilayah yang sama. Jika pelanggan memenuhi syarat untuk lebih dari satu penawaran, Google Play akan menampilkan maksimal satu penawaran retensi dalam alur pembatalan. Google Play memilih penawaran dalam urutan berikut:

  1. Mode penargetan: Penawaran yang ditargetkan per pengguna (retentionPerUserRule) selalu lebih diprioritaskan daripada penawaran berbasis aturan (retentionRule), meskipun penawaran berbasis aturan memiliki persentase diskon yang lebih tinggi.
  2. Persentase diskon: Di antara penawaran yang memenuhi syarat yang menggunakan mode penargetan yang sama, Google Play menampilkan penawaran dengan persentase diskon tertinggi yang ditampilkan.
  3. Harga diskon: Jika penawaran memiliki persentase diskon yang sama, Google Play akan menampilkan penawaran dengan harga diskon terendah.
  4. ID Penawaran: Jika penawaran masih sama, Google Play akan menampilkan penawaran yang offerId-nya berada di urutan terakhir dalam urutan abjad.

Membuat penawaran retensi di Konsol Play

Untuk membuat penawaran retensi di Konsol Google Play, lakukan hal berikut:

  1. Buka Monetisasi dengan Google Play > Produk > Langganan.
  2. Pilih langganan, lalu pilih paket dasar yang ingin Anda tambahi penawaran.
  3. Tambahkan penawaran untuk Pelanggan lama yang mencoba membatalkan langganan.
  4. Pilih Penawaran tingkat kelompok untuk menjaga retensi atau Penawaran tingkat pengguna untuk menjaga retensi.

Membuat penawaran retensi dengan Google Play Developer API

Anda juga dapat membuat dan memperbarui penawaran retensi secara terprogram. Untuk membuat penawaran, panggil metode monetization.subscriptions.basePlans.offers.create. Untuk memperbarui penawaran yang ada, panggil metode monetization.subscriptions.basePlans.offers.patch atau monetization.subscriptions.basePlans.offers.batchUpdate. Ketiga metode ini mendukung kolom retentionRule, retentionPerUserRule, startTime, dan endTime. Di objek SubscriptionOffer, tetapkan kolom berikut:

  • offerId: ID penawaran retensi unik Anda.
  • targeting: Tetapkan retentionRule ke objek RetentionTargetingRule yang menentukan siapa yang memenuhi syarat untuk penawaran. Untuk kolom yang tersedia, lihat Menetapkan aturan kelayakan retensi. Untuk memilih pelanggan yang memenuhi syarat dari backend, tetapkan retentionPerUserRule. Untuk mengetahui detailnya, lihat Menargetkan penawaran retensi ke pelanggan tertentu.
  • phases[]: Penawaran retensi hanya mendukung satu fase harga. Pada fase tersebut, tetapkan kolom berikut:
    • recurrenceCount: Jumlah periode penagihan selama diskon berlaku, dari 1 hingga 52. Jika recurrenceCount lebih besar dari 1, fase duration harus sama dengan periode penagihan paket dasar.
    • regionalConfigs[]: Tetapkan relativeDiscount ke diskon sebagai pecahan yang lebih besar dari 0 dan kurang dari 1. Misalnya, gunakan 0.5 untuk diskon 50%. Penawaran retensi hanya mendukung relativeDiscount. Fase harga tetap (price), diskon mutlak (absoluteDiscount), dan gratis (free) tidak didukung.
  • startTime: Opsional. Waktu saat penawaran retensi tersedia untuk pelanggan yang memenuhi syarat, sebagai stempel waktu RFC 3339. Menetapkan kolom ini tidak akan mengaktifkan penawaran. Jika Anda tidak menetapkan kolom ini, penawaran akan tersedia berdasarkan statusnya.
  • endTime: Opsional. Waktu saat penawaran retensi berhenti tersedia, sebagai stempel waktu RFC 3339, terlepas dari status penawaran. Jika Anda tidak menetapkan kolom ini, penawaran tidak akan memiliki tanggal akhir. Jika Anda menetapkan kolom ini, kolom tersebut harus berada di masa mendatang dan lebih lambat dari startTime.

Metode monetization.subscriptions.basePlans.offers.create selalu membuat penawaran dalam status DRAFT, meskipun Anda menetapkan startTime. Untuk mengaktifkan penawaran, panggil metode monetization.subscriptions.basePlans.offers.activate.

Menetapkan aturan kelayakan retensi

Objek RetentionTargetingRule berisi kolom-kolom berikut:

  • scope: Wajib diisi. Langganan yang dipertimbangkan aturan. Untuk penawaran retensi, satu-satunya nilai yang didukung adalah thisSubscription, langganan tempat penawaran ditentukan. Tetapkan kolom ini ke {"thisSubscription": {}}.
  • minDuration: Wajib diisi. Waktu minimum pengguna harus menjadi pelanggan berbayar agar memenuhi syarat, sebagai durasi ISO 8601 dalam hari, dari P0D hingga P1826D. Misalnya, gunakan P90D selama 90 hari. Agar tidak memerlukan waktu langganan berbayar minimum, tetapkan kolom ini ke P0D.
  • allowMultipleClaims: Opsional. Apakah pelanggan dapat mengklaim penawaran lebih dari sekali. Jika false, pelanggan yang pernah mengklaim penawaran ini tidak akan pernah memenuhi syarat untuk penawaran ini lagi. Jika true, pelanggan dapat memenuhi syarat lagi setelah waktu di minOfferCooldownDuration berlalu sejak akhir periode diskon penawaran retensi sebelumnya. Nilai defaultnya adalah false.
  • minOfferCooldownDuration: Wajib diisi jika allowMultipleClaims adalah true. Waktu minimum yang harus berlalu setelah periode diskon penawaran retensi sebelumnya berakhir sebelum pelanggan memenuhi syarat lagi, sebagai durasi ISO 8601 dalam hari, dari P1D hingga P1826D. Misalnya, gunakan P180D selama 180 hari. Jangan tetapkan kolom ini jika allowMultipleClaims adalah false atau tidak ditetapkan.

Contoh berikut menunjukkan kolom startTime, endTime, dan targeting dari objek SubscriptionOffer untuk penawaran retensi yang tersedia bagi pelanggan yang telah membayar setidaknya selama 90 hari, dan yang dapat mereka klaim lagi 180 hari setelah diskon retensi sebelumnya berakhir:

{
  "offerId": "retention-50off-2m",
  "startTime": "2026-12-01T00:00:00Z",
  "endTime": "2027-03-01T00:00:00Z",
  "targeting": {
    "retentionRule": {
      "scope": {
        "thisSubscription": {}
      },
      "minDuration": "P90D",
      "allowMultipleClaims": true,
      "minOfferCooldownDuration": "P180D"
    }
  }
}

Menargetkan penawaran retensi kepada pelanggan tertentu

Daripada membiarkan Google Play memutuskan kelayakan dengan RetentionTargetingRule, Anda dapat menyediakan penawaran retensi hanya untuk pelanggan yang dipilih backend Anda. Misalnya, Anda dapat menargetkan penawaran kepada pelanggan yang ditandai berisiko oleh model prediksi churn, atau kepada pelanggan yang memulai proses pembatalan di aplikasi Anda.

Pelanggan akan melihat penawaran retensi per pengguna dalam alur pembatalan Google Play yang sama seperti penawaran retensi lainnya, dan Anda menangani penerimaan dengan cara yang sama. Untuk mengetahui detailnya, lihat Menangani peristiwa penawaran retensi di backend Anda.

Untuk menargetkan penawaran retensi kepada pelanggan tertentu, lakukan hal berikut:

  1. Buat penawaran retensi per pengguna. Saat Anda memanggil metode monetization.subscriptions.basePlans.offers.create, monetization.subscriptions.basePlans.offers.patch, atau monetization.subscriptions.basePlans.offers.batchUpdate, tetapkan targeting ke objek retentionPerUserRule, bukan objek retentionRule. Objek RetentionPerUserTargetingRule tidak memiliki kolom. Penawaran dapat menggunakan retentionRule atau retentionPerUserRule, tetapi tidak keduanya.

    {
      "offerId": "retention-peruser-30off",
      "targeting": {
        "retentionPerUserRule": {}
      }
    }
    

    Aktifkan penawaran sebelum Anda menargetkannya kepada pelanggan. Jika Anda memanggil metode activateOfferTargeting untuk penawaran yang belum pernah diaktifkan, panggilan akan gagal dengan kode status HTTP 400 Bad Request dan status error INVALID_ARGUMENT. Untuk mengetahui detailnya, lihat Menangani error penargetan. Meskipun penawaran aktif, Google Play hanya menampilkannya kepada pelanggan yang langganannya Anda targetkan di langkah berikutnya.

  2. Targetkan penawaran ke langganan. Panggil metode purchases.subscriptionsv2.activateOfferTargeting dengan nama paket aplikasi Anda, purchaseToken langganan, dan offerId penawaran retensi per pengguna:

    POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{purchaseToken}:activateOfferTargeting
    
    {
      "offerId": "retention-peruser-30off"
    }
    

    Panggilan yang berhasil akan menampilkan kode status HTTP 204 No Content tanpa isi respons. Google Play Store menyimpan penargetan dengan langganan, sehingga Anda tidak perlu memanggil API saat pelanggan membatalkan. Saat pelanggan mulai membatalkan di Google Play, Google Play dapat menampilkan penawaran, selama langganan memenuhi persyaratan kelayakan. Penargetan per pengguna hanya menggantikan aturan kelayakan yang ditentukan oleh retentionRule. Semua persyaratan kelayakan lainnya, dan pemeriksaan tingkat platform yang dilakukan Google Play, seperti persyaratan kepatuhan regional, tetap berlaku.

    Anda dapat menargetkan lebih dari satu penawaran retensi per pengguna ke langganan yang sama. Untuk melakukannya, panggil metode activateOfferTargeting satu kali untuk setiap penawaran. Google Play masih menampilkan maksimal satu penawaran retensi dalam alur pembatalan. Untuk mengetahui detail tentang cara Google Play memilih penawaran, lihat Mengonfigurasi penawaran retensi.

    Metode activateOfferTargeting bersifat idempoten. Jika Anda memanggilnya untuk penawaran yang sudah ditargetkan ke langganan, panggilan akan berhasil dan Google Play akan memperbarui activateTime penawaran ke waktu permintaan terbaru.

  3. Hapus penargetan jika diperlukan. Jika Anda tidak ingin lagi pelanggan menerima penawaran, misalnya karena risiko churn mereka berubah, panggil metode purchases.subscriptionsv2.deactivateOfferTargeting dengan nama paket, purchaseToken, dan offerId yang sama. Panggilan yang berhasil akan menampilkan kode status HTTP 204 No Content tanpa isi respons.

    Metode deactivateOfferTargeting juga idempoten. Jika penawaran tidak ditargetkan ke langganan, misalnya karena Anda tidak pernah mengaktifkan penargetan, panggilan akan berhasil dan tidak berpengaruh.

Penargetan berlaku untuk satu purchaseToken dan tidak akan berakhir masa berlakunya selama langganan aktif dan diperpanjang otomatis. Penawaran ini tetap ada setelah pelanggan melihat, menerima, atau menolak penawaran. Google Play hanya akan menghapusnya saat Anda memanggil metode deactivateOfferTargeting, atau 60 hari setelah langganan berakhir. Jika perubahan paket atau berlangganan lagi membuat purchaseToken baru, penargetan tidak akan diterapkan.

Untuk memeriksa penawaran retensi per pengguna yang ditargetkan ke langganan, panggil metode purchases.subscriptionsv2.get. Kolom developerTargetedOffers setiap item baris mencantumkan penawaran yang ditargetkan. Setiap entri berisi offerId dan activateTime saat Anda mengaktifkan penargetan:

{
  "lineItems": [
    {
      "productId": "premium_monthly_sub",
      "developerTargetedOffers": [
        {
          "offerId": "retention-peruser-30off",
          "activateTime": "2026-12-03T15:04:05Z"
        }
      ]
    }
  ]
}

Menangani error penargetan

Jika panggilan ke metode activateOfferTargeting atau deactivateOfferTargeting gagal, respons akan berisi kode status HTTP dan status error yang menjelaskan penyebabnya. Tabel berikut mencantumkan kode status HTTP dan status error yang dapat ditampilkan oleh metode ini:

Kode status HTTP Status error Metode Penyebab
404 Not Found NOT_FOUND Keduanya purchaseToken tidak ada.
400 Bad Request INVALID_ARGUMENT activateOfferTargeting offerId tidak ada di paket dasar langganan saat ini, atau penawaran masih dalam status draf dan belum pernah diaktifkan.
400 Bad Request FAILED_PRECONDITION activateOfferTargeting targeting penawaran tidak ditetapkan ke retentionPerUserRule.
400 Bad Request FAILED_PRECONDITION activateOfferTargeting Masa berlaku langganan telah berakhir.

Metode activateOfferTargeting tidak memeriksa apakah langganan yang belum habis masa berlakunya memenuhi syarat untuk penawaran. Misalnya, jika langganan dibatalkan, tetapi belum habis masa berlakunya, panggilan akan berhasil dan Google Play akan menyimpan penargetan. Google Play mengevaluasi kelayakan langganan saat pelanggan memasuki alur pembatalan.

Menangani peristiwa penawaran retensi di backend Anda

Saat pelanggan menerima penawaran retensi, dan kemudian saat perpanjangan dengan diskon terjadi, Google Play akan mengirimkan RTDN ke backend Anda. Setelah Anda menerima setiap notifikasi, panggil metode purchases.subscriptionsv2.get dengan purchaseToken dari notifikasi untuk mendapatkan status langganan terbaru.

Menerima penawaran retensi tidak akan membuat pembelian baru. purchaseToken tetap sama, sehingga Anda tidak perlu mengonfirmasi pembelian lagi, dan Google Play tidak akan membuat linkedPurchaseToken. Pertahankan hak yang ada untuk pelanggan. Proses pesanan perpanjangan dengan diskon dengan cara yang sama seperti perpanjangan langganan lainnya.

Jenis pemberitahuan Waktu pengiriman Yang harus dilakukan
SUBSCRIPTION_PLAN_TRANSITION_UPDATED (21) Saat pelanggan menerima penawaran retensi dalam alur pembatalan. Panggil metode purchases.subscriptionsv2.get dan periksa planTransitionDetails. transitionState adalah IN_PROGRESS. Langganan tetap aktif dan diperpanjang otomatis, jadi terus berikan akses.
SUBSCRIPTION_RENEWED (2) Saat periode penagihan saat ini berakhir dan langganan diperpanjang dengan harga penawaran retensi yang didiskon. Panggil metode purchases.subscriptionsv2.get, konfirmasi bahwa offerDetails.offerId adalah ID penawaran retensi dan bahwa planTransitionDetails tidak ada lagi, dan perpanjang akses pelanggan ke expiryTime baru.

Objek planTransitionDetails berisi kolom-kolom berikut:

  • productId: ID produk paket yang menjadi tujuan transisi langganan. Untuk penawaran retensi, produk ini sama.
  • basePlanId: ID paket dasar dari paket yang menjadi tujuan transisi langganan.
  • offerId: ID penawaran retensi yang diterima pelanggan. Gunakan kolom ini untuk mengidentifikasi penawaran retensi yang diklaim.
  • transitionInfo.transitionState: Status transisi. Untuk penawaran retensi, statusnya adalah IN_PROGRESS saat transisi tertunda.
  • transitionInfo.expectedTransitionTime: Kapan persyaratan penawaran retensi diperkirakan akan berlaku.

Google Play menyertakan planTransitionDetails hanya saat transisi tertunda. Saat langganan diperpanjang dengan harga penawaran retensi diskon, transisi selesai dan Google Play akan menghapus planTransitionDetails dari respons purchases.subscriptionsv2.get. Sejak saat itu, item baris itu sendiri akan menampilkan diskon retensi aktif:

  • offerDetails.offerId adalah ID penawaran retensi yang diterima.
  • offerPhase adalah {"introductoryPrice": {}} selama periode penagihan diskon. Setelah periode penagihan diskon berakhir dan langganan diperpanjang dengan harga paket dasar reguler, offerPhase akan berubah menjadi {"basePrice": {}}.

Respons setelah pelanggan menerima penawaran

Setelah pelanggan menerima penawaran retensi, periode penagihan saat ini akan berlanjut tanpa perubahan. Objek planTransitionDetails menampilkan transisi terjadwal dengan transitionState dari IN_PROGRESS:

{
  "lineItems": [
    {
      "productId": "premium_monthly_sub",
      "expiryTime": "2026-12-15T10:00:00Z",
      "offerDetails": {
        "basePlanId": "monthly-base"
      },
      "autoRenewingPlan": {
        "autoRenewEnabled": true,
        "planTransitionDetails": {
          "productId": "premium_monthly_sub",
          "basePlanId": "monthly-base",
          "offerId": "retention-50off-2m",
          "transitionInfo": {
            "transitionState": "IN_PROGRESS",
            "expectedTransitionTime": "2026-12-15T10:00:00Z"
          }
        }
      }
    }
  ]
}

Respons setelah perpanjangan dengan diskon

Setelah tanggal perpanjangan berlalu dan pelanggan dikenai harga diskon, offerDetails.offerId akan menampilkan penawaran retensi, offerPhase akan menampilkan introductoryPrice, dan respons tidak lagi menyertakan planTransitionDetails:

{
  "lineItems": [
    {
      "productId": "premium_monthly_sub",
      "expiryTime": "2027-01-15T10:00:00Z",
      "offerDetails": {
        "basePlanId": "monthly-base",
        "offerId": "retention-50off-2m"
      },
      "offerPhase": {
        "introductoryPrice": {}
      },
      "autoRenewingPlan": {
        "autoRenewEnabled": true,
        "recurringPrice": {
          "currencyCode": "USD",
          "units": "9",
          "nanos": 990000000
        }
      }
    }
  ]
}

Interaksi siklus proses

Perhatikan perilaku berikut saat Anda menangani penawaran retensi:

  • Akhir diskon: Setelah periode penagihan dengan diskon berakhir, langganan akan otomatis diperpanjang dengan harga paket dasar reguler. Anda akan menerima notifikasi SUBSCRIPTION_RENEWED, seperti perpanjangan lainnya, dan offerPhase item baris akan berubah menjadi {"basePrice": {}}. Pelanggan tidak perlu melakukan tindakan apa pun.
  • Pemulihan pembayaran setelah diskon: Jika perpanjangan dengan harga paket dasar reguler setelah diskon berakhir ditolak dan langganan memasuki masa tenggang atau penangguhan akun, pemulihan pembayaran akan mengenakan harga paket dasar reguler. Google Play tidak menerapkan diskon penawaran retensi yang telah selesai. Jika pembayaran untuk perpanjangan pertama yang didiskon ditolak, transisi yang tertunda akan dipertahankan, dan harga penawaran retensi akan berlaku saat pembayaran dipulihkan.
  • Penagihan yang ditangguhkan: Jika Anda memanggil metode purchases.subscriptionsv2.defer saat transisi penawaran retensi berstatus IN_PROGRESS, transisi yang tertunda akan dipertahankan dan berlaku pada perpanjangan yang ditangguhkan. Untuk mendapatkan tanggal perpanjangan baru, periksa expiryTime item baris.
  • Perubahan paket sebelum transisi: Penawaran retensi hanya berlaku untuk purchaseToken langganan tempat pelanggan menerimanya. Jika pelanggan beralih ke paket dasar atau langganan lain sebelum expectedTransitionTime, Google Play akan membuat token pembelian baru, membatalkan transisi terjadwal, dan menghapus planTransitionDetails. Penawaran retensi yang tertunda tidak berlaku untuk paket baru.
  • Pembatalan dan pemulihan: Jika pelanggan membatalkan langganan setelah menerima penawaran retensi, transisi yang dijadwalkan akan tetap tertunda dan transitionState tetap IN_PROGRESS. Jika pelanggan memulihkan langganan sebelum masa berlakunya berakhir, diskon penawaran retensi masih berlaku saat perpanjangan.
  • Berakhir dan berlangganan kembali: Jika langganan berakhir tanpa dipulihkan, Google Play akan membatalkan transisi yang tertunda. Jika pengguna berlangganan lagi atau mendaftar lagi nanti, Google Play akan membuat pembelian langganan baru, dan penawaran retensi yang diterima sebelumnya tidak berlaku.
  • Perubahan penawaran: Jika Anda mengubah diskon atau periode penagihan penawaran retensi, perubahan tersebut hanya berlaku untuk penukaran di masa mendatang. Pelanggan yang telah menyetujui penawaran akan tetap menggunakan persyaratan awal.
  • Penonaktifan penawaran: Jika Anda menonaktifkan penawaran retensi, atau penawaran mencapai tanggal akhirnya, pelanggan yang telah menerimanya akan tetap mendapatkan persyaratan yang mereka setujui. Pelanggan dengan transisi IN_PROGRESS masih menerima diskon pada perpanjangan berikutnya, dan pelanggan yang sudah berada dalam periode penagihan diskon akan tetap mendapatkan diskon selama durasi penuh yang disepakati.
  • Perubahan harga: Perubahan harga paket dasar tetap berlaku. Google Play memigrasikan pelanggan ke harga baru hanya jika pelanggan membayar harga reguler dan tidak memiliki transisi penawaran retensi yang tertunda. Untuk mengetahui informasi selengkapnya, lihat Mengubah harga langganan.
  • Pengembalian dana: Anda dapat mengembalikan dana pelanggan dengan API pengembalian dana dan pencabutan standar, seperti metode purchases.subscriptionsv2.revoke. Tindakan ini akan mengembalikan dana pembayaran terbaru dan mengakhiri akses pelanggan.

Menguji penawaran retensi

Google Play hanya menampilkan penawaran retensi aktif dalam alur pembatalan, dan mengevaluasi aturan kelayakan dalam waktu kalender yang sebenarnya. Untuk menguji penawaran retensi dengan akun penguji lisensi, gunakan salah satu metode berikut:

Sebelum menggunakan salah satu metode, buka Setelan > Pengujian lisensi di Konsol Google Play, lalu tambahkan Akun Google pengujian sebagai penguji lisensi.

Menguji penawaran retensi per pengguna

Google Play hanya menampilkan penawaran retensi per pengguna ke langganan yang Anda targetkan, sehingga Anda dapat mengujinya di paket dasar produksi tanpa mengeksposnya ke pelanggan sungguhan. Untuk menguji penawaran retensi per pengguna, lakukan hal berikut:

  1. Buat penawaran retensi per pengguna di paket dasar, lalu aktifkan. Di Konsol Google Play, pilih Penawaran retensi tingkat pengguna. Dengan Google Play Developer API, tetapkan targeting ke objek retentionPerUserRule. Untuk mengetahui detailnya, lihat Menargetkan penawaran retensi ke pelanggan tertentu.
  2. Jika Anda baru saja mengaktifkan penawaran, tunggu 10 hingga 15 menit agar perubahan diterapkan, lalu hapus cache aplikasi Google Play Store.
  3. Di perangkat pengujian, login dengan akun penguji lisensi, lalu beli paket dasar di aplikasi Anda.
  4. Dari backend, panggil metode purchases.subscriptionsv2.activateOfferTargeting dengan nama paket aplikasi, purchaseToken penguji lisensi, dan offerId penawaran retensi.
  5. Di aplikasi Google Play Store, buka Pembayaran & langganan > Langganan, pilih langganan, lalu ketuk Batalkan langganan. Penawaran retensi akan muncul dalam alur pembatalan.
  6. Setujui penawaran, lalu konfirmasi bahwa backend Anda menerima RTDN SUBSCRIPTION_PLAN_TRANSITION_UPDATED dan menangani perpanjangan dengan diskon.

Menguji penawaran retensi berbasis aturan

Setelah Anda mengaktifkan penawaran retensi berbasis aturan, Google Play dapat menampilkannya kepada pelanggan yang memenuhi syarat di paket dasar. Agar penawaran tidak terekspos ke pengguna produksi, uji penawaran di aplikasi pengujian non-produksi atau di paket dasar pengujian khusus yang tidak dapat diakses oleh pengguna produksi. Untuk menguji penawaran retensi berbasis aturan, lakukan hal berikut:

  1. Di aplikasi pengujian atau di paket dasar pengujian, buat penawaran retensi berbasis aturan, dan tetapkan minDuration ke P0D (0 hari). Di Konsol Google Play, pilih Penawaran retensi tingkat kelompok. Dengan Google Play Developer API, tetapkan targeting ke objek retentionRule. Untuk mengetahui detailnya, lihat Menetapkan aturan kelayakan retensi.
  2. Aktifkan penawaran, tunggu 10 hingga 15 menit hingga perubahan diterapkan, lalu hapus cache aplikasi Google Play Store.
  3. Di perangkat pengujian, login dengan akun penguji lisensi, lalu beli paket dasar pengujian.
  4. Di aplikasi Google Play Store, buka Pembayaran & langganan > Langganan, pilih langganan, lalu ketuk Batalkan langganan. Karena penawaran tidak memerlukan durasi langganan berbayar minimum, Anda dapat memulai alur pembatalan tepat setelah pembelian. Penawaran retensi akan muncul dalam alur pembatalan.
  5. Setujui penawaran, lalu konfirmasi bahwa backend Anda menerima RTDN SUBSCRIPTION_PLAN_TRANSITION_UPDATED dan menangani perpanjangan dengan diskon.

Setelah memverifikasi integrasi, buat dan aktifkan penawaran retensi berbasis aturan pada paket dasar produksi Anda.

Memecahkan masalah pengujian penawaran retensi

Jika penawaran retensi tidak muncul, periksa hal berikut:

  • Penawaran retensi aktif, dan waktu saat ini berada di antara startTime dan endTime, jika Anda menetapkannya.
  • Untuk penawaran retensi per pengguna, kolom developerTargetedOffers dalam respons purchases.subscriptionsv2.get untuk purchaseToken penguji lisensi menyertakan penawaran.
  • Langganan tersebut adalah langganan tunggal, bukan langganan dengan add-on.
  • Langganan tidak dalam masa tenggang, penangguhan akun, atau dijeda.
  • Langganan tidak memiliki perubahan paket atau perubahan harga yang tertunda.
  • Perpanjangan berikutnya akan dikenai harga paket dasar reguler. Untuk uji coba gratis dan penawaran harga perkenalan, penawaran retensi hanya tersedia selama periode penagihan akhir dari fase uji coba atau perkenalan.
  • Anda telah menunggu 10 hingga 15 menit setelah mengaktifkan atau mengubah penawaran, dan Anda telah menghapus cache aplikasi Google Play Store.