Adapty Mail を始める

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

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

アカウントタイプを選択する
データを接続する
ブランドを設定する
送信ドメインを設定する
会社の住所を追加する
ウェブペイウォールを作成する
AIでキャンペーンを生成する
フローを開始する
送信を開始する

Adapty Mail はオンボーディングチェックリストの進捗を追跡し、すべてのステップが完了すると非表示になります。

始める前に

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

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

アカウントタイプの選択

Warning

慎重に選んでください — Adapty Mail で自身で作成したプロジェクトは、後から Adapty にリンクすることができません。

アカウントタイプによって、Adapty Mail プロジェクトでできることが決まります:

	Adapty連携（推奨）	スタンドアロン
サインアップ	AdaptyアカウントでサインインしてMailを開きます。Adaptyはあなたのアプリに紐付いたプロジェクトを作成します。Adapty MailとSDK間のデータ交換は、セットアップの最終ステップまで無効になっています。購入情報をAdaptyに移行する必要はありません。トランザクションを報告するだけの簡単にセットアップできるオブザーバーモードで十分です。	メールアドレスとパスワードでAdapty Mailのみにサインアップします。Adaptyアカウントもアプリへのインストールも不要で、FunnelFoxまたはAPIを通じてデータを自分で持ち込みます。
チェックアウトページ（ステップ6）	AIで生成 — あなたのブランドに合わせたホスト型チェックアウトページでStripe決済が統合済み — またはご自身のホスト型ペイウォール	ご自身のホスト型ペイウォール
セグメント	Adaptyからインポート、またはMailで作成	Mailで作成
ブランド — メール生成の元となる情報：名前、ロゴ、カラー、トーン（ステップ3）	アプリのストアリストから自動で構築（リストがある場合）	貼り付けたストアURLから構築
購入データ（ステップ2）	Settings > Projectでワンクリック；FunnelFoxとAPIも利用可能	Adaptyダッシュボードまたはアプリへシークレットキーを貼り付け、またはAPI
チーム	チームメンバーはAdaptyカンパニーからMailを開くと参加できます；メール招待も可能	メール招待

2. データを接続する

Adapty Mail がユーザーにメールを送信するには、次のものが必要です。

メールアドレス: メールの送信先。
カスタマーユーザーID: ユーザーを一意に識別するID。Adapty はこれをユーザーのプロファイルに保存し、デバイスをまたいで同一ユーザーを認識します。設定しない場合、アプリの再インストールやログアウトのたびに新しいプロファイルが作成されます。
サブスクリプションイベントフィード: トライアル開始、更新、キャンセル、返金などのイベントがリアルタイムで送信されます。これにより、ユーザーの行動に基づいたターゲティングや、購入につながったメールへの収益の紐付けが可能になります。イベントフィードがない場合、ユーザーが受信できるシーケンスは「一度も購入したことがないユーザー向け」のものだけになります。

次の手順に従って、このデータの**エントリーポイント**を作成してください。

Adapty: アプリがすでに Adapty SDK を使用している場合はこちらを選択してください。Adapty がプロファイル、メールアドレス、サブスクリプションイベントを自動的に転送するため、独自のサーバーは不要です。アプリ側でユーザーの識別とメールアドレスの収集を追加してください。詳細は Adapty と Adapty Mail の連携をご覧ください。
Adapty Mail API: バックエンドがすでにこのデータを保持している場合、アプリに Adapty SDK が導入されていない場合、または他の場所からサブスクライバーをインポートする場合はこちらを選択してください。プロファイルとトランザクションイベントを自分でポストします。Settings > Project のシークレットキーでリクエストを認証します。詳細は Adapty Mail API でメールとトランザクションを送信するをご覧ください。
FunnelFox: FunnelFox のウェブファネルでユーザーの獲得・課金を行っている場合はこちらを選択してください。FunnelFox はメールアドレス、購入情報、サブスクリプションイベントをすでに保持しており、Adapty Mail に自動で転送します。SDK の対応もリクエストの記述も不要です。詳細は FunnelFox 連携ガイドをご覧ください。
複数の組み合わせ: 複数のエントリポイントを同時に使用することもできます。Adapty Mail は customer_user_id とメールアドレスで受信したユーザーデータを照合します。

Adapty Mail は、その他の設定が完了すると、メールの送信を開始します。

3. ブランドを設定する

Adapty Mail では、ブランドを設定しないとメールやウェブペイウォールを生成できません。ブランドには、Adapty Mail がアプリの外観やトーンに合わせるために必要な情報（名前、ロゴ、カラー、フォント、トーンオブボイス、機能、レビューなど）が保存されます。ストアのリスティング情報を提供すると、Adapty Mail がそこからブランドを構築します。

Adapty Mail で Brand を開きます。
ページにブランド情報が入力済みであれば内容を確認して次に進みます。Set up your brand 画面が表示されている場合は、以下の手順を続けてください。
Store でアプリのプラットフォームとして App Store または Google Play を選択し、ストアの掲載ページURLを貼り付けます。

Note

セットアップ画面で指定できるのは App Store または Google Play の掲載ページ URL のみです。ウェブからアプリへのファネルなど、ストア掲載ページのないアプリの場合は、続行する前に Adapty サポートにお問い合わせください。
Build my brand をクリックします。Adapty Mail がページを取得してレビューを解析し、ブランドボイスを推定します。通常は1分以内に完了します。
セクションの確認、手動編集、ランディングページやソーシャルメディアのソース追加については、ブランドを参照してください。

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

Adapty Mail はあなたのプライベートドメインからメールを送信します。DNS レコードを一度追加するだけで、すべてのキャンペーンが同じ確認済みドメインを使用します。

最初のドメインを登録するには、Adapty Mail で Settings > DNS > Email domains セクションに移動してください。

Domainフィールドに、ルートドメイン（例：yourapp.com）を入力します。頂点ドメインのみ受け付けており、app.yourapp.comのようなサブドメインは入力時に拒否されます。
Sending subdomainフィールドに、メール送信元のプレフィックスを入力するか、空のままにしてmailを使用します。メールはhello@mail.yourapp.comから送信されます。
Add domainをクリックします。
ドメインレジストラで、新しいドメインカードに表示されているすべての DNS レコードを追加します。レコードは3つのグループに分かれています：送信サブドメインの DKIM および MAIL FROM レコード、ドメインをウォームアップするメールボックスのレコード、画像とトラッキングリンクを配信する go.yourapp.com のレコードです。各グループが何を認証するかについては、追加するレコードを参照してください。すべてのレコードを一括で取得するには、Export をクリックします。
必要に応じて、ルートドメインに推奨の DMARC TXT レコードを追加します（推奨）。
Check をクリックして即時に確認するか、カードを離れて Adapty Mail が DNS をポーリングするのを待ちます。

確認タイミングの概要:

自動ポーリング: ドメインを追加してから1分後に最初のチェックが実行され、その後はレコードが見つかるまで最大1時間おきに間隔が倍増します。
手動チェック: Check をクリックすると、いつでも即時チェックを実行できます。
DNS 伝播: 通常は数分で完了しますが、まれに最大48時間かかることがあります。
確認ウィンドウ: 7日間。期限が切れても DNS レコードはそのまま残ります。新しいウィンドウを開始するには、Settings > DNS でドメインを再度追加してください。

確認済みのドメインが1つあれば、Adapty Mail の利用を開始できます。1つのプロジェクトにつき最大5つのドメインを登録でき、残りは後から追加できます。

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

5. 会社の住所を追加する

スパム防止法により、すべてのマーケティングメールには実際の住所の記載が必要です。Adapty Mail はすべてのキャンペーンメールのフッターにその住所を表示し、住所が入力されるまでキャンペーンの生成をブロックします。

Adapty Mail で Settings > Company に移動します。
Company address セクションで、Legal company name、Address line 1、City、Postal code、Country を入力します。Address line 2 と State / Region は任意です。
Save をクリックします。

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

メールのCTAをクリックした受信者は、webペイウォール（ブラウザ上のチェックアウトページ）に遷移します。すべてのキャンペーンはwebペイウォールにリンクしており、webペイウォールなしのキャンペーンはAdapty Mailに拒否されます。これはアプリ内のペイウォールとは異なります。ここでの購入はウェブ決済であり、App StoreやGoogle Playのトランザクションではありません。

選択肢は2つあります：

AIで生成: FunnelFoxを活用した内蔵ビルダーでペイウォールを生成します。生成されたペイウォールはStripeで決済を処理します。
独自のホスト型ペイウォールを使用: すでにホストしているページをAdapty Mailに指定し、任意の決済プロバイダーを使用できます。Adapty Mailはユーザーの詳細情報をURLに事前入力した状態でペイウォールにリダイレクトします。セルフホスト型ペイウォールはあらゆる決済プロバイダーに対応しています。

Note

AIによる生成にはStripeとAdaptyに連携したアカウントが必要です。生成されたチェックアウトがサポートするプロバイダーはStripeのみです。別のプロバイダーを使用している場合、またはAdapty Mailのスタンドアロンアカウントの場合は、独自のホスト型ペイウォールをご利用ください。

まず、Adapty Mailで Web Paywalls > Create に移動します。

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

このページには、順番に進めるべき前提条件チェックリストがインラインボタン付きで表示されます。すべての項目を確認してから生成に進んでください。チェックリストには、ペイウォールビルダーへのログイン、Stripeの接続、プロダクトの追加、および結果の確認が含まれます。完全なウォークスルーはチェックアウトの設定を参照してください。別のタブで前提条件を完了した場合は、チェックリストの Refresh をクリックしてステータスを同期してください。

すべての前提条件が緑色になったら、Proceed to generation をクリックします。Choose plans ダイアログでは：

プランを1〜3つ選択します。すべて同じ通貨で、それぞれが生成されたペイウォールでチェックアウト時に表示されるオファーです。2つ目・3つ目を追加するには Add plan をクリックします。
各プランについて、本番価格、サンドボックス対応価格、またはその両方を選択します。同じ行の本番価格とサンドボックス価格は1つのプランとして扱われます。
Generate paywall をクリックします。

プランごとに列をすべて入力するか、すべてのプランで空欄のままにしてください。列が一部しか入力されていない場合、生成がブロックされます。サンドボックス価格がない場合、テストメールは本番ペイウォールにリンクされ、テスト購入は機能しません。

Important

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

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

Enter URL manually を選択します。
プレースホルダーをクエリパラメーターとして含む、ホスト型ペイウォールの URL を貼り付けます。Adapty Mail は受信者ごとにプレースホルダーを置換するため、チェックアウトページで訪問者を識別できます。例：
```
https://example.com/paywall?email={email}&adapty_profile_id={adapty.external_profile_id}
```
作成ページには使用できるプレースホルダーの一覧が表示されます。各プレースホルダーの解決値については、チェックアウトの設定を参照してください。
保存して公開します。

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

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

キャンペーンとは、1人の受信者が時間をかけて受け取る最大15通のメールのシーケンスです。AIはステップ3で設定したブランドをもとに、コピー・デザイン・ヒーロー画像・パーソナライズされたチェックアウトリンクを含むシーケンス全体を作成します。

Adapty MailでCampaignsに移動し、Createをクリックします。
キャンペーン名を設定します。
Web paywallドロップダウンで、前のステップで追加したウェブペイウォールを選択します。
Generate emails をクリックします。
生成ダイアログに入力します — トーン、言語、任意のカスタムプロンプト（最大 2,000 文字）、メール数（1〜15 件、デフォルト 4 件）。各フィールドの詳細はキャンペーンの作成を参照してください。
Generateをクリックします。生成には通常数分かかります。完了できない場合は5分後にタイムアウトするので、その場合は再試行してください。
各メールをプレビューします。プレビューのヘッダーにはTheme toggle（Auto、Light、Dark）があり、プレビューの表示方法を切り替えられます。生成されるコンテンツ自体はどのモードでも同じです。個別のメールを再生成したり、コピーを編集したり、HTMLエディターを開いて細かく調整したりすることもできます。

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

キャンペーンは下書きとして保存され、まだ送信されません。キャンペーンは、フローに紐づけられたときに初めて有効になります（次のステップ）。キャンペーンエディターには「公開」操作はありません。

8. フローを起動する

Adapty Mail には独自のフローが含まれています。フローはトリガー（サブスクリプションイベント）とキャンペーン（メールシーケンス）を結びつけます。サブスクリプションの期限切れや支払い失敗など、5つのトリガーそれぞれに専用のフローがあります。フローはトリガーに該当した全員に1つのキャンペーンを送ることも、セグメントを使ってグループごとに異なるキャンペーンを送ることもできます。

Adapty Mail で Flows に移動し、設定したいトリガーを開きます:
- Never purchased — サインアップしたがまだ購入していないユーザー。
- Renewal cancelled — 自動更新をオフにしているが、サブスクリプションはまだ有効なユーザー。
- Billing issue — 支払い失敗、カードの拒否または期限切れ、またはグレース期間中のユーザー。
- Expired — サブスクリプションが失効し、アクセスがなくなったユーザー。
- Refunded — 購入後に返金を申請したユーザー。
各トリガーの目的とトーンのガイダンスについては、フローを参照してください。
Create をクリックしてダイアログを開きます。

ダイアログで以下を設定します：
- Segment を選択します。All Users はこのトリガーに到達したすべてのユーザーを対象とし、ローンチするにはこれで十分です。後でオーディエンスを絞り込む場合は、国、年齢、サブスクリプション状態などに基づいてユーザーをフィルタリングした別のセグメントを作成してください。
- コンテンツタイプを Campaign に設定します（A/B テストオプションについてはA/B テストをご確認ください）。
- ステップ 7 で保存した Campaign を選択します。
Save をクリックします。

フローは即時に公開されます。別途起動手順はありません。この時点から、セグメントに一致するユーザーがトリガーイベントを発生させると、すぐにキャンペーンを受け取り始めます。

Note

同じトリガーに複数の行を追加でき、それぞれに独自のセグメントとキャンペーンを設定できます。Adapty Mail は上から順にチェックし、最初に一致したセグメントを使用します。All Users は必ず最後に配置してください — それ以外の位置にあると Adapty Mail はフローを保存できません。

Tip

新しい受信者がマーケティングメールを受け取る前にアドレスの確認が必要な場合は、この手順の前にダブルオプトインを有効にしてください。有効にした後に作成されたプロファイルのみが確認を求められます。

9. 送信を開始する

キャンペーンの設定は完了していますが、まだ送信は始まっていません — ユーザーデータが Adapty Mail に届いていない状態です。選択したエントリーポイントからデータを流し始めましょう。プロジェクトが Adapty に連携されているかどうか（ステップ 1）によって変わるのは、Adapty フィードのオン/オフの切り替え方だけで、届くデータの内容は変わりません。

データの送信元	Mail プロジェクトが Adapty アプリに連携されているか	対応方法
Adapty SDK	はい	Adapty Mail で Settings > Project に移動し、Enable Adapty integration をクリックします。フロー（ステップ 8）が作成されるまでボタンは無効のままです。
Adapty SDK	いいえ	Adapty は連携されていないプロジェクトにもデータを送信できます。必要なのはキーのみです。Settings > Project からシークレットキーをコピーし、Adapty ダッシュボードの Integrations > Adapty Mail に貼り付けてください。
バックエンド（Adapty Mail API 経由）	どちらでも	プロファイルとトランザクションイベントの送信を開始してください。このセットアップが完了する前に送信したプロファイルには何も配信されません。そのため、このステップは最後に行います。
FunnelFox	どちらでも	Settings > Project からシークレットキーをコピーし、FunnelFox の Integrations > Adapty Mail に貼り付けてください。約 1 分以内にデータが届き始めます。

ここから、セグメントに一致するユーザーがトリガーを満たした時点でキャンペーンが配信されます。実際のユーザーを対象にする前に、テストユーザー1人でフロー全体をテストしてください。

トラブルシューティング

問題	解決策
Generate emails がグレーアウトしている	ブランドまたは会社の住所が未設定です。ボタンのツールチップに原因が表示されます。ステップ3とステップ5を参照してください
ペイウォールの生成がブロックされている	パネルに原因が表示されます：ブランド未設定、Stripeアカウント未接続、または価格が設定されたStripeプロダクトがない。修正後、Refreshでチェックリストを更新してください
キャンペーンを保存できない	すべてのキャンペーンにはウェブペイウォールが必要です。ステップ6で作成してください
Enable Adapty integration がグレーアウトしている	Adapty Mailには少なくとも1つのフローが必要です。ステップ8を参照してください
DNSレコードが検証されない	末尾のドット、CNAMEターゲット、1レコードあたりの値など、完全に一致しているか確認してください。DNSの反映には最大48時間かかる場合があります
検証ウィンドウの期限が切れた	Settings > DNS でドメインを再度追加して新しいウィンドウを開始してください。レジストラ側のレコードはそのまま有効です — 再追加は不要です
メール生成がタイムアウトした	生成は5分後に停止します。再試行し、繰り返し失敗する場合はAdaptyサポートにお問い合わせください

初期セットアップ以外のエラーについては、送信ドメインの設定とチェックアウトの設定のトラブルシューティングセクションを参照してください。

詳細はこちら

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