Bu kılavuzda Adapty Mail’i kuracak ve ilk e-posta akışınızı başlatacaksınız.

Kurulum altı bölümden oluşmaktadır:

1. Adapty SDK’nızı yapılandırın
2. Gönderme domain’inizi ayarlayın
3. Bir web paywall’u oluşturun
4. Yapay zeka ile bir kampanya oluşturun
5. Bir akış başlatın
6. Gönderimi etkinleştirin

Başlamadan önce

Başlamadan önce aşağıdakilerin hazır olduğundan emin olun:

• DNS erişimi: Kök alan adınıza kayıt ekleyebiliyorsunuz.
• Web ödeme sağlayıcısı: Abonelik ürünlerinizin yapılandırılmış olduğu bir Stripe, Paddle veya PayPal hesabınız var.

1. Adapty SDK’nızı Yapılandırın

Adapty Mail’in uygulamanızdan ihtiyaç duyduğu üç şey vardır: satın alma verisi (her dönüşümü sağlayan e-postaya geliri atfedebilmek için), kararlı bir kullanıcı tanımlayıcısı ve kullanıcı e-posta adresleri.

1. Adapty’nin gelirinizi takip etmesine izin verin. İlk adım, uygulama içi satın almalarınızın zaten mevcut olup olmadığına bağlıdır:

   • Adapty ile uygulama içi satın almalarınızı zaten uyguladıysanız, bu aşamada başka bir şey yapmanıza gerek yok.
   • Adapty olmadan uygulama içi satın almalarınızı zaten uyguladıysanız ve Adapty’ye geçmeyi planlamıyorsanız, platformunuz için Adapty SDK’sını 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 yeterlidir. Platform kılavuzları: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor.
   • Uygulama içi satın almalarınızı henüz uygulamadıysanız ve Adapty kullanmak istiyorsanız, satın alma işlemlerini Adapty’ye devretmek için hızlı başlangıç kılavuzundaki adımları tamamlayın. Ardından gelir ile ilgili güncellemeleri doğrudan App Store’dan almak için Adapty’de App Store sunucu bildirimlerini etkinleştirin.

2. Kullanıcı kimliğini ayarlayın. Backend kullanıcı kimliğinizi, Firebase UID’nizi veya benzer bir ID’yi; Adapty.identify() çağırarak ya da SDK başlatılırken .activate() metoduna customerUserId geçirerek iletin. customer_user_id, Adapty Mail’in kampanyaları, tıklamaları ve satın almaları doğru profile eşleştirmek için kullandığı tanımlayıcıdır. Platform kılavuzları: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor.

3. Kullanıcı e-postalarını toplayın. Kullanıcı uygulamanızda e-posta adresini girdiğinde (örneğin kayıt veya ödeme sırasında), e-posta özelliğiyle birlikte updateProfile çağrısı yaparak bunu Adapty’ye iletin. Bir kampanyanın her alıcısının bu değere sahip olması gerekir. Platform kılavuzları: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor.

Uygulamanız henüz e-posta toplamıyorsa E-posta toplama stratejileri sayfasına bakın.

2. Gönderme alan adınızı ayarlayın

Adapty Mail, kendi alan adınızdan gönderim yapar. DNS kayıtlarını bir kez eklersiniz — tüm kampanyalar aynı doğrulanmış alan adını kullanır.

1. Adapty Mail’de Settings → Email Domains bölümüne gidin.
2. Kök alan adınızı girin (örneğin, yourapp.com) ve Preview’a tıklayın. Yalnızca apex alan adları kabul edilir — app.yourapp.com gibi alt alan adları girişte reddedilir.

3. Adapty, iki gönderme alt alan adı oluşturur (mail.yourapp.com ve email.yourapp.com). Gerekli DNS kayıtlarını görmek için Confirm’e tıklayın.

4. Alan adı kayıt şirketinizde gösterilen 10 DNS kaydını ekleyin (her alt alan adı için 5 kayıt):
   • Her alt alan adı için 3 CNAME kaydı (DKIM)
   • Her alt alan adı için 1 MX kaydı (Mail-From)
   • Her alt alan adı için 1 TXT kaydı (SPF, v=spf1 include:amazonses.com ~all)
5. İsteğe bağlı olarak kök alan adınıza bir DMARC TXT kaydı ekleyin (önerilir).
6. Settings → Email Domains bölümüne geri dönün ve Check Verification düğmesine tıklayın.

Doğrulama süresine genel bakış:

• Otomatik sorgulama: İlk kontrol, kaydı gönderdikten yaklaşık 5 dakika sonra çalışır. Kayıtlar bulunana kadar aralıklar saatte bire kadar uzar.
• Manuel kontrol: Anında kontrol başlatmak için istediğiniz zaman Check Verification düğmesine tıklayın.
• DNS yayılımı: Genellikle birkaç dakika sürer; nadir durumlarda 48 saate kadar çıkabilir.
• Doğrulama penceresi: 7 gündür. Süre dolarsa DNS kayıtlarınız yerinde kalır; yeni bir pencere başlatmak için Settings → Email Domains bölümüne alan adınızı yeniden girin.

Her kayıt türü ve alan adı ısınması hakkında ayrıntılı bilgi için bkz. Gönderme alan adınızı ayarlama.

3. Gönderim alan adınızı ayarlayın

Adapty Mail, kendi alan adınızdan gönderim yapar. DNS kayıtlarını bir kez eklersiniz — tüm kampanyalar aynı doğrulanmış alan adını kullanır.

1. Adapty Mail’de Settings → Email Domains bölümüne gidin.
2. Ana alan adınızı girin (örneğin, yourapp.com) ve Preview’e tıklayın. Yalnızca apex alan adları kabul edilir — app.yourapp.com gibi alt alan adları girişte reddedilir.

3. Adapty iki gönderim alt alan adı oluşturur (mail.yourapp.com ve email.yourapp.com). Gerekli DNS kayıtlarını görmek için Confirm’e tıklayın.

4. Domain kayıt sağlayıcınızda gösterilen 10 DNS kaydını ekleyin (her subdomain için 5):
   • Her subdomain için 3 CNAME kaydı (DKIM)
   • Her subdomain için 1 MX kaydı (Mail-From)
   • Her subdomain için 1 TXT kaydı (SPF, v=spf1 include:amazonses.com ~all)
5. İsteğe bağlı olarak, kök domaininize bir DMARC TXT kaydı ekleyin (önerilir).
6. Settings → Email Domains bölümüne geri dönün ve Check Verification butonuna tıklayın.

Doğrulama süresine genel bakış:

• Otomatik yoklama: İlk kontrol, gönderimin ardından yaklaşık 5 dakika sonra başlar. Kayıtlar bulunana kadar aralıklar saatte bire kadar uzar.
• Manuel kontrol: Anında kontrol başlatmak için istediğiniz zaman Check Verification düğmesine tıklayın.
• DNS yayılımı: Genellikle dakikalar içinde tamamlanır; nadir durumlarda 48 saate kadar sürebilir.
• Doğrulama penceresi: 7 gün. Süre dolarsa DNS kayıtlarınız yerinde kalır — yeni bir pencere başlatmak için Settings → Email Domains bölümüne alan adınızı yeniden girin.

Her kayıt türü ve alan adı ısınması hakkında ayrıntılı bilgi için bkz. Gönderme alan adınızı kurma.

Seçenek A: Yapay Zeka ile Oluştur

Sayfa, satır içi düğmeler içeren bir Önkoşullar listesi gösterir — önce sırayla bunları tamamlayın, ardından geri dönerek oluşturma işlemini başlatın. Liste; paywall builder’a giriş yapma, Stripe’ı bağlama, ürün ekleme ve sonucu inceleme adımlarını kapsar. Tam adımlar için bkz. Ödemeyi yapılandırma.

Tüm önkoşullar yeşile döndüğünde, oluşturma iletişim kutusunu açmak için Generate düğmesine tıklayın:

• Environment: Production veya Sandbox seçin. Sandbox, Stripe test modu ürünlerinizi kullanır ve geliştirme ile yerel ortamlar için güvenli varsayılandır.
• Plans: En fazla 3 Stripe planı seçin (her plan bir ürün + fiyattır). Bunlar, oluşturulan paywall’ın kullanıcılara ödeme sırasında sunduğu tekliflerdir.

Derlemeyi başlatmak için Generate’e tıklayın. Tamamlandığında, incelemek ve yayımlamak için editörü açın.

A Seçeneği: Yapay Zeka ile Oluştur

1. Generate with AI seçeneğini seçin.
2. Log in to the paywall builder butonuna tıklayın. Web paywall builder yeni bir sekmede açılır. Henüz oturum açmadıysanız Adapty kimlik bilgilerinizle giriş yapın.
3. Builder’da ödeme sağlayıcı entegrasyonunuzu (Stripe, Paddle veya PayPal) etkinleştirin. Ayrıntılar için Web paywall yapılandırması bölümüne bakın.
4. Adapty Mail’e dönün ve Proceed to generation butonuna tıklayın.
5. Oluşturulan paywallı inceleyin, ardından kaydedin ve yayınlayın.

4. Yapay zeka ile kampanya oluşturun

Yapay zeka, markanıza özel olarak tüm e-posta dizisini sizin için oluşturur; metin, tasarım, hero görseller ve kişiselleştirilmiş ödeme bağlantıları dahil.

1. Adapty Mail’de Campaigns bölümüne gidin ve Create düğmesine tıklayın.
2. Kampanya adını belirleyin.
3. Web paywall açılır menüsünden önceki adımda eklediğiniz web paywallı seçin.

4. E-posta oluştur’a tıklayın.
5. Oluşturma iletişim kutusunu doldurun — ton, dil, isteğe bağlı özel bir komut istemi (en fazla 2.000 karakter) ve e-posta sayısı (1–15, varsayılan 4). Her alanın ne işe yaradığını öğrenmek için Kampanya oluştur bölümüne bakın.

6. Generate’e (Oluştur) tıklayın. Oluşturma genellikle birkaç dakika sürer. Tamamlanamazsa sistem 5 dakika sonra zaman aşımına uğrar — bu durumda tekrar deneyin.
7. Her e-postayı önizleyin. Önizleme başlığında, önizlemenin nasıl görüneceğini kontrol eden bir Theme toggle (Tema değiştirici) (Auto, Light, Dark) bulunur — oluşturulan içerik tüm modlarda aynıdır. Tek tek e-postaları yeniden oluşturabilir, metinleri düzenleyebilir veya ayrıntılı kontrol için HTML düzenleyiciyi açabilirsiniz.

8. Kampanyayı kaydetmek için Create’e tıklayın. Kampanya taslak olarak kaydedilir ve henüz gönderilmez — kampanyalar yalnızca bir flow’a eklendikten sonra (bir sonraki adım) yayına girer. Kampanya düzenleyicisinde ayrı bir “yayınla” işlemi yoktur.

5. Bir akış başlatın

Bir akış, bir tetikleyici’yi (aboneliğin sona ermesi gibi bir olay) bir segment ile eşleştirir ve o segmente seçtiğiniz kampanyayı gönderir. Adapty Mail, her birinin kendine özgü akış görünümü olan beş sabit tetikleyiciyle birlikte gelir.

1. Adapty Mail’de Flows bölümüne gidin, ardından yapılandırmak istediğiniz tetikleyiciyi açın:

   • Never purchased — kaydolmuş ancak henüz satın alma yapmamış kullanıcılar.
   • Renewal cancelled — otomatik yenilemeyi kapattığı halde aktif aboneliği devam eden kullanıcılar.
   • Billing issue — ödeme başarısız, kart reddedilmiş veya süresi dolmuş ya da ek sürede olan kullanıcılar.
   • Expired — aboneliği sona ermiş ve erişimi kalkmış kullanıcılar.
   • Refunded — satın alma sonrasında para iadesi talep etmiş kullanıcılar.

   Her tetikleyicinin amacı ve ton rehberliği için Flows sayfasına bakın.

2. Diyaloğu açmak için Create düğmesine tıklayın.

3. İletişim kutusunda:
   • Bir Segment seçin (örneğin, bu tetikleyiciye ulaşan herkesi hedeflemek için All Users ya da profil özelliklerine göre yeni bir segment oluşturun).
   • İçerik türünü Campaign olarak bırakın (A/B Testi seçeneği A/B testi bölümünde ele alınmaktadır).
   • 4. Adımda kaydettiğiniz Campaign’i seçin.
4. Save’e tıklayın.

Flow hemen yayına girer — ayrı bir başlatma adımı yoktur. Bu noktadan itibaren segmentle eşleşen kullanıcılar, tetikleyici olayına ulaştıkları anda kampanyayı almaya başlar.

6. Gönderimi etkinleştirin

Şimdiye kadar kampanyanızı kurdunuz, ancak henüz çalışmıyor — abonelik etkinliklerini Adapty Mail ile senkronize eden Adapty entegrasyonu hâlâ kapalı. Bunu açmak son adımdır: etkinlikler akmaya, segmentler eşleşmeye ve e-postalar gönderilmeye başlar.

Bu adım yalnızca 5. adım tamamlandıktan sonra açılır. Bir akış başlatmadan önce, Settings → Integrations bölümündeki Enable düğmesi “Set up at least one flow before enabling Adapty integration.” ipucu mesajıyla devre dışı kalır.

1. Adapty Mail’de Settings → Integrations bölümüne gidin.
2. Enable Adapty integration (ya da daha önce kurulum yapıldıysa Enable) seçeneğine tıklayın.

Etkinleştirildiğinde, Adapty tüm abonelik olaylarını — yeni abonelikler, yenilemeler, denemeler, dönüşümler, iadeler, ö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 sekansı durduran koşulları yönetir.

Sorun Giderme

Sorun	Çözüm
DNS doğrulaması takılı kaldı	Kayıtların tam olarak eşleştiğini kontrol edin — sonda nokta olmamalı, CNAME hedefleri doğru olmalı. 5–10 dakika bekleyin, ardından Check Verification düğmesine tekrar tıklayın
Doğrulama penceresi sona erdi	Kayıtlarınız yerinde duruyor. Yeni bir pencere başlatmak için Settings → Email Domains bölümüne alan adınızı tekrar girin
Oluşturma başarısız oldu veya zaman aşımına uğradı	İnternet bağlantınızı kontrol edip tekrar deneyin. Sorun devam ederse Adapty desteğiyle iletişime geçin

Daha fazla bilgi edinin

• Kullanıcı e-postalarını toplayın: Uygulamanız henüz e-posta toplamıyorsa e-posta kapsamı elde etmeye yönelik stratejiler.
• Gönderme etki alanınızı ayarlayın: DNS kayıt ayrıntıları, ısınma kademeleri ve sorun giderme.
• Ödeme sayfasını ayarlayın: Ödeme hunisi yapısı ve kişiselleştirme.
• Kampanya analitiği: Teslimat, etkileşim ve geliri takip edin.
• A/B testi: Birden fazla sıra sürümünü test edin.