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

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

1. Hesap türünüzü seçin
2. Verilerinizi bağlayın
3. Markanızı ayarlayın
4. Gönderim alan adınızı ayarlayın
5. Şirket adresinizi ekleyin
6. Bir web paywallı oluşturun
7. Yapay zeka ile kampanya oluşturun
8. Bir flow başlatın
9. Göndermeye başlayın

Adapty Mail, onboarding kontrol listenizdeki ilerlemenizi takip eder ve her adım tamamlandığında listeyi gizler.

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. Hesap türünüzü seçin

Hesap türü, Adapty Mail projenizin neler yapabileceğini belirler:

	Adapty bağlantılı (önerilen)	Bağımsız
Kayıt ol	Adapty hesabınızla giriş yapın ve Mail’i açın. Adapty, uygulamanıza bağlı bir proje oluşturur. Adapty Mail ile SDK arasındaki veri alışverişi, kurulumun son adımına kadar devre dışıdır. Satın alımlarınızı Adapty’ye taşımanıza gerek yok: yalnızca işlemlerinizi raporlayan, kurulumu kolay observer mode yeterlidir.	Bir e-posta adresi ve şifreyle yalnızca Adapty Mail’e kaydolun. Adapty hesabı gerekmez, uygulamanıza hiçbir şey kurmanıza gerek yok; verileri kendiniz, FunnelFox veya API aracılığıyla getirirsiniz.
Ödeme sayfası (6. Adım)	AI ile oluşturun — markanız etrafında inşa edilmiş, Stripe ödemeleri entegre edilmiş barındırılan bir ödeme sayfası — ya da kendi barındırılan paywall’unuz	Kendi barındırılan paywall’unuz
Segmentler	Adapty’den içe aktarın veya Mail’de oluşturun	Mail’de oluşturun
Marka — e-postalarınızın oluşturulduğu kaynak: ad, logo, renkler ve ton (3. Adım)	Varsa, uygulamanızın mağaza listesinden siz gelmeden önce oluşturulur	Yapıştırdığınız bir mağaza URL’sinden oluşturulur
Satın alma verileri (2. Adım)	Settings > Project içinde tek tıkla; FunnelFox ve API de çalışır	Adapty kontrol paneline veya FunnelFox’a yapıştırılan gizli anahtar ya da API
Ekip	Takım arkadaşları, Adapty şirketinizden Mail’i açtıklarında katılır; e-posta davetleri de desteklenir	E-posta davetleri

2. Verilerinizi bağlayın

Adapty Mail bir kullanıcıya e-posta gönderebilmek için şunlara ihtiyaç duyar:

• E-posta adresleri: E-postalarınızın gönderileceği adres.
• Müşteri kullanıcı kimliği: Kullanıcı için benzersiz tanımlayıcı. Adapty bunu kullanıcının profilinde saklar; böylece aynı kişi farklı cihazlarda tanınabilir. Bu kimlik olmadan, kullanıcı uygulamanızı her yeniden yüklediğinde veya oturumu kapattığında Adapty yeni bir profil oluşturur.
• Abonelik etkinlikleri akışı: Gerçek zamanlı olarak deneme başlatma, yenileme, iptal ve iade işlemleri. Bunlar, kullanıcıları davranışlarına göre hedeflemenize ve geliri satın almayı tetikleyen e-postaya bağlamanıza olanak tanır. Etkinlik akışı olmadan, kullanıcının alabileceği tek dizi hiç satın alma yapmamış kişilere yönelik olandır.

Bu veriyi kullanarak bir giriş noktası oluşturmak için talimatları izleyin:

• Adapty: Uygulamanız zaten Adapty SDK’sını kullanıyorsa bu seçeneği tercih edin. Adapty, profilleri, e-postaları ve abonelik olaylarını sizin adınıza iletir; bu nedenle kendi sunucunuza ihtiyacınız olmaz. Uygulamanıza kullanıcı tanımlama ve e-posta toplama özelliklerini ekleyin. Bkz. Adapty’yi Adapty Mail’e bağlama.
• Adapty Mail API: Bu verileri tutan bir arka ucunuz zaten varsa, uygulamanızda Adapty SDK yoksa veya başka bir yerden aboneleri içe aktarıyorsanız bu seçeneği kullanın. Profilleri ve işlem olaylarını kendiniz gönderirsiniz. Settings > Project sayfasındaki gizli anahtar, isteklerin kimliğini doğrular. Bkz. Adapty Mail API aracılığıyla e-posta ve işlem gönderme.
• FunnelFox: Kullanıcıları FunnelFox web hunileri aracılığıyla edinip ücretlendiriyorsanız bu seçeneği kullanın. FunnelFox, e-postalarını, satın almalarını ve abonelik olaylarını zaten elinde bulundurur ve bunları kendi başına Adapty Mail’e iletir; SDK çalışması veya yazılacak istek gerekmez. Bkz. FunnelFox entegrasyon kılavuzu.
• Kombinasyon: Birden fazla giriş noktasını aynı anda kullanabilirsiniz. Adapty Mail, gelen kullanıcı verilerini customer_user_id ve e-posta adresiyle eşleştirir.

Adapty Mail, kurulumun geri kalanı tamamlandıktan sonra e-posta göndermeye başlar.

3. Markanızı Ayarlayın

Adapty Mail, bir marka olmadan e-posta veya web paywallı oluşturamaz. Markanız, Adapty Mail’in uygulamanızın görünümüne ve sesine uyum sağlamak için ihtiyaç duyduğu bilgileri depolar — ad, logo, renkler, fontlar, ton, özellikler ve yorumlar. Siz mağaza listesini sağlarsınız, Adapty Mail ise markayı bundan oluşturur.

1. Adapty Mail’de Brand bölümünü açın.
2. Sayfa dolu bir marka bilgisi gösteriyorsa inceleyin ve devam edin. Set up your brand ekranı görünüyorsa aşağıdaki adımları takip edin.
3. Store altında App Store veya Google Play’i seçin, ardından mağaza listeleme URL’nizi yapıştırın.
   Note

   Kurulum ekranı yalnızca App Store veya Google Play listeleme URL’si kabul eder. Uygulamanızın mağaza listesi yoksa — örneğin web-to-app hunisi kullanıyorsanız — devam etmeden önce Adapty desteğiyle iletişime geçin.

4. Build my brand düğmesine tıklayın. Adapty Mail sayfayı çeker, yorumları analiz eder ve marka sesinizi belirler. Bu işlem genellikle bir dakikadan az sürer.
5. Bölümleri incelemek, elle düzenlemek ya da açılış sayfası ve sosyal medya kaynakları eklemek için Brand sayfasına bakın.

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

Adapty Mail, e-postaları kendi özel alan adınızdan gönderir. DNS kayıtlarını bir kez eklersiniz ve her kampanya aynı doğrulanmış alan adını kullanır.

İlk alan adınızı kaydetmek için Adapty Mail’de Settings > DNS > Email domains bölümüne gidin.

1. Domain alanına kök etki alanınızı yazın (örneğin, yourapp.com). Yalnızca apex etki alanları kabul edilir — app.yourapp.com gibi alt etki alanları girişte reddedilir.

2. Sending subdomain alanına e-postalarınızın gönderileceği öneki yazın ya da mail kullanmak için boş bırakın. E-postalar bu durumda hello@mail.yourapp.com adresinden gelir.

3. Add domain düğmesine tıklayın.

   

4. Domain kayıt sağlayıcınızda, yeni domain kartının listelediği tüm DNS kayıtlarını ekleyin. Bunlar üç grupta gelir: gönderim subdomain’inizin DKIM ve MAIL FROM kayıtları, domain’i ısıtan posta kutusu kayıtları ve görsel ile takip edilen bağlantılara hizmet eden go.yourapp.com kayıtları. Her grubun ne kimlik doğruladığı hakkında bilgi almak için Hangi kayıtları eklediğinize bakın. Hepsini aynı anda almak için Export düğmesine tıklayın.

5. İsteğe bağlı olarak, root domain’inize önerilen DMARC TXT kaydını ekleyin (önerilir).

6. Hemen doğrulamak için Check düğmesine tıklayın ya da kartı kapatıp Adapty Mail’in DNS’i otomatik olarak kontrol etmesini bekleyin.

Doğrulama zamanlamasına kısa bakış:

• Otomatik yoklama: İlk kontrol, alan adını ekledikten 1 dakika sonra çalışır; ardından kayıtlar bulunana kadar aralıklar iki katına çıkarak saatte bir’e ulaşır.
• Manuel kontrol: Anlık kontrol başlatmak için istediğiniz zaman Check’e tıklayın.
• DNS yayılımı: Genellikle birkaç dakika, 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 > DNS bölümünden alan adınızı tekrar ekleyin.

Adapty Mail’i kullanmaya başlamak için bir doğrulanmış alan adı yeterlidir. Bir projede en fazla beş alan adı tutulabilir ve kalanları daha sonra ekleyebilirsiniz.

Her kayıt türü ve alan adı ısınma süreci hakkında ayrıntılar için Gönderme alan adınızı yapılandırın bölümüne bakın.

5. Şirket adresinizi ekleyin

Spam karşıtı yasalar, her pazarlama e-postasında fiziksel bir posta adresi bulunmasını zorunlu kılar. Adapty Mail, adresinizi her kampanya e-postasının alt bölümüne ekler ve siz bu alanı doldurana kadar kampanya oluşturmayı engeller.

1. Adapty Mail’de Settings > Company bölümüne gidin.
2. Company address bölümünde Legal company name, Address line 1, City, Postal code ve Country alanlarını doldurun. Address line 2 ve State / Region alanları isteğe bağlıdır.
3. Save düğmesine tıklayın.

6. Web paywall oluşturun

Bir alıcı e-postanızdaki CTA’ya tıkladığında web paywall’a — tarayıcıda açılan bir ödeme sayfasına — yönlendirilir. Her kampanya bir web paywall’a bağlıdır ve Adapty Mail, web paywall’ı olmayan kampanyayı reddeder. Bu, uygulama içi paywall’ınız değildir: orada yapılan bir satın alma, App Store veya Google Play işlemi değil, bir web ödemesidir.

İki seçeneğiniz var:

• AI ile Oluştur: FunnelFox destekli yerleşik builder ile bir paywall oluşturun. Oluşturulan paywall, ödemeleri işlemek için Stripe kullanır.
• Kendi barındırdığınız paywallı kullanın: Adapty Mail’i halihazırda barındırdığınız ve istediğiniz sağlayıcıyı kullanan bir sayfaya yönlendirin. Adapty Mail, kullanıcıyı URL’de önceden doldurulmuş kullanıcı bilgileriyle paywallinize yönlendirir. Kendi barındırdığınız bir paywall herhangi bir ödeme sağlayıcısı kullanabilir.

Başlamak için Adapty Mail’de Web Paywalls > Create seçeneğine gidin.

Seçenek A: Yapay Zeka ile Oluşturma

Sayfa, satır içi düğmeler içeren bir önkoşul kontrol listesi gösterir — sırayla tamamlayın, ardından geri dönüp oluşturmaya başlayın. Kontrol listesi; paywall builder’a giriş yapma, Stripe bağlama, ürün ekleme ve sonucu inceleme adımlarını kapsar. Tam kurulum için bkz. Ödeme kurulumu. Bir önkoşulu başka bir sekmede tamamladıysanız, durumunu güncellemek için kontrol listesindeki Refresh düğmesine tıklayın.

Her önkoşul yeşile döndüğünde Proceed to generation düğmesine tıklayın. Choose plans iletişim kutusunda:

1. 1–3 plan seçin, hepsi aynı para biriminde olmalıdır. Her plan, oluşturulan paywallın ödeme sırasında sunduğu bir teklife karşılık gelir. İkinci ve üçüncü plan için Add plan düğmesine tıklayın.
2. Her plan için bir üretim fiyatı, sandbox karşılığı veya her ikisini birden seçin. Aynı satırdaki bir üretim ve sandbox fiyatı tek bir plan sayılır.
3. Generate paywall düğmesine tıklayın.

Her plan için bir sütunu doldurun ya da hepsini boş bırakın — kısmen doldurulmuş bir sütun oluşturmayı engeller. Sandbox fiyatları olmadan, test e-postaları üretim paywallına bağlantı verir ve test satın almaları çalışmaz.

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.

7. Yapay zeka ile kampanya oluşturma

Kampanya, bir alıcının zaman içinde aldığı en fazla 15 e-postadan oluşan bir dizidir. Yapay zeka, 3. Adım’da kurduğunuz markayı temel alarak tüm diziyi oluşturur: metin, tasarım, hero görseller ve kişiselleştirilmiş ödeme bağlantıları.

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 bir önceki adımda eklediğiniz web paywall’ı seçin.

   

4. Generate emails’e tıklayın.

5. Oluşturma iletişim kutusunu doldurun — ton, dil, isteğe bağlı özel bir istem (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şturma sayfasına bakın.

   

6. Generate’e 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. Önizleme başlığındaki Theme toggle (Auto, Light, Dark) seçeneği, önizlemenin nasıl görüneceğini kontrol eder; oluşturulan içerik tüm modlarda aynıdır. Tek tek e-postaları yeniden oluşturabilir, metni düzenleyebilir veya daha ayrıntılı kontrol için HTML düzenleyicisini 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 eklendiğinde yayına girer (sonraki adım). Kampanya düzenleyicisinde ayrı bir “yayınla” eylemi bulunmaz.

8. Bir flow başlatın

Adapty Mail kendi flow’larını içerir. Bir flow, tetikleyicileri (abonelik olayları) kampanyalarla (e-posta dizileri) birbirine bağlar. Aboneliğin sona ermesi, ödemenin başarısız olması gibi beş tetikleyicinin her birinin kendine ait bir flow’u vardır. Bir flow, tetikleyiciye ulaşan herkese tek bir kampanya gönderebilir ya da farklı gruplara farklı kampanyalar göndermek için segmentleri kullanabilir.

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 kapatmış ancak hâlâ aktif aboneliği olan kullanıcılar.
   • Billing issue — ödeme başarısız, kart reddedilmiş ya da süresi dolmuş veya ek süre durumu.
   • Expired — abonelik sona ermiş ve erişim kalkmış kullanıcılar.
   • Refunded — satın alma sonrası iade talep etmiş kullanıcılar.

   Her tetikleyicinin amacı ve ton rehberi 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. All Users bu tetikleyiciye ulaşan herkesi hedefler ve başlatmak için yeterlidir. Kitleyi daha sonra daraltmak için farklı bir segment oluşturun — kullanıcılarınızın ülkesine, yaşına veya abonelik durumuna göre filtrelenmiş bir alt küme.
   • İçerik türünü Campaign olarak ayarlayın (A/B Test seçeneği A/B testing bölümünde ele alınmaktadır).
   • 7. Adımda kaydettiğiniz Campaign’ı 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ı gerçekleştirdiklerinde kampanyayı almaya başlar.

9. Göndermeye Başlayın

Kampanyanız bağlantılı ama henüz tetiklenmiyor — hiçbir kullanıcı verisi Adapty Mail’e ulaşmıyor. Veriyi seçtiğiniz giriş noktasından akmaya başlatın. Projenizin Adapty’ye bağlı olup olmadığı (Adım 1), yalnızca Adapty beslemesini nasıl açtığınızı etkiler, ne geleceğini değil:

Verileriniz şuradan gelir	Mail projeniz bir Adapty uygulamasına bağlı mı	Ne yapmalısınız
Adapty SDK	Evet	Adapty Mail’de Settings > Project bölümüne gidin ve Enable Adapty integration butonuna tıklayın. Bir flow oluşturmadan (Adım 8) bu buton pasif kalır.
Adapty SDK	Hayır	Adapty, bağlı olmadığı bir projeye de veri besleyebilir — yalnızca anahtara ihtiyaç duyar. Settings > Project bölümünden gizli anahtarı kopyalayın ve Adapty kontrol panelinde Integrations > Adapty Mail altına yapıştırın.
Adapty Mail API aracılığıyla kendi backend’iniz	Her ikisi de	Profilleri ve işlem olaylarını göndermeye başlayın. Bu kurulum tamamlanmadan önce gönderdiğiniz profiller hiçbir zaman e-posta almaz; bu yüzden bu adım en sona bırakılmıştır.
FunnelFox	Her ikisi de	Settings > Project bölümünden gizli anahtarı kopyalayın ve FunnelFox’ta Integrations > Adapty Mail altına yapıştırın. Veriler yaklaşık bir dakika içinde gelmeye başlar.

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

Sorun	Çözüm
Generate emails seçeneği gri görünüyor	Marka veya şirket adresiniz eksik. Düğmenin ipucunda hangisinin eksik olduğu belirtilir. 3. Adım ve 5. Adım bölümlerine bakın
Paywall oluşturma engellendi	Panel nedeni belirtir: marka yok, bağlı Stripe hesabı yok veya fiyatlı Stripe ürünü yok. Sorunu düzeltin, ardından kontrol listesini Refresh ile yenileyin
Kampanya kaydedilemiyor	Her kampanyanın bir web paywallına ihtiyacı var. 6. Adım bölümünde bir tane oluşturun
Enable Adapty integration seçeneği gri görünüyor	Adapty Mail’in çalışması için en az bir flow gerekir. 8. Adım bölümüne bakın
DNS kayıtları doğrulanamıyor	Kayıtların tam olarak eşleştiğini kontrol edin — sonda nokta olmamalı, CNAME hedefleri doğru olmalı, her kayıtta tek bir değer bulunmalı. DNS yayılması 48 saate kadar sürebilir
Doğrulama penceresi sona erdi	Yeni bir pencere başlatmak için Settings > DNS bölümünde alanı tekrar ekleyin. Kayıt şirketinizdeki kayıtlar hâlâ geçerli — orada yeniden bir şey eklemenize gerek yok
E-posta oluşturma zaman aşımına uğradı	Oluşturma işlemi 5 dakika sonra durur. Tekrar deneyin; sorun devam ederse Adapty destek ekibiyle iletişime geçin

İlk kurulum dışındaki hatalar için Gönderme alan adınızı ayarlayın ve Ödeme sayfasını ayarlayın bölümlerindeki sorun giderme kısımlarına bakın.

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.