---
title: "Adapty Mail'e Başlarken"
description: "Adapty Mail'i kurun ve ilk e-posta flow'unuzu başlatın."
---

Bu kılavuzda Adapty Mail'i kuracak ve ilk e-posta flow'unuzu başlatacaksınız.
:::note
Adapty SDK kullanmadan, kendi sunucunuzdan da Adapty Mail'e veri gönderebilirsiniz. Kullanıcı e-postalarını ve satın alımlarını backend'inizde zaten tutuyorsanız veya başka bir kaynaktan abone içe aktarıyorsanız, bkz. [Adapty Mail API aracılığıyla e-posta ve işlem gönderme](mail-send-data-via-api).
:::

Kurulum altı bölümden oluşmaktadır:
1. [Adapty SDK'nızı yapılandırın](#1-configure-your-adapty-sdk)
2. [Gönderme domain'inizi ayarlayın](#2-set-up-your-sending-domain)
3. [Bir web paywall'u oluşturun](#3-create-a-web-paywall)
4. [Yapay zeka ile bir kampanya oluşturun](#4-generate-a-campaign-with-ai)
5. [Bir akış başlatın](#5-launch-a-flow)
6. [Gönderimi etkinleştirin](#6-enable-sending)
:::tip
Adapty üzerinden Adapty Mail'e kaydolduysanız, **brand profili** otomatik olarak projenizin mağaza URL'sinden oluşturulur. İstediğiniz zaman **Brand** sayfasını açıp inceleyebilir veya düzenleyebilirsiniz — bkz. [Brand](mail-brand). Bağımsız kaydolduysanız, kampanya veya web paywall oluşturmadan önce aynı sayfada markanızı ayarlayın.
:::
## Başlamadan önce \{#before-you-start\}

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 \{#1-configure-your-adapty-sdk\}

:::important
Adapty Mail **bağımsız bir üründür**. Paywall'larınız, abonelikleriniz veya analizleriniz Adapty tarafından yönetilmese bile kullanabilirsiniz — tüm altyapınızı taşımanız gerekmez.

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'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](implement-observer-mode), [Android](implement-observer-mode-android), [React Native](implement-observer-mode-react-native), [Flutter](implement-observer-mode-flutter), [Unity](implement-observer-mode-unity), [Kotlin Multiplatform](implement-observer-mode-kmp), [Capacitor](implement-observer-mode-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](quickstart) 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](enable-app-store-server-notifications).

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](identifying-users), [Android](android-identifying-users), [React Native](react-native-identifying-users), [Flutter](flutter-identifying-users), [Unity](unity-identifying-users), [Kotlin Multiplatform](kmp-identifying-users), [Capacitor](capacitor-identifying-users).

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](setting-user-attributes), [Android](android-setting-user-attributes), [React Native](react-native-setting-user-attributes), [Flutter](flutter-setting-user-attributes), [Unity](unity-setting-user-attributes), [Kotlin Multiplatform](kmp-setting-user-attributes), [Capacitor](capacitor-setting-user-attributes).

Uygulamanız henüz e-posta toplamıyorsa [E-posta toplama stratejileri](mail-collect-emails#email-collection-strategies) sayfasına bakın.
## 2. Gönderim etki alanınızı ayarlayın \{#set-up-your-sending-domain\}

Adapty Mail'i açın: Üst bilgideki Adapty logosuna tıklayın ve **Mail**'i seçin.

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

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

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

4. Alan adı kayıt kuruluşunuzda gösterilen 10 DNS kaydını ekleyin (alt alan başına 5 kayıt):
   - Alt alan başına 3 CNAME kaydı (DKIM)
   - Alt alan başına 1 MX kaydı (Mail-From)
   - Alt alan başına 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** sayfasına dönün ve **Check Verification**'a tıklayın.

Doğrulama zamanlamasına genel bakış:

- **Otomatik yoklama**: İlk kontrol, gönderimden yaklaşık 5 dakika sonra çalışır. Kayıtlar bulunana kadar aralıklar saatte bir'e kadar uzar.
- **Manuel kontrol**: Anında kontrol tetiklemek için istediğiniz zaman **Check Verification** seçeneğine 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üre dolarsa DNS kayıtlarınız yerinde kalır — yeni bir pencere başlatmak için **Settings → Email Domains** bölümüne geri dönüp etki alanınızı tekrar girin.
Kayıt türleri ve alan adı ısınma süreci hakkında ayrıntılı bilgi için bkz. [Gönderim alan adınızı ayarlayın](mail-sending-domain).
## 3. Gönderim alan adınızı ayarlayın \{#set-up-your-sending-domain\}

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](mail-sending-domain).
### Seçenek A: Yapay Zeka ile Oluştur \{#option-a-generate-with-ai\}

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](mail-checkout).

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.

:::important
Paywall, ödeme trafiğine hizmet verebilmesi için yayımlanmış olmalıdır. Yayımlanmamış paywall'lar, kullanıcılar e-posta ödeme bağlantılarına tıkladığında hata döndürür.
:::
### A Seçeneği: Yapay Zeka ile Oluştur \{#option-a-generate-with-ai\}

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ı](web-paywall-configuration) 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 \{#generate-a-campaign-with-ai\}

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](mail-create-campaign) 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 \{#launch-a-flow\}

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](mail-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](mail-ab-testing) 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.
:::note
Aynı tetikleyiciye birden fazla segment → kampanya satırı ekleyebilirsiniz; bunlar öncelik sırasına göre çalışır. **All Users** satırı, kullanılıyorsa, daha spesifik bir segmentle eşleşmeyen herkesi yakalamak için en sona (en düşük önceliğe) yerleştirilmelidir.
:::

## 6. Gönderimi etkinleştirin \{#enable-sending\}

Ş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.

:::note
Ayarlar'daki **Adapty entegrasyonu** geçiş düğmesi, sizi Adapty Mail'e giriş yaptıran Adapty iş ortağı çalışma alanıyla *aynı şey değildir*. İş ortağı çalışma alanı, hesabınızı (ve Adapty aracılığıyla kaydolduysanız markanızı) oluşturan şeydir. Buradaki entegrasyon geçiş düğmesi ise etkinlik senkronizasyonunu kontrol eder — her proje için ayrı ayrı açılması gerekir.
:::
## Sorun Giderme \{#troubleshooting\}
| 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 \{#learn-more\}

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