Adapty を Adapty Mail に接続する

Adapty は Adapty Mail のエントリーポイントの一つです。アプリがすでに Adapty SDK を使用している場合に活用できます。Adapty はプロファイル、メールアドレス、サブスクリプションイベントを Adapty Mail に渡し、Adapty Mail はそれらを使って受信者を選定し、各ユーザーをフローに振り分け、購入につながったメールに収益をアトリビュートします。

アプリが Adapty SDK を使用していない場合は、代わりにサーバーから同じデータを送信してください。詳細はAdapty Mail API を使用したメールとトランザクションの送信をご覧ください。

Important

正確な収益データを取得するには、最低限の設定として、オブザーバーモードで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、Firebase UID などの安定した ID を渡してください。SDK 起動時に .activate() の customerUserId として渡すか、後から（ログイン時など）Adapty.identify() を呼び出すことで設定できます。いずれの方法でも、ペイウォールを表示する前に ID を設定してください。Adapty はこの ID を使って、再インストールやログインをまたいで 1 人につき 1 つのプロファイルを維持します。また、Adapty Mail はこの ID をプロファイルの外部 ID として保存します。なお、Adapty Mail はメールアドレスで照合を行うため、この ID は照合には使用されません。

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

3. ユーザーのメールアドレスを収集する

ユーザーがアプリ内でメールアドレスを入力したら（例：サインアップ時やチェックアウト時）、email 属性を指定して updateProfile を呼び出し、Adapty に渡してください。キャンペーンの受信者全員にこの値が必要です。

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

Important

安定した 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 に移動し、Data integration セクションの Enable Adapty integration（すでに以前のセットアップからインテグレーションが存在する場合は Enable）をクリックします。
リンクなし。このプロジェクトは Adapty Mail で自分で作成したもので、スタンドアロンアカウントまたは Adapty アカウントのどちらでも構いません。

Data integration セクションに Enable Adapty integration ボタンはありませんが、Adapty はキーさえあればプロジェクトにデータを送信できます。
1. Adapty Mail で Settings > Project に移動し、Secret key をコピーします。
2. Adapty ダッシュボードで Integrations > Adapty Mail に移動し、インテグレーションをオンにして、Secret Key にキーを貼り付けて保存します。

どちらの方法でも、Adapty 上で同じ連携が作成されます — Adapty Mail のボタンを使うと、シークレットキーが自動で入力されます。

有効にすると、Adapty はすべてのサブスクリプションイベント（新規サブスクリプション、更新、トライアル、コンバージョン、返金、請求エラーなど）を Adapty Mail に送信します。これらのイベントにより、セグメントのメンバーシップ、キャンペーンのルーティング、そしてユーザーがコンバージョンしたときにシーケンスを一時停止するストップ条件が機能します。

制限事項

匿名ユーザー: 安定した customer_user_id がない場合、アプリの再インストールやログアウトのたびに Adapty は新しいプロファイル ID を発行します。メールアドレスを提供する前に行った購入は、Adapty Mail のプロファイルに反映されず、古い ID に紐づいたままになります。その結果、収益・購入状態・セグメントのメンバーシップがすべて正確でなくなります。
メールアドレスを持たないユーザー: メールアドレスを提供していないユーザーに対して、Adapty Mail はプロファイルを一切作成しません。配信やアナリティクスから除外する対象そのものが存在しないため、単純に対象外となります。アドレスが登録された時点でプロファイルが作成され、配信対象になります。