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購入ステータスの変更。追加フィールド：
  • currency — ISO 4217に基づく3文字の通貨コード。
  • value — 名目購入金額。
  • transaction_id — エクソーラのシステムの決済ID。
  • coupon — クーポンコード。
  • items — アイテムパラメータ。

コンテンツイベント

イベント説明
content_view75%以上のコンテンツが表示されました。「グループ」ステータスを持つコンテンツの場合、イベントは送信されません。追加のフィールド：
  • content_name — コンテンツID。
  • content_name — コンテンツ名。
  • content_type — コンテンツタイプ。
  • banner_type — バナータイプ。
  • target_game_id — パブリッシャーアカウントのIDまたはゲームのSteamアプリIDにリンクします。
  • content_link — コンテンツタイプがリンクまたは動画の場合のURLアドレス。
content_clickユーザーがコンテンツ要素をクリックしました。

認証イベント

イベント説明
loginユーザーはランチャーで正常に認証されました。追加のフィールド：
  • auth_type — 認証オプション。
  • method — 認証に使用されるソーシャルネットワーク。

入手方法

  1. Googleアナリティクスに登録し、アカウントにログインしてください。
  2. Googleアナリティクスでカスタムディメンションを以下の表のように作成又は編集してください。
フィールド寸法範囲説明
analytics_target_game_idAnalytics Target Game IDEventパブリッシャーアカウントのIDまたはゲームのSteamアプリIDへのリンク。
auth_typeAuth TypeEventJWTで渡される認証オプション。可能な値：
  • social — ソーシャルログイン。
  • phone — 電話番号に送信されるワンタイムコードによるパスワードなしのログイン。
  • email — 電子メールに送信されたワンタイムコードによるパスワードなしのログイン。
  • xsolla_login — エクソーラログインデータストレージを使用した、ユーザー名/メールアドレスとパスワードによるクラシックログイン。
  • firebase — Firebaseデータストレージを使用したユーザー名/メールアドレスとパスワードによるクラシックログイン。
  • playfab — Playfabデータストレージを使用したユーザー名/メールアドレスとパスワードによるクラシックログイン。
  • proxy — カスタムデータストレージを使用したユーザー名/メールアドレスとパスワードによるクラシックログイン。
  • device — デバイスIDでログイン。
  • server_custom_id — カスタムID（サーバー上で生成されたユーザーID）でログイン。
content_idContent IDEventコンテンツタイルID。
content_linkContent LinkEventコンテンツタイプがリンクまたはビデオの場合のURLアドレス。
content_nameContent NameEvent英語のコンテンツタイル名。
content_typeContent TypeEventコンテンツタイプ。可能な値：news、link internal、link external、video。
distribution_platformDistribution PlatformEventランチャーを開くために使用されたプラットフォーム。
可能な値：Xsolla、Steam。
game_nameGame NameEvent英語のゲーム名。
game_platformGame PlatformEventゲームプラットフォーム。可能な値：Xsolla、Steam。
build_numberLauncher Build NumberEventビルド番号。
例：ランチャーのバージョンが3.0.49-latest.1の場合、ビルド番号は11です。
launcher_project_idLauncher Project IDEventパブリッシャーアカウントからのランチャープロジェクトID。
例：147はhttps://publisher.xsolla.com/72209/projects/173640/new-launcher/147のプロジェクトIDです
app_versionLauncher VersionEventランチャーコードのバージョン。
例：ランチャーのバージョンが3.0.49-latest.1の場合、ランチャーコードのバージョンは3.0.49-latestです。
login_project_idLogin Project IDEventログインプロジェクトID。
platform_game_idPlatform Game IDEventプラットフォーム上のゲームID。プラットフォームがエクソーラの場合、パブリッシャーアカウントのプロジェクトIDが渡されます。
publisher_account_game_idPublisher Account Game IDEventコンテンツが関連するゲームのアドミンページのID。コンテンツがゲームに関連していない場合、このフィールドは空白になります。
target_game_idTarget Game IDEventパブリッシャーアカウントのIDまたはゲームのSteamアプリIDへのリンク。
window_sizeWindow SizeEventランチャーウィンドウのサイズ。
例：800x600.
  1. サイドメニューの「管理者」をクリックします。
  2. Googleアナリティクス4プロパティを作成します。
  3. データストリームを追加します：
    1. 「ウェブ」タイプを選択します。
    2. 「URL」フィールドに任意のURLアドレスを入力します。
  4. データストリームの設定の「測定ID」フィールドの値をコピーします。
  5. パブリッシャーアカウントであなたのプロジェクトを開きます。
  6. サイドメニューで「ランチャー」を開きます。
  7. ダッシュボードでランチャーを見つけて、「ランチャーを編集する」をクリックします。
  8. 「設定 > 一般情報 > アナリティクス」に移動します。
  9. 測定IDを「Googleアナリティクス4測定ID」フィールドに貼り付けます。
  10. 「変更内容を保存する」をクリックします。
この記事は役に立ちましたか？
ありがとうございます！
改善できることはありますか？ メッセージ
申し訳ありません
この記事が参考にならなかった理由を説明してください。 メッセージ
ご意見ありがとうございました！
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。
このページを評価する
このページを評価する
改善できることはありますか？

答えたくない

ご意見ありがとうございました！
最終更新日: 2024年1月22日

誤字脱字などのテキストエラーを見つけましたか？ テキストを選択し、Ctrl+Enterを押します。

問題を報告する
当社は常にコンテンツを見直しています。お客様のご意見は改善に役立ちます。
フォローアップ用のメールをご提供してください
ご意見ありがとうございました！