Heap Auto-Capture プロダクトアナリティクス Cookieコンセント統合ガイド：2026年パブリッシャー向けプレイブック
Heapがプロダクトアナリティクスのエコシステムで特異なのは、デフォルトの動作にある。Mixpanel、Amplitude、PostHogがパブリッシャーに重要なイベントのインストルメンテーションを求めるのに対し、Heapはすべてを自動でキャプチャし、アナリストがキャプチャされたストリームから遡及的にイベントを定義できる。このauto-captureモデルが製品の定義的な特徴であり、チームがHeapを選ぶ理由である。同時に、デフォルトのHeap展開がパブリッシャーが導入するほぼすべてのツールの中で最も広い行動データサーフェスを持つ理由でもある。すべてのクリック、タップ、スクロール、フォーム操作、ページ遷移、レイジクリックは、ページ読み込みからミリ秒以内に永続的な識別子と紐付けてキャプチャされる——つまり、それらの操作のすべてがコンセント義務を発生させる。良いニュースは、ContentsquareによるHeap買収以降、Heapがプロダクトアナリティクス空間で最も詳細なコンセントAPIの一つを提供していることだ。課題は、auto-captureサーフェス、アイデンティティレイヤー、Contentsquareとのセッションリプレイモジュールにわたってそれを正しく接続することにある。
HeapがコンセントをなぜAを必要とするか——そしてなぜその答えが通常のアナリティクスより広いか
デフォルトのHeap初期化は、ページの最初のペイントでいくつかのことを行う。永続的なユーザー識別子を含む_hp2_id.{envId}配下にファーストパーティCookieを設定し、セッション識別子を含む_hp2_ses_id.{envId}配下にセッションCookieを設定し、_hp2_props.{envId}配下にサンプルレートCookieを設定し、SDKが初期化されたことを示す_hp2_loadedマーカーを設定する。存在しない場合は識別子を生成し、リファラー、UTMパラメーター、クリック識別子とともに初回ページビューをキャプチャし、その識別子に対してすべての後続のインタラクション——クリック、タップ、フォーム変更、ルート変更、カスタムイベント、そしてContentsquare統合が有効な場合はセッションリプレイのためのレンダリング済みDOM差分全体——のリコーディングをすぐに開始する。
これらの活動はそれぞれ別個のコンセントゲートを要する。ユーザー識別子の保存は、ePrivacy指令第5条(3)に基づくストレージ・アクセス操作であり、EEA、英国、および同一基準を取り入れた管轄区域全体で、事前の、自由に与えられた、特定的な、インフォームドかつ曖昧さのないコンセントを必要とする。auto-captureイベントストリームのキャプチャは、識別子、IPアドレス、行動的痕跡の組み合わせが個人を特定するのに十分であるため、GDPRに基づく個人データの処理に当たる。セッションリプレイは、EDPBのセッションリプレイガイダンスに基づく別個のより厳格なカテゴリに位置する——リプレイはレンダリング済みDOMおよびマスクされていない入力フィールドをキャプチャし、汎用的なアナリティクスコンセントとは異なる明示的かつ詳細なコンセントを必要とする。CCPAおよびCPRAは、パブリッシャーがHeapとの適切なサービスプロバイダー契約を持っていない限り、同じ処理を販売または共有として扱う。
Heapがコンセント前に書き込むもの——抑制すべきこと
HeapダッシュボードとともにリリースされるスタンダードなQuickstartは、トラッキングスニペットをページの<head>に直接インストールする。これは文書通りに動作するが、Heap展開における最も一般的なコンプライアンス障害の原因でもある——スニペットはCookieバナーがレンダリングされる前に実行され、_hp2_ CookieはミリセカンドAnd以内に書き込まれ、auto-captureストリームはユーザーがのちに決定することに関わらずheapanalytics.comに流れ始める。このパターンについて判断を下したすべてのヨーロッパの規制当局は同じ結論を出している：コンセント前に設定されたCookieは違法であり、パブリッシャーが責任を負う。
したがって、コンプライアントな統合は、関連するコンセントカテゴリが付与されるまでHeapスニペットがロードされるのを防がなければならない。本番環境で機能する2つのパターンは、条件付きスクリプトインジェクション——CMPがコンセントを通知した後にのみスニペットをDOMに追加する——と、heap.load(appId, { disableTextCapture: true, secureCookie: true, autocapture: false })でスニペットを遅延ブートストラップとしてプリロードし、コンセントが記録された後にheap.startAutoCapture()を呼び出すパターンだ。条件付きインジェクションパターンはよりクリーンで、現在Heapドキュメントが推奨するものだ。遅延ブートストラップパターンは、パブリッシャーがアイデンティティスティッチングのために安定したグローバル参照を必要とするが、コンセント前にauto-captureが発火することを許可できない場合に適している。
Heapが書き込むCookieとストレージ
Heapスニペットは初期化時に以下の識別子を書き込む——これらはすべて非必須でコンセントが必要だ：ユーザー識別子を含む14ヶ月有効期限の_hp2_id.{envId}、30分のセッション有効期限の_hp2_ses_id.{envId}、サンプルレートとプロパティ伝播のための_hp2_props.{envId}、ロードマーカーとしての_hp2_loaded。Contentsquare統合セッションリプレイモジュールは、数秒ごとにHeapエンドポイントにフラッシュされるインメモリ記録バッファを追加し、小さなリプレイセッション識別子を別途保存することがある。したがって、コンセントの撤回は_hp2_ Cookieを期限切れにし、ユーザーの以前の記録とイベントストリームについてHeapのGDPR APIを通じて削除リクエストを送信する両方を行わなければならない。
HeapをコンセントフレームワークにマッピングAする
HeapはIAB TCFやIAB Global Privacy Platformをネイティブに実装していない——広告技術ベンダーではなく、ファーストパーティのプロダクトアナリティクスプラットフォームだ——しかし、パブリッシャーサイドのブリッジングを通じてGoogle Consent Mode v2と統合し、ネイティブのオプトインとオプトアウトAPIを公開し、コンセントステータスに関わらず動作するセンシティブプロパティの編集レイヤーをサポートする。規制当局のレビューを通過するパターンは、各HeapモジュールをそれぞれのCMPシグナルに紐付けた別個のゲートとして扱う。
- auto-captureとコアイベントストリームはアナリティクス目的に紐付く。TCFの観点では、これは最も一般的に目的8（コンテンツパフォーマンスの測定）と目的1（情報の保存・アクセス）の組み合わせだ。Consent Modeではanalytics_storageにマッピングされる。
- Contentsquare統合によるセッションリプレイはより厳格な別個のゲートの背後にある——リプレイはレンダリング済みDOMとマスクされていない入力フィールドをキャプチャし、EDPBのセッションリプレイガイダンスは汎用的なアナリティクスとは異なる明示的かつ詳細なコンセントが必要なカテゴリとして扱う。
- heap.identify()によるユーザー識別は、ユーザーが匿名の場合、正当な利益のもとで一時的なセッション識別子で実行できる。しかし、セッション間で永続的なファーストパーティ識別子に識別を紐付けることは、アナリティクスと同じコンセントを必要とする——その時点で識別子が追跡可能なユーザーレベルのデータポイントになるからだ。
- アイデンティティAPIを通じたクロスサイトまたはクロスプロダクトのアイデンティティ伝播は、プロダクトアナリティクスからユーザーレベルのマーケティングアトリビューションへの境界を越えるため、マーケティングゲートが必要だ。
機能する統合パターン
参照実装には4つの部分がある：リアルタイムコンセント変更イベントを公開するCMP、auto-captureを無効にしてHeapをロードする遅延ブートストラップ、関連ゲートが開いたときにauto-captureをオンにしてセッションリプレイバッファを開始するコンセントリスナー、そしてheap.resetIdentity()を呼び出し、auto-captureを停止し、_hp2_ Cookieを期限切れにし、HeapのGDPRエンドポイントを通じて削除リクエストをディスパッチする撤回パスだ。
Web実装
Webでは、最もクリーンなパターンはHeapスニペットを条件付きでロードすることだ——<script>タグはアナリティクスカテゴリが付与された後にのみインジェクトされる。CMPのコンセント変更イベントにサブスクライブする。アナリティクスカテゴリがtrueに変わったら、secureCookie: true、完全なauto-captureのためのdisableTextCapture: false、および環境固有の設定でHeapスニペットをインジェクトする。セッションリプレイコンセントがtrueに変わり、Contentsquare統合が有効な場合、リプレイバッファは自動的に起動する。いずれかのゲートが撤回したら、heap.resetIdentity()を呼び出し、次にHeapスクリプト要素を削除し、document.cookieで_hp2_ Cookieを期限切れにし、ユーザーの識別子についてGDPR削除APIを呼び出す。
センシティブプロパティのリダクション
Heapはコンセントステータスに関わらず動作するリダクションレイヤーを備えており、コンセントが付与された場合でもパブリッシャーは使用すべきだ。フォームフィールドのdata-heap-redact-text属性はキャプチャされたテキストコンテンツを抑制し、data-heap-redact-attributes属性は要素属性を抑制する。GDPRの特別カテゴリ規則とCCPAのセンシティブ個人情報の定義のもと、健康情報、財務情報、政府識別子、生体データ、正確な位置情報、または私的通信の内容をキャプチャする可能性のあるフィールドは、ユーザーのコンセントステータスに関わらずリダクション属性を使用しなければならない。フォームレベルで属性を設定するのが最も安全なパターンだ——開発者が個別にマークし忘れた新しいフィールドを追加した場合でも、フォーム全体を抑制する。
リージョン選択：EUとUS のデータレジデンシー
Heapは別個のEUとUSのインジェスションエンドポイントを運用している。EEAと英国のトラフィックにはEUエンドポイントが適切なデフォルトだ。インジェスション、処理、ストレージをEEA内に保ち、US地域のアナリティクス展開が持つSchrems IIエクスポージャーを低減する。エンドポイントはスニペット設定で設定され、遡及的に変更することはできない——既存のデータは最初にインジェストされた場所に留まる。Heapのロールアウトを計画しているパブリッシャーは、スケールアップ前にリージョンを確認し、プライバシーノーティスに選択を記録して、収集からストレージまでの法的根拠の連鎖をクリーンに保つ価値がある。
統合と監査証跡の検証
検証ステップは規制当局がチェックするものであり、パブリッシャーが最も頻繁にスキップするものだ。正しく統合されたHeap展開は、4つのテストを順番に通過しなければならない。まず、バナーが表示されているが選択がなされていないクリーンなブラウザセッションは、SDKファイルフェッチを超えたheapanalytics.comへのリクエストをゼロにし、document.cookieの_hp2_ CookieをゼロにしなければAならない。次に、アナリティクスを拒否することでその状態を維持——auto-captureなし、識別子なし、記録なし。3番目に、アナリティクスを受け入れることで、正しいSameSite属性を持つ期待される_hp2_id Cookieと設定済みリージョンエンドポイントに流れるイベントトラフィックが生成されなければならない。4番目に、コンセントの撤回は、さらなるauto-captureとリプレイをすぐに停止し、_hp2_ Cookieを期限切れにし、HeapのGDPR APIを通じて削除リクエストをトリガーしなければならない。
EDPBの2023年Cookieバナーガイドラインと更新された2026年タスクフォース優先事項に基づく監査証跡の期待は、パブリッシャーがHeapプロジェクト内の任意のイベントについて、それを生成したユーザーがキャプチャ時に有効なコンセントを与えていたことを証明できることだ。標準的なパターンは、heap.addUserProperties({ consent_version: 'v3', consent_ts: ts })を通じてコンセントバージョンとタイムスタンプをディスティンクトIDのユーザープロパティとして設定し、個々のイベントが特定のコンセントログエントリに追跡可能にすることだ。正しくゲートされた展開は、デフォルトでセンシティブフィールドを抑制するリダクション属性と撤回時に有効になる削除パスと組み合わさることで、HeapのAuto-captureモデルを規制上の集中リスクから、パブリッシャーのプロダクトアナリティクススタックの最も強力で防御可能な部分の一つへと変える。