コンテキストイベントは、ユーザーの行動から「今どんな状態か」を読み取り、自動でイベントを発生させる機能です。
通常のイベントが「ページを見た」「ボタンを押した」といった行動そのものを記録するのに対し、コンテキストイベントは行動の意味を捉えます。

機能の概要や設定の流れはコンテキストイベント（β版）の概要と設定例を参照してください。

本記事では、各コンテキストイベントの設定方法と仕様を説明します。
各イベントのサンプルは、実際のイベントデータの values.{イベント名} 部分を示しています。

ご注意ください

• 本機能はWebのみ対応しています。Appでは利用できません。
• SPAサイトでは正常に動作しません。 「SPAサイトとは何か？」については、SPAサイトにおける特別な計測タグ設置手順について を参照してください。
• 本機能はβ版です。今後、仕様が大幅に変わったり、提供を終了する可能性があります。終了する場合はあらかじめアナウンスしますが、ご注意ください。

共通設定

すべてのコンテキストイベントに共通する設定項目です。

ご注意ください

同じ種類のコンテキストイベントを複数設定する場合の注意

同じ種類のコンテキストイベント（例：「読了」を複数、「興味あり」を複数）を、計測ページ条件が重複する形で複数設定した場合、1つの設定からのみイベントが発生します。 他の設定は条件を満たしてもイベントが発生しません。また、どの設定からイベントが発生するかは保証されていません。

たとえば「読了」イベントを「スクロール率40%かつ30秒」と「スクロール率80%かつ60秒」の2つで作成し、同じページを対象にした場合、どちらか一方からしかイベントが発生しません。

同じページで複数の条件を計測したい場合は、指定要素までのスクロールでイベントを送信する方法やスクリプト接客でのイベント送信を検討してください。

なお、種類が異なるコンテキストイベント（例：「読了」と「興味あり」）を同じページに設定した場合は、それぞれイベントが発生します。この制限は同じ種類のイベント間でのみ適用されます。

ページ上のコンテキスト

設定画面の「ページ上のコンテキスト」に含まれるイベントです。
ページ上のユーザー行動（滞在時間、スクロール、クリック、テキスト表示など）をトリガーとして発生します。

興味あり

一定時間の滞在や複数回のスクロールを「該当ページに興味がある」と解釈して発生するイベントです。

設定項目

• スクロール回数：ページ表示後のスクロール回数

  • 最後のスクロールから500ms以上停止した場合に1回とカウントします

• 経過時間：ページ表示後の経過秒数

イベントサンプル

{
  "have_interest": {
    "title": "CX（顧客体験）プラットフォーム KARTE（カルテ）",
    "url": "https://karte.io/",
    "scroll_count": 10,
    "spend_time": 300
  }
}

読了

一定時間の経過やページ下部までのスクロールを「ページを読了した」と解釈して発生するイベントです。

設定項目

• スクロール率：ページ全体に対するスクロール到達率（0〜100で指定）

• 経過時間：ページ表示後の経過秒数

イベントサンプル

{
  "finish_reading": {
    "title": "CX（顧客体験）プラットフォーム KARTE（カルテ）",
    "url": "https://karte.io/",
    "scroll_rate": 90,
    "spend_time": 300
  }
}

離席

一定時間操作がないことを「ページから離席した」と解釈して発生するイベントです。

補足

この機能では「ページ閲覧後に一定時間以上操作がない」行動のみ計測できます。ブラウザタブを閉じる等の離脱行動は計測できません。

設定項目

• 経過時間：最後のスクロールからの経過分数

イベントサンプル

{
  "leave": {
    "title": "CX（顧客体験）プラットフォーム KARTE（カルテ）",
    "url": "https://karte.io/",
    "spend_time": 300
  }
}

検索

検索を実行したことを示すイベントです。

設定項目

• URLのクエリキーから取得（任意）：検索語が含まれるクエリパラメータのキー名。設定すると検索語をイベントデータに含められます

  • 例：検索結果URLが https://karte.io/?q=beer の場合、キーは q

イベントサンプル

{
  "search": {
    "title": "CX（顧客体験）プラットフォーム KARTE（カルテ）",
    "url": "https://karte.io/",
    "text": "beer"
  }
}

ランキングページ閲覧

ランキングページを閲覧したことを示すイベントです。

設定項目

なし（共通の計測ページ条件のみ）

イベントサンプル

{
  "view_ranking": {
    "title": "CX（顧客体験）プラットフォーム KARTE（カルテ）",
    "url": "https://karte.io/"
  }
}

ゴール前によくみるページ閲覧

ゴール前によくアクセスされるページを閲覧したことを示すイベントです。

設定項目

なし（共通の計測ページ条件のみ）

イベントサンプル

{
  "view_near_goal": {
    "title": "CX（顧客体験）プラットフォーム KARTE（カルテ）",
    "url": "https://karte.io/"
  }
}

クリック系イベント

指定した要素のクリックをトリガーとして発生するイベントです。

計測方法の詳細はコンテキストイベント（β版） クリック系イベントの設定方法を参照してください。

共通仕様

共通の設定項目

• CSSセレクターで取得：計測対象の要素を指定

• リンクのURL条件：リンクURLの条件を指定し、発生条件を絞り込み（「アイテム情報をチェック」を除く）

アイテムクリック

アイテム（商品・記事など）の要素をクリックした際に発生するイベントです。

イベントサンプル

{
  "click_item": {
    "item": "アイテム情報",
    "title": "元ページのタイトル",
    "url": "元ページのURL",
    "link": "遷移先のURL",
    "selector": "指定されたCSSセレクター"
  }
}

レコメンドアイテムクリック

レコメンドされたアイテムの要素をクリックした際に発生するイベントです。
設置場所ごとに計測設定を分けることで、レポートで各レコメンド枠の効果を比較できます。

イベントサンプル

{
  "click_recommend_item": {
    "item": "アイテム情報",
    "title": "元ページのタイトル",
    "url": "元ページのURL",
    "link": "遷移先のURL",
    "selector": "指定されたCSSセレクター"
  }
}

ランキングクリック

ランキング表示されたアイテムの要素をクリックした際に発生するイベントです。
ランキングの種類や場所ごとに計測設定を分けることで、レポートで効果を比較できます。

イベントサンプル

{
  "click_ranking_item": {
    "item": "アイテム情報",
    "title": "元ページのタイトル",
    "url": "元ページのURL",
    "link": "遷移先のURL",
    "selector": "指定されたCSSセレクター"
  }
}

アイテム情報をチェック

アイテムの詳細情報を確認する操作（「もっと見る」クリック、画像拡大、口コミ表示など）で発生するイベントです。

設定項目の差分

• リンクのURL条件：なし（CSSセレクターのみで指定）

イベントサンプル

{
  "check_item_info": {
    "item": "アイテム情報",
    "title": "元ページのタイトル",
    "url": "元ページのURL",
    "selector": "指定されたCSSセレクター"
  }
}

お気に入りに追加

アイテムをお気に入りに追加した際に発生するイベントです。お気に入りボタンのクリックを検知して計測します。

補足

お気に入り追加がクリック以外の操作で行われるサイトの場合は、サポートまでご相談ください。

イベントサンプル

{
  "favorite_item": {
    "item": "アイテム情報",
    "title": "元ページのタイトル",
    "url": "元ページのURL",
    "link": "遷移先のURL",
    "selector": "指定されたCSSセレクター"
  }
}

カートに入れる

アイテムをカートに追加した際に発生するイベントです。カート追加ボタンのクリックを検知して計測します。

補足

カート追加がクリック以外の操作で行われるサイトの場合は、サポートまでご相談ください。

イベントサンプル

{
  "cart_in_item": {
    "item": "アイテム情報",
    "title": "元ページのタイトル",
    "url": "元ページのURL",
    "link": "遷移先のURL",
    "selector": "指定されたCSSセレクター"
  }
}

表示テキストに関するイベント

画面上に特定のテキストが表示されたことを検知して発生するイベントです。

計測方法の詳細はコンテキストイベント（β版） 表示テキストに関するイベントの設定方法を参照してください。

共通仕様

共通の設定項目

• CSSセレクターで取得：テキストが表示される要素を指定

• テキスト値：検知対象のテキスト内容

• 判定方法：完全一致 / 部分一致

• 繰り返しチェック：画面読込後もテキスト値のチェックを継続するか指定

入力フォームエラー発生

入力内容にエラーがあり修正を求められている状況（会員登録画面の入力エラーなど）を示すイベントです。

イベントサンプル

{
  "input_form_error": {
    "item": "アイテム情報",
    "title": "ページタイトル",
    "url": "ページURL",
    "selector": "指定されたCSSセレクター",
    "text": "指定された要素のテキスト"
  }
}

検索結果0件

検索結果が0件で、ユーザーが期待した結果を得られていない状況を示すイベントです。

イベントサンプル

{
  "no_search_results": {
    "item": "アイテム情報",
    "title": "ページタイトル",
    "url": "ページURL",
    "selector": "指定されたCSSセレクター",
    "text": "指定された要素のテキスト",
    "search_word": "検索ワード"
  }
}

アイテム在庫なし

閲覧したアイテムが在庫切れで購入できない状況を示すイベントです。

イベントサンプル

{
  "item_is_out_of_stock": {
    "item": "アイテム情報",
    "title": "ページタイトル",
    "url": "ページURL",
    "selector": "指定されたCSSセレクター",
    "text": "指定された要素のテキスト"
  }
}

アイテム予約受付中

閲覧したアイテムが発売前で予約受付中の状態であることを示すイベントです。

イベントサンプル

{
  "item_is_on_preorder": {
    "item": "アイテム情報",
    "title": "ページタイトル",
    "url": "ページURL",
    "selector": "指定されたCSSセレクター",
    "text": "指定された要素のテキスト"
  }
}

セッション上のコンテキスト

設定画面の「セッション上のコンテキスト」に含まれるイベントです。
セッション全体を通じたユーザー行動をトリガーとして発生します。

頻繁に見ている

セッション内で同一ページを複数回閲覧したことを「頻繁に見ている」と解釈して発生するイベントです。

設定項目

• 同じページを閲覧した回数：セッション内で同一ページを閲覧した回数のしきい値

  • 画面読み込み時と画面アクティブ時（別タブから戻った時）にカウントします

イベントサンプル

{
  "view_frequently_item": {
    "title": "CX（顧客体験）プラットフォーム KARTE（カルテ）",
    "url": "https://karte.io/",
    "count": 5,
    "item": {
      "item_id": "A123",
      "name": "アイテム123番"
    }
  }
}