Adapty を Adapty Mail に接続する
Adapty は Adapty Mail のエントリーポイントの一つです。アプリがすでに Adapty SDK を使用している場合に活用できます。Adapty はプロファイル、メールアドレス、サブスクリプションイベントを Adapty Mail に渡し、Adapty Mail はそれらを使って受信者を選定し、各ユーザーをフローに振り分け、購入につながったメールに収益をアトリビュートします。
アプリが Adapty SDK を使用していない場合は、代わりにサーバーから同じデータを送信してください。詳細はAdapty Mail API を使用したメールとトランザクションの送信をご覧ください。
正確な収益データを取得するには、最低限の設定として、オブザーバーモードでAdapty SDKをインストールし、App Serverサーバー通知を有効にする必要があります。
Adapty Mailがアプリに必要なものは3つあります。購入データ（各コンバージョンを発生させたメールに収益を紐付けるため）、安定したユーザー識別子、そしてユーザーのメールアドレスです。この3つをすべて設定したうえで、Adapty Mailでドメイン、チェックアウト、キャンペーン、フローを設定し、最後に送信をオンにしてください。
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（バックエンドのユーザーID、Firebase UIDなど）を渡してください。方法は2つあります。SDK起動時に.activate()のcustomerUserIdとして渡すか、後から（例：ログイン時に）Adapty.identify()を呼び出すかのいずれかです。どちらの方法でも、ペイウォールを表示する前にIDを設定してください。Adapty Mailがキャンペーン、クリック、購入を正しいプロファイルに紐づけるために、customer_user_idが使われます。
プラットフォームガイド: iOS、Android、React Native、Flutter、Unity、Kotlin Multiplatform、Capacitor。
3. ユーザーのメールアドレスを収集する
ユーザーがアプリ内でメールアドレスを入力したら（例：サインアップ時やチェックアウト時）、email 属性を指定して updateProfile を呼び出し、Adapty に渡してください。キャンペーンの受信者全員にこの値が必要です。
プラットフォームガイド: iOS、Android、React Native、Flutter、Unity、Kotlin Multiplatform、Capacitor
- 安定した
customer_user_idを必ず渡してください。匿名の識別子は使わないでください。ユーザーがアプリをアンインストールして再インストールした場合、Adapty はこの ID を使って再インストールを既存のプロファイルに紐付け、購入を正しいユーザーに帰属させます。 - メールアドレスを収集して Adapty に送信する前に、ユーザーから明示的な同意を得てください。対象市場における GDPR・CAN-SPAM などの規制への準拠はお客様の責任です。Adapty Mail が新しいアドレスごとに確認メールを送信してからマーケティングメールを配信するようにするには、ダブルオプトイン を有効にしてください。
メールのカバレッジを確認する
収集を実装したら、Adapty でカバレッジを確認しましょう：
- Customers → Profiles に移動します。
- メールが設定されているプロファイルでフィルタリングします。
最初のキャンペーンを開始する前に、アクティブユーザーの少なくとも 30〜50% のメールカバレッジを目標にしてください。100% を待つ必要はありません — 30% に達したらすぐに開始しましょう。後からメールを登録したユーザーは、条件を満たした時点でアクティブなキャンペーンに自動的に登録されます。
メールの収集方法
多くのアプリはデフォルトではメールを収集しません。アプリの現状に合わせたアプローチを選んでください。
| 戦略 | 最適なケース | 仕組み |
|---|---|---|
| 既存の認証 | 何らかのログイン機能を持つアプリ | ユーザー認証後にメールアドレスを取得済みなので、それを Adapty に渡すだけで済みます。 |
| ペイウォール前のメールゲート | 認証なしのアプリ（ヘルス、ウェルネス、占星術、フォトエディター等） | オンボーディングとペイウォールの間にメール入力画面を1つ追加します。ユーザーはすでに時間を投資しているため、コンバージョン率は通常70〜90%になります。 |
| Webペイウォールビルダーのチェックアウト | SDKの実装を最小限にしたい場合、またはWeb上でメールを取得する場合 | Webペイウォールビルダーの最初の画面でメールアドレスを収集し、Adapty に渡します。アプリ内ゲートが稼働する前にキャンペーンをクリックしたユーザーに有効です。 |
| オンボーディングのステップ | クイズ形式のオンボーディング（フィットネス、栄養、教育） | オンボーディングの2〜3ステップ目にメール入力を配置します。「パーソナライズされたプランをメールでお送りします」のように価値提供としてフレーミングし、スキップ可能にしないことが重要です。 |
| Adapty Mail API | Adapty SDK を使わずサーバーからメールを送信する場合 | Adapty Mail API の Save profile エンドポイントにプロファイルを送信します。詳細はAdapty Mail API を使ったメールとトランザクションの送信をご覧ください。 |
4. ドメイン、チェックアウト、キャンペーン、フローの設定
メールを送信するには、Adapty Mail に以下が必要です。
- 確認済みの送信ドメイン
- メールからリンクするチェックアウトページ
- 送信するキャンペーン
- 受信者を決定するフロー
これらすべてを Adapty Mail で設定してください。Adapty Mail を始めるガイドのステップ 3〜8 に従ってください。
5. 送信を有効にする
インテグレーションを有効にするのが最後のステップです。これにより、イベントの送信、セグメントのマッチング、メールの送信が開始されます。Mail プロジェクトが Adapty アプリに連携されているかどうかによって、有効にする方法が異なるだけで、届く内容は変わりません。
- Adapty アプリに連携済み。Adapty ダッシュボードから Mail を初めて開いたときに、Adapty がこのプロジェクトを自動的に作成しました。
Adapty Mail で Settings > Project に移動し、Adapty Integration セクションの Enable Adapty integration（以前のセットアップで統合が既に存在する場合は Enable）をクリックします。このボタンは、少なくとも1つのフローが存在するまで無効のままで、ツールチップには “Set up at least one flow before enabling Adapty integration” と表示されます。
-
Not linked。このプロジェクトは Adapty Mail でご自身が作成したものです — スタンドアロンアカウントでも、Adapty アカウントでも同様です。
Adapty Integration セクションは表示されませんが、Adapty はキーさえあればプロジェクトにデータを提供できます。
- Adapty Mail で Settings > Project に移動し、Secret key をコピーします。 2. Adapty ダッシュボードで Integrations > Adapty Mail に移動し、インテグレーションをオンにして、Secret Key にキーを貼り付け、保存します。
どちらの手順でも同じインテグレーションが作成されます。Adapty Mail のボタンを使うと、シークレットキーが自動で入力されます。
有効化すると、Adapty はすべてのサブスクリプションイベント（新規サブスクリプション、更新、トライアル、コンバージョン、返金、請求の問題など）を Adapty Mail に送信します。これらのイベントは、セグメントのメンバーシップ、キャンペーンのルーティング、およびユーザーがコンバージョンした際にシーケンスを一時停止するストップ条件を制御します。
制限事項
- 匿名ユーザー: 安定した
customer_user_idを持たないユーザーはキャンペーンを受け取ることができません。アカウント作成時やログイン時に識別することで、その後にメールアドレスを提供すればAdaptyのプロファイルと紐付けられます。 - メールアドレスのないユーザー: メールアドレスのないプロファイルはキャンペーン配信から除外され、キャンペーンの分析にも表示されません。メールアドレスを提供した時点で、以降のキャンペーンの対象となります。