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.
Doğru gelir verisi elde etmek için 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ü tetikleyen e-postaya geliri atfedebilmek için), kararlı bir kullanıcı tanımlayıcısı ve kullanıcı e-postaları. Bu üçünü kurduktan sonra Adapty Mail’de alan adınızı, ödeme sayfanızı, kampanyanızı ve flow’unuzu ayarlayın; son olarak gönderimi etkinleştirin.
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 sabit bir
customer_user_idgönderin, anonim bir tanımlayıcı kullanmayın. Bir kullanıcı uygulamanızı kaldırıp yeniden yüklediğinde Adapty, yeniden yüklemeyi mevcut profille ilişkilendirmek ve satın almaları doğru kullanıcıya atamak için bu kimliği kullanır. - E-posta adreslerini toplayıp Adapty’ye göndermeden önce kullanıcılardan açık onay alın. Hedef pazarlarınızdaki GDPR, CAN-SPAM ve benzeri mevzuata uyum sağlamak sizin sorumluluğunuzdadır. Adapty Mail’in her yeni adresi gönderi yapmadan önce doğrulamasını istiyorsanız çift onay özelliğini etkinleştirin.
E-posta kapsamınızı doğrulayın
Toplama işlemini uyguladıktan sonra Adapty’de kapsamı kontrol edin:
- Customers → Profiles bölümüne gidin.
- E-posta adresi ayarlanmış profillere göre filtreleyin.
İlk kampanyanızı başlatmadan önce aktif kullanıcılarınız arasında en az %30–50 e-posta kapsamını hedefleyin. %100’ü beklemenize gerek yok — %30’a ulaştığınızda başlatın. E-posta adreslerini daha sonra sağlayan kullanıcılar, uygun 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. Domain, ödeme sayfası, kampanya ve flow ayarlama
E-posta göndermek için Adapty Mail şunları gerektirir:
- Doğrulanmış bir gönderme domain’i
- E-postalarınızın yönlendireceği bir ödeme sayfası
- Gönderilecek bir kampanya
- Kimin alacağına karar veren bir flow
Tüm dördünü Adapty Mail’de ayarlayın — Adapty Mail ile başlayın kılavuzunun 3 ile 8. adımlarını takip edin.
5. Gönderimi etkinleştir
Entegrasyonu açmak son adımdır: eventler akmaya başlar, segmentler eşleşmeye başlar ve e-postalar gönderilmeye başlar. Mail projenizin bir Adapty uygulamasına bağlı olup olmaması yalnızca nasıl açacağınızı etkiler, gelen içeriği değil:
- Bir Adapty uygulamasına bağlı. Adapty bu projeyi, Mail’i Adapty Kontrol Paneli’nden ilk açtığınızda sizin için oluşturdu.
Adapty Mail’de Settings > Project bölümüne gidin ve Adapty Integration kısmında Enable Adapty integration (ya da önceki bir kurulumdan entegrasyon zaten varsa Enable) düğmesine tıklayın. En az bir flow oluşturmadan bu düğme devre dışı kalır; üzerine geldiğinizde “Set up at least one flow before enabling Adapty integration” ipucu görünür.
-
Not linked. Bu projeyi Adapty Mail’de kendiniz oluşturdunuz — ister bağımsız bir hesapta, ister Adapty hesabınızda.
Adapty Integration bölümü görünmez; ancak Adapty projeye yine de veri gönderebilir — tek ihtiyacı olan anahtar bilgisidir.
- Adapty Mail’de Settings > Project bölümüne gidin ve Secret key’i kopyalayın. 2. Adapty kontrol panelinde Integrations > Adapty Mail bölümüne gidin, entegrasyonu açın, anahtarı Secret Key alanına yapıştırın ve kaydedin.
Her iki yol da Adapty’de aynı entegrasyonu oluşturur — Adapty Mail’deki düğme, secret key’i sizin için otomatik olarak doldurur.
Etkinleştirildiğinde, Adapty her abonelik olayını — yeni abonelikler, yenilemeler, denemeler, dönüşümler, iadeler, faturalandırma sorunları — Adapty Mail’e gönderir. Bu olaylar segment üyeliğini, kampanya yönlendirmesini ve bir kullanıcı dönüşüm yaptığında bir diziyi duraklatacak durdurma koşullarını yönetir.
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.