Adapty Mail’in kullanıcılara ulaşabilmesi için her kullanıcıya ait sabit bir customer_user_id ve bir e-posta adresi gerekir. Bir kampanya başlatmadan önce her ikisini de uygulama kodunuzda ayarlayın.

Kullanıcı e-postalarını toplama

Adapty’e her kullanıcı için iki değer iletilmesi gerekir: kullanıcıyı tanımlayan kararlı bir customer_user_id ve e-postanın kendisi. Önce kimlik doğrulama yapılmalıdır — bu olmadan Adapty’nin e-postayı ekleyeceği bir profil bulunmaz.

1. Kullanıcıyı tanımlayın. SDK başlatılırken customerUserId olarak .activate() metoduna geçirerek ya da daha sonra (örneğin, oturum açma sırasında) Adapty.identify() çağırarak kararlı bir ID — backend kullanıcı ID’niz, Firebase UID’si veya benzeri bir değer — iletin. Her iki durumda da herhangi bir paywall gösterilmeden önce bu ID ayarlanmış olmalıdır. Platform kılavuzları: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor.

2. E-postayı iletin. Kullanıcı e-postasını sağlar sağlamaz, email parametresiyle updateProfile aracılığıyla Adapty’ye gönderin. Platform kılavuzları: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor.

E-posta kapsamınızı doğrulayın

Toplama işlemini uyguladıktan sonra Adapty’de kapsamı kontrol edin:

1. Customers → Profiles bölümüne gidin.
2. E-postası olan profilleri filtreleyin.

İlk kampanyanızı başlatmadan önce aktif kullanıcılarınızın en az %30–50’sinin e-posta kapsamına sahip olmasını hedefleyin. %100’ü beklemenize gerek yok — %30’a ulaştığınızda başlatabilirsiniz. E-postalarını sonradan ekleyen kullanıcılar, uygun oldukları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 uygun olduğu durum	Nasıl çalışır
Mevcut kimlik doğrulama	Herhangi bir giriş yöntemi olan uygulamalar	E-posta zaten elinizde — kullanıcı kimlik doğrulaması yaptıktan sonra Adapty’e gönderin. Nereden okunacağı için aşağıdaki auth yöntemi referansına bakın.
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ş ekranı ekleyin. Kullanıcılar zaten zaman harcadığından dönüşüm oranı genellikle %70–90 arasında olur.
Web paywall builder ödeme akışı	Minimum SDK çalışması; e-posta web’de yakalanır	Web paywall builder’ın ilk ekranı e-postayı toplayıp Adapty’e iletir — uygulama içi kapı henüz yayında değilken kampanya bağlantısına 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şi ekleyin. Bunu değer sunumu olarak çerçeveleyin (“Kişiselleştirilmiş planınızı e-postayla göndereceğiz”) ve adımı atlanabilir yapmaktan kaçının.
Sunucu taraflı API içe aktarma	Başka bir platformda mevcut e-posta listesi olan uygulamalar	Kayıtları mevcut profiller ile eşleştirmek için email ve external_profile_id parametreleriyle Update profile endpoint’ini kullanın.

Sınırlamalar

• Anonim kullanıcılar: Sabit bir customer_user_id olmayan 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.