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

Kurulum altı bölümden oluşur:

1. Adapty SDK’nızı yapılandırın
2. Adapty Mail’i uygulama verilerinize bağlayın
3. Gönderim alan adınızı ayarlayın
4. Web paywallı oluşturun
5. Yapay zeka ile kampanya oluşturun
6. Bir akış başlatın

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 verileri (her dönüşümü tetikleyen e-postaya geliri bağlayabilmek için), sabit 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 alma işlemlerinizin zaten mevcut olup olmadığına göre değişir:

   • Adapty ile uygulama içi satın almaları zaten uyguladıysanız, bu aşamada başka bir şey yapmanıza gerek yoktur.
   • Adapty olmadan uygulama içi satın almaları zaten uyguladıysanız ve Adapty’ye geçiş yapmayı planlamıyorsanız, platformunuz için Adapty SDK’yı gözlemci modunda yükleyin. Bu aşamada yalnızca SDK’yı projenize eklemeniz, gözlemci modu etkin şekilde başlatmanız ve işlemleri raporlamanız gerekir. Platform kılavuzları: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor.
   • Henüz uygulama içi satın alma uygulamadıysanız ve Adapty’yi 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ı tanımlamayı ayarlayın. Backend kullanıcı ID’niz, Firebase UID’niz veya benzeri bir değer gibi sabit bir ID’yi — Adapty.identify() çağırarak ya da SDK başlatma sırasında .activate() metoduna customerUserId geçirerek — iletin. Adapty Mail, kampanyaları, tıklamaları ve satın almaları doğru profile eşleştirmek için customer_user_id alanını kullanır. 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-posta adresini girdiğinde (örneğin kayıt veya ödeme sırasında), e-posta özniteliğiyle updateProfile çağırarak bunu Adapty’ye iletin. Bir kampanyanın tüm alıcıları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 bölümüne bakın.

2. Adapty Mail’i uygulama verilerinize bağlayın

SDK bağlandıktan sonra, ürünün SDK’nın gönderdiği verileri gerçekten kullanabilmesi için iki kontrol paneli ayarı uygulamanızı Adapty Mail’e bağlar.

1. Adapty entegrasyonunu etkinleştirin. Adapty Mail’de Settings → Integrations bölümüne gidin ve Adapty entegrasyonunu açın. Etkinleştirildiğinde, Adapty müşterilerinizin oluşturduğu tüm olaylara ilişkin bilgileri gönderir — yeni abonelikler, yenilemeler, denemeler, dönüşümler, iadeler ve ödeme sorunları. Bu olaylar doğrudan bir müşterinin hangi segmente gireceğini, hangi kampanyaya atanacağını ve satın alma durumuna göre e-posta gönderiminin durdurup durdurulmayacağını belirler.

   

2. App Store veya Google Play URL’nizi ekleyin. Adapty Mail’de Settings → App metadata bölümüne gidin ve doğrudan mağaza URL’sini yapıştırın — iOS için https://apps.apple.com/…id{numbers}, Android için https://play.google.com/store/apps/details?id={package}.

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.

4. Bir web paywall oluşturun

Her e-posta, kullanıcıların bir CTA’ya tıkladığında açılan ödeme sayfası olan bir web paywall’a bağlantı içerir. İki seçeneğiniz var:

• Yapay zeka ile oluştur: Dahili web paywall builder’ın uygulamanız için bir tane oluşturmasına izin verin.
• Kendi barındırdığınız paywall’ı kullanın: Halihazırda barındırdığınız bir paywall’ı bağlayın.

Başlamak için Adapty Mail’de Web Paywalls → Create bölümüne gidin.

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.

Seçenek B: Kendi barındırdığınız paywallı kullanın

1. Enter URL manually seçeneğini seçin.

2. Barındırdığınız paywallın URL’sini yapıştırın. URL, sorgu parametresi olarak {email} ve {external_profile_id} yer tutucularını içermelidir — Adapty Mail, ödeme sayfasının ziyaretçiyi tanıyabilmesi için bunları her alıcıya göre doldurur. Örnek:

   https://example.com/paywall?email={email}&profile={external_profile_id}

3. Kaydedin ve yayınlayın.

Ödeme hunisinin anatomisi ve kişiselleştirmenin nasıl çalıştığı hakkında bilgi almak için Ödemeyi ayarlama konusuna bakın.

5. Yapay Zeka ile Kampanya Oluşturma

Yapay zeka, e-posta dizisinin tamamını sizin için oluşturur — metin, tasarım, hero görseller ve kişiselleştirilmiş ödeme bağlantıları, hepsi uygulamanıza özel.

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’u seçin.

4. E-posta oluştur’a tıklayın.
5. Açılan diyalog penceresinde ton ve dil seçin. Varsayılan olarak AI, uygulama bağlamına ve en iyi uygulamalara göre oluşturulacak e-posta sayısını belirler. Sayıyı kendiniz ayarlamak istiyorsanız Sayıyı manuel olarak ayarla’ya tıklayıp değeri girin (1–15, varsayılan 4).

6. Generate’a tıklayın. Oluşturma işlemi genellikle birkaç dakika sürer. Tamamlanamazsa sistem 5 dakika sonra zaman aşımına uğrar — böyle bir durumda tekrar deneyin.
7. Her e-postayı önizleyin. Tek tek e-postaları yeniden oluşturabilir, metni 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önderilmeye başlanmaz — kampanyalar yalnızca bir akışa bağlandığında yayına girer (sonraki adım). Kampanya düzenleyicisinde ayrı bir “yayınla” butonu yoktur.

6. Bir flow başlatın

Bir flow, bir tetikleyiciyi (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 ait bir flow görünümü bulunan üç 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 almamış kullanıcılar.
   • Expired — sona ermiş abonelikler.
   • Refunded — iade edilmiş satın almalar.
2. Diyaloğu açmak için Create’e 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).
   • 5. Adımda kaydettiğiniz Campaign’i seçin.
4. Save’e tıklayın.

Akış hemen devreye girer — ayrı bir başlatma adımı yoktur. Artık segmentle eşleşen kullanıcılar, tetikleyici olayına ulaştıkları anda kampanyayı almaya başlar.

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 bekleyip Check Verification butonuna 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.