FunnelFoxをAdapty Mailに接続する

FunnelFoxはAdapty Mailのエントリーポイントの1つです。FunnelFoxのウェブファネルでユーザーを獲得・課金している場合に使用してください。FunnelFoxにはすでにユーザーのメールアドレス、購入情報、サブスクリプションイベントが蓄積されているため、接続にSDK作業や独自リクエストは一切不要です。

この接続は一方向です。FunnelFox はデータを Adapty Mail にプッシュするのみで、キャンペーンを読み取ることはなく、メールを送信することもありません。

FunnelFox が送信する内容

プロファイルとメールアドレス: ファネルがメールを収集した場合。
識別子: 受信者の FunnelFox プロファイル ID と、ファネルが保持しているカスタムユーザー ID（存在する場合）。プロファイルページでは External Profile IDs の下に、FunnelFox 行と Custom 行として表示されます。
購入履歴: サブスクリプション、更新、買い切り購入。払い戻しはマイナス金額で届きます。
サブスクリプションイベント: キャンセル、再アクティベーション、請求の問題、有効期限切れ。これらが各ユーザーをフローに配置するイベントです。
プロファイル属性: 国、デバイス、OS、プラットフォーム、ロケール — この5つはすべてセグメントフィルターです。FunnelFox は後ろの4つをブラウザのユーザーエージェントから読み取ります。また、受信者がメールを受け取る時刻を設定するタイムゾーンも送信しますが、これはフィルターにはなりません。アプリバージョンは送信しないため、そのフィルターはファネルユーザーに対しては空のままです。
ファネルコンテキスト: プロファイルのカスタム属性として以下のキーで保存されます。
- fnlfx_funnel_id: メールを収集したファネル。
- fnlfx_session_id: ファネルセッション。
- fnlfx_experiment_id: ユーザーが参加していた場合のファネル実験。
- email_consent: ユーザーがファネルでメール受信に同意したかどうか。値はテキスト "true" または "false" なので、このフィールドへのセグメントフィルターはテキスト比較になります。

これらの値をチェックアウトページに渡すには、リンクにプレースホルダーを追加します（例：{custom_attribute.fnlfx_session_id}）。詳しくはプレースホルダーをご覧ください。

データはファネルイベント発生から約1分以内にAdapty Mailに届きます。

FunnelFox を接続する

まず Adapty Mail の設定を完了してください — Adapty Mail を始めるを参照してください。フローが存在しない限り、送信したメールは何も生成されません。

Adapty Mail で Settings > Project に移動し、Secret key をコピーします。
FunnelFox で Integrations > Adapty Mail に移動します。
キーを貼り付けて保存します。

FunnelFox 側の設定については、FunnelFox のインテグレーションガイドを参照してください。

連携後の動作

プロファイルページの External Profile IDs に FunnelFox の行が表示され、その人物に対して FunnelFox が使用している ID を確認できます。複数のソースから報告されたプロファイルには、それぞれのソースに対応する行が表示されるため、その人物を認識しているすべてのソースを把握できます。

チェックアウトリンクを手動で作成する場合、{funnelfox.external_profile_id} は FunnelFox 内の受信者のプロファイル ID に解決されます。利用可能なプレースホルダーの一覧はメール送信先をご覧ください。

別のエントリーポイントと併用する

FunnelFox と別のエントリーポイントを同時に使用できます。Adapty Mail はメールアドレスでユーザーを照合します。同じアドレスを報告する2つのソースは1つのプロファイルにまとめられ、異なるアドレスは customer_user_id が同一であっても別々のプロファイルとして作成されます。