Retention Messaging API: iptal öncesi abonelik mesajı

Retention Messaging API, Apple'ın sunucudan sunucuya çalışan bir hizmeti. Bir abone Cancel Subscription'a dokunduğu anda ona senin mesajını gösteriyor. Mesaj, iptal onaylanmadan önce bir onay sayfasında çıkıyor. Aboneliğinin değerini hatırlatabilir, başka bir plan ya da promosyon teklifi önerebilir, ama iptal butonu her zaman orada kalır. API Temmuz 2025'ten beri önizleme aşamasında, erişim talep üzerine veriliyor. Apple ayrıca 2026 sonbaharı için App Store Connect içinde daha basit bir sürüm duyurdu.

Bu rehber API'nin neyi gösterdiğini, ne zamandan beri var olduğunu, kimlerin kullanabileceğini, koşullarını ve kurulumunu anlatıyor. Her şey Apple'ın dokümantasyonundan ve bu konuya ayrılmış WWDC26 oturumundan geliyor. Hepsini 3 Kasım 2026'da tekrar okudum.

iOS uygulamalarımda abonelik satıyorum: sosyal medya engelleyici Solys, trading simülatörü TradaZen, yapay zekayla kıyafet deneme uygulaması Nolera ve Vigie. 25 Ekim 2026'da dördü için de API erişimi istedim ve mesajlarını tüm dillerde hazırladım. 28 Ekim itibarıyla Apple'ın onayı henüz gelmemişti. Yani bu rehber kuralı ve benim hazırlığımı anlatıyor, henüz sonuçları değil.

Retention Messaging API ne yapar

Apple'ın dokümantasyonuna göre API, bir müşteri aboneliğin detay sayfasına baktığında ve belki iptal etmek üzereyken sistemin göstereceği mesajı seçmene izin veriyor. Mesajlarını önceden, her ürün ve her dil için hazırlıyorsun.

Akış hep aynı:

1. Abone aboneliğini açar, örneğin Apple Account, Subscriptions yolundan ya da App Store'dan.
2. Cancel Subscription'a dokunur.
3. Sistem, senin mesajını içeren bir onay sayfası (Confirm Cancellation) gösterir.
4. Yine de iptal edebilir, aboneliğini koruyabilir ya da mesajının önerdiğini kabul edebilir.

Mesaj iOS 15.1 ve iPadOS 15.1 ya da daha yenisinde, visionOS 1'de ve macOS 14 ya da daha yenisinde görünür.

Ne zamandan beri ve kimin için

Tarih	Apple'a göre neler değişti
16 Tem. 2025	Sürüm 1.0: API'nin ilk önizlemesi
9 Ara. 2025	Gerçek zamanlı kullanım için sunucu performans testi
31 Mart 2026	Mesajlarda madde işaretleri, gerçek zamanlı adresin API ile ayarı
27 Nis. 2026	12 ay taahhütlü aylık abonelik desteği
Haziran 2026	WWDC26: App Store Connect içinde bir modül duyurusu

Tarihler API sürüm günlüğünden geliyor, sonuncusu hariç: o WWDC26 oturumundan. API hâlâ önizleme aşamasında. Dokümantasyon seni bir erişim talep formuna yönlendiriyor, bunun için geliştirici hesabınla giriş yapman gerekiyor.

WWDC26'da Explore Retention Messaging in App Store Connect oturumu, App Store Connect içinde kod yazmadan ayarlanabilen bir modül tanıttı. Apple bunu "herkese açık" diye niteliyor. Gerçek zamanlı sürüm ise talep üzerine kalıyor. App Store yenilikler sayfası modülü "bu sonbahar" için duyuruyor. 3 Kasım 2026 itibarıyla App Store Connect yardımında ona ayrılmış bir sayfa hâlâ yok, 28 Ekim'de de modül hesabımda görünmüyordu.

API, otomatik yenilenen abonelik satan uygulamaları ilgilendiriyor. Sadece büyük yayıncılara özel değil: RevenueCat, 22 milyon mesaj üzerine yaptığı çalışmada küçük uygulamaların da erişim isteyebileceğini belirtiyor.

4 mesaj türü

Tür	Abonenin gördüğü	Varsayılan mesaj	Gerçek zamanlı
Metin	Bir başlık, bir metin, en fazla beş madde işareti	Evet	Evet
Görselli metin	Aynısı, bir görselle birlikte	Evet	Evet
Plan değişikliği	Bir metin ve aynı gruptan başka bir abonelik	Hayır	Evet
Promosyon teklifi	Bir metin ve indirimli fiyatla devam etme teklifi	Hayır	Evet

Mesajların hazırlanması sayfasına göre varsayılan mesaj yalnızca görselli ya da görselsiz bir metin olabilir. API ile bir teklif ya da başka bir plan önermek, gerçek zamanlı yanıt vermeyi gerektiriyor. App Store Connect'te duyurulan modül ise sunucu olmadan teklifli bir mesaj sunacak.

Promosyon teklifi, App Store Connect'te oluşturduğun tekliftir. Promosyon teklifleri yardım sayfasına göre mevcut ve eski aboneleri hedefler. Mesajların hazırlanması sayfasına göre, bir elde tutma mesajında onu imzalayan senin sunucundur. Plan değişikliği aynı gruptan bir abonelik önerir. Bu tekliflere yeniysen önce teklif kodları ve promosyon teklifleri rehberimi oku.

Neler gösterebilirsin: kesin sınırlar

Öğe	Apple'ın sınırı
Başlık	En fazla 66 karakter
Metin	En fazla 144 karakter
Madde işaretleri	En fazla 5
Tam genişlik görsel	Şeffaflıksız PNG, 3.840 px genişlik, 160-2.160 px yükseklik
Madde işareti görseli	1.024 × 1.024 px
Uygulama başına görsel	En fazla 2.000

Uzunluklar mesaj gönderme isteğinin gövdesi açıklamasından, formatlar ise görsel gönderme sayfasından geliyor. Apple ayrıca hem açık hem koyu modda iyi görünen görseller istiyor.

Her mesaj ve her görsel Apple tarafından inceleniyor. Durumları PENDING'den APPROVED'a geçiyor ve sistem yalnızca onaylananları gösteriyor. Sandbox'ta onay otomatik. Dokümantasyon net bir içerik kuralı koyuyor: yanıltıcı ya da yanlış hiçbir şey gönderme.

Karşılaman gereken koşullar

• Her ürün için, her dilde bir varsayılan mesaj. O olmadan o dilde hiçbir şey görünmez. Sunucun yanıt vermezse yedek de odur.
• Onaylanmış mesajlar ve görseller, yayına almadan önce.
• Gerçek zamanlı için hızlı bir sunucu. Gerçek zamanlı adresin kurulumu sayfası geçerli bir SSL sertifikası, TLS 1.2 ve production'da 700 ms'nin altında yanıt istiyor. Bunu aşarsa istek başarısız olur ve varsayılan mesaj gösterilir.
• Sandbox'ta başarılı bir performans testi, production adresini bildirmeden önce.
• Uygulama doğrulaması. Apple'ın her isteği uygulamanın kimliğini, appAppleId'yi içerir. Seninkiyle eşleşmiyorsa Apple yanıt vermemeni istiyor.

Gerçek zamanlı istek sana orijinal işlemin kimliğini, ürünü ve cihazın dilini verir. Mesajı kendi kurallarına göre seçmek sana kalmış.

Retention Messaging'i kurmak: üç yol

Yol	Kimin için	Ne gerekiyor
App Store Connect modülü	Herkes, çıktığında	Kod yok; metin, görsel ya da teklif
API, kendi sunucunla	Back-end'i olanlar	Apple erişimi, HTTPS adresi, performans testi
API, RevenueCat ile	Zaten RevenueCat kullanan uygulamalar	Apple erişimi, panelde ayarlar

Birden fazla ayar bir arada olduğunda Apple, WWDC26 oturumunda izlenen sırayı açıklıyor: önce gerçek zamanlı yanıt. O yoksa ya da hatalıysa App Store Connect ayarı. O da yoksa API ile yapılandırılmış varsayılan mesaj.

Kendi sunucunla

1. Apple'ın formuyla erişim iste.
2. Önce görsellerini, sonra her biri için bir başlık ve metinle mesajlarını gönder.
3. Onaylanmalarını bekle, sonra her abonelik ve her dil için bir varsayılan mesaj bildir.
4. Gerçek zamanlı için sunucunda Get Retention Message adresini oluştur ve sandbox'ta bildir.
5. Sandbox'ta, bir test işlemiyle performans testini başlat.
6. Test başarılı olunca production adresini bildir.

RevenueCat ile

Benim seçtiğim yol bu: yazılacak sunucu yok ve uygulamalarım zaten RevenueCat'ten geçiyor, bunu RevenueCat ve iOS uygulama içi abonelik yazımda anlatıyorum. RevenueCat dokümantasyonuna göre:

1. Apple'ın formunda vermen gereken adres, RevenueCat'in App Store uygulamanın ayarlarında gösterdiği adres.
2. Onaydan sonra Lifecycle'ı, ardından Retention'ı aç ve sandbox adresini bağla.
3. Aktif bir sandbox ya da TestFlight aboneliğiyle performans testini başlat. Bir saate kadar sürebilir.
4. Önce dil dil bir varsayılan mesaj oluştur.
5. Sonra kurallarla gerçek zamanlı mesajlar ekle. Bunlardan biri, "Is in free trial", ücretsiz denemedeki kişileri hedefliyor.
6. Production'a geç: sandbox ayarları aktarılmıyor, mesajları yeniden oluşturman gerekiyor.

Tuzak kurmadan elde tutan bir mesaj yazmak

Metin sabit ve gösterilmeden önce Apple tarafından inceleniyor. Yani okuyan kişiden de, okuduğu günden de bahsedemez. TradaZen için hazırladığım varsayılan mesajın Türkçe hali şöyle:

Başlık (59 karakter):
Trade öğrenmek istiyordun, şimdi körlemesine mi gidiyorsun?

Metin (125 karakter):
Antrenman olmadan her hatayı gerçek paran öder. Burada hatalar hiçbir şeye mal olmaz. Günlük serin, ligin ve derslerin durur.

Dört uygulamam için kendime koyduğum kurallar:

• Başlık kişiyi hedefine geri götürür, soru şeklinde. Onu utandırmaz.
• Metin tam olarak neyin durduğunu söyler. Veriler kaldığında erişimin "kilitlendiğini" yazarım, asla "silineceğini" değil.
• Zaman kelimesi yok, "yarın" ya da "bugün" gibi: aynı metin dönemin herhangi bir anında gösteriliyor.
• Kazanç vaadi yok, sahte aciliyet yok. Trading sayesinde hayatını değiştirmeyi vaat eden ilk bir başlık, gönderilmeden önce elendi. Guideline 5.6 her türlü manipülatif uygulamayı yasaklıyor ve TradaZen'in paywall'u bu gerekçeyle zaten reddedilmişti, bunu guideline 5.6 ve paywall yazımda anlatıyorum.
• Her dilin kendi metni var, çevrilmiş uygulamanın kelime dağarcığıyla ve karakterine kadar sayılmış.

TradaZen için yıllık abonelikte denemede olan kişilere yönelik gerçek zamanlı bir mesaj da planlıyorum. Aynı gruptan daha ucuz bir yıllık plan önerecek, çünkü rakamlarım bu kişilerin uygulamayı ödeme yapanlar kadar kullandığını gösteriyor: reddettikleri şey fiyat. Bu ayar Apple'ın onayını bekliyor.

Ne bekleyebilirsin

Mucize bekleme. Apple, onay sayfasına geldikten sonra aboneliğini koruyan abonelerin oranına kurtarma oranı diyor. WWDC26 oturumunda Apple, Retention Messaging'i benimseyen aboneliklerin bu oranda ortalama 1,4 puan kazandığını açıklıyor. Promosyon teklifli mesajlar gözlemlenen en iyi kazancı, 5,5 puanı sağlıyor ve sonuçlar geliştiriciden geliştiriciye değişiyor. RevenueCat'in çalışması ise abonelerin promosyon tekliflerinin yalnızca yaklaşık %1,1'ini, plan değişikliklerinin de %0,6'sını kabul ettiğini tespit ediyor.

Yani mesaj, öncesindeki işin yerini tutmuyor. Bir dakika içinde iptal edilen ücretsiz deneme, paywall'da ve ilk oturumlarda belirleniyor: nedenler ve çözümler iptal edilen ücretsiz deneme rehberimde, denemenin oluşturulması da tanıtım teklifi yazımda.

Mesajdan önce aboneliğini hazırlamak

iOS & Android Kit, uygulamalarımın başlangıç kodundan yola çıkıyor: onboarding, paywall ve abonelikler zaten kodlanmış durumda ve dört adımlı yol seni kendi temponda App Store'a kadar götürüyor. App Store Connect'teki ürünlerden paywall'a kadar tüm zincir iOS uygulama içi abonelik sayfasında anlatılıyor.

İlk yayınına hazırlanıyorsan ücretsiz teşhisini yap: projeni gerçekte neyin tıkadığını söyler ve sana Apple redlerine karşı kontrol listemi gönderir.

Sık sorulan sorular

Apple'ın Retention Messaging API'si nedir?

Bir abone Cancel Subscription'a dokunduğunda ona gösterilecek mesajı seçen, sunucudan sunucuya çalışan bir hizmet. Mesaj, iptalden önce bir onay sayfasında görünür. Aboneliğin değerini hatırlatabilir, başka bir plan ya da promosyon teklifi önerebilir.

Retention Messaging tüm geliştiricilere açık mı?

API bir önizleme ve erişim Apple'dan talep üzerine veriliyor. WWDC26'da Apple, App Store Connect içinde herkese açık, 2026 sonbaharı için planlanan bir modül duyurdu. 3 Kasım 2026 itibarıyla App Store Connect yardımı onu henüz anlatmıyor.

Mesaj hangi iOS sürümlerinde görünüyor?

iOS 15.1 ve iPadOS 15.1 ya da daha yenisinde, visionOS 1'de ve macOS 14 ya da daha yenisinde. Daha eski bir cihazda iptal mesajsız gerçekleşir.

Mesaj abonenin iptal etmesini engelliyor mu?

Hayır. Onay sayfasında iptal butonu kalıyor. Abone aboneliğini koruyabilir ya da önerilen teklifi veya planı da kabul edebilir.

İptal anında indirim önerilebilir mi?

Evet. API ile bu bir promosyon teklifi mesajı, yalnızca gerçek zamanlı: teklif App Store Connect'te oluşturulur ve senin sunucun tarafından imzalanır. App Store Connect'te duyurulan modül de teklifli mesaja izin veriyor. Plan değişikliği ise aynı gruptan başka bir abonelik önerir.

Bir elde tutma mesajı kaç karakter olabilir?

Başlık en fazla 66 karakter, metin en fazla 144. En fazla beş madde işareti ve şeffaflıksız bir PNG görsel ekleyebilirsin. Her dilin kendi varsayılan mesajına ihtiyacı var.

Retention Messaging için sunucu gerekiyor mu?

Varsayılan mesajlar için barındırman gereken bir adres yok: onları göndermek ve bildirmek için API'yi çağırman yeterli. RevenueCat ile sunucu rolünü o üstleniyor. Gerçek zamanlı kullanım, 700 ms'nin altında yanıt veren bir HTTPS adresi istiyor. App Store Connect'te duyurulan modül ise kod yazmadan ayarlanıyor.