メインコンテンツへスキップ
Turnint AI のエージェントウィジェットは、ページ上で検出されたアナリティクスツールへセッションイベントを自動で送信します。追加のコード記述は不要です。

​
仕組み

ウィジェットがイベントを発火する際、window 上に各アナリティクスツールのグローバル関数・オブジェクトが存在するかを検出し、見つかったすべてのツールへイベントを送信します。
GA4 (gtag) と GTM (dataLayer) は排他的に扱われます。gtag が検出された場合は GA4 のみに送信し、dataLayer への重複プッシュは行いません。これは gtag が内部的に dataLayer を使用するため、二重カウントを防止するためです。

​
対応ツール

ツール個別ページ
Google Analytics 4GA4
Google Tag ManagerGTM
Meta PixelMeta Pixel
SegmentSegment
MixpanelMixpanel
PlausiblePlausible
KARTEKARTE
BrazeBraze
PostHogPostHog
AmplitudeAmplitude
HeapHeap
HubSpotHubSpot
PendoPendo
FullStoryFullStory
RudderStackRudderStack

​
イベント一覧

すべてのイベント名は turnint_ プレフィックス付きのスネークケースで送信されます。
イベント名発火タイミング送信データ
turnint_startedセッション開始時{ type: "started" }
turnint_endedセッション終了時{ type: "ended" }
turnint_slide_viewedスライド閲覧時{ type: "slide-viewed", id }
turnint_action_executedアクション実行時{ type: "action-executed", actionId, actionLabel, actionExecType }
turnint_message_sentメッセージ送信時{ type: "message-sent" }
turnint_context_updatedゲート（フォームなど）を通じてユーザー情報が識別されたとき{ type: "context-updated" }
プライバシー保護のため、メッセージ本文やコンテキストの詳細などの機密データはアナリティクスツールには送信されません。アクションについても、ID・ラベル・実行タイプのみが送信されます。

​
Portal での設定方法

Portal を使用している場合、ダッシュボードからアナリティクスタグを注入できます。
  1. ダッシュボードの ポータル設定 を開く
  2. 詳細設定 セクションを展開
  3. ヘッドスクリプト に計測タグを貼り付ける
各ツールの具体的なタグについては、個別ページを参照してください。
ヘッドスクリプトには <script>, <link>, <meta>, <style>, <noscript> タグのみ使用できます。それ以外のタグは自動的に除去されます。

​
CustomEvent API

すべてのイベントは turnint:event という名前の CustomEvent としても発火されます。独自のリスナーを登録することで、任意のハンドリングが可能です。 
window.addEventListener("turnint:event", (event) => {
  const data = event.detail;
  console.log(data.type, data);
});