Elde tutma teklifleriyle aboneleri elde tutma

Elde tutma teklifleri, abonelere Google Play'de aboneliklerini iptal etmeye çalıştıkları anda indirim göstererek isteğe bağlı abonelik iptallerini azaltmanıza yardımcı olur.

Uygun bir abone iptal işlemine başladığında Google Play, yapılandırdığınız elde tutma teklifini gösterir. Örneğin, "Aboneliğinizi devam ettirin ve sonraki 2 ay için %50 indirim kazanın." Abone teklifi kabul ederse aboneliği iptal edilmez. İndirimli fiyat, bir sonraki fatura tarihinde geçerli olur.

Bu sayfada, elde tutma tekliflerinin işleyiş şekli, nasıl yapılandırılacağı, ortaya çıkan etkinliklerin arka ucunuzda nasıl işleneceği ve nasıl test edileceği açıklanmaktadır.

Başlamadan önce

Elde tutma teklifleri oluşturmadan önce aşağıdakileri yaptığınızdan emin olun:

Google Play, elde tutma fırsatlarını uygulamanızın dışında gösterdiğinden bunları kullanmak için uygulamanızı değiştirmeniz veya Google Play Faturalandırma Kitaplığı entegrasyonunuzu güncellemeniz gerekmez. Tüm entegrasyon çalışmaları Google Play Console'da ve arka ucunuzda gerçekleşir.

Elde tutma tekliflerinin işleyiş şekli

Elde tutma teklifleri yalnızca Google Play abonelik yönetiminde (Google Play Store uygulaması ve web'deki Google Play) görünür. Uygulamanızda görünmezler. Google Play Faturalandırma Kitaplığı, elde tutma tekliflerini queryProductDetailsAsync() sonuçlarında döndürmez. Bu nedenle, ProductDetails.getSubscriptionOfferDetails() listesine dahil edilmezler ve launchBillingFlow() üzerinden satılamazlar. Uygulamanız, aboneleri Google Play abonelik merkezine veya belirli bir aboneliğe yönlendirerek aboneliklerini yönetmelerini ya da iptal etmelerini sağlamak için derin bağlantılar kullanıyorsa bu aboneler, iptal işlemine başladıklarında elde tutma teklifinizi görebilirler.

Aşağıdaki adımlarda, bir abone iptal etmeye çalıştığında ne olacağı açıklanmaktadır:

  1. Abone, Google Play'de aboneliğini açar ve iptal etmeye başlar.
  2. Google Play, teklif için belirlediğiniz uygunluk kurallarına veya teklifi o aboneye hedefleyip hedeflemediğinize bağlı olarak abonenin elde tutma tekliflerinizden birine uygun olup olmadığını kontrol eder.

  3. Abone uygunsa Google Play, iptal işlemine alternatif olarak elde tutma teklifini gösterebilir. Google Play, bölgesel uygunluk şartları gibi platform düzeyinde ek kontroller de gerçekleştirdiğinden uygunluk ölçütlerinizi karşılamanız, fırsatın gösterileceğini garanti etmez. Google Play teklifi gösterirse abone aşağıdakilerden birini yapabilir:

    • Teklifi kabul etme: Abone, tek bir dokunuşla teklifi kabul eder. Abonelik etkin kalır ve otomatik olarak yenilenir. Aboneye hemen ödeme yansıtılmaz. İndirimli fiyat, bir sonraki fatura döneminden itibaren geçerli olur.
    • İptal işlemine devam etme: Abone, teklifi reddeder ve standart iptal akışını tamamlar. Her zamanki SUBSCRIPTION_CANCELED bildirimini alırsınız. Ayrıntılı bilgi için İptaller bölümünü inceleyin.

Abone, teklifi kabul etmeden veya iptal etmeden iptal akışından ayrılırsa aboneliği değişmez. Bu durum hem Google Play Store uygulaması hem de web'deki Google Play için geçerlidir. Elde tutma teklifini kabul etmeden görüntülemek, teklifin talep sınırına dahil edilmez veya teklifler arasındaki bekleme süresini başlatmaz. Google Play, teklifi gösterirken ve abone teklifi kabul ettiğinde talep sınırını kontrol eder. Kabul edilen bir teklif, abonelik indirimli fiyattan yenilendiğinde talep sınırına dahil edilir. Teklifler arasındaki bekleme süresi, aynı temel plandaki önceki elde tutma teklifinin indirimli dönemi sona erdiğinde başlar. Abone, hâlâ uygunsa bir sonraki iptal etme denemesinde teklifi tekrar görebilir.

Planlı geçiş

Bir abone, elde tutma teklifini kabul ettiğinde Google Play, bunu abonenin mevcut satın alma işleminde planlı bir plan geçişi olarak modeller. Bu, yeni bir satın alma süreci gerektiren ve yeni bir satın alma jetonu oluşturan ertelenmiş değişimden farklıdır. Elde tutma teklifiyle abone aynı purchaseToken aboneliğini kullanmaya devam eder ve yalnızca gelecekteki faturalandırma şartları değişir.

Abone teklifi kabul ettiğinde Google Play şunları yapar:

  • Arka ucunuza bir SUBSCRIPTION_PLAN_TRANSITION_UPDATED (21) RTDN gönderir.
  • SubscriptionPurchaseV2 kaynağında etkilenen satır öğesinin autoRenewingPlan alanına bir planTransitionDetails nesnesi ekler.

Bu etkinlikleri işleme hakkında ayrıntılı bilgi için Elde tutma teklifi etkinliklerini arka ucunuzda işleme başlıklı makaleyi inceleyin.

Uygunluk koşulları

Aşağıdaki koşulların tümü karşılandığı sürece, bir sonraki yenilemeden önce herhangi bir zamanda abonelik için elde tutma teklifi sunulabilir:

  • Abonelik etkin ve otomatik olarak yenileniyor. Ek süre içinde olan, hesabı askıya alınmış veya duraklatılmış abonelikler elde tutma teklifleri alamaz.
  • Abonelik tek bir aboneliktir. Elde tutma teklifleri, eklenti içeren aboneliklerde desteklenmez.
  • Abonelik, yükleme tabanı planı kullanmıyor. Yükleme tabanı planları, elde tutma teklifleri için uygun değildir.
  • Bir sonraki ödeme, normal yinelenen temel plan fiyatı üzerinden yapılır. Abone, ücretsiz deneme veya tanıtım fiyatı aşamasındaysa fırsat yalnızca bu aşamanın son fatura döneminde, yaklaşan yenileme normal fiyattan yapıldığında kullanılabilir.
  • Abone, daha önce kabul edilen bir elde tutma teklifinin indirimli fatura döneminde değildir. Elde tutma teklifinin indirimli aşamasında olan bir abone, abonelik normal temel plan fiyatından yenilenene kadar başka bir elde tutma teklifinden yararlanamaz.
  • Abonelikte bekleyen planlı geçiş yok. Bir aboneliğin en fazla bir tane bekleyen planlı geçişi olabilir. Bu geçiş, IN_PROGRESS durumundaki bir planTransitionDetails nesnesidir. Örneğin, henüz geçerli olmayan bir elde tutma teklifini kabul etmiş olan bir abone başka bir teklif alamaz.
  • Abonelikte onaylanmamış fiyat değişikliği yok.
  • Elde tutma teklifinin indirimli fiyatı, abonenin bir sonraki temel plan yenileme fiyatından düşük veya bu fiyata eşit olmalıdır.
  • Abone, teklif için yapılandırdığınız uygunluk kurallarını karşılıyorsa Kullanıcıları elde tutma teklifi için abonelik hedeflemeyi activateOfferTargeting yöntemiyle etkinleştirdiniz.

Elde tutma tekliflerini yapılandırma

Elde tutma fırsatlarını Google Play Console'da veya Google Play Developer API'yi kullanarak oluşturabilirsiniz. Her elde tutma teklifi, aşağıdaki hedefleme modlarından birini kullanır:

  • Kurala dayalı hedefleme: Google Play, belirlediğiniz uygunluk kurallarına (ör. minimum ücretli abonelik süresi) göre hangi abonelerin uygun olduğuna karar verir.
  • Kullanıcı bazında hedefleme: Arka ucunuz, belirli abonelikleri hedefleyerek teklifi hangi abonelerin görebileceğine karar verir.

Bir temel planda aynı ülke veya bölgede birden fazla etkin elde tutma fırsatı olabilir. Bir abone birden fazla teklif için uygun olduğunda Google Play, iptal sürecinde en fazla bir elde tutma teklifi gösterir. Google Play, teklifi aşağıdaki sırayla seçer:

  1. Hedefleme modu: Kullanıcı bazında hedeflenen bir teklif (retentionPerUserRule), kural tabanlı teklif daha yüksek bir indirim yüzdesine sahip olsa bile her zaman kural tabanlı bir teklife (retentionRule) göre önceliklidir.
  2. İndirim yüzdesi: Google Play, aynı hedefleme modunu kullanan uygun fırsatlar arasında en yüksek indirim yüzdesine sahip fırsatı gösterir.
  3. İndirimli fiyat: Fırsatların indirim yüzdesi aynıysa Google Play, en düşük indirimli fiyata sahip fırsatı gösterir.
  4. Teklif numarası: Teklifler hâlâ eşitse Google Play, offerId değeri alfabetik sıralamada en sonda olan teklifi gösterir.

Google Play Console'da elde tutma fırsatı oluşturma

Google Play Console'da elde tutma fırsatı oluşturmak için aşağıdakileri yapın:

  1. Google Play ile para kazanın > Ürünler > Abonelikler'e gidin.
  2. Bir abonelik seçin ve ardından teklifi eklemek istediğiniz temel planı seçin.
  3. Aboneliğini iptal etmeye çalışan mevcut aboneler için bir fırsat ekleyin.
  4. Grup düzeyinde elde tutma teklifi veya Kullanıcı düzeyinde elde tutma teklifi'ni seçin.

Play Developer API ile elde tutma fırsatı oluşturma

Elde tutma tekliflerini programatik olarak da oluşturup güncelleyebilirsiniz. Teklif oluşturmak için monetization.subscriptions.basePlans.offers.create yöntemini çağırın. Mevcut teklifleri güncellemek için monetization.subscriptions.basePlans.offers.patch veya monetization.subscriptions.basePlans.offers.batchUpdate yöntemini çağırın. Üç yöntem de retentionRule, retentionPerUserRule, startTime ve endTime alanlarını destekler. SubscriptionOffer nesnesinde aşağıdaki alanları ayarlayın:

  • offerId: Benzersiz elde tutma teklifi kimliğiniz.
  • targeting: retentionRule değerini, tekliften kimlerin yararlanabileceğini tanımlayan bir RetentionTargetingRule nesnesi olarak ayarlayın. Kullanılabilir alanlar için Saklama uygunluk kuralları belirleme başlıklı makaleyi inceleyin. Uygun aboneleri arka ucunuzdan seçmek için retentionPerUserRule değerini ayarlayın. Ayrıntılı bilgi için Elde tutma teklifleriyle belirli aboneleri hedefleme başlıklı makaleyi inceleyin.
  • phases[]: Elde tutma teklifleri yalnızca tek bir fiyatlandırma aşamasını destekler. Bu aşamada aşağıdaki alanları ayarlayın:
    • recurrenceCount: İndirimin geçerli olduğu fatura dönemi sayısı (1 ile 52 arasında). recurrenceCount 1'den büyükse duration aşaması, temel planın fatura dönemine eşit olmalıdır.
    • regionalConfigs[]: relativeDiscount değerini, 0'dan büyük ve 1'den küçük bir kesir olarak indirim tutarına ayarlayın. Örneğin, %50 indirim için 0.5 kullanın. Elde tutma fırsatları yalnızca relativeDiscount destekler. Sabit fiyatlı (price), net indirim tutarı (absoluteDiscount) ve ücretsiz (free) aşamalar desteklenmez.
  • startTime: İsteğe bağlı. Elde tutma teklifinin uygun abonelere sunulduğu zaman (RFC 3339 zaman damgası olarak). Bu alanın ayarlanması, teklifi etkinleştirmez. Bu alanı ayarlamazsanız teklif, durumuna göre kullanılabilir hale gelir.
  • endTime: İsteğe bağlı. Teklifin durumundan bağımsız olarak, elde tutma teklifinin kullanılabilirliğinin sona erdiği zaman (RFC 3339 zaman damgası olarak). Bu alanı ayarlamazsanız teklifin bitiş tarihi olmaz. Bu alanı ayarlarsanız gelecekteki bir tarih ve startTime tarihinden sonraki bir zaman olmalıdır.

monetization.subscriptions.basePlans.offers.create yöntemi, startTime değerini ayarlasanız bile teklifi her zaman DRAFT durumunda oluşturur. Teklifi etkinleştirmek için monetization.subscriptions.basePlans.offers.activate yöntemini çağırın.

Elde tutma uygunluk kurallarını ayarlama

RetentionTargetingRule nesnesi aşağıdaki alanları içerir:

  • scope: Zorunlu. Kuralın dikkate aldığı abonelikler. Elde tutma teklifleri için desteklenen tek değer, teklifin tanımlandığı abonelik olan thisSubscription değeridir. Bu alanı {"thisSubscription": {}} olarak ayarlayın.
  • minDuration: Zorunlu. Kullanıcının uygun olması için ücretli abone olması gereken minimum süre. P0D ile P1826D arasında, gün cinsinden ISO 8601 süresi olarak belirtilir. Örneğin, 90 gün için P90D kullanın. Minimum ücretli abonelik süresi şartı koymamak için bu alanı P0D olarak ayarlayın.
  • allowMultipleClaims: İsteğe bağlı. Abonenin teklifi birden fazla kez kullanıp kullanamayacağı. false ise bu teklifi daha önce kullanmış olan aboneler tekliften tekrar yararlanamaz. true ise abone, önceki elde tutma teklifinin indirimli döneminin sona ermesinden sonra minOfferCooldownDuration süresi geçtiğinde tekrar uygun olabilir. Varsayılan değer false'dir.
  • minOfferCooldownDuration: allowMultipleClaims, true ise zorunludur. Abone tekrar uygun olmadan önce, önceki elde tutma teklifinin indirimli dönemi sona erdikten sonra geçmesi gereken minimum süre. ISO 8601 biçiminde gün cinsinden süre olarak P1D ile P1826D arasında. Örneğin, 180 gün için P180D kullanın. allowMultipleClaims, false ise veya ayarlanmamışsa bu alanı ayarlamayın.

Aşağıdaki örnekte, en az 90 gün boyunca ödeme yapmış olan abonelere sunulan ve önceki elde tutma indirimlerinin sona ermesinden 180 gün sonra tekrar talep edebilecekleri bir elde tutma teklifi için SubscriptionOffer nesnesinin startTime, endTime ve targeting alanları gösterilmektedir:

{
  "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"
    }
  }
}

Elde tutma teklifleriyle belirli aboneleri hedefleme

Google Play'in uygunluğu RetentionTargetingRule ile belirlemesine izin vermek yerine, elde tutma teklifini yalnızca arka ucunuzun seçtiği abonelere sunabilirsiniz. Örneğin, teklifi, aboneliği iptal etme tahmini modelinizin riskli olarak işaretlediği abonelere veya uygulamanızda iptal sürecini başlatan abonelere sunabilirsiniz.

Aboneler, kullanıcı başına kullanıcıları elde tutma teklifini diğer elde tutma teklifleriyle aynı Google Play iptal akışında görür ve kabul işlemini aynı şekilde gerçekleştirirsiniz. Ayrıntılar için Arka ucunuzda elde tutma teklifi etkinliklerini işleme başlıklı makaleyi inceleyin.

Elde tutma tekliflerini belirli abonelere hedeflemek için aşağıdakileri yapın:

  1. Kullanıcı başına kullanıcıları elde tutma teklifi oluşturun. monetization.subscriptions.basePlans.offers.create, monetization.subscriptions.basePlans.offers.patch veya monetization.subscriptions.basePlans.offers.batchUpdate yöntemini çağırdığınızda targeting değerini bir retentionRule nesnesi yerine retentionPerUserRule nesnesi olarak ayarlayın. RetentionPerUserTargetingRule nesnesinde alan yok. Tekliflerde retentionRule veya retentionPerUserRule kullanılabilir ancak ikisi birden kullanılamaz.

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

    Teklifi abonelere hedeflemeden önce etkinleştirin. Hiç etkinleştirilmemiş bir teklif için activateOfferTargeting yöntemini çağırırsanız çağrı, HTTP 400 Bad Request durum kodu ve INVALID_ARGUMENT hata durumuyla başarısız olur. Ayrıntılı bilgi için Hedefleme hatalarını ele alma başlıklı makaleyi inceleyin. Fırsat etkin olsa bile Google Play, fırsatı yalnızca bir sonraki adımda aboneliklerini hedeflediğiniz abonelere gösterir.

  2. Teklifi bir aboneliğe hedefleyin. Uygulamanızın paket adı, aboneliğin purchaseToken değeri ve kullanıcıyı elde tutma fırsatının offerId değeri ile purchases.subscriptionsv2.activateOfferTargeting yöntemini çağırın:

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

    Başarılı bir çağrı, yanıt gövdesi olmadan HTTP 204 No Content durum kodu döndürür. Google Play Store, hedeflemeyi abonelikle birlikte sakladığından abone iptal ettiğinde API'yi çağırmanız gerekmez. Abone, Google Play'de bir sonraki iptal işlemine başladığında abonelik uygunluk koşullarını karşılıyorsa Google Play teklifi gösterebilir. Kullanıcı bazlı hedefleme, yalnızca retentionRule tarafından tanımlanan uygunluk kurallarını değiştirir. Bölgesel uygunluk koşulları gibi diğer tüm uygunluk koşulları ve Google Play'in gerçekleştirdiği platform düzeyindeki kontroller geçerli olmaya devam eder.

    Aynı abonelik için kullanıcı başına birden fazla kullanıcıları elde tutma teklifi hedefleyebilirsiniz. Bunun için her teklif için activateOfferTargeting yöntemini bir kez çağırın. Google Play, iptal akışında en fazla bir elde tutma teklifi göstermeye devam eder. Google Play'in teklifi nasıl seçtiğiyle ilgili ayrıntılar için Elde tutma tekliflerini yapılandırma başlıklı makaleyi inceleyin.

    activateOfferTargeting yöntemi, eş kuvvetlidir. Aboneliği hedefleyen bir teklif için bu yöntemi çağırırsanız çağrı başarılı olur ve Google Play, teklifin activateTime değerini en son isteğin zamanına günceller.

  3. Gerektiğinde hedeflemeyi kaldırın. Bir abonenin teklifi almasını artık istemiyorsanız (ör. aboneliği iptal etme riski değiştiği için) aynı paket adı, purchaseToken ve offerId ile purchases.subscriptionsv2.deactivateOfferTargeting yöntemini çağırın. Başarılı bir çağrı, yanıt gövdesi olmadan HTTP 204 No Content durum kodu döndürür.

    deactivateOfferTargeting yöntemi de eş güçlüdür. Teklif, aboneliğe hedeflenmemişse (ör. hedeflemeyi hiç etkinleştirmediğiniz için) çağrı başarılı olur ve herhangi bir etkisi olmaz.

Hedefleme tek bir purchaseToken için geçerlidir ve abonelik etkin olduğu ve otomatik yenilendiği sürece geçerliliğini korur. Abone teklifi gördükten, kabul ettikten veya reddettikten sonra da yerinde kalır. Google Play, bu jetonu yalnızca deactivateOfferTargeting yöntemini çağırdığınızda veya abonelik süresi dolduktan 60 gün sonra kaldırır. Plan değişikliği veya yeniden abone olma işlemi yeni bir purchaseToken oluşturursa hedefleme aktarılmaz.

Bir aboneliği hedefleyen kullanıcıları elde tutma tekliflerini kontrol etmek için purchases.subscriptionsv2.get yöntemini çağırın. Her satır öğesinin developerTargetedOffers alanında hedeflenen teklifler listelenir. Her giriş, hedeflemeyi etkinleştirdiğiniz offerId ve activateTime değerlerini içerir:

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

Hedefleme hatalarını giderme

activateOfferTargeting veya deactivateOfferTargeting yöntemine yapılan bir çağrı başarısız olduğunda yanıt, bir HTTP durum kodu ve nedeni açıklayan bir hata durumu içerir. Aşağıdaki tabloda, bu yöntemlerin döndürebileceği HTTP durum kodları ve hata durumları listelenmiştir:

HTTP durum kodu Hata durumu Yöntemler Neden
404 Not Found NOT_FOUND Her ikisi de purchaseToken mevcut değil.
400 Bad Request INVALID_ARGUMENT activateOfferTargeting offerId, aboneliğin mevcut temel planında yok veya teklif hâlâ taslak durumunda ve hiç etkinleştirilmemiş.
400 Bad Request FAILED_PRECONDITION activateOfferTargeting Teklifin targeting değeri retentionPerUserRule olarak ayarlanmamış.
400 Bad Request FAILED_PRECONDITION activateOfferTargeting Aboneliğin süresi doldu.

activateOfferTargeting yöntemi, süresi dolmamış bir aboneliğin teklif için uygun olup olmadığını kontrol etmez. Örneğin, abonelik iptal edilmiş ancak henüz süresi dolmamışsa çağrı başarılı olur ve Google Play Store hedeflemeyi depolar. Google Play, abone iptal akışına girdiğinde aboneliğin uygunluğunu değerlendirir.

Arka ucunuzda elde tutma teklifi etkinliklerini işleme

Bir abone, elde tutma teklifini kabul ettiğinde ve daha sonra indirimli yenileme gerçekleştiğinde Google Play, arka ucunuza RTDN'ler gönderir. Her bildirimi aldıktan sonra, en son abonelik durumunu almak için bildirimdeki purchaseToken ile purchases.subscriptionsv2.get yöntemini çağırın.

Elde tutma teklifinin kabul edilmesi yeni bir satın alma işlemi oluşturmaz. purchaseToken aynı kalır. Bu nedenle, satın alma işlemini tekrar onaylamanız gerekmez ve Google Play, linkedPurchaseToken oluşturmaz. Abone, mevcut hakkını kullanmaya devam eder. İndirimli yenileme siparişini diğer abonelik yenilemeleriyle aynı şekilde işleyin.

Bildirim türü Veriler ne zaman gönderilir? Yapılması gerekenler
SUBSCRIPTION_PLAN_TRANSITION_UPDATED (21) Abonenin iptal sürecinde elde tutma teklifini kabul etmesi. purchases.subscriptionsv2.get yöntemini çağırın ve planTransitionDetails değerini kontrol edin. transitionState, IN_PROGRESS. Abonelik etkin kalmaya ve otomatik olarak yenilenmeye devam eder. Bu nedenle erişim izni vermeye devam edin.
SUBSCRIPTION_RENEWED (2) Mevcut fatura dönemi sona erdiğinde ve abonelik, indirimli elde tutma teklifi fiyatı üzerinden yenilendiğinde. purchases.subscriptionsv2.get yöntemini çağırın, offerDetails.offerId değerinin elde tutma teklifi kimliği olduğunu ve planTransitionDetails değerinin artık mevcut olmadığını onaylayın ve abonenin yeni expiryTime değerine erişimini uzatın.

planTransitionDetails nesnesi aşağıdaki alanları içerir:

  • productId: Aboneliğin geçiş yaptığı planın ürün kimliği. Elde tutma teklifinde bu, aynı üründür.
  • basePlanId: Aboneliğin geçiş yaptığı planın temel plan kimliği.
  • offerId: Abonenin kabul ettiği elde tutma teklifinin kimliği. Hangi elde tutma teklifinin kullanıldığını belirlemek için bu alanı kullanın.
  • transitionInfo.transitionState: Geçişin durumu. Elde tutma tekliflerinde, geçiş beklemedeyken durum IN_PROGRESS olur.
  • transitionInfo.expectedTransitionTime: Elde tutma teklifi şartlarının geçerli olmaya başlayacağı tarih.

Google Play, planTransitionDetails değerini yalnızca geçiş beklemedeyken ekler. Abonelik, indirimli elde tutma teklifi fiyatı üzerinden yenilendiğinde geçiş tamamlanır ve Google Play, purchases.subscriptionsv2.get yanıtından planTransitionDetails değerini kaldırır. Bu noktadan sonra satır öğesinin kendisi, etkin müşteri tutma indirimini gösterir:

  • offerDetails.offerId, kabul edilen elde tutma teklifinin kimliğidir.
  • İndirimli fatura dönemlerinde offerPhase, {"introductoryPrice": {}} olur. İndirimli fatura dönemleri sona erdikten ve abonelik normal temel plan fiyatı üzerinden yenilendikten sonra offerPhase, {"basePrice": {}} olarak değişir.

Abone teklifi kabul ettikten sonraki yanıt

Abone, elde tutma teklifini kabul ettikten sonra mevcut fatura dönemi değişmeden devam eder. planTransitionDetails nesnesi, IN_PROGRESS değerinde bir transitionState ile planlanan geçişi gösterir:

{
  "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"
          }
        }
      }
    }
  ]
}

İndirimli yenilemeden sonraki yanıt

Yenileme tarihi geçtikten ve aboneden indirimli fiyat alındıktan sonra offerDetails.offerId, elde tutma teklifini gösterir, offerPhase, introductoryPrice değerini gösterir ve yanıtta artık planTransitionDetails yer almaz:

{
  "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
        }
      }
    }
  ]
}

Yaşam döngüsü etkileşimleri

Elde tutma tekliflerini yönetirken aşağıdaki davranışları göz önünde bulundurun:

  • İndirimin sona ermesi: İndirimli fatura dönemleri sona erdikten sonra abonelik, normal temel plan fiyatı üzerinden otomatik olarak yenilenir. Diğer yenilemelerde olduğu gibi SUBSCRIPTION_RENEWED bildirimi alırsınız ve satır öğesinin offerPhase değeri {"basePrice": {}} olarak değişir. Abone herhangi bir işlem yapmaz.
  • İndirimden sonra ödeme kurtarma: İndirim sona erdikten sonra normal temel plan fiyatı üzerinden yenileme reddedilirse ve abonelik ek süreye veya hesabın askıya alınması durumuna girerse ödeme kurtarma, normal temel plan fiyatını ücretlendirir. Google Play, tamamlanan elde tutma teklifi indirimini uygulamaz. İlk indirimli yenileme ödemesi reddedilirse bekleyen geçiş korunur ve ödeme yapıldığında elde tutma teklifi fiyatı uygulanır.
  • Ertelenmiş faturalandırma: Elde tutma teklifi geçişi IN_PROGRESS durumundayken purchases.subscriptionsv2.defer yöntemini çağırırsanız bekleyen geçiş korunur ve ertelenen yenileme sırasında uygulanır. Yeni yenileme tarihini öğrenmek için satır öğesinin expiryTime bölümüne bakın.
  • Geçişten önce plan değişikliği: Elde tutma teklifi, yalnızca abonenin kabul ettiği aboneliğin purchaseToken için geçerlidir. Abone, expectedTransitionTime tarihinden önce farklı bir temel plana veya aboneliğe geçerse Google Play yeni bir satın alma jetonu oluşturur, planlanan geçişi iptal eder ve planTransitionDetails değerini temizler. Beklemedeki elde tutma teklifi yeni plan için geçerli değildir.
  • İptal ve geri yükleme: Bir abone, elde tutma teklifini kabul ettikten sonra aboneliği iptal ederse planlanan geçiş beklemede kalır ve transitionState IN_PROGRESS olarak kalır. Abone, aboneliği süresi dolmadan önce geri yüklerse elde tutma teklifi indirimi yenileme sırasında geçerli olmaya devam eder.
  • Süre sonu ve yeniden abone olma: Abonelik yenilenmeden sona ererse Google Play bekleyen geçişi iptal eder. Kullanıcı daha sonra yeniden abone olur veya kaydolursa Google Play yeni bir abonelik satın alma işlemi oluşturur ve daha önce kabul edilen elde tutma teklifi geçerli olmaz.
  • Teklif değişiklikleri: Bir elde tutma teklifinin indirim veya fatura dönemlerini değiştirirseniz değişiklik yalnızca gelecekteki kullanımlara uygulanır. Teklifi daha önce kabul etmiş olan aboneler için orijinal şartlar geçerli olmaya devam eder.
  • Teklifi devre dışı bırakma: Bir elde tutma teklifini devre dışı bırakırsanız veya teklifin bitiş tarihi gelirse teklifi kabul etmiş olan aboneler, kabul ettikleri şartları kullanmaya devam eder. IN_PROGRESS geçişi olan aboneler, bir sonraki yenilemelerinde indirimi almaya devam eder. İndirimli fatura dönemlerinde olan aboneler ise indirimi, üzerinde anlaşmaya varılan süre boyunca kullanır.
  • Fiyat değişiklikleri: Temel plan fiyat değişiklikleri geçerli olmaya devam eder. Google Play, bir aboneyi yalnızca normal fiyatı ödüyorsa ve bekleyen bir elde tutma teklifi geçişi yoksa yeni fiyata geçirir. Daha fazla bilgi için Abonelik fiyatlarını değiştirme başlıklı makaleyi inceleyin.
  • Geri ödemeler: purchases.subscriptionsv2.revoke yöntemi gibi standart geri ödeme ve iptal API'lerini kullanarak abonelere geri ödeme yapabilirsiniz. Bu işlem, en son ödemeyi geri öder ve abonenin erişimini sonlandırır.

Elde tutma tekliflerini test etme

Google Play, iptal akışında yalnızca etkin elde tutma fırsatlarını gösterir ve uygunluk kurallarını gerçek takvim zamanında değerlendirir. Elde tutma tekliflerini lisans test kullanıcısı hesabıyla test etmek için aşağıdaki yöntemlerden birini kullanın:

Bu yöntemlerden birini kullanmadan önce Google Play Console'da Ayarlar > Lisans testi'ne gidin ve test Google Hesabı'nı lisans test kullanıcısı olarak ekleyin.

Kullanıcı düzeyinde kullanıcıları elde tutma teklifini test etme

Google Play, kullanıcıları elde tutma fırsatını yalnızca hedeflediğiniz aboneliklere gösterir. Böylece, gerçek abonelere göstermeden canlı sürüm temel planında test edebilirsiniz. Kullanıcı başına kullanıcıları elde tutma teklifini test etmek için aşağıdakileri yapın:

  1. Temel plan kapsamında kullanıcıları elde tutma teklifi oluşturun ve ardından bu teklifi etkinleştirin. Google Play Console'da Kullanıcı düzeyinde elde tutma fırsatı'nı seçin. Google Play Developer API ile targeting değerini bir retentionPerUserRule nesnesi olarak ayarlayın. Ayrıntılı bilgi için Elde tutma teklifleriyle belirli aboneleri hedefleme başlıklı makaleyi inceleyin.
  2. Teklifi yeni etkinleştirdiyseniz değişikliğin uygulanması için 10-15 dakika bekleyin ve ardından Google Play Store uygulama önbelleğini temizleyin.
  3. Test cihazında lisans test kullanıcısı hesabıyla oturum açın ve ardından uygulamanızda temel planı satın alın.
  4. Arka ucunuzdan, uygulamanızın paket adı, lisans test kullanıcısının purchaseToken ve elde tutma teklifinin offerId ile purchases.subscriptionsv2.activateOfferTargeting yöntemini çağırın.
  5. Google Play Store uygulamasında Ödemeler ve abonelikler > Abonelikler'e gidin, aboneliği seçin ve Aboneliği iptal et'e dokunun. Elde tutma teklifi, iptal akışında gösterilir.
  6. Teklifi kabul edin ve ardından arka ucunuzun SUBSCRIPTION_PLAN_TRANSITION_UPDATED RTDN'yi aldığını ve indirimli yenilemeyi işlediğini onaylayın.

Kurala dayalı elde tutma teklifini test etme

Kurala dayalı elde tutma teklifini etkinleştirdikten sonra Google Play, bu teklifi temel plandaki uygun abonelere gösterebilir. Teklifin üretim kullanıcılarına gösterilmesini önlemek için teklifi üretim dışı bir test uygulamasında veya üretim kullanıcılarının erişemeyeceği özel bir test temel planında test edin. Kurala dayalı elde tutma teklifini test etmek için aşağıdaki adımları uygulayın:

  1. Test uygulamanızda veya test temel planınızda kurala dayalı elde tutma fırsatı oluşturun ve minDuration değerini P0D (0 gün) olarak ayarlayın. Google Play Console'da Kohort düzeyinde elde tutma fırsatı'nı seçin. Google Play Developer API ile targeting değerini retentionRule nesnesi olarak ayarlayın. Ayrıntılı bilgi için Saklama uygunluk kuralları belirleme başlıklı makaleyi inceleyin.
  2. Teklifi etkinleştirin, değişikliğin uygulanması için 10-15 dakika bekleyin ve ardından Google Play Store uygulama önbelleğini temizleyin.
  3. Test cihazında lisans test kullanıcısı hesabıyla oturum açın ve ardından test temel planını satın alın.
  4. Google Play Store uygulamasında Ödemeler ve abonelikler > Abonelikler'e gidin, aboneliği seçin ve Aboneliği iptal et'e dokunun. Teklif için minimum ücretli abonelik süresi gerekmediğinden satın alma işleminden hemen sonra iptal sürecini başlatabilirsiniz. Elde tutma teklifi, iptal akışında gösterilir.
  5. Teklifi kabul edin ve ardından arka ucunuzun SUBSCRIPTION_PLAN_TRANSITION_UPDATED RTDN'yi aldığını ve indirimli yenilemeyi işlediğini onaylayın.

Entegrasyonu doğruladıktan sonra, üretim temel planınızda kural tabanlı elde tutma fırsatını oluşturup etkinleştirin.

Elde tutma teklifi testiyle ilgili sorunları giderme

Elde tutma teklifi görünmüyorsa aşağıdakileri kontrol edin:

  • Elde tutma teklifi etkin ve geçerli saat, ayarladıysanız startTime ile endTime arasında.
  • Kullanıcı düzeyinde kullanıcıları elde tutma teklifleri için lisans test kullanıcısının purchaseToken öğesine yönelik purchases.subscriptionsv2.get yanıtındaki developerTargetedOffers alanı teklifi içerir.
  • Abonelik, eklenti içeren bir abonelik değil, tek bir aboneliktir.
  • Abonelik ek süre, hesabın askıya alınması veya duraklatma durumunda olmamalıdır.
  • Abonelikte bekleyen bir plan değişikliği veya fiyat değişikliği yoktur.
  • Bir sonraki yenileme, normal temel plan fiyatı üzerinden yapılır. Ücretsiz denemeler ve tanıtım teklifleri için elde tutma teklifi yalnızca deneme veya tanıtım aşamasının son fatura döneminde kullanılabilir.
  • Teklifi etkinleştirdikten veya değiştirdikten sonra 10-15 dakika beklediniz ve Google Play Store uygulama önbelleğini temizlediniz.