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.

Important

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

Backend kullanıcı ID’niz, Firebase UID’niz veya benzer bir şey gibi kalıcı bir ID’yi — SDK başlangıcında .activate() metoduna customerUserId olarak geçirerek ya da daha sonra (örneğin, oturum açma sırasında) Adapty.identify() çağırarak — iletin. Her iki durumda da, herhangi bir paywall gösterilmeden önce ID’yi ayarlayın. Adapty, yeniden yüklemeler ve oturum açmalar boyunca her kişi için tek bir profil tutmak amacıyla bunu kullanır; Adapty Mail ise bunu profilin harici ID’leri arasında saklar. Adapty Mail, kişileri bu ID’ye göre değil, e-posta adresine göre eşleştirir.

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.

Important

Her zaman sabit bir customer_user_id gö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 girilmiş profillere göre filtreleyin.

İlk kampanyanızı başlatmadan önce aktif kullanıcılarınızın en az %30–50’sinin e-posta kapsamını hedefleyin. %100’ü beklemenize gerek yok — %30’a ulaştığınızda başlatın. E-posta adresini sonradan sağlayan kullanıcılar, uygun olduklarında aktif kampanjalara 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: olaylar akmaya, segmentler eşleşmeye ve e-postalar gönderilmeye başlar. Mail projenizin bir Adapty uygulamasına bağlı olup olmaması yalnızca nasıl etkinleştireceğinizi değiştirir, gelen veriler değil:

Bir Adapty uygulamasına bağlı. Adapty bu projeyi, Adapty kontrol panelinden Mail’i ilk açtığınızda sizin için oluşturdu.

Adapty Mail’de Settings > Project bölümüne gidin ve Data integration kısmında Enable Adapty integration (ya da entegrasyon önceki bir kurulumdan zaten mevcutsa Enable) düğmesine tıklayın.
Bağlı değil. Bu projeyi Adapty Mail’de kendiniz oluşturdunuz — ister bağımsız bir hesapta, ister Adapty hesabınızda.

Data integration bölümünde Enable Adapty integration butonu bulunmaz, ancak Adapty projeye yine de veri besleyebilir — yalnızca anahtara ihtiyaç duyar.
1. Adapty Mail’de Settings > Project sayfasına gidin ve Secret key’i kopyalayın.
2. Adapty kontrol panelinde Integrations > Adapty Mail sayfasına 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, gizli anahtarı sizin için otomatik olarak doldurur.

Etkinleştirildiğinde, Adapty her abonelik olayını — yeni abonelikler, yenilemeler, denemeler, dönüşümler, iade talepler, ödeme sorunları — Adapty Mail’e gönderir. Bu olaylar segment üyeliğini, kampanya yönlendirmesini ve bir kullanıcı dönüşüm gerçekleştirdiğinde sırayı durduran koşulları yönetir.

Sınırlamalar

Anonim kullanıcılar: Sabit bir customer_user_id olmadan Adapty, birisi uygulamayı yeniden yükledikçe veya çıkış yaptıkça yeni bir profil kimliği oluşturur. Kullanıcının e-posta vermeden önce yaptığı bir satın alma, Adapty Mail profiline hiçbir zaman ulaşmaz — eski kimliğe bağlı kalır. Bu noktadan itibaren geliri, satın alma durumu ve segment üyeliği hatalı olur.
E-postası olmayan kullanıcılar: Adapty Mail, e-posta adresi vermemiş biri için profil oluşturmaz. Teslimat veya analizlerden hariç tutulacak hiçbir şey yoktur — bu kullanıcılar sistemde mevcut değildir. Bir adres gelir gelmez profil oluşturulur ve kullanıcı uygun hale gelir.