RPGツクールMVでアプリリリースを目指す開発室

プラグイン「Wataridori_GoogleAnalytics.js」の解説記事です。
Googleアナリティクスプラグインの使い方、導入方法、注意点まとめています。
Googleアナリティクス（GA）側の簡単な導入部分も整理しているので、興味のある方の参考になれば。

【プラグイン配布】Googleアナリティクスプラグイン【RPGツクールMV】
制作者：飯尾隼人様
https://ci-en.dlsite.com/creator/2449/article/215213
スペシャルサンクス：BIT/O様

まずは作者様に御礼申し上げます。


WEBサイトのデータ分析ツールです。
大雑把に言うと「どこに顧客がいて、どこに注力すると効果的か」などを調べるのに使われます。

余談：
Googleアナリティクスアカデミー（英語、字幕あり）で説明されているので、興味ある方はご覧ください。

ツクール作品においては、「WEBサイト＝ゲームデータ」「ページ＝マップ」と置き換えて、分析に活用できます。

★ゲーム作者さん以外の方に向けて補足

・メールアドレスや電話番号は取得されません
・個人特定もできません（東京大田区にヘビーユーザーさんがいるな、ありがたいな、程度です）
・通信量が大きく増えることもありません
本件でテストした限りでは1回のマップ移動あたり102バイト
WEB広告の300×250のバナーやサムネイルが100KBだとして、その1/1000程度のサイズです
この処理でローディングが増えることもありません

作者がフルにこの情報を活かせば、パラメーター周りのゲームバランスの改善が期待できる恩恵があります
私がこのページを書いている理由は両者にとってプラスだと思っているからです


・1作品に対して長期間メンテナンス/サポート対応ができる人
真面目にやると、データ取得範囲を決め、データをチェックして、仮説を立て、改善、チェック（以後繰り返す）ような作業が続きます。
単にアクセス数を採るつもりなら、DL数やプレイ数を見るのと変わりません。
GDPR、通信トラフィック、パフォーマンスへの説明など、考慮することも少なくありません。


・Googleアナリティクスアカウント（Googleアカウントから取得可能。Gmail持ちなら5分）
・ツクールMVの公開作品

金銭コストはかかりません。
労力はかかります。




1）Googleアナリティクスアカウントを作成する
GMailアドレスがあればアカウントにログインした状態で所要時間5分程度。

https://analytics.google.com/analytics/web/

2）アカウント→プロパティを作る
プロパティ＝WEBサイトです。
今回はWEBサイトがRPGツクールの作品に置き換わると考えてください。

2-1）Googleアナリティクス左ペインの管理→アカウント→プロパティ→プロパティを作成


2-2）プロパティの作成で「ウェブ」を選択
Apps、アプリとウェブはiOS/Androidアプリ用向け。本プラグインを活用する分にはウェブで網羅できると考えます。
（訂正、意見歓迎します）

2-3）
ウェブサイトの名前：作品名（変更可能）
ウェブサイトのURL：実在する自己管理が利く任意のURL（変更可能かつ、プロパティの区別なのでこだわる必要なし）
業種：私はアート/エンターテイメントにしました（Google広告と連携する際に影響してたような。連携しない分には影響なし）
レポートのタイムゾーン：日本（レポートを見る際の時間。アメリカの顧客が多数を占める場合は、UTCにして分析した方がいいでしょう）



2-4）
登録が終わったら
左下の「管理」→アカウント→プロパティ→トラッキング情報→トラッキングコードの画面を表示させておきます。




3）プラグインの設定
プラグインを有効化し、プラグインのパラメーターを設定します。

詳細はこちらをご覧ください。
https://ci-en.dlsite.com/creator/2449/article/215213

・TrackingID（必須）
Googleアナリティクス左ペインの管理→アカウント→プロパティ→トラッキング情報→トラッキングコードの文字列を入れます。
UA-XXXXXXXXX-Xのような値


本記事を読み進めながらテストするだけなら、残りは規定のままで大丈夫です。

4）プロジェクトの設定
3）の設定だけで、以下のことがわかります。

・リアルタイムプレイヤー数
・初めてプレイした人、続きからプレイした人
・どのマップに何回アクセスしたか
・どのマップで終了したか

これ以上のことをする場合の手順を書きます。

[イベント到達をカウントする]
例1.マップ「故郷」でサブイベント「主人公の記憶」を見たユーザー数を取得する

ツクールのイベント内にプラグインコマンドで次の入力をします。

ANALYTICS_EVENT 故郷 主人公の記憶を見た

「故郷」「主人公の記憶を見た」はマップIDやイベント名にあわせる必要はありません。
データを分析するあなたが直感的に分かる命名にしてください。

[変数を取得する]
例2.「普通の町」で「宝箱1」を開けたときの中身「変数1番」を取得する
ツクールのイベント内にプラグインコマンドで次の入力をします。

ANALYTICS_EVENT 普通の町 宝箱1 \v[1]


例3.リザルト画面で戦闘回数、アクター1のレベルを取得する

ANALYTICS_EVENT リザルト 戦闘回数 \v[1]
ANALYTICS_EVENT リザルト アクター1のLv \v[2]


収集結果を見る画面をレポートと呼びます。

●「リアルタイム」→「概要」


すぐに機能が有効か確認できます
テストプレイをして、現在が「0」の場合は次の問題が考えられます。

-オフラインになっている
-TrackingIDがプラグインで設定されていない→3）をチェック
-TrackingIDが間違っている→2-4）をチェック

24時間以上経過したら以下のレポートにデータが反映されます。

●「オーディエンス」→「概要」


・ユーザー数とはユニークアクセスのようなものでブラウザのCoockieの数
・セッションとはアクセス数のようなものでブラウザから発信されるアクセス
・新規ユーザー(New Visitor)ははじめてのCoockie、Returning Visitorは二度目移行のCoockieで判別

ここで役立つのは次の値
・平均セッション時間……平均プレイ時間

以下は検証2日目時点で取得できません
・地域……取得できれば、翻訳言語の判断材料になる
・テクノロジー……OS情報、機種情報など（Chromeということだけはわかる）
・ユーザー属性……どの層に刺さっているか、がわかる
これはツクールMVのChromiumに保存されたCoockie情報が、普段使いのブラウザのCoockieと連動していないからかもしれません。

セッションについて
規定では30分無反応だと切断され、再開したらランディングページとしてカウントされる
（プラグインパラメーターのtimeoutは5000秒＝83分なのでおそらく83分無操作の場合切断）
Title画面以外で再開箇所が予期しないマップの場合はこの挙動が考えられる

●「行動」レポート→概要

ここが一番見る箇所。
各種値は自分の作品で、実物を見た方が良いでしょう。

・イベントカテゴリ


先の例だとプラグインコマンド「ANALYTICS_EVENT 普通の町 宝箱1 \v[1]」の中の「普通の町」のカウント（マップ遷移数）が確認できます

・イベントアクション


先の例だとプラグインコマンド「ANALYTICS_EVENT 普通の町 宝箱1 \v[1]」の中の「宝箱1」のカウントが確認できます

・イベントラベル


先の例だとプラグインコマンド「ANALYTICS_EVENT 普通の町 宝箱1 \v[1]」の中の「\v[1]（変数1）」の値が確認できます
乱数0-100にしていたのでこのようなバラつきが観測できました

プラグインコマンドを実行する際、カテゴリ、アクション、ラベルはこのような自分が見るときを意識して命名しておくと良いです。

・行動フロー


マップ遷移と離脱（セーブして終了した直前）がわかります
ランディングページとはアクセスの起点のこと。多くはTitleになるはず

・サイトコンテンツ


ページはマップをあらわします。
ここでの表示を意識して私は
「マップID_マップ名」にしていました
プロジェクト側の工夫もしておくと分析がラクになります



この行動レポートをフィルターにかけて分析して……というのが先に待っている作業。
だから冒頭の説明は煽りでもなく、本当に大変なのです。
後は各々研究してください。


・EU圏ユーザーが触れる環境では使わない（プラグインを無効にする）

理由：GDPR対応がとれないため
具体的にはEU圏のユーザーから個人情報取得について物言いがついた場合、72時間以内にEU監督機関に連絡しなければならない
https://www.pwc.com/jp/ja/knowledge/column/awareness-cyber-security/gdpr01.html
詳細および罰則についてはWEB検索やリンク先に譲ります

・プライバシーポリシーは作品タイトルではなく、製品ページ、公式サイトにする

理由：ユーザビリティの問題
リンククレジットプラグインを改変して公式サイト、作者Twitterに誘導する施策の方が良いと思います
公式サイトには将来の作品への動線も作る、これで作品同士を繋げられます（こうした将来を見据えた設計は大事）

・機能の有効化/無効化

無料体験版は基本有効にして使って頂く
製品版はプレイヤーさんがON/OFFを選べる（規定はOFF）
基本的にはゲーム内でプレイヤーさんが選べるものにする

[マップ遷移の情報取得]
有効化：ANALYTICS_MOVE_TURN ON
無効化：ANALYTICS_MOVE_TURN OFF

[イベントの情報取得]
有効化：ANALYTICS_CND_TURN ON
無効化：ANALYTICS_CND_TURN OFF

これらはセーブに保存されません。
設定例としては、選択肢で許可を問う、→設定情報をツクールのスイッチか変数に記録。
ゲーム開始時に実行するコモンイベントの中で条件分岐-スイッチONの場合-プラグインコマンド「ANALYTICS_CND_TURN ON」みたいにする必要があります。

Kindle本体の広告アリ版/ナシ版のように本機能有効化版（フィードバック機能付き版・少しお値引きする）と無効化版と本体を分けてもいいかもしれませんね。

リザルトの値やChapter到達など限定的な場面だけトラッキングしたい場合はプラグインオプションの「isAnalyzingMove」をOFFにすればOKです（タイトルや場所移動でトラッキングしなくなる）


本機能とのつながりはありませんが、Googleアナリティクスについての説明補足です。

・Steamworks（Steamの設定ページ）にもGoogleアナリティクスのトラッキングコードを埋め込めます
例.Steam製品ページ、コミュニティハブのページ
・Wixの有料プランにはGoogleアナリティクストラッキングコードに対応しています
・私のfanblogは無料ですがトラッキングコードに対応しています

・RPGアツマールでの利用においては利用規約第8条に抵触する恐れがあります
もし、大丈夫ですかと問い合わせた場合、明確にNOと返答されたら利用禁止が確定します
https://game.nicovideo.jp/atsumaru/term

◆◇

Googleアナリティクスはサービスをよりよくする改善のツールだと考えてます。
出入口を知り、入りやすくする、出るときは出た理由を改善する、滞在時間を快適なものにする……などなど。
こうした分析と改善の思考をセットで考えて、プラグインの導入検討をされることをオススメします。
厳しい言い方をしますと、数字を見て上がった下がったを見るだけなら、入れない方がいいです。


「言葉を集め、世界を旅するRPG」をキャッチコピーにしたオリジナルRPGを制作しています。
毎日7:30に制作状況を公開しているので、興味を覚えた方はご覧いただけるとうれしいです。
https://ci-en.net/creator/4244


プラグインコマンド実行状況をコンソールで見た場合
通信処理102バイト、場所移動時の処理時間は57~70ms（20回試行）