とっとるびー第49回発表資料(UnrealEngineのWindowデスクトップアプリでAnalytics)

UnrealEngineのWindowデスクトップアプリでAnalytics @mechamogera

自己紹介 • mechamogera • 主にQiitaで活動：https://qiita.com/mechamogera • 第２種電気工事士の勉強中 2

• https://qiita.com/mechamogera

今日お話しする内容 • Analytics利用の動機 • UnrealEngineのWindowsデスクトップアプリのAnalytics環境 • GameAnalyticsの利用 • GoogleAnalyticsの利用 3

最近の仕事 • UnrealEngineを使ったVRコミュニケーションサービス作成 • UnrealEngineとは • 3D制作プラットフォーム • C++で作成 • スタンドアロン(Quest2)ではなくPC VR(Quest Link)を利用 • 3Dモデル読み込みなどを行うのでマシンパワーが必要 • サーバーからのストリーミングは環境が整っていない • Windowsアプリ 4

Analyticsしたい • ユーザーの動向を分析したい 5

使えるAnalyticsサービスがほとんどない問題 • UnrealEngineのWindowsデスクトップ向け = WindowsのC++環境 • 一般的なAnalyticsサービスのメインターゲット： iOS、Android、Web • Windowsアプリ向けだとVisual Studio App Center Analyticsあり ただし、UWPアプリとかWPFアプリとかモダンな環境向け 6

UnrealEngineのAnalyticsのIF • Analytics用の共通的なIFがある • UE5.0以降の文書から消えている(実装はまだある) お蔵入り？ • https://docs.unrealengine.com/4.27/ja/TestingAndOptimization/A nalytics/ • 利用してみた所感： • サービス固有の内容をラップしきれてない サービスを変えるとごそっと変更がいる （Analyticsサービス間で共通性があまりなさそう、イベント名とか） • 設定値の読み取りとか共通部分はあるが無くても良い感じ 7

• https://docs.unrealengine.com/4.27/ja/TestingAndOptimization/Analytics/

UnrealEngineのAnalytics デフォルトで用意されているAnalytics • Apsalar：消えてる？ • Flurry：スマホ向け • ファイルロギング WindowsアプリサポートのAnalyticsサービスなし 8

GameAnalytics • 最初に使ったAnalytics • プラットフォーム無料 • UnrealEngineプラグイン無料、MarketPlaceから取得可 • 良くなかったところ • 自由にダッシュボードがカスタマイズできない • 利用ユーザーグループ毎にしかグラフが作れない （各ユーザーグループの利用状況を単一グラフで一覧したい） • サービスのバージョンアップでダッシュボードが吹っ飛んだ （旧UIに切り替えてやっと見れる） 9

GoogleAnalyticsへ • GoogleAnalytics利用したい • GoogleAnalyticsUniversalからGoogleAnalytics4への移行でGA4利 用必要 • UnrealEngine C++向けSDKは用意されていない • スマホ向けSDKは利用できていてUnrealEngineのMarketPlaceにはいくつ かプラグインがある 10

Measurement Protocol利用 • HTTPリクエストでAnalyticsデータをGoogleAnalytics4に送信可能 • Goolge Analytics Universalのものと比べて制限有 ほぼカスタムイベント記録用？ • そのせいでMarketPlaceにあったMeasurementProtocol利用のプラグイン は移行できてないらしい • https://unamedia.com/help/ue5-google-analytics/ga4-state 11

• https://unamedia.com/help/ue5-google-analytics/ga4-state

UnrealEngineのプラグイン作った • UnrealEngineからGA4 Measurement Protocolを利用できる • https://github.com/mechamogera/GoogleMeasurementProtocolAnalytics • UnrealEngine標準のHTTP通信とJSON生成のライブラリを利用 • UnrealEngineのAutomation Specでテスト書いた • https://github.com/mechamogera/GoogleMeasurementProtocolAnalytics/blo b/main/Plugins/GMPAnalytics/Source/GMPAnalytics/Spec/GMPAnalytics.spec .cpp • モック機能などはないので継承して実際にMeasumentProtocolを送信し ないように 12

• https://github.com/mechamogera/GoogleMeasurementProtocolAnalytics
• https://docs.unrealengine.com/5.3/ja/automation-spec-in-unreal-engine/
• https://github.com/mechamogera/GoogleMeasurementProtocolAnalytics/blob/main/Plugins/GMPAnalytics/Source/GMPAnalytics/Spec/GMPAnalytics.spec.cpp

イベント設計 • 共通パラメータ • group_name：利用ユーザーグループ種別 • イベント例 • 数値パラメータはvalue[数値]、文字パラメータはdimension[数値]で記 録 （カスタム指標やディメンションの制限数が結構厳しいので節約） イベント パラメータ名 パラメータ値 session_complete value1 最大プレーヤー数 value2 セッション時間(秒) value1 ファイルサイズ dimension1 [3Dデータの拡張子] dimension2 Success/Failure dimension3 Datasmith/PointCloud load_3ddata 13

Analyticsの可視化 • GoogleAnalytics自体ではカスタム イベントの可視化は限定的 • グラフのカスタマイズが限定 的 • レポートを自由に配置できな い • 無料で利用できるGoogleの LoockerStudioで可視化 • かなり自由にグラフ、レポー トを設定可 14

まとめ • 今日お話した内容 • • • • Analytics利用の動機 UnrealEngineのWindowsデスクトップアプリのAnalytics環境 GameAnalyticsの利用 GoogleAnalyticsの利用 • MeasurementProtocolの利用、プラグインの作成、LoockerStudioでの可視化 • UnrealEngineのC++環境ゆえの辛みを感じた • C++ゆえにサポートされない、サポートが遅れるはありそう 15