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:
- Membuat langganan dengan setidaknya satu paket dasar dengan perpanjangan otomatis. Penawaran retensi hanya dapat ditambahkan ke paket dasar dengan perpanjangan otomatis.
- Mengonfigurasi Notifikasi developer real-time (RTDN) dan menyiapkan
backend Anda untuk memanggil metode
purchases.subscriptionsv2.get. Backend Anda menggunakan ini untuk mendeteksi saat pelanggan menerima penawaran retensi.
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:
- Pelanggan membuka langganannya di Google Play dan mulai membatalkannya.
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.
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_CANCELEDseperti 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
planTransitionDetailske kolomautoRenewingPlandari item baris yang terpengaruh di resourceSubscriptionPurchaseV2.
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
planTransitionDetailsdalam statusIN_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:
- 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. - Persentase diskon: Di antara penawaran yang memenuhi syarat yang menggunakan mode penargetan yang sama, Google Play menampilkan penawaran dengan persentase diskon tertinggi yang ditampilkan.
- Harga diskon: Jika penawaran memiliki persentase diskon yang sama, Google Play akan menampilkan penawaran dengan harga diskon terendah.
- 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:
- Buka Monetisasi dengan Google Play > Produk > Langganan.
- Pilih langganan, lalu pilih paket dasar yang ingin Anda tambahi penawaran.
- Tambahkan penawaran untuk Pelanggan lama yang mencoba membatalkan langganan.
- 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: TetapkanretentionRuleke objekRetentionTargetingRuleyang menentukan siapa yang memenuhi syarat untuk penawaran. Untuk kolom yang tersedia, lihat Menetapkan aturan kelayakan retensi. Untuk memilih pelanggan yang memenuhi syarat dari backend, tetapkanretentionPerUserRule. 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. JikarecurrenceCountlebih besar dari 1, fasedurationharus sama dengan periode penagihan paket dasar.regionalConfigs[]: TetapkanrelativeDiscountke diskon sebagai pecahan yang lebih besar dari 0 dan kurang dari 1. Misalnya, gunakan0.5untuk diskon 50%. Penawaran retensi hanya mendukungrelativeDiscount. 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 daristartTime.
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 adalahthisSubscription, 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, dariP0DhinggaP1826D. Misalnya, gunakanP90Dselama 90 hari. Agar tidak memerlukan waktu langganan berbayar minimum, tetapkan kolom ini keP0D.allowMultipleClaims: Opsional. Apakah pelanggan dapat mengklaim penawaran lebih dari sekali. Jikafalse, pelanggan yang pernah mengklaim penawaran ini tidak akan pernah memenuhi syarat untuk penawaran ini lagi. Jikatrue, pelanggan dapat memenuhi syarat lagi setelah waktu diminOfferCooldownDurationberlalu sejak akhir periode diskon penawaran retensi sebelumnya. Nilai defaultnya adalahfalse.minOfferCooldownDuration: Wajib diisi jikaallowMultipleClaimsadalahtrue. Waktu minimum yang harus berlalu setelah periode diskon penawaran retensi sebelumnya berakhir sebelum pelanggan memenuhi syarat lagi, sebagai durasi ISO 8601 dalam hari, dariP1DhinggaP1826D. Misalnya, gunakanP180Dselama 180 hari. Jangan tetapkan kolom ini jikaallowMultipleClaimsadalahfalseatau 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:
Buat penawaran retensi per pengguna. Saat Anda memanggil metode
monetization.subscriptions.basePlans.offers.create,monetization.subscriptions.basePlans.offers.patch, ataumonetization.subscriptions.basePlans.offers.batchUpdate, tetapkantargetingke objekretentionPerUserRule, bukan objekretentionRule. ObjekRetentionPerUserTargetingRuletidak memiliki kolom. Penawaran dapat menggunakanretentionRuleatauretentionPerUserRule, tetapi tidak keduanya.{ "offerId": "retention-peruser-30off", "targeting": { "retentionPerUserRule": {} } }Aktifkan penawaran sebelum Anda menargetkannya kepada pelanggan. Jika Anda memanggil metode
activateOfferTargetinguntuk penawaran yang belum pernah diaktifkan, panggilan akan gagal dengan kode status HTTP400 Bad Requestdan status errorINVALID_ARGUMENT. Untuk mengetahui detailnya, lihat Menangani error penargetan. Meskipun penawaran aktif, Google Play hanya menampilkannya kepada pelanggan yang langganannya Anda targetkan di langkah berikutnya.Targetkan penawaran ke langganan. Panggil metode
purchases.subscriptionsv2.activateOfferTargetingdengan nama paket aplikasi Anda,purchaseTokenlangganan, danofferIdpenawaran 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 Contenttanpa 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 olehretentionRule. 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
activateOfferTargetingsatu 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
activateOfferTargetingbersifat idempoten. Jika Anda memanggilnya untuk penawaran yang sudah ditargetkan ke langganan, panggilan akan berhasil dan Google Play akan memperbaruiactivateTimepenawaran ke waktu permintaan terbaru.Hapus penargetan jika diperlukan. Jika Anda tidak ingin lagi pelanggan menerima penawaran, misalnya karena risiko churn mereka berubah, panggil metode
purchases.subscriptionsv2.deactivateOfferTargetingdengan nama paket,purchaseToken, danofferIdyang sama. Panggilan yang berhasil akan menampilkan kode status HTTP204 No Contenttanpa isi respons.Metode
deactivateOfferTargetingjuga 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 adalahIN_PROGRESSsaat 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.offerIdadalah ID penawaran retensi yang diterima.offerPhaseadalah{"introductoryPrice": {}}selama periode penagihan diskon. Setelah periode penagihan diskon berakhir dan langganan diperpanjang dengan harga paket dasar reguler,offerPhaseakan 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, danofferPhaseitem 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.defersaat transisi penawaran retensi berstatusIN_PROGRESS, transisi yang tertunda akan dipertahankan dan berlaku pada perpanjangan yang ditangguhkan. Untuk mendapatkan tanggal perpanjangan baru, periksaexpiryTimeitem baris. - Perubahan paket sebelum transisi: Penawaran retensi hanya berlaku untuk
purchaseTokenlangganan tempat pelanggan menerimanya. Jika pelanggan beralih ke paket dasar atau langganan lain sebelumexpectedTransitionTime, Google Play akan membuat token pembelian baru, membatalkan transisi terjadwal, dan menghapusplanTransitionDetails. 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
transitionStatetetapIN_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_PROGRESSmasih 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:
- Uji penawaran retensi pengguna pada paket dasar produksi, tanpa menampilkan penawaran kepada pelanggan sebenarnya.
- Uji penawaran retensi berbasis aturan di aplikasi pengujian atau di paket dasar pengujian yang tidak dapat diakses oleh pengguna produksi.
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:
- 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
targetingke objekretentionPerUserRule. Untuk mengetahui detailnya, lihat Menargetkan penawaran retensi ke pelanggan tertentu. - Jika Anda baru saja mengaktifkan penawaran, tunggu 10 hingga 15 menit agar perubahan diterapkan, lalu hapus cache aplikasi Google Play Store.
- Di perangkat pengujian, login dengan akun penguji lisensi, lalu beli paket dasar di aplikasi Anda.
- Dari backend, panggil metode
purchases.subscriptionsv2.activateOfferTargetingdengan nama paket aplikasi,purchaseTokenpenguji lisensi, danofferIdpenawaran retensi. - Di aplikasi Google Play Store, buka Pembayaran & langganan > Langganan, pilih langganan, lalu ketuk Batalkan langganan. Penawaran retensi akan muncul dalam alur pembatalan.
- Setujui penawaran, lalu konfirmasi bahwa backend Anda menerima
RTDN
SUBSCRIPTION_PLAN_TRANSITION_UPDATEDdan 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:
- Di aplikasi pengujian atau di paket dasar pengujian, buat penawaran retensi berbasis aturan, dan tetapkan
minDurationkeP0D(0 hari). Di Konsol Google Play, pilih Penawaran retensi tingkat kelompok. Dengan Google Play Developer API, tetapkantargetingke objekretentionRule. Untuk mengetahui detailnya, lihat Menetapkan aturan kelayakan retensi. - Aktifkan penawaran, tunggu 10 hingga 15 menit hingga perubahan diterapkan, lalu hapus cache aplikasi Google Play Store.
- Di perangkat pengujian, login dengan akun penguji lisensi, lalu beli paket dasar pengujian.
- 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.
- Setujui penawaran, lalu konfirmasi bahwa backend Anda menerima
RTDN
SUBSCRIPTION_PLAN_TRANSITION_UPDATEDdan 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
startTimedanendTime, jika Anda menetapkannya. - Untuk penawaran retensi per pengguna, kolom
developerTargetedOffersdalam responspurchases.subscriptionsv2.getuntukpurchaseTokenpenguji 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.