Adapty Mailを始める

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

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

1. データを接続する
2. 送信ドメインを設定する
3. ウェブペイウォールを作成する
4. AIでキャンペーンを生成する
5. フローを起動する
6. 送信を開始する

始める前に

始める前に、以下を準備してください：

• DNS アクセス: ルートドメインにレコードを追加できること。
• 決済: サブスクリプションプロダクトが設定済みの Stripe アカウントを持っていること。別のプロバイダーを使用する場合は、チェックアウトを自分でホストしてください — チェックアウトの設定を参照してください。

1. データを接続する

Adapty Mail が機能するには、購入履歴（メールが各コンバージョンを促した際にその収益を紐づけるため）、安定したユーザー識別子、そして各ユーザーのメールアドレスが必要です。データがすでに存在する場所に合ったエントリーポイントを用意してください。残りのセットアップが受信データに対応できるようになったら、ステップ 6 でタップを開きます：

• Adapty: アプリが Adapty SDK を使用している場合は、ユーザー識別とメールの収集を設定してください。インテグレーション自体はまだオフのままにしておきます。フローが作成されるまで、Adapty Mail によってブロックされます。詳細はAdapty と Adapty Mail を接続するを参照してください。
• Adapty Mail API: バックエンドが信頼できる情報源である場合は、Settings からシークレットキーを取得してリクエストを作成してください。ただし、まだ送信しないでください。セットアップが完了する前に受信したプロファイルには何も送信されません。詳細はAdapty Mail API を使ったメールとトランザクションの送信を参照してください。

複数のエントリポイントを同時に使用することができます。Adapty Mail はcustomer_user_idとメールアドレスで受信データを照合するため、複数のソースから情報が届いた場合でも、1つのプロファイルと1つのシーケンスにまとめられます。

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

Adapty Mail を開きます。ヘッダーの Adapty ロゴをクリックして、Mail を選択してください。

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

1. Adapty Mail で Settings → DNS に移動し、Email domains セクションの Add domain をクリックします。
2. Domain フィールドに、ルートドメイン（例：yourapp.com）を入力します。受け付けるのは apex ドメインのみで、app.yourapp.com のようなサブドメインは入力時に拒否されます。
3. Sending subdomain フィールドに、メール送信元のプレフィックスを入力するか、空白のままにして mail を使用します。メールは hello@mail.yourapp.com から送信されます。
4. Add domain をクリックします。

5. ドメインレジストラで、新しいドメインカードに表示されているすべての DNS レコードを追加します。レコードは3つのグループに分かれています。送信サブドメインの DKIM および MAIL FROM レコード、ドメインのウォームアップに使用するメールボックスのレコード、画像やトラッキングリンクを配信する go.yourapp.com のレコードです。各グループが何を認証するかについては、追加するレコードを参照してください。まとめてエクスポートするには、Export をクリックします。
6. 必要に応じて、ルートドメインに推奨の DMARC TXT レコードを追加します（推奨）。
7. Check をクリックしてすぐに検証するか、カードを離れて Adapty Mail が DNS をポーリングするのを待ちます。

確認タイミングの概要：

• 自動ポーリング：ドメインを追加してから1分後に最初のチェックが実行され、レコードが見つかるまで最長1時間ごとになるよう間隔が2倍ずつ延びていきます。
• 手動チェック：Check をクリックすると、いつでも即時チェックを実行できます。
• DNS 伝播：通常は数分以内ですが、まれに最大48時間かかる場合があります。
• 確認ウィンドウ：7日間です。期限が切れても DNS レコードはそのまま残ります — Settings → DNS でドメインを再度追加すると、新しいウィンドウが開始されます。

送信を開始するには、認証済みドメインが1つあれば十分です。プロジェクトには最大5つまで登録でき、残りは後から追加できます。

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

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 を貼り付けます。Adapty Mail は受信者ごとにプレースホルダーを置換するため、チェックアウトページで訪問者を識別できます。例：

   https://example.com/paywall?email={email}&adapty_profile_id={adapty.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 に届いていない状態です。データの流れを開始することが最後のステップで、ステップ1で選んだエントリーポイントによって手順が異なります。

• Adapty: Adapty Mail で Settings → Project に移動し、Enable Adapty integration をクリックします。このボタンはステップ 5 が完了するまで無効化されており、「Set up at least one flow before enabling Adapty integration」 というツールチップが表示されます。詳細は Adapty を Adapty Mail に接続する をご覧ください。
• Adapty Mail API: プロファイルとトランザクションイベントの送信を開始します。このセットアップが完了する前に送信したプロファイルには何も送信されません。そのため、このステップは最後に行います。詳細は Adapty Mail API 経由でメールとトランザクションを送信する をご覧ください。

ここから、セグメントに一致するユーザーがトリガーを実行すると、すぐにキャンペーンを受け取ります。実際のユーザーを対象にする前に、テストユーザー1人を使ってフロー全体をテストしてください。

トラブルシューティング

詳細はこちら

• フローのテスト：ローンチ前に、テストユーザーでフロー全体を通して確認しましょう。
• Adapty を Adapty Mail に接続する：SDK のセットアップと、アプリでメールアドレスを収集していない場合のカバレッジ確保の方法。
• 送信ドメインの設定：DNS レコードの詳細、ウォームアップの段階的な設定、トラブルシューティング。
• チェックアウトの設定：チェックアウトファネルの構成とパーソナライズ。
• キャンペーン分析：配信、エンゲージメント、収益の追跡。
• A/B テスト：複数のシーケンスバージョンのテスト。