Google Analytics連携

このページでは、Google Analyticsとの連携機能について説明します。

Google Analytics連携とは

Google Analytics連携は、metatellのルーム内でのユーザー行動をGoogle Analyticsで計測できる機能です。組織ごとにGoogle Analytics 4(GA4)の計測IDを設定することで、以下のようなデータをお客様のGoogle Analyticsアカウントで確認できるようになります。

ルームへの入室/退室
チャットやリアクションの利用状況
マイクの操作
アバターの選択
メディア(画像・動画)の表示
ルーム内リンクのクリック
トリガー(インタラクション)の実行

これにより、ルームの利用状況を定量的に把握し、コンテンツの改善やイベント運営に役立てることができます。

前提条件

Google Analyticsのアカウントを作成済みであること。
Google Analytics 4(GA4)のプロパティを作成済みであること。
GA4の計測ID(G-から始まる文字列)を取得済みであること。

備考

計測IDはGoogle Analyticsの管理画面から確認できます。詳しくはGoogle公式ヘルプを参照してください。

計測IDの設定方法

計測IDは組織の管理者のみが設定できます。

画面上部の組織タブから「組織設定」ボタンをクリックする。
組織設定画面の「Google Analytics」セクションにある「計測ID」フィールドに、GA4の計測IDを入力する。
「保存」ボタンをクリックして設定を保存する。

以下の動画で設定手順を確認できます。

警告

計測IDはG-で始まる英数字の形式(例: G-XXXXXXXXXX)である必要があります。旧形式のUA-で始まるIDには対応していません。

DebugViewで設定を確認する

計測IDを保存した後、正しくデータが送信されているかをリアルタイムで確認するには、Google AnalyticsのDebugViewを利用します。

Google ChromeにGoogle Analytics Debugger拡張機能をインストールする。
拡張機能のアイコンをクリックして有効化する(アイコンが「ON」の状態になる)。
metatellのルームにアクセスする。
Google Analyticsの管理画面で「管理」>「DebugView」を開く。
ルーム内で操作(入室、チャット送信、リンクのクリックなど)を行うと、DebugView上にイベントがリアルタイムで表示される。

DebugViewでは、各イベント名とそのパラメータを確認できます。カスタムイベント(load_room、chat、open_linkなど)が表示されていれば、計測IDの設定は正しく完了しています。

備考

DebugViewの詳細についてはGoogle公式ヘルプを参照してください。

計測IDの削除方法

Google Analyticsとの連携を解除したい場合は、計測IDのフィールドを空にしてから「保存」ボタンをクリックしてください。

計測されるカスタムイベント

metatellでは、ルーム内のユーザー行動に応じて以下のカスタムイベントがGoogle Analyticsに送信されます。

ルームの入退室

イベント名	説明
`load_room`	ルームページの読み込みが完了した際に送信される。
`enter_room`	ユーザーが3D空間に入室した際に送信される。
`join_room`	ユーザーがルームに参加した際に送信される。
`join_tour`	ユーザーが見学(ツアー)モードでルームに参加した際に送信される。
`exit_room`	ユーザーがルームから退室した際に送信される。

load_roomはページの読み込み、enter_roomは3D空間への入室、join_roomはルームへの参加をそれぞれ表します。これらのイベントを組み合わせることで、ルームの訪問者数や入室率、見学モードの利用状況を把握できます。

チャット

イベント名	説明	パラメータ
`chat`	テキストメッセージが送信された際に記録される。	`message_length`: メッセージの文字数
`chat2`	画像付きメッセージが送信された際に記録される。	`message_length`: メッセージの文字数
`group-chat:create`	グループチャットが作成された際に記録される。	`member_count`: 参加人数
`group-chat:send`	グループチャットでメッセージが送信された際に記録される。	`has_image`: 画像の有無、`message_length`: メッセージの文字数

備考

プライバシー保護のため、チャットの具体的な内容はGoogle Analyticsに送信されません。送信されるのはメッセージの文字数や画像の有無などのメタ情報のみです。

リアクション

イベント名	説明	パラメータ
`reaction`	ユーザーがリアクションや挙手を行った際に記録される。	`reaction_id`: リアクションの種類

マイク操作

イベント名	説明	パラメータ
`toggle_mic`	ユーザーがマイクのON/OFFを切り替えた際に記録される。	`mic_status`: `on`または`off`

アバター選択

イベント名	説明	パラメータ
`avatar_selected`	ユーザーがアバターを選択した際に記録される。	`avatar_id`: アバターのID、`avatar_name`: アバター名

メディアの表示

イベント名	説明	パラメータ
`media_modal_open`	ルーム内のメディア(画像・動画など)を表示した際に記録される。	`type`: メディアの種類(`image`/`video`/`rssBoard`など)

リンクのクリック

イベント名	説明	パラメータ
`open_link`	ルーム内のリンクがクリックされた際に記録される。	`clicked_name`: リンク名、`dest_url`: リンク先URL

ルーム内に設置したリンクのクリック率を把握し、コンテンツの効果測定に活用できます。

トリガー(インタラクション)の実行

イベント名	説明	パラメータ
`trigger_executed`	ルーム内のトリガーが実行された際に記録される。	`trigger_id`: トリガーのID、`trigger_type`: トリガーの種類、`trigger_phase`: 実行フェーズ(`click`/`enter`/`exit`/`event`)、`trigger_name`: トリガー名

トリガーの実行回数や種類を分析することで、ルーム内のインタラクション設計の改善に役立てることができます。

計測データの確認方法

計測IDの設定後、ユーザーがルームにアクセスすると自動的にデータが送信されます。データはGoogle Analyticsのリアルタイムレポートや各種レポート画面から確認できます。

備考

設定後、Google Analyticsのレポートにデータが反映されるまで数分から最大48時間程度かかる場合があります。