Adapty'yi Adapty Mail'e Bağlayın
Adapty, Adapty Mail’in giriş noktalarından biridir — uygulamanız halihazırda Adapty SDK’sını çalıştırıyorsa bunu kullanın. Adapty; profilleri, e-posta adreslerini ve abonelik olaylarını Adapty Mail’e iletir. Adapty Mail ise bunları alıcıları seçmek, her kişiyi bir flow’a yerleştirmek ve satın almayı yönlendiren e-postaya geliri atfetmek için kullanır.
Uygulamanız Adapty SDK’sını çalıştırmıyorsa aynı verileri sunucunuzdan gönderin — bkz. Adapty Mail API aracılığıyla e-posta ve işlem gönderme.
Adapty Mail bağımsız bir üründür. Paywall’larınız, abonelikleriniz veya analizleriniz Adapty tarafından yönetilmese bile kullanabilirsiniz — tüm altyapınızı taşımanız gerekmiyor.
Doğru gelir verisi almak için gereken minimum kurulum, Adapty SDK’yı gözlemci modunda yüklemek ve App Store sunucu bildirimlerini etkinleştirmektir.
Adapty Mail, uygulamanızdan üç şeye ihtiyaç duyar: satın alma verisi (her dönüşümü o dönüşümü sağlayan e-postaya bağlayabilmek için), kararlı bir kullanıcı tanımlayıcısı ve kullanıcı e-postaları. Bu üçünü ayarlayın, ardından gönderimi açın.
1. Adapty’nin gelirinizi takip etmesine izin verin
İlk adım, uygulamanızda halihazırda uygulama içi satın alma işlemlerinizin olup olmadığına bağlıdır:
- Adapty ile uygulama içi satın almalarınız zaten uygulanmışsa, bu aşamada başka bir şey yapmanıza gerek yok.
- Adapty olmadan uygulama içi satın almalarınız zaten uygulanmışsa ve Adapty’e geçiş yapmayı planlamıyorsanız, platformunuz için Adapty SDK’yı observer mode ile yükleyin. Bu aşamada yalnızca SDK’yı projenize eklemeniz, observer mode etkin şekilde başlatmanız ve işlemleri raporlamanız gerekiyor. Platform kılavuzları: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor.
- Uygulama içi satın almalarınız henüz uygulanmamışsa ve Adapty kullanmak istiyorsanız, satın alma işlemlerini Adapty’e devretmek için hızlı başlangıç kılavuzundaki adımları tamamlayın.
Ardından, App Store’dan gelir ile ilgili güncellemeleri doğrudan almak için Adapty’de App Store sunucu bildirimlerini etkinleştirin.
2. Kullanıcılarınızı Tanımlayın
Stabil bir ID — backend kullanıcı kimliğiniz, Firebase UID’niz veya benzeri — geçirin; bunu SDK başlatılırken .activate() metoduna customerUserId olarak iletebilir ya da daha sonra (örneğin giriş sırasında) Adapty.identify() çağırarak yapabilirsiniz. Her iki durumda da herhangi bir paywall gösterilmeden önce ID’yi ayarlayın. customer_user_id, Adapty Mail’in kampanyaları, tıklamaları ve satın alımları doğru profile eşleştirmek için kullandığı bilgidir.
Platform kılavuzları: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor.
3. Kullanıcı e-postalarını toplayın
Bir kullanıcı uygulamanızda e-postasını girdikten sonra (örneğin kayıt veya ödeme sırasında), email özelliğiyle updateProfile çağrısı yaparak bunu Adapty’e iletin. Bir kampanyanın her alıcısı için bu değer gereklidir.
Platform kılavuzları: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor.
- Her zaman kararlı bir
customer_user_idiletin, anonim tanımlayıcı kullanmayın. Bir kullanıcı uygulamanızı kaldırıp yeniden yüklediğinde, Adapty bu ID’yi kullanarak yeniden yüklemeyi mevcut profille ilişkilendirir ve satın almaları doğru kullanıcıya bağlar. - E-posta toplamadan ve Adapty’e göndermeden önce kullanıcıdan açık onay alın. GDPR, CAN-SPAM ve hedef pazarlarınızdaki benzer düzenlemelere uyum sağlamak sizin sorumluluğunuzdadır.
E-posta kapsamınızı doğrulayın
Koleksiyonu uyguladıktan sonra Adapty’de kapsamı kontrol edin:
- Customers → Profiles bölümüne gidin.
- E-posta adresi girilmiş profillere göre filtreleyin.
Aktif kullanıcılarınız arasında en az %30–50 e-posta kapsama oranına ulaştıktan sonra ilk kampanyanızı başlatın. %100’ü beklemenize gerek yok — %30’a ulaştığınızda başlatabilirsiniz. Daha sonra e-posta adresi sağlayan kullanıcılar, koşulları sağladıklarında aktif kampanyalara otomatik olarak dahil edilir.
E-posta toplama stratejileri
Çoğu uygulama varsayılan olarak e-posta toplamaz. Uygulamanızın mevcut durumuna uyan yaklaşımı seçin.
| Strateji | En iyi kullanım | Nasıl çalışır |
|---|---|---|
| Mevcut kimlik doğrulama | Herhangi bir giriş formu olan uygulamalar | E-postaya zaten sahipsiniz — kullanıcı kimliğini doğruladıktan sonra Adapty’ye iletin. |
| Paywall öncesi e-posta kapısı | Kimlik doğrulaması olmayan uygulamalar — sağlık, wellness, astroloji, fotoğraf editörleri | Onboarding ile paywall arasına tek bir e-posta girişi ekranı ekleyin. Kullanıcılar zaten zaman harcadığından dönüşüm oranı genellikle %70–90 arasında seyreder. |
| Web paywall builder checkout | Minimal SDK çalışması; e-posta web’de yakalanır | Web paywall builder’ın ilk ekranı e-postayı toplar ve Adapty’ye iletir — uygulama içi bir kapı yayına girmeden önce kampanyaya tıklayan kullanıcılar için kullanışlıdır. |
| Onboarding adımı | Quiz tabanlı onboarding (fitness, beslenme, eğitim) | Onboarding’in 2–3. adımına bir e-posta giriş alanı ekleyin. Bunu değer sunumu olarak çerçevelendirin (“Kişiselleştirilmiş planınızı e-postayla göndereceğiz”) ve bu adımın atlanabilir olmasından kaçının. |
| Adapty Mail API | E-postaları Adapty SDK’sı olmadan sunucunuzdan göndermek | Profilleri Adapty Mail API’nin Profili kaydet endpoint’ine gönderin. Bkz. Adapty Mail API aracılığıyla e-posta ve işlem gönderme. |
4. Gönderimi etkinleştirin
Bu adıma, kurulumun geri kalanı tamamlandıktan sonra geri dönün. Adapty Mail, en az bir flow oluşturulmadan Enable düğmesini devre dışı bırakır ve şu ipucunu gösterir: “Set up at least one flow before enabling Adapty integration” — bu nedenle önce gönderim domain’inizi, ödeme sayfanızı, kampanyanızı ve flow’unuzu tamamlayın. Bkz. Adapty Mail’e başlarken.
Entegrasyonu açmak son adımdır: olaylar akmaya, segmentler eşleşmeye ve e-postalar gönderilmeye başlar.
- Adapty Mail’de Settings → Project bölümüne gidin ve Adapty Integration kısmını bulun.
- Enable Adapty integration seçeneğine tıklayın (önceki bir kurulumdan entegrasyon zaten mevcutsa Enable olarak görünebilir).
Etkinleştirildiğinde Adapty, yeni abonelikler, yenilemeler, denemeler, dönüşümler, iadeler ve ödeme sorunları gibi tüm abonelik olaylarını Adapty Mail’e gönderir. Bu olaylar segment üyeliğini, kampanya yönlendirmesini ve bir kullanıcı dönüştüğünde diziyi durduran koşulları yönetir.
Adapty Entegrasyonu bölümü yalnızca bir Adapty çalışma alanına bağlı projeler için görünür. Adapty Mail’e doğrudan kaydolduysanız ve projeniz bağlı değilse bu bölüm görünmez — verilerinizi bunun yerine Adapty Mail API aracılığıyla gönderin.
Ayarlar’daki Adapty integration geçiş düğmesi, sizi Adapty Mail’e giriş yaptıran Adapty iş ortağı çalışma alanıyla aynı şey değildir. İş ortağı çalışma alanı, hesabınızı (ve Adapty üzerinden kaydolduysanız markanızı) oluşturan şeydir. Buradaki entegrasyon geçiş düğmesi ise etkinlik senkronizasyonunu kontrol eder — her proje için ayrı ayrı etkinleştirilmesi gerekir.
Sınırlamalar
- Anonim kullanıcılar: Sabit bir
customer_user_idolmayan kullanıcılar kampanya alamaz. Hesap oluştururken veya giriş yaparken bu kullanıcıları tanımlayın — o andan itibaren sağladıkları e-posta, Adapty profilleriyle eşleştirilir. - E-postası olmayan kullanıcılar: E-postası bulunmayan profiller kampanya dağıtımının dışında tutulur ve kampanya analizlerinde görünmez. E-posta sağladıkları anda gelecekteki kampanyalara dahil edilirler.