Google Analytics連携
neodigのサイト内検索・チャットボット・FAQページは、エンドユーザーの操作をGoogle Analytics（GA4）のイベントとして送信します。GA4上で購入などのコンバージョンと同じユーザー単位で扱えるため、検索やチャットを使ったユーザーの行動を、お客様自身のGA4で分析できます。
イベントは、設置先のページでGA4のタグ（gtag.js）またはGoogle タグ マネージャー（GTM）が動作している場合に送信されます。どちらも無いページでは何も送信せず、検索・チャットの動作にも影響しません。
このページでは、送信するイベントと、GA4で正しく計測できるようにするための設定を説明します。
送信するイベント
| イベント名 | 送信するタイミング | パラメータ |
|---|---|---|
view_search_results | サイト内検索の結果が表示されたとき | search_term、neodig_result_count |
neodig_search_result_click | 検索結果をクリックしたとき | link_url、neodig_position |
neodig_search_recommendation_click | おすすめコンテンツをクリックしたとき | link_url、neodig_position |
neodig_search_faq_click | 検索結果に表示されたFAQをクリックしたとき | neodig_position |
neodig_ai_overview_view | 検索結果ページにAIによる回答が表示されたとき | なし |
neodig_ai_overview_citation_click | AIによる回答内のリンク（引用元）をクリックしたとき | link_url |
neodig_chat_open | エンドユーザーがチャットを開いたとき | なし |
neodig_chat_message_send | チャットで質問を送信したとき | neodig_message_source |
neodig_chat_link_click | チャットの回答内のリンクをクリックしたとき | link_url、neodig_link_type |
neodig_chat_feedback | チャットの回答を評価したとき | neodig_evaluation |
neodig_faq_feedback | FAQページの「この記事は役に立ちましたか？」に回答したとき | neodig_evaluation |
view_search_results はGA4の推奨イベントです。GA4の「検索キーワード」でそのまま集計できます。
パラメータ
| パラメータ名 | 内容 |
|---|---|
search_term | 検索キーワード |
neodig_result_count | 検索結果の件数。0 は検索結果が0件だったことを表します。検索に失敗した場合は付きません |
link_url | クリックしたリンク先のURL |
neodig_position | クリックした項目の表示順位（1始まり） |
neodig_message_source | 質問の送り方。input（入力欄から送信）、initial_question（初期質問）、follow_up（関連する質問）、clarify（聞き返しへの回答） |
neodig_link_type | リンクの種類。answer（回答本文のリンク）、source（参照した情報源）、loading_page（回答の作成中に表示する確認中のページ） |
neodig_evaluation | 評価。positive（役に立った）、negative（役に立たなかった） |
GA4はパラメータの値を100文字までで記録します。100文字を超えるURLは、link_url に先頭の100文字が記録されます。
送信しない情報
チャットの質問・回答の本文と、FAQページの評価に添えられたコメントは、どのイベントにも含めません。氏名・連絡先・注文番号などが書かれることがあるためです。これらの内容は、neodigのダッシュボードのチャットログ・フィードバックログで確認できます。
GA4の設置方法ごとの対応
neodigは、ページで動作しているGA4のタグを見つけ、その設置方法に合った形でイベントを送信します。送信先は、ページで設定されているGA4のプロパティです。
| GA4の設置方法 | 必要な設定 |
|---|---|
| GA4のタグ（gtag.js）をページに直接設置 | 不要 |
| Nuxt・Next.js・React・Vue などのモジュールやプラグインで設置 | 不要 |
| WordPress などのCMSのプラグインで設置 | 不要 |
Google 広告のタグやGoogle タグ（GT- で始まるID）と一緒に設置 | 不要 |
| データレイヤーの名前を変えて設置 | 不要 |
| Partytown でタグを Web Worker で実行 | 不要 |
| タグを自社のドメインから配信（Google タグ ゲートウェイ など） | 不要 |
| Google タグ マネージャー（GTM）で設置 | GTMでの設定が必要 |
| Shopify のカスタマーイベント（ウェブピクセル）で設置 | 送信できません |
Shopify のカスタマーイベント（ウェブピクセル）で設置したGA4は、ページから切り離された環境で動作するため、neodigからはイベントを送信できません。
neodig_ で始まるパラメータをGA4のレポートや探索で使うには、どの設置方法でもカスタムディメンションの登録が必要です。
GTMとGA4のタグを両方設置しているサイト
ブラウザの開発者ツールのコンソールで typeof gtag を実行し、結果によって次のように扱われます。
"function"の場合: GA4のタグ（gtag.js）経由で送信します。GTMでの設定は不要です- それ以外の場合: GTMのデータレイヤーに追加します。GTMでの設定を行ってください
GTMでの設定
GTMで設置しているサイトでは、neodigはイベントをGTMのデータレイヤーに追加します（dataLayer.push）。GA4へ送るには、GTMで次の設定を行ってください。
- データレイヤー変数を作成する
「変数」>「ユーザー定義変数」>「新規」で、変数のタイプに「データレイヤーの変数」を選び、次のデータレイヤー変数名ごとに1つずつ作成します。
search_term、neodig_result_count、link_url、neodig_position、neodig_message_source、neodig_link_type、neodig_evaluation - トリガーを作成する
「トリガー」>「新規」で、トリガーのタイプに「カスタム イベント」を選びます。イベント名に
^(view_search_results|neodig_.+)$を入力し、「正規表現一致を使用」にチェックを入れます。 - GA4イベントタグを作成する
「タグ」>「新規」で、タグの種類に「Google アナリティクス: GA4 イベント」を選びます。
- 測定ID: お客様のGA4の測定ID
- イベント名:
{{Event}}（組み込み変数「Event」） - イベントパラメータ: 手順1で作成した変数を、同じ名前のパラメータに設定します（例: パラメータ名
link_url、値{{link_url}}） - トリガー: 手順2で作成したトリガー
- 公開する プレビューモードで検索やチャットを操作し、タグが配信されることを確認してから公開します。
neodigは、イベントごとに使わないパラメータを空にしてデータレイヤーへ追加します。前のイベントの値が後のイベントに付いて記録されることはありません。
カスタムディメンションの登録
neodig_ で始まるパラメータは、GA4でカスタムディメンションとして登録すると、レポート・探索・セグメントの条件に使えるようになります。GA4の「管理」>「データの表示」>「カスタム定義」>「カスタム ディメンションを作成」から、次のように登録してください。
| ディメンション名（例） | 範囲 | イベント パラメータ |
|---|---|---|
| 検索結果件数 | イベント | neodig_result_count |
| 表示順位 | イベント | neodig_position |
| 質問の送り方 | イベント | neodig_message_source |
| リンクの種類 | イベント | neodig_link_type |
| 評価 | イベント | neodig_evaluation |
search_term と link_url はGA4が標準で扱うパラメータのため、登録は不要です。カスタムディメンションは登録した時点以降のデータにだけ反映されます。
拡張計測「サイト内検索」の設定
GA4の拡張計測「サイト内検索」は、ページのURLに検索キーワードのパラメータ（q など）があると view_search_results を自動で送信します。neodigの検索結果ページは検索キーワードを q パラメータに持つため、拡張計測を有効にしたままだと検索1回につき view_search_results が2回記録されます。
GA4の「管理」>「データストリーム」> 対象のウェブストリーム >「拡張計測機能」の設定から、「サイト内検索」をオフにしてください。ほかのページでもサイト内検索の計測が必要な場合は、「詳細設定を表示」の「検索キーワードのクエリ パラメータ」から q を外してください。
FAQページとneodigで配信する検索ページ
FAQページとneodigで配信する検索ページは、お客様サイトとは別のドメインで配信されます。アクセス解析設定の「Google Analytics連携」でGA4の測定IDを設定すると、これらのページにGA4のタグが埋め込まれ、ページ上の検索・チャットボット・FAQの評価について、このページで説明したイベントが送信されます。測定IDは1つで、FAQページと検索ページの両方に使われます。
お客様サイトとこれらのページを行き来するエンドユーザーを同じユーザーとして計測するには、次の2つを設定してください。
- アクセス解析設定の測定IDに、お客様サイトと同じ測定IDを入力する
- GA4の「管理」>「データストリーム」> 対象のウェブストリーム >「タグ設定を行う」>「ドメインの設定」に、お客様サイトのドメインと、FAQページ・検索ページのドメインの両方を登録する（クロスドメイン測定）
動作確認
GA4の「管理」>「DebugView」、またはレポートの「リアルタイム」で、イベントが届いていることを確認できます。GTMを設置しているサイトでは、GTMのプレビューモードで確認すると、DebugViewにもイベントが表示されます。
- サイト内検索で検索し、
view_search_resultsが届き、neodig_result_countに件数が入っていることを確認します - 検索結果のリンクをクリックし、
neodig_search_result_clickが届くことを確認します - チャットを開いて質問を送信し、
neodig_chat_openとneodig_chat_message_sendが届くことを確認します