ドキュメントメニュー

インタラクションと分析

受信者が投票に参加したり、フォームを送信したり、評価をタップしたりすると、そのインタラクションはMailInAppのホスティングされたエンドポイントによってリアルタイムに記録され、あなたのプロジェクトに帰属します。

インタラクションが届く仕組み

インタラクティブブロックは、フォールバックの考え方に沿って、2つの方法で記録エンドポイントに到達します:

  • リンク(普遍的)。 投票、評価、出欠(RSVP)のすべての選択肢は、どのメールアプリでも単純なリンクです。タップすると、そのアクションを確認して記録する軽量なホスティングページが開きます。単純なリンクは、テストしたすべてのメールアプリで機能します。
  • メール内でのフォーム送信(拡張)。 フォームとクイズはメール内にフォームを残し、フォームを送信できるアプリ(ウェブ版Gmailと、iOS・Android版Outlookアプリ)では、標準的なHTMLフォームエンコーディングを使ってメールから直接送信されます。送信後、受信者は自分が設定したページへリダイレクトされます。どのフォームにも下にウェブで回答するリンクが常に表示され、他のアプリの読者はライブビューで開けます。投票、評価、出欠はメールからフォームを送信することはなく、常に短い確認ページへのリンクです。

どちらの経路も同じデータを受け付けるため、受信者がどのクライアントを使ったかにかかわらず、結果は1か所に集約されます。

商品ブロックの今すぐ購入のクリックは唯一の例外です: 購入はStripe自身のホスティングされたチェックアウトページ上でしか完了できないため、このエンドポイントを通じては一切記録できません。それでも、金額、通貨、数量を伴うpurchaseイベントとしてここに記録されますが、それは購入者のクリックだけではなく、Stripeのwebhookが実際に決済の完了を確認した時点でのみです。

ボットやスキャナーからの保護

企業のセキュリティツールは、スキャンするすべてのメール内のすべてのリンクをプリフェッチします。単純なリンククリックだけで投票が記録されてしまうなら、投票結果はロボットで埋め尽くされてしまいます。MailInAppは、単純なGETに対しては何も記録しません: リンクを起点としたアクションには受信者による明示的な確認アクションが必要であり、ライブビューのインタラクションはフォーム送信を通じて記録されます。ライブビューのリンクを参照してください。

エンドポイントは必然的に公開されている(受信箱側で認証はできない)ため、すべてのペイロードはサーバー側で検証され、個人化された送信は、ライブビューのリンクを保護しているのと同じ署名付きトークンを通じて帰属付けられます — 偽造された、または不一致のトークンは拒否されます。

さらに2つの仕組みが結果の信頼性を保っています:

  • 受信者単位の重複排除。 1人の受信者自身の投票、評価、リビール、フォーム送信は1回だけカウントされます — 自分のリンクを再クリックしても(せっかちな二度タップ、再試行されたページ読み込み)何も起こらず、2件目として記録されることはありません。カルーセルのスライドを繰り返し閲覧することは意図的に重複排除の対象外です。ここでは繰り返しの閲覧は二重カウントではなく、意味のあるエンゲージメント信号だからです。
  • 匿名フラッド抑制。 キャンペーンのcampaignIdはメール自身のHTMLソースに丸見えの状態で存在するため、受信者トークンを一切持たないスクリプトが任意の投票を送信することを止めるものは何もありません。帰属先のない送信は、IPアドレスごと・キャンペーンごと・1分あたりで上限が設定されます。これはベストエフォートの網であり、精密な本人確認ではありません — 企業や無料メールの共有ネットワークでは、多くの本物の受信者が1つのIPの背後にいる場合があるため、正当な開封のバーストをブロックしないよう、上限は十分に緩やかに設定されています。

記録される内容

各インタラクションイベントは次の内容を記録します:

  • そのイベントが属するプロジェクト(キャンペーン)、
  • それを発生させたブロック(どの投票、どのフォームか)、
  • 値(選択されたオプション、送信されたフィールド、星の数)、
  • データソースでメールが個人化されていた場合の受信者の行 — 何人答えたかだけでなく、誰が答えたかがわかります、
  • タイムスタンプ。

アンケートのライフサイクル

プロジェクトには、締切日と/または回答数の上限を設定できます(送信設定と一緒に設定します)。いずれかに達すると、記録エンドポイントはそのプロジェクトの新しいイベントを受け付けなくなります — ライブビューはエラーを出す代わりにインタラクティブブロックを終了案内に切り替えます — 一方、締切前に収集済みのデータはすべてそのまま記録され続けます。回答とWebhookを参照してください。

クリックトラッキング

単純なリンク(ボタン、リンク付き画像、ソーシャルアイコン、リンク付きのカルーセルのスライド、スクラッチやスピン抽選の賞品リンク)は投票や評価ではありませんが、それでも知っておく価値があります。個人化された受信者リンク付きでメールが送信された場合、MailInAppはこれらの単純なクリックを、本来の遷移先に向かう途中でトラッキング付きのリダイレクトを経由させます。クリックが記録された後、受信者は追加のステップや遅延なく、設定したURLに到着します。受信者コンテキストのないメール(例:トランザクションAPI経由の自由形式の送信)は、代わりに遷移先へ直接リンクします。クリックを帰属付ける対象が何もないためです。

これらはそれぞれ別のリンクとしてトラッキングされます。カルーセルのスライドは1枚ずつ数えられるため、カルーセルがクリックされたことだけでなく、どの商品がクリックされたかもわかります。スクラッチカードのショップボタンは、表示された賞品の中にあってもカードの下にあっても、同じように数えられます。実験のユニーククリック率が数えるのは、これらのクリックです。

投票や評価と異なり、クリックは決して重複排除されません — 受信者が同じボタンを5回クリックすれば5クリックとして数えられます。ここでは繰り返しのクリックが二重カウントではなく意味のあるエンゲージメント信号だからです。結果はブロックごとのクリックヒートマップに集計されます — 回答とWebhookを参照してください。

結果表示とスライドの閲覧

スクラッチのカードを削る、スピン抽選のホイールを回す、カルーセルで別のスライドに移る、といった操作は受信者のメールアプリの中で起こります。これらのブロックには、結果表示やスライドの切り替えの瞬間にだけ読み込まれる小さな画像が入っています。MailInAppはその画像が読み込まれたときに結果表示やスライドの閲覧を記録しますが、それを行うのは一部のメールアプリだけです。

2026年10月に、主なメールアプリをテスト用の受信トレイで計測しました。

メールアプリ結果表示とスライドの閲覧
iPhoneのメール(Apple Mailのプライバシー保護あり)記録される
Thunderbird記録される
Gmail記録されない:Gmailはフォールバック(スクラッチオフの景品、スピン抽選の景品ボタン、最初のスライド)を表示し、削る・回す・スワイプの操作はありません
Outlook.com、iOS・Android版Outlook記録されない:同じフォールバックを表示します
Yahoo Mail記録されない:Yahooはスクラッチオフとスピン抽選を実行しますが、画像プロキシが結果表示用の画像を取得する方法がプリフェッチと区別できないため、カウントされません。カルーセルはここではフォールバックを表示します
MacのApple Mail、プライバシー保護なしのiPhoneのメール、Windows版Outlook、Samsung Email未計測

これらの数値を正直に保つためのルールがいくつかあります。

  • 結果表示が記録されていないことは「表示しなかった」ことを意味しません。 報告できないアプリの受信者も、フォールバックで景品を見ている可能性があります。MailInAppはその人を「表示しなかった」とは数えません。
  • 先読みは除外されます。 メールのほかの画像と同じタイミングでまとめて読み込まれた画像や、GmailやYahooの画像プロキシによる読み込みは、結果表示として数えません。
  • 数えるのは個人用リンクだけです。 結果表示とスライドの閲覧は、連絡先リストへの送信のように受信者ごとに個別のリンクを持つメールで記録されます。エクスポートしたHTMLでは記録されません。ホストされたライブビューでは常に記録されます。
  • 受信者ごとに1回です。 結果表示は1人・1カードにつき1回、スライドの閲覧は1人・1スライドにつき1回数えます。

インサイト › ブロックでは、スクラッチとスピン抽選ごとにリビールカードが表示されます。カルーセルごとに、最初のスライドより先へスワイプした人数も数えます。どちらも開封または操作したすべての人に対する割合で、結果表示やスワイプを報告できないアプリの人も母数に含まれるため、下限として読んでください。実験はもっと厳密です。観測された開封演出率は結果表示を報告できるアプリのメールだけを数え、結果ではその割合を結果表示の計測範囲として示します。

スクロール深度

ホスティングされたライブビューページは、受信者が読み進めながらどこまでスクロールしたか(ページの25%、50%、75%、100%)も報告します。これはMailInApp内で唯一、小さなスクリプトが動作する場所です。送信されるメール自体は必ず100%スクリプトフリーのままですが、ライブビューはもともと通常のホスティングされたWebページなので、そこでのスクロールリスナーは何も損ないません。マイルストーンはスクロール深度ファネルに集計されます。回答とWebhookを参照してください。

開封トラッキング

ダッシュボードから送信されるすべてのメールには、小さな不可視の開封トラッキングピクセルも含まれています。これにより、明示的なインタラクションに加えて、「開封したがエンゲージしなかった」と「一度も開封されていない」を区別する信号が得られます。回答ビューでは、インタラクションの一覧に混ぜず、受信者ごとの独立した開封済みインジケーター(最初の開封時刻)として表示されます。

これはベストエフォートの最低限の測定であり、精密な計測ではありません: Apple Mail Privacy ProtectionとGmailの画像プロキシは、受信者が実際にメッセージを開封したかどうかにかかわらず画像をプリフェッチまたはキャッシュするため、開封数は過小にも過大(誤検知)にもなり得ます。方向性を示す信号として扱い、絶対的な事実の源としては扱わないでください。

完了した回答

回答はそれぞれ、回答された時点で個別に記録されます。メールが2つ以上のブロックで回答を求める場合、MailInApp は受信者がそのすべてに回答した時点も記録します。これが完了した回答です。インサイトでは 完了 の段階と完了率として表示され、Webhook には response.completed が配信されます。完了率 を参照してください。

結果はどこにあるか

インタラクションデータはプロジェクトごとに収集され、3つの方法であなたに返されます:

  • 受信者ごとの回答 — ダッシュボードの回答ビューは、すべてのインタラクションを受信者ごとにグループ化し、データソースと結合して、何人が答えたかだけでなく誰が答えたかを表示します。回答とWebhookを参照してください。
  • Webhook — 各インタラクションは、届いた瞬間に自分のエンドポイントへプッシュでき、MailInAppから送られたものであることを検証できるよう署名されています。これも回答とWebhookで説明しています。
  • 受信者向けのライブ結果 — 投票ブロックは、受信者のホスティングされた結果ページでライブの結果を表示できます。

プライバシーに関する注記: MailInAppは、受信者が意図的に行ったインタラクション — 投票、送信、評価、結果表示、スライドの閲覧 — に加えて、上記の開封トラッキングピクセルを記録します。エンドポイントは、単純なリンクの取得時にそれ以外の付随的なトラッキングを一切記録しないよう設計されています。