Adapty Mail'e Başlarken

Bu kılavuzda Adapty Mail’i kuracak ve ilk email flow’unuzu başlatacaksınız.

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

1. Verilerinizi bağlayın
2. Gönderim domaininizi ayarlayın
3. Web paywallı oluşturun
4. Yapay zeka ile kampanya oluşturun
5. Bir flow başlatın
6. Göndermeye başlayın

Başlamadan önce

Başlamadan önce şunların hazır olduğundan emin olun:

• DNS erişimi: Kök alan adınıza kayıt ekleyebilmeniz gerekir.
• Ödemeler: Abonelik ürünlerinizin yapılandırılmış olduğu bir Stripe hesabınız olmalıdır. Farklı bir sağlayıcı kullanmak istiyorsanız ödeme sayfasını kendiniz barındırın — bkz. Ödeme sayfasını kurma.

1. Verilerinizi Bağlayın

Adapty Mail, satın alma geçmişine (her dönüşümü gerçekleştiren e-postaya geliri atfedebilmek için), kararlı bir kullanıcı tanımlayıcısına ve her kullanıcı için bir e-posta adresine ihtiyaç duyar. Verilerin halihazırda bulunduğu konumla eşleşen giriş noktasını hazırlayın — 6. Adımda, kurulumun geri kalanı gelen verilere göre hareket edebilir hale geldiğinde musluğu açacaksınız:

• Adapty: Uygulamanız Adapty SDK çalıştırıyorsa kullanıcı tanımlama ve e-posta toplama adımlarını tamamlayın. Entegrasyonu şimdilik kapalı bırakın — bir flow oluşturmadan Adapty Mail bunu engeller. Bkz. Adapty’yi Adapty Mail’e bağlama.
• Adapty Mail API: Backend’iniz gerçeğin kaynağıysa Settings bölümünden gizli anahtarınızı alın ve isteklerinizi oluşturun; ancak henüz göndermeyin. Kurulum tamamlanmadan önce gelen profiller hiçbir zaman e-posta almaz. Bkz. Adapty Mail API aracılığıyla e-posta ve işlem gönderme.

Aynı anda birden fazla giriş noktası kullanabilirsiniz. Adapty Mail, gelen verileri customer_user_id ve e-posta adresiyle eşleştirir; bu sayede birden fazla kaynaktan bilgi aldığı bir kişi için yalnızca tek bir profil ve tek bir sekans oluşturulur.

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

Adapty Mail’i açın: Başlıktaki Adapty logosuna tıklayın ve Mail’i seçin.

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 → DNS bölümüne gidin ve Email domains bölümünde Add domain düğmesine tıklayın.
2. Domain alanına kök alan adınızı yazın (örneğin, yourapp.com). Yalnızca apex alan adları kabul edilir; app.yourapp.com gibi alt alan adları girişte reddedilir.
3. Sending subdomain alanına e-postalarınızın gönderileceği ön eki yazın ya da mail kullanmak için alanı boş bırakın. E-postalar hello@mail.yourapp.com adresinden gelir.
4. Add domain düğmesine tıklayın.

5. Domain kayıt sağlayıcınızda, yeni domain kartının listelediği her DNS kaydını ekleyin. Bu kayıtlar üç grupta gelir: gönderim alt alan adınızın DKIM ve MAIL FROM kayıtları, domain’i ısıtan posta kutusu kayıtları ve görseller ile takip edilen bağlantılara hizmet eden go.yourapp.com kayıtları. Her grubun ne doğruladığını görmek için Hangi kayıtları ekliyorsunuz bölümüne bakın. Hepsini bir anda almak için Export’a tıklayın.
6. İsteğe bağlı olarak, kök domain’inize önerilen DMARC TXT kaydını ekleyin (önerilir).
7. Hemen doğrulamak için Check’e tıklayın ya da kartı kapatıp Adapty Mail’in DNS’i sorgulamasını bekleyin.

Bir bakışta doğrulama zamanlaması:

• Otomatik yoklama: İlk kontrol, domain’i ekledikten 1 dakika sonra çalışır; ardından kayıtlar bulunana kadar aralıklar saatte bir olacak şekilde ikiye katlanır.
• Manuel kontrol: Anlık bir kontrol tetiklemek için istediğiniz zaman Check düğmesine tıklayın.
• DNS yayılımı: Genellikle birkaç dakika sürer; nadir durumlarda 48 saate kadar uzayabilir.
• Doğrulama penceresi: 7 gün. Süresi dolarsa DNS kayıtlarınız yerinde kalır — yeni bir pencere başlatmak için Settings → DNS bölümünde domain’inizi tekrar ekleyin.

Göndermeye başlamak için bir doğrulanmış alan adı yeterlidir. Bir projede en fazla beş alan adı tutulabilir, geri kalanları daha sonra ekleyebilirsiniz.

Her kayıt türü ve alan adı ısınma süreci 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.

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

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

2. Paywallınızın URL’sini, yer tutucuları sorgu parametresi olarak ekleyerek yapıştırın. Adapty Mail, ödeme sayfasının ziyaretçiyi tanımlayabilmesi için bu yer tutucuları her alıcıya göre ayrı ayrı değiştirir. Örnek:

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

   Kullanabileceğiniz yer tutucular Create sayfasında listelenmektedir. Her birinin neye karşılık geldiğini görmek için bkz. Ödeme sayfasını kurma.

3. Kaydedin ve yayınlayın.

Kişiselleştirmenin nasıl çalıştığı ve ödeme hunisi anatomisi hakkında bilgi almak için Ödemeyi ayarlama sayfasına bakı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öndermeye Başla

Kampanyanız hazırlandı ama henüz çalışmıyor — kullanıcı verisi Adapty Mail’e ulaşmıyor. Veri akışını başlatmak son adımdır ve 1. Adım’daki her giriş noktası farklı şekilde başlar:

• Adapty: Adapty Mail’de Settings → Project bölümüne gidin ve Enable Adapty integration butonuna tıklayın. Bu buton, 5. adımı tamamlayana kadar devre dışıdır ve üzerinde “Set up at least one flow before enabling Adapty integration” ipucu gösterilir. Bkz. Adapty’yi Adapty Mail’e bağlama.
• Adapty Mail API: Profil ve işlem olaylarını göndermeye başlayın. Bu kurulumu tamamlamadan önce gönderdiğiniz profiller hiçbir şey almaz; bu yüzden bu adım en sona bırakılmıştır. Bkz. Adapty Mail API aracılığıyla e-posta ve işlem gönderme.

Segmentinizle eşleşen kullanıcılar, tetikleyiciye ulaştıkları anda kampanyayı alır. Gerçek kullanıcıları dahil etmeden önce, bir test kullanıcısıyla tüm zinciri test edin.

Sorun Giderme

Daha fazla bilgi edinin

• Flow’unuzu test edin: Yayına geçmeden önce tüm zinciri bir test kullanıcısıyla çalıştırın.
• Adapty’yi Adapty Mail’e bağlayın: SDK kurulumu ve uygulamanız henüz e-posta toplamıyorsa e-posta kapsamı elde etme stratejileri.
• Gönderme domain’inizi ayarlayın: DNS kayıt detayları, ısınma kademeleri ve sorun giderme.
• Checkout’u ayarlayın: Checkout hunisinin anatomisi ve kişiselleştirme.
• Kampanya analitiği: Teslimat, etkileşim ve geliri takip edin.
• A/B testi: Birden fazla dizi sürümünü test edin.