---
title: "Adapty Mailを始める"
description: "Adapty Mailをセットアップして、最初のメールフローを起動する方法を説明します。"
---

このガイドでは、Adapty Mailをセットアップして最初のメールフローを起動する方法を説明します。

:::note
独自のサーバーからAdapty SDKを使わずにAdapty Mailにデータを送ることもできます。ユーザーのメールアドレスや購入情報をバックエンドで管理している場合、または別のソースからサブスクライバーをインポートする場合は、[Adapty Mail APIでメールとトランザクションを送信する](mail-send-data-via-api)をご覧ください。
:::

セットアップは6つのパートで構成されています：

1. [Adapty SDKを設定する](#1-configure-your-adapty-sdk)
2. [送信ドメインを設定する](#2-set-up-your-sending-domain)
3. [Webペイウォールを作成する](#3-create-a-web-paywall)
4. [AIでキャンペーンを生成する](#4-generate-a-campaign-with-ai)
5. [フローを起動する](#5-launch-a-flow)
6. [送信を有効にする](#6-enable-sending)

:::tip
AdaptyからAdapty Mailに登録した場合、**ブランドプロファイル**はプロジェクトのストアURLから自動的に作成されます。**Brand**をいつでも開いて確認・修正できます — [Brand](mail-brand)をご覧ください。スタンドアロンで登録した場合は、キャンペーンやWebペイウォールを生成する前に同じページでブランドを設定してください。
:::

## 始める前に \{#before-you-start\}

開始前に以下を確認してください：

- **DNSアクセス**: ルートドメインにレコードを追加できること。
- **Web決済プロバイダー**: サブスクリプションプロダクトが設定済みのStripe、Paddle、またはPayPalアカウントを持っていること。

## 1. Adapty SDKを設定する \{#1-configure-your-adapty-sdk\}

:::important
Adapty Mailは**スタンドアロンプロダクト**です。ペイウォール、サブスクリプション、アナリティクスをAdaptyで管理していなくても使用できます — スタック全体の移行は必須ではありません。

正確な収益データを取得するための最小構成は、Adapty SDKをオブザーバーモードでインストールし、App Serverサーバー通知を有効にすることです。
:::

Adapty Mailがアプリから必要とするのは、購入データ（各コンバージョンを誘導したメールに収益を紐付けるため）、安定したユーザー識別子、そしてユーザーのメールアドレスの3つです。

1. **Adaptyで収益をトラッキングする。** 最初のステップは、アプリ内課金がすでに実装されているかどうかによって異なります：
   - **Adaptyでアプリ内課金をすでに実装している場合**は、この段階で追加の作業は不要です。
   - **Adapty以外でアプリ内課金をすでに実装していてAdaptyへの移行を予定していない場合**は、お使いのプラットフォーム向けAdapty SDKをオブザーバーモードでインストールしてください。この段階では、SDKをプロジェクトに追加し、オブザーバーモードを有効にして起動し、トランザクションをレポートするだけで構いません。プラットフォームガイド: [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)。
   - **アプリ内課金をまだ実装しておらず、Adaptyを使いたい場合**は、[クイックスタートガイド](quickstart)の手順を完了して、購入処理をAdaptyに委譲してください。

   次に、[AdaptyでApp Storeサーバー通知を有効にする](enable-app-store-server-notifications)ことで、App Storeから収益関連の更新を直接受け取れるようにします。

2. **ユーザー識別を設定する。** バックエンドのユーザーID、Firebase UID、または類似の安定したIDを渡してください。`Adapty.identify()`を呼び出すか、SDK起動時に`.activate()`に`customerUserId`を渡す方法で設定します。`customer_user_id`は、Adapty Mailがキャンペーン、クリック、購入を正しいプロファイルに紐付けるために使用されます。

   プラットフォームガイド: [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. **ユーザーのメールアドレスを収集する。** アプリ内でユーザーがメールアドレスを提供したら（たとえばサインアップ時やチェックアウト時）、emailアトリビュートを指定して`updateProfile`を呼び出し、Adaptyに渡してください。キャンペーンのすべての受信者にはこの値が必要です。

   プラットフォームガイド: [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)。

   アプリでまだメールアドレスを収集していない場合は、[メールアドレス収集の戦略](mail-collect-emails#email-collection-strategies)をご覧ください。

## 2. 送信ドメインを設定する \{#2-set-up-your-sending-domain\}

Adapty Mailはあなた自身のドメインから送信します。DNSレコードを一度追加すれば、すべてのキャンペーンで同じ確認済みドメインが使用されます。

1. Adapty Mailで、**Settings → Email Domains**に移動します。
2. ルートドメイン（例: `yourapp.com`）を入力して、**Preview**をクリックします。受け付けられるのはApexドメインのみです — `app.yourapp.com`のようなサブドメインは入力時に拒否されます。

3. Adaptyが2つの送信サブドメイン（`mail.yourapp.com`と`email.yourapp.com`）を生成します。**Confirm**をクリックして、必要なDNSレコードを確認します。

4. ドメインレジストラで、表示される10件のDNSレコード（サブドメインごとに5件）を追加します：
   - サブドメインごとに3件のCNAMEレコード（DKIM）
   - サブドメインごとに1件のMXレコード（Mail-From）
   - サブドメインごとに1件のTXTレコード（SPF、`v=spf1 include:amazonses.com ~all`）
5. 任意で、ルートドメインにDMARC TXTレコードを追加します（推奨）。
6. **Settings → Email Domains**に戻り、**Check Verification**をクリックします。

確認のタイミングについての概要：

- **自動ポーリング**: 最初のチェックは送信から約5分後に実行されます。レコードが見つかるまで、間隔は最大1時間ごとに延びていきます。
- **手動チェック**: **Check Verification**をいつでもクリックして即時チェックを実行できます。
- **DNS伝搬**: 通常は数分で完了しますが、まれに最大48時間かかることがあります。
- **確認ウィンドウ**: 7日間。期限が切れても、DNSレコードはそのまま残ります — **Settings → Email Domains**でドメインを再入力すると、新しいウィンドウが開始されます。

各レコードタイプとドメインウォームアップの詳細については、[送信ドメインの設定](mail-sending-domain)をご覧ください。

## 3. Webペイウォールを作成する \{#3-create-a-web-paywall\}

すべてのメールはWebペイウォールにリンクしています — CTAをクリックしたユーザーが訪れるチェックアウトページです。2つの選択肢があります：

- **AIで生成する**: バンドルされたWebペイウォールビルダーがアプリ向けに自動生成します。
- **独自のホスト済みペイウォールを使用する**: すでにホストしているペイウォールを接続します。

開始するには、Adapty Mailで**Web Paywalls → Create**に移動します。

### オプションA: AIで生成する \{#option-a-generate-with-ai\}

ページにはインラインボタン付きの**Prerequisites**チェックリストが表示されます — 順番に進めてから戻って生成してください。チェックリストには、ペイウォールビルダーへのログイン、Stripeの接続、プロダクトの追加、結果の確認が含まれます。詳細なウォークスルーは[チェックアウトの設定](mail-checkout)をご覧ください。

すべての前提条件が緑になったら、**Generate**をクリックして生成ダイアログを開きます：

- **Environment**: **Production**または**Sandbox**を選択します。SandboxはStripeのテストモードのプロダクトを使用するため、開発環境やローカル環境のデフォルトとして安全です。
- **Plans**: 最大**3つのStripeプラン**を選択します（各プランはプロダクト＋価格）。これらが生成されたペイウォールでユーザーに提示されるオファーです。

**Generate**をクリックしてビルドを実行します。完了したら、エディターを開いて確認・公開してください。

:::important
ペイウォールはメールのチェックアウトリンクのトラフィックを受け付けるために、公開されている必要があります。未公開のペイウォールは、ユーザーがメールのチェックアウトリンクをクリックするとエラーを返します。
:::

### オプションB: 独自のホスト済みペイウォールを使用する \{#option-b-use-your-own-hosted-paywall\}

1. **Enter URL manually**を選択します。
2. ホスト済みペイウォールのURLを貼り付けます。URLにはクエリパラメーターとして`{email}`と`{external_profile_id}`のプレースホルダーを含める必要があります — Adapty Mailが受信者ごとにこれらを埋め込むことで、チェックアウトページが訪問者を識別できるようになります。例：

   ```
   https://example.com/paywall?email={email}&profile={external_profile_id}
   ```
3. 保存して公開します。

チェックアウトファネルの構造とパーソナライゼーションの仕組みについては、[チェックアウトの設定](mail-checkout)をご覧ください。

## 4. AIでキャンペーンを生成する \{#4-generate-a-campaign-with-ai\}

AIがメールシーケンス全体を作成します — コピー、デザイン、ヒーロー画像、パーソナライズされたチェックアウトリンクまで、すべてあなたのブランドに合わせて調整されます。

1. Adapty Mailで**Campaigns**に移動し、**Create**をクリックします。
2. キャンペーン名を設定します。
3. **Web paywall**ドロップダウンで、前のステップで追加したWebペイウォールを選択します。

4. **Generate emails**をクリックします。
5. 生成ダイアログに入力します — トーン、言語、任意のカスタムプロンプト（最大2,000文字）、メールの件数（1〜15、デフォルトは4）。各フィールドの説明は[キャンペーンの作成](mail-create-campaign)をご覧ください。

6. **Generate**をクリックします。生成には通常数分かかります。完了できない場合は5分後にタイムアウトします — その場合は再試行してください。
7. 各メールをプレビューします。プレビューヘッダーには**テーマトグル**（Auto、Light、Dark）があり、プレビューの表示方法を制御します — 生成されたコンテンツはどのモードでも同一です。個別のメールを再生成したり、コピーを編集したり、HTMLエディターを開いて細かく調整したりできます。

8. **Create**をクリックしてキャンペーンを保存します。

キャンペーンは**下書き**として保存され、まだ送信されません — キャンペーンはフローに紐付けられた時点で初めて有効になります（次のステップ）。キャンペーンエディターには「公開」アクションは別途ありません。

## 5. フローを起動する \{#5-launch-a-flow\}

フローは**トリガー**（サブスクリプションの期限切れなどのイベント）と**セグメント**を組み合わせ、選択した**キャンペーン**をそのセグメントに送信します。Adapty Mailには5つの固定トリガーがあり、それぞれ専用のフロービューを持っています。

1. Adapty Mailで**Flows**に移動し、設定したいトリガーを開きます：
   - **Never purchased** — サインアップしたがまだ購入していないユーザー。
   - **Renewal cancelled** — 自動更新をオフにしたが、まだアクティブなサブスクリプションを持つユーザー。
   - **Billing issue** — 支払い失敗、カード拒否や期限切れ、またはグレース期間中のユーザー。
   - **Expired** — サブスクリプションが失効してアクセスが失われたユーザー。
   - **Refunded** — 購入後に返金を申請したユーザー。

   各トリガーの目的とトーンのガイダンスについては、[フロー](mail-flows)をご覧ください。

2. **Create**をクリックしてダイアログを開きます。

3. ダイアログで：
   - **Segment**を選択します（例：**All Users**でこのトリガーに該当するすべてのユーザーをターゲットにする、またはプロファイルアトリビュートに基づいて新しいセグメントを作成する）。
   - コンテンツタイプは**Campaign**のままにします（A/B Testオプションは[A/B テスト](mail-ab-testing)で説明しています）。
   - ステップ4で保存した**Campaign**を選択します。
4. **Save**をクリックします。

フローはすぐに有効になります — 別途起動ステップはありません。この時点から、セグメントに一致するユーザーはトリガーイベントが発生した時点でキャンペーンを受け取り始めます。

:::note
同じトリガーに複数のセグメント → キャンペーンの行を追加できます。優先順位の高い順に実行されます。**All Users**行を使用する場合は、より具体的なセグメントにマッチしないすべてのユーザーをキャッチできるよう、最後（最低優先度）の行にする必要があります。
:::

## 6. 送信を有効にする \{#6-enable-sending\}

この時点でキャンペーンは設定されていますが、まだ実際には送信されていません — サブスクリプションイベントをAdapty Mailに同期する**Adaptyインテグレーション**がまだオフの状態です。これをオンにすることが最後のステップです。イベントが流れ始め、セグメントがマッチし始め、メールが送信され始めます。

このステップはステップ5が完了した後にのみ実行できます。フローを起動する前は、**Settings → Integrations**の**Enable**ボタンが無効になっており、「*Set up at least one flow before enabling Adapty integration.*」というツールチップが表示されます。

1. Adapty Mailで、**Settings → Integrations**に移動します。
2. **Enable Adapty integration**（または、以前のセットアップからインテグレーションが既に存在する場合は**Enable**）をクリックします。

有効にすると、Adaptyはすべてのサブスクリプションイベント（新規サブスクリプション、更新、トライアル、コンバージョン、返金、支払い問題）をAdapty Mailに送信します。これらのイベントがセグメントのメンバーシップ、キャンペーンのルーティング、ユーザーがコンバートしたときにシーケンスを一時停止するストップ条件を駆動します。

:::note
Settingsの**Adaptyインテグレーション**トグルは、Adapty MailにサインインさせたAdaptyパートナーワークスペースとは*異なります*。パートナーワークスペースはアカウントを作成し、（Adapty経由で登録した場合は）ブランドを作成したものです。ここのインテグレーショントグルはイベント同期を制御します — プロジェクトごとにオンにする必要があります。
:::

## トラブルシューティング \{#troubleshooting\}

| 問題 | 解決策 |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
| DNS確認が進まない | レコードが正確に一致しているか確認します — 末尾のドット、正しいCNAMEターゲット。5〜10分待ってから**Check Verification**をもう一度クリックします |
| 確認ウィンドウが期限切れ | レコードはそのまま残ります。**Settings → Email Domains**でドメインを再入力して新しいウィンドウを開始してください |
| 生成に失敗またはタイムアウト | インターネット接続を確認して再試行してください。問題が続く場合はAdaptyサポートにお問い合わせください |

## 詳細情報 \{#learn-more\}

- **[ユーザーメールアドレスの収集](mail-collect-emails)**: アプリでまだ収集していない場合のメールカバレッジ取得戦略。
- **[送信ドメインの設定](mail-sending-domain)**: DNSレコードの詳細、ウォームアップ階層、トラブルシューティング。
- **[チェックアウトの設定](mail-checkout)**: チェックアウトファネルの構造とパーソナライゼーション。
- **[キャンペーンアナリティクス](mail-analytics)**: 配信、エンゲージメント、収益のトラッキング。
- **[A/B テスト](mail-ab-testing)**: 複数のシーケンスバージョンのテスト。