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}。プレースホルダーを参照してください。

    FunnelFox のファネルに必要なのは fpid のみです。fsid パラメーターにセッションを渡さないでください。別のファネルに属するセッションを拾ってしまいます。

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

FunnelFox を接続する

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

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

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

連携後の動作

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

メールを FunnelFox ファネルに紐付けるには、fpid パラメーターに {funnelfox.external_profile_id} を渡してください。詳しくは FunnelFox ファネルへのリンク を参照してください。

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

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