メインコンテンツへスキップ
ウィジェットが埋め込まれたページの URL に含まれるトラッキングパラメータ、および広告プラットフォームが設定する Cookie を自動的に検出し、セッションへの保存とリンクへの伝播を行います。追加の設定は不要です。

対応パラメータ

UTM パラメータ

広告クリック ID

クロスドメインパラメータ

CRM パラメータ

hubspotid は大文字小文字の揺れ(HubspotId 等)と、アンダースコア表記(hubspot_id)も自動的に正規化され、hubspotid として保存されます。HubSpot Contact ID を表す hs_contact_idhscontactid も同様に hubspotid として扱われます。
URL のクエリパラメータに加え、広告プラットフォームのタグ・ピクセルが設定する Cookie も自動的に読み取ります。 HubSpot のトラッキングスクリプトが設定する Cookie も自動的に読み取ります。
Cookie とクエリパラメータに同じキー名の値が存在する場合、クエリパラメータの値が優先されます。

データフロー

セッションへの保存

ウィジェットがセッションを開始する際、Cookie およびページ URL からトラッキングパラメータを抽出し、セッションコンテキストの sys.tracking に保存します。
保存されたトラッキングデータは以下から確認できます。
  • ダッシュボード — セッション詳細画面
  • Webhook — セッション開始イベントのペイロードに含まれます(Webhook 連携
トラッキングパラメータはページ訪問ごとに URL と Cookie から取得されます。ゲートの設定やフォーム入力とは独立して、常に自動的に保存されます。

リンクへの自動伝播

ウィジェット内に表示されるすべてのリンクに、検出されたトラッキングパラメータが自動的に付与されます。
  • リダイレクトアクション — 遷移先 URL にパラメータが追加されます
  • 埋め込みアクション — 埋め込み元の URL にパラメータが追加されます
  • エージェントの回答内リンク — 回答に含まれるリンクにもパラメータが追加されます
リンク先に同名のパラメータがすでに存在する場合は上書きしません。リンク側のパラメータが優先されます。

関連ドキュメント