メインコンテンツへスキップ
Zenovaydocs
3分で読めます

自動キャプチャイベント

Zenovay は、計測対象のすべてのウェブサイトで 4 種類のインタラクションイベントを自動的に記録します。コードを追加したり zenovay('track', ...) を呼び出したりする必要はありません — 計測スクリプトが標準でこの 4 種類のキャプチャを処理します。

キャプチャされる内容

イベント記録される内容記録されない内容
動画再生の進捗
(HTML5、YouTube、Vimeo)		ソース URL、プロバイダ、マイルストーン (25 / 50 / 75 / 100 %)、再生時間動画の内容
フォーム送信フォームの ID、name、action URL、フィールド数フォームの入力値
ファイルアップロードファイルタイプ (例: application/pdf)、ファイルサイズファイルの中身
クリックCSS セレクタ、表示テキスト、遷移先 URL (アンカーの場合)入力値

各キャプチャの仕組み

1. 動画再生の進捗

ページ上のすべての <video> 要素について、Zenovay は timeupdate イベントを監視し、訪問者が 25 %、50 %、75 %、100 % のマイルストーンを超えたタイミングで video_progress イベントを発火します。マイルストーンは動画ごと・セッションごとに重複排除されるため、それぞれ最大 1 回だけ発火します。

YouTube と Vimeo の iframe は postMessage 経由でサポートされます — Zenovay は youtube.com、youtube-nocookie.com、player.vimeo.com からの状態変更メッセージを監視します。これはホストページが既に YouTube または Vimeo の iframe API を読み込んでいる場合に限り動作します。Zenovay はこれらの SDK をバンドルに含めません。

ライブ配信 (duration === Infinity のケース) では play と ended のみが発火し、マイルストーンは発火しません — 計測すべき固定の長さがないためです。

event_data の形JSON
{
"video_src": "https://example.com/intro.mp4",
"video_title": "製品紹介",
"provider": "html5",
"milestone": 50,
"duration": 120,
"current_time": 60
}

provider は "html5"、"youtube"、"vimeo" のいずれかです。milestone は 25、50、75、100 のいずれかです。duration と current_time は秒単位です。

2. フォーム送信

Zenovay はすべての <form> の submit イベントにキャプチャフェーズのリスナーを追加します。ページ側のハンドラが preventDefault() を呼び出した場合でもイベントは発火します。記録されるフィールド:

  • form_id — <form> 要素の id
  • form_name — <form> 要素の name 属性
  • form_action — action 属性の URL
  • field_count — フォーム内で名前付けされた入力要素の数

入力値は一切読み取られず、送信もされません。

event_data の形JSON
{
"form_id": "newsletter",
"form_name": "newsletter-form",
"form_action": "https://example.com/api/subscribe",
"field_count": 2
}

対応する HTML 属性がフォーム要素に設定されていない場合、いずれのフィールドも null になり得ます。

3. ファイルアップロード

訪問者が <input type="file"> でファイルを選択すると、Zenovay は各ファイルの MIME タイプとバイト単位のサイズを含む file_upload イベントを発火します:

event_data の形JSON
{
"files": [
  { "type": "application/pdf", "size": 10485760 }
],
"count": 1
}

ファイルの中身は決して読み取られず、送信もされません — ブラウザが File インターフェースを通じて既に公開しているメタデータのみが対象です。

4. クリック

<button>、<a href>、[role="button"]、<input type="submit">、<input type="button"> 要素へのクリックは click イベントを発火します。汎用的な <div> や <span> へのクリックはキャプチャされません — インタラクティブな要素のみです。記録されるフィールド:

  • selector — その要素を一意に識別する短い CSS セレクタ (最大 200 文字)
  • text — 要素の表示テキスト (80 文字で切り詰め)
  • href — 遷移先 URL (アンカーの場合のみ)
  • tag — 要素のタグ名 ("BUTTON"、"A"、"INPUT")

Zenovay はテキスト・メール・パスワードの <input> 要素へのクリックをキャプチャしないため、入力値が記録されることは決してありません — トラッカーはこれらの要素にリスナーを設定していません。

event_data の形JSON
{
"selector": "button#signup-cta",
"text": "無料で登録",
"href": null,
"tag": "BUTTON"
}

このデータを確認できる場所

  • 訪問者単位: サイドバーの Behavior セクションにある Journeys を開く → 任意の訪問者をクリック → Timeline タブで自動キャプチャされた各イベントが専用のアイコン (Play、FileText、Upload、MousePointer) と共に表示されます。
  • 集計 (Pro+): Analytics タブに 2 つのウィジェットがあります — Video Performance (完了率による上位動画) と Form Performance (送信数による上位フォーム)。Free プランではアップグレードを促す表示になります。
  • 公開共有ダッシュボード: 共有トークン付き URL を持つ人は同じウィジェットを閲覧できます — 共有ビューにはプランによる制限は適用されません。

プライバシー

フォームの入力値、ファイルの中身、入力フィールドの値はブラウザの外に出ません。Zenovay はブラウザが既に公開しているメタデータ (フォーム構造、MIME タイプ、ファイルサイズ) のみを記録します。

トラッカーはエンドツーエンドで Sec-GPC: 1 (Global Privacy Control) シグナルを尊重します — GPC が存在する場合、行動的なエンリッチメントは実行されず、訪問者レコードにその旨が記録されます。

何が収集され何が収集されないかの完全な詳細は、プライバシーコンプライアンス を参照してください。

個別キャプチャの無効化

これら 4 つのキャプチャはデフォルトで動作します。現時点ではイベントごとのオプトアウトフラグはありません。コンプライアンス上の理由でいずれかを無効化したい場合は [email protected] までお問い合わせください — お客様のトラッキングコード単位で設定を適用できます。

関連トピック

このページは役に立ちましたか？