渡り鳥の楽園 2020/02/24 20:00

【プラグイン配布】Googleアナリティクスプラグイン【RPGツクールMV】


レティシア物語改良体験版ver1.03.zip (823.97MB)

ダウンロード
製品版のイラスト一部公開中!
レティシア物語の製品版はこちらから!

Googleアナリティクスプラグイン


Ci-enにてRPGツクールMVプラグイン配布の第八弾!
同人ゲームを制作する上であったら便利だなと思って作成したプラグインを配布します!
第八弾の今回は、Googleアナリティクスによるアクセス解析を作成したゲームに適用できるプラグインです!!!
「本プラグインは、Googleアナリティクスへのヒットの送信を提供するプラグインとなります。本プラグイン導入により、ページ遷移もしくはプラグインコマンドを使用してのGoogleアナリティクスによるアクセス解析が可能となります」
※本プラグインはBIT/Oさんのプラグイン「BITO_Game_Analytics.js」をローカル版でも使用可能に改良したプラグインとなります。素晴らしいプラグインを作って下さったBIT/Oさんに感謝申し上げます。
【ver1.00】Googleアナリティクスプラグイン

Wataridori_GoogleAnalytics.js (28.37kB)

ダウンロード

利用規約


本プラグインを無断で改変、再配布が可能で商用、18禁利用等を問わずにご利用が可能です。改良して頂いた場合、報告して頂けると喜びます。クレジットして頂ければ泣いて喜びます。

本プラグインの使用によって生じたいかなる損失・損害、トラブルについても一切責任を負いかねますことをご了承ください。

This software is released under the MIT License.
MIT License

注意事項

※このプラグインは外部接続が制限されている環境下では動作しません。
※Googleアナリティクスへの通信にはインターネット接続が必要です。

プラグインの説明


本プラグイン導入により、Googleアナリティクスにて制作したゲームのアクセス解析が可能となります。

デフォルトの設定では、タイトル画面、セーブ画面、ゲームオーバー画面、場所移動先のマップに遷移した際に情報を送信します。また、プラグインコマンドにてイベント情報を随時送信することもできます。
Googleアナリティクスへの情報送信には「Measurement Protocol」を使用しています。詳細は下記をご覧ください。
Measurement Protocol の概要
Googleアナリティクスについては下記をご覧ください。
Googleアナリティクス

プラグインパラメータの説明


プラグインパラメータの説明をします。必ず取得したTrackingIDを設定してください。TrackingIDの設定がない場合、Googleアナリティクスへ情報は送信されません。

TrackingID

必ずGoogleアナリティクスのアカウントを開設し、取得したTrackingIDを設定してください。

isAnalyzingMove

「タイトル画面」「ゲームオーバー画面」「場所移動先のマップ」「セーブ画面」に遷移した際に、計測のためのGoogleアナリティクスへの情報送信を許可します。プラグインコマンドにてゲーム中にONとOFFを変更可能です。

isAnalyzingCommand

プラグインコマンドによる計測のためのGoogleアナリティクスへの情報送信を許可します。プラグインコマンドにてゲーム中にONとOFFを変更可能です。

isAnalyzingStartup

ONの場合、起動直後のタイトル画面遷移を計測します。

isAddAxes

ONにするとページの名称に座標が追加されます。


isMapNameUrl

ONにするとページトラッキング時のタイトルにマップIDではなくマップ名を使用します。


isDisplayPolicy

ONにするとタイトル画面にプライバシーポリシーを表示するためのコマンドを追加します。

PolicyName

タイトル画面に表示するプライバシーポリシーを表示するコマンドの名称を設定可能です。

PolicyDetail1

プライバシーポリシー1全文
「当ゲームでは、個人を特定しない形でユーザ情報をGoogleに送信しています。当ゲームはそれらの情報を Google Analytics を使用しゲーム利用状況の把握やゲームの改善、ユーザーの傾向をコンテンツとして紹介するといった用途で利用する可能性があります。本ゲームのユーザーは本ゲームを利用することで、上記方法および目的においてGoogleとゲーム制作者が行うこうしたデータ処理に対して、許可を与えたものとみなします。Googleによる情報収集および利用方法については、Google Analyticsサービス利用規約およびGoogle社プライバシーポリシーによって定められています。」

PolicyDetail2

プライバシーポリシー2全文
「Cookieについて Cookieとは、ゲーム(もしくはGoogleアナリティクスのような第三者サービス)が、ゲームユーザーが利用するデバイスのブラウザに情報を保存し、あとで取り出すことができる符号です。ただしゲーム管理者は、当ゲームで設定するCookieからユーザーの個人情報を把握することはできませんのでご安心ください。なお、ゲームユーザーはブラウザの設定によりCookieの受け取りを拒否することができます。」

PolicyDetail3

プライバシーポリシー3全文
「Googleアナリティクス オプトアウトアドオン https://tools.google.com/dlpage/gaoptout」

PolicyBreakSize

プライバシーポリシーの文章を改行する文字数を設定可能です。

PrefixPluginCommand

プラグインコマンドの接頭辞を変更可能です。例として「TEST」へ変更した場合、下記の様になります。
変更前)ANALYTICS_VIEW
変更後)TEST_VIEW

timeout

Googleアナリティクスへの通信におけるタイムアウトの時間です。

folderName

Googleアナリティクス上でゲームを識別するための名称を設定可能です。
デフォルトの状態ではGoogleアナリティクス上で下記の様に表示されます。


UseDebugMode

ONにすると、デバックモードとなります。デバックモードにて送信されたヒットはレポートには表示されず、デバッグにのみ使用されます。

プラグインの使い方の説明


プラグインを導入し、TrackingIDを設定することにより自動的にページ遷移の際にGoogleアナリティクスへ情報が送信されます。特定のイベント実行時に情報を送信したい場合は、下記プラグインコマンドを使用してください。各項目の設定には制御文字の使用が可能です。

プラグインコマンド一覧

プラグインコマンドの接頭辞「ANALYTICS」はプラグインパラメータ「PrefixPluginCommand」で変更可能です。

ANALYTICS_MOVE_TURN

ページ遷移(タイトル、ゲームオーバー、セーブ、マップ移動)によるトラッキングの有効化・無効化を設定します。デフォルトはプラグインパラメータ「isAnalyzingMove」で変更可能です。
無効化した状態でページ遷移を行ってもGoogleアナリティクスへ情報は送信されません。
有効化:ANALYTICS_MOVE_TURN ON
無効化:ANALYTICS_MOVE_TURN OFF
※セーブを行っても変更した設定は保存されません。

ANALYTICS_CND_TURN

プラグインコマンド(ANALYTICS_VIEW, ANALYTICS_EVENT)によるトラッキングの有効化・無効化を設定します。デフォルトはプラグインパラメータ「isAnalyzingCommand」で変更可能です。
無効化した状態でプラグインコマンドを実行してもGoogleアナリティクスへ情報は送信されません。
有効化:ANALYTICS_CND_TURN ON
無効化:ANALYTICS_CND_TURN OFF
※セーブを行っても変更した設定は保存されません。

ANALYTICS_VIEW

ページ閲覧によるトラッキングに使用します。プラグインコマンド「ANALYTICS_VIEW」の後に計測に使用するページの名称を記述してください。
例)ANALYTICS_VIEW 1年前の回想
例)ANALYTICS_VIEW \P[1]の部屋
例)ANALYTICS_VIEW
※何も指定しない場合は、マップ名を送信します。

ANALYTICS_EVENT

イベント実行によるトラッキングに使用します。プラグインコマンド「ANALYTICS_EVENT」の後に計測に使用する(イベントカテゴリ) (イベントアクション) (イベントラベル) (イベントバリュー)を半角スペースで区切って記述してください。

(イベントカテゴリ) (イベントアクション)

(イベントカテゴリ) と(イベントアクション)は必須項目です。必ず両方指定してください。1つ目が(イベントカテゴリ) 、2つ目が (イベントアクション)です。
ANALYTICS_EVENT (イベントカテゴリ) (イベントアクション)
例)ANALYTICS_EVENT 飛行船 入手
例)ANALYTICS_EVENT 宿泊 店舗名:\V[20]

(イベントラベル)

省略可能です。3つ目の項目が(イベントラベル)となります。
ANALYTICS_EVENT (イベントカテゴリ) (イベントアクション) (イベントラベル)
例)ANALYTICS_EVENT 宝箱 入手 古びた鍵
例)ANALYTICS_EVENT モンスター 討伐完了 裏ボスA

(イベントバリュー)

省略可能です。4つ目の項目が(イベントバリュー)となります。(イベントバリュー)は正の整数のみ設定してください。
ANALYTICS_EVENT (イベントカテゴリ) (イベントアクション) (イベントラベル) (イベントバリュー)
例)ANALYTICS_EVENT ゲーム情報 読込時間 オープニング 12
例)ANALYTICS_EVENT ゲーム情報 読込時間 オープニング \V[5]
※負の整数はサポートされていません。設定するとエラーログが出力され、Googleアナリティクスに情報は送信されません。

デバックモード

プラグインパラメータ「UseDebugMode」をONにすることにより、デバックログをコンソール(F8)に出力可能です。デバックモードにて送信されたヒットは、レポートには表示されず、デバッグにのみ使用されます。デバックの詳細については下記をご覧ください。
ヒットの検証 - Measurement Protocol


次回作の制作を着々と進行させています・・・!


Copyright(c) 渡り鳥の楽園

この記事が良かったらチップを贈って支援しましょう!

チップを贈るにはユーザー登録が必要です。チップについてはこちら

月別アーカイブ

記事を検索