Googleアナリティクス4へデータを送信する方法
どのように動作するか
Googleアナリティクス4からユーザーの行動やランチャーの動作に関するデータをイベントとして受け取る場合、そのデータは以下の表に示すようなペイロードで送信されます。
| 寸法 | 説明 |
|---|---|
| Distrubution platform | ランチャーを開くために使用されたプラットフォーム。 可能な値： Xsolla、Steam。 |
| Language | ランチャーの言語。 |
| Page title | ランチャー画面。可能な値：Starting screen、Login screen、Game screen、Game store screen、Game news screen、Opened content screen、Settings screen、Custom tab screen。 |
| Platform game ID | プラットフォーム上のゲームID。プラットフォームがエクソーラの場合、パブリッシャーアカウントのプロジェクトIDが渡されます。 |
| Stream name | ランチャーネーム。 |
| Launcher project ID | パブリッシャーアカウントからのランチャープロジェクトID。 例： 147はhttps://publisher.xsolla.com/72209/projects/173640/new-launcher/147のプロジェクトIDです |
| Login project ID | ログインプロジェクトID。 |
| App version | ランチャーバージョン。 |
| Build number | ビルド番号。 例：ランチャーのバージョンが 3.0.49-latest.1の場合、ビルド番号は11です。 |
| Window size | ランチャーウィンドウのサイズ。 例： 800x600. |
| Screen resolution | 画面解析度。 |
| Operating system, Operating system with version, OS version. | ユーザーの操作システムを検出するためのユーザーエージェント。 |
| Publisher Account game ID | コンテンツが関連するゲームのパブリッシャーアカウントのID。コンテンツがゲームに関連していない場合、このフィールドは空白になります。 |
| City, City ID, Continent, Continent ID, Country, Country ID, Region, Region ID, Subcontinent, Subcontinent ID | 地理データ。 |
一般的なイベント
| イベント | 説明 |
|---|---|
| launcher_start | ランチャーが開始ています。更新後にランチャーが開始した場合は送信されません。 |
| close_app | ランチャーが閉じています。アップデート前にランチャーが終了した場合は送信されません。 |
UIイベント
| イベント | 説明 |
|---|---|
| page_view | ユーザーはランチャー画面を開きました。 |
| logout | ユーザーはログアウトをクリックしました。 |
ランチャー更新イベント
| イベント | 説明 |
|---|---|
| launcher_update_check_start | ランチャーが更新確認を開始します。 |
| launcher_update_check_complete | ランチャーは更新確認を終了しました。追加のvalueフィールドは、CDNでより新しいバージョンが見つかった場合はupdate_foundの値を持ちます。それ以外の場合はno_updatesとなります。 |
| launcher_update_check_skip | ユーザーはランチャー更新をスキップしました。 |
| launcher_update_download_start | ランチャーが更新内容のダウンロードを開始しました。 |
| launcher_update_download_complete | ランチャーが更新内容のダウンロードを完了しました。 |
| launcher_update_start | ランチャーが更新を完了しました。 |
| launcher_update_complete | ランチャーは成功に更新されました。 |
ゲーム所有権イベント
| イベント | 説明 |
|---|---|
| purchase | 購入ステータスの変更。追加フィールド： |
コンテンツイベント
| イベント | 説明 |
|---|---|
| content_view | 75%以上のコンテンツが表示されました。「グループ」ステータスを持つコンテンツの場合、イベントは送信されません。追加のフィールド：
|
| content_click | ユーザーがコンテンツ要素をクリックしました。 |
認証イベント
| イベント | 説明 |
|---|---|
| login | ユーザーはランチャーで正常に認証されました。追加のフィールド：
|
入手方法
- Googleアナリティクスに登録し、アカウントにログインしてください。
- Googleアナリティクスでカスタムディメンションを以下の表のように作成又は編集してください。
| フィールド | 寸法 | 範囲 | 説明 |
|---|---|---|---|
| analytics_target_game_id | Analytics Target Game ID | Event | パブリッシャーアカウントのIDまたはゲームのSteamアプリIDへのリンク。 |
| auth_type | Auth Type | Event | JWTで渡される認証オプション。可能な値：
|
| content_id | Content ID | Event | コンテンツタイルID。 |
| content_link | Content Link | Event | コンテンツタイプがリンクまたはビデオの場合のURLアドレス。 |
| content_name | Content Name | Event | 英語のコンテンツタイル名。 |
| content_type | Content Type | Event | コンテンツタイプ。可能な値：news、link internal、link external、video。 |
| distribution_platform | Distribution Platform | Event | ランチャーを開くために使用されたプラットフォーム。 可能な値： Xsolla、Steam。 |
| game_name | Game Name | Event | 英語のゲーム名。 |
| game_platform | Game Platform | Event | ゲームプラットフォーム。可能な値：Xsolla、Steam。 |
| build_number | Launcher Build Number | Event | ビルド番号。 例：ランチャーのバージョンが 3.0.49-latest.1の場合、ビルド番号は11です。 |
| launcher_project_id | Launcher Project ID | Event | パブリッシャーアカウントからのランチャープロジェクトID。 例： 147はhttps://publisher.xsolla.com/72209/projects/173640/new-launcher/147のプロジェクトIDです |
| app_version | Launcher Version | Event | ランチャーコードのバージョン。 例：ランチャーのバージョンが 3.0.49-latest.1の場合、ランチャーコードのバージョンは3.0.49-latestです。 |
| login_project_id | Login Project ID | Event | ログインプロジェクトID。 |
| platform_game_id | Platform Game ID | Event | プラットフォーム上のゲームID。プラットフォームがエクソーラの場合、パブリッシャーアカウントのプロジェクトIDが渡されます。 |
| publisher_account_game_id | Publisher Account Game ID | Event | コンテンツが関連するゲームのパブリッシャーアカウントのID。コンテンツがゲームに関連していない場合、このフィールドは空白になります。 |
| target_game_id | Target Game ID | Event | パブリッシャーアカウントのIDまたはゲームのSteamアプリIDへのリンク。 |
| window_size | Window Size | Event | ランチャーウィンドウのサイズ。 例： 800x600. |
- サイドメニューの「管理者」をクリックします。
- Googleアナリティクス4プロパティを作成します。
- データストリームを追加します：
- 「ウェブ」タイプを選択します。
- 「URL」フィールドに任意のURLアドレスを入力します。
- データストリームの設定の「測定ID」フィールドの値をコピーします。
- パブリッシャーアカウントでプロジェクトを開き、配信 > ランチャーセクションに移動します。
- ダッシュボードでランチャーを見つけて、「ランチャーを編集」をクリックします。
- 「設定 > 一般情報 > アナリティクス」に移動します。
- 測定IDを「Googleアナリティクス4測定ID」フィールドに貼り付けます。
- 「変更内容を保存」をクリックします。
この記事は役に立ちましたか？
ご意見ありがとうございました！
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。誤字脱字などのテキストエラーを見つけましたか？ テキストを選択し、Ctrl+Enterを押します。
