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

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

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

始める前に

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

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

1. Adapty SDKを設定する

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

1. Adaptyで収益をトラッキングする。 最初のステップは、アプリ内課金がすでに実装されているかどうかによって異なります：

   • Adaptyでアプリ内課金をすでに実装している場合は、この段階で追加の作業は不要です。
   • 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. ユーザーのメールアドレスを収集する。 アプリ内でユーザーがメールアドレスを提供したら（たとえばサインアップ時やチェックアウト時）、emailアトリビュートを指定してupdateProfileを呼び出し、Adaptyに渡してください。キャンペーンのすべての受信者にはこの値が必要です。

   プラットフォームガイド: iOS、Android、React Native、Flutter、Unity、Kotlin Multiplatform、Capacitor。

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

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

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でドメインを再入力すると、新しいウィンドウが開始されます。

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

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

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

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

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

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

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

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

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

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ドロップダウンで、前のステップで追加したWebペイウォールを選択します。

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

6. Generateをクリックします。生成には通常数分かかります。完了できない場合は5分後にタイムアウトします — その場合は再試行してください。
7. 各メールをプレビューします。プレビューヘッダーにはテーマトグル（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 TestオプションはA/B テストで説明しています）。
   • ステップ4で保存したCampaignを選択します。
4. Saveをクリックします。

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

6. 送信を有効にする

この時点でキャンペーンは設定されていますが、まだ実際には送信されていません — サブスクリプションイベントを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に送信します。これらのイベントがセグメントのメンバーシップ、キャンペーンのルーティング、ユーザーがコンバートしたときにシーケンスを一時停止するストップ条件を駆動します。

トラブルシューティング

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

詳細情報

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