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

セットアップは6つのパートに分かれています：

1. Adapty SDK を設定する
2. 送信ドメインを設定する
3. ウェブペイウォールを作成する
4. AI でキャンペーンを生成する
5. フローを起動する
6. 送信を有効にする

始める前に

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

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

1. Adapty SDKを設定する

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

1. Adaptyで収益を追跡する。 最初のステップは、すでにアプリ内課金を実装しているかどうかによって異なります：

   • AdaptyでアプリIn内課金をすでに実装している場合は、この段階で追加の作業は不要です。
   • Adaptyを使わずにアプリ内課金をすでに実装していて、Adaptyへの移行を予定していない場合は、各プラットフォームのAdapty SDKをオブザーバーモードでインストールしてください。この段階では、SDKをプロジェクトに追加し、オブザーバーモードを有効にして起動し、トランザクションを報告するだけで構いません。プラットフォーム別ガイド：iOS、Android、React Native、Flutter、Unity、Kotlin Multiplatform、Capacitor。
   • アプリ内課金をまだ実装しておらず、Adaptyを使いたい場合は、クイックスタートガイドの手順に従って、購入処理をAdaptyに委任してください。 次に、Adapty で App Store サーバー通知を有効化して、App Store から収益関連の更新を直接受け取れるようにします。

2. ユーザー識別を設定する。 バックエンドのユーザー ID、Firebase UID などの安定した ID を、Adapty.identify() を呼び出すか、SDK 起動時に .activate() へ customerUserId として渡すことで設定します。customer_user_id は、Adapty Mail がキャンペーン、クリック、購入を正しいプロファイルに紐付けるための識別子です。 プラットフォームガイド: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor.

3. ユーザーのメールアドレスを収集する。 ユーザーがアプリ内でメールアドレスを入力したタイミング（サインアップやチェックアウトなど）で、updateProfile にメール属性を指定して Adapty に渡してください。キャンペーンの受信者全員にこの値が必要です。 プラットフォーム別ガイド: iOS、Android、React Native、Flutter、Unity、Kotlin Multiplatform、Capacitor

アプリでまだメールアドレスを収集していない場合は、メール収集戦略をご覧ください。

2. 送信ドメインを設定する

Adapty Mail を開く: ヘッダーの Adapty ロゴをクリックして Mail を選択します。

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

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

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

4. ドメインレジストラーで、表示された 10 件の DNS レコードを追加します（サブドメインごとに 5 件）:
   • サブドメインごとに CNAME レコード 3 件（DKIM）
   • サブドメインごとに MX レコード 1 件（Mail-From）
   • サブドメインごとに TXT レコード 1 件（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 でドメインを再入力すると、新しいウィンドウが開始されます。 各レコードタイプとドメインウォームアップの詳細については、送信ドメインの設定を参照してください。

3. Webペイウォールを作成する

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

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

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

オプション A: AIで生成する

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

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

• Environment: Production または Sandbox を選択します。Sandbox は Stripe のテストモードプロダクトを使用し、開発環境やローカル環境ではこちらが安全なデフォルトです。
• Plans: Stripe のプランを最大 3 つ選択します（各プランはプロダクト＋価格の組み合わせです）。これらが、生成されたペイウォールでチェックアウト時にユーザーに提示されるオファーになります。

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

オプションB: 独自のホスト済みペイウォールを使用する

1. Enter URL manuallyを選択します。

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

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

3. 保存して公開します。

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

4. AIでキャンペーンを生成する

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

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

4. Generate emails をクリックします。
5. 生成ダイアログに入力します。トーン、言語、任意のカスタムプロンプト（最大2,000文字）、メール数（1〜15件、デフォルト4件）を設定します。各フィールドの詳細はキャンペーンを作成するを参照してください。

6. Generateをクリックします。生成には通常数分かかります。完了できない場合は5分後にタイムアウトするので、その場合は再試行してください。
7. 各メールをプレビューで確認します。プレビューのヘッダーにはTheme toggle（Auto・Light・Dark）があり、プレビューの表示方法を切り替えられます。なお、生成されたコンテンツ自体はどのモードでも同じです。メールを個別に再生成したり、文章を編集したり、HTMLエディターを開いて細かく調整したりすることもできます。

8. Createをクリックしてキャンペーンを保存します。 キャンペーンは下書きとして保存され、まだ送信されません。キャンペーンはフローに紐付けられたときにのみ有効になります（次のステップ）。キャンペーンエディター内に「公開」という独立したアクションはありません。

5. フローを起動する

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

1. Adapty Mail で Flows に移動し、設定したいトリガーを開きます：

   • Never purchased — サインアップしたがまだ購入していないユーザー。
   • Renewal cancelled — 自動更新をオフにしているが、まだアクティブなサブスクリプションを持つユーザー。
   • Billing issue — 支払い失敗、カード拒否・期限切れ、またはグレース期間中のユーザー。
   • Expired — サブスクリプションが失効し、アクセスが失われたユーザー。
   • Refunded — 購入後に返金を申請したユーザー。

   各トリガーの目的とトーンについては、フローを参照してください。

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

3. ダイアログで以下を設定します：
   • Segment を選択します（例：All Users でこのトリガーに到達した全員を対象にする、またはプロファイル属性に基づいて新しいセグメントを作成する）。
   • コンテンツタイプは Campaign のままにします（A/B テストオプションについては A/B テスト を参照してください）。
   • ステップ 4 で保存した Campaign を選択します。
4. Save をクリックします。

フローはすぐに有効になります — 別途起動する手順はありません。この時点から、セグメントに一致するユーザーはトリガーイベントに到達した時点でキャンペーンの受信が始まります。

6. 送信を有効にする

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

このステップはステップ 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 に送信します。これらのイベントにより、セグメントのメンバーシップ、キャンペーンのルーティング、およびユーザーがコンバートしたときにシーケンスを一時停止するストップ条件が機能します。

トラブルシューティング

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

詳細情報

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