読者です 読者をやめる 読者になる 読者になる

BIT/O

WEBやデザイン、ゲームなど

ゲームをアクセス解析?! ツクールMV用プラグイン BITO_Game_Analytics.js を公開しました!

ツクールMV用プラグイン BITO_Game_Analytics.js

ツクールMV用プラグイン
BITO_Game_Analytics.js を開発し公開しました!

BITO_Game_Analytics.js を使うと、Google Analytics を使ってゲームのアクセス解析を行うことができます!

はじめてつくったプラグイン

既存のプラグインをちょこっといじったりしたことはありますが、プラグインを作るのはこれがはじめてです。動作に問題ありましたらTwitter等でおしらせください(汗

ご利用上の注意

[注意1] このプラグインローカル環境では正常に動作しません(これは、開発時のローカル環境、また動作検証はしておりませんが、スマートフォンアプリ内でも動作しない可能性を意味します)。

[注意2] このプラグイン外部接続が制限されている環境下では動作しません

プラグイン動作デモ

プラグイン動作デモ
プラグイン動作デモ

▲クリックで起動。

Google Analyticsにどのように「記録」されるのか?

場所移動時、タイトルへ戻った時、ゲームオーバー時ページ遷移としてトラッキングします。

マップIDと座標が仮想URL(マップIDからマップ名へ切替可)、

(記録例: "/1/8/6" )

マップ名が仮想ページタイトルとして記録されます(座標表示の有無は変更可)。

(記録例: "主人公の家(8,6)" )

またプラグインコマンドを使って「ページ遷移」、「イベントアクション」を Google Analytics送信できます。

f:id:bitorchard:20161112205628p:plain

▲コンソール上でGoogleにどのような形で、データを送信しているのかを確認することができます(ブラウザ上でF12キー)。

プライバシーポリシーが表示されます

デフォルトでタイトル画面に「プライバシーポリシー」を表示します。

f:id:bitorchard:20161112210210p:plain

f:id:bitorchard:20161112210338p:plain

表示するかどうかはパラメーターで変更できますが、Google Analytics利用規約により表示が必須なのでタイトルをスキップするなどの事情がない限りは出していたほうが良いと思います。

コマンド名やポリシーの内容についても、パラメーターで変更可能です。

導入の仕方

下記のダウンロードボタンからプラグインをダウンロード、インストールし、各種パラメータをいじります。

Google Analytics のアカウントが必要となりますので、アカウントを作成しトラッキングIDを取得してください。

その際は、Google Analytics サービス利用規約およびGoogle社プライバシーポリシーをご覧ください。

なお、Google Analytics に 1か月に送信されるヒット数がアナリティクスの利用規約で定められている上限を超えた場合、その超過分のヒット数が処理される保証はありません。その場合は、有料サービスにアップグレードする必要があります。

Google Analytics は、Google Inc. の登録商標です。

パラメーター

パラメータ名説明初期値
ラッキングID Googleアナリティクスアカウントを作成し"UA-00000000-1"といった文字列のトラッキングIDを入力します。 UA-00000000-1
場所移動をトラッキング イベント「場所移動」「ゲームオーバー」「タイトル画面に戻す」を実行した時に「ページ遷移」としてトラッキングを行います。(ON/OFF) ON
プラグインコマンドのトラッキング プラグインコマンドで実行されるトラッキング実施を行うか設定します。(ON/OFF) ON
起動直後からトラッキング 通常は最初のマップから開始されるトラッキングを起動直後から開始します。タイトルをスキップする場合などにONにしてください。(ON/OFF) OFF
仮想ページタイトルに座標を追加 仮想ページタイトルに座標を追加してトラッキング。(ON/OFF)
(記録例: "主人公の家(8,6)" )
ON
仮想URLにマップ名を適用 ページトラッキング時の"URL"を、マップIDではなくマップ名を用いる。(ON/OFF) OFF
ポリシーの掲載 タイトルメニューにプライバシーポリシーの項目を追加します。
掲載はアナリティクスの利用規約で定められています。(ON/OFF)
ON
ポリシーの名称 タイトルのメニュー項目の名称
default:プライバシーポリシー
プライバシーポリシー
ポリシーの内容1 プライバシーポリシーの内容を入力します(1)。 当ゲームでは、個人を特定しない形で(以下省略)
ポリシーの内容2 プライバシーポリシーの内容を入力します(2)。 Cookieについて Cookieとは、(以下省略)
ポリシーの内容3 プライバシーポリシーの内容を入力します(3)。 Googleアナリティクス(以下省略)
ポリシーの改行文字数 ポリシーの文章を何文字毎で改行するかを入力します。
default:60
60

プラグインコマンド

▼ページ トラッキングの有効化・無効化

BITO_GA_MOVE_TURN (ON/OFF)

例)BITO_GA_MOVE_TURN OFF

プラグインコマンドによるトラッキングの有効化・無効化

BITO_GA_CND_TURN (ON/OFF)

例)BITO_GA_CND_TURN OFF

▼ページ トラッキングを実行

BITO_GA_VIEW (ページ名)

例)BITO_GA_VIEW 1年前の回想

例)BITO_GA_VIEW \P[1]の部屋

例)BITO_GA_VIEW

※何も指定しない場合は、マップ名を送信されます。

▼イベント トラッキングを実行

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

例)BITO_GA_EVENT 飛行船 入手

例)BITO_GA_EVENT 宿泊 店舗名:\V[20]

もしくは

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

例)BITO_GA_EVENT 宝箱 入手 古びた鍵

例)BITO_GA_EVENT モンスター 討伐完了 裏ボスA

もしくは

BITO_GA_EVENT (イベントカテゴリ) (イベントアクション) (イベントラベル) (正の整数)

例)BITO_GA_EVENT ゲーム情報 読込時間 オープニング \V[5]

例)BITO_GA_EVENT レベル チェック \N[1] \V[10]

※負の整数はサポートされていません。

ライセンス

Copyright (c) 2016 BIT/O
This software is released under the MIT License.
http://opensource.org/licenses/mit-license.php

作者に無断で改変、再配布が可能で、利用形態についても制限はありません。このプラグインはもうあなたのものです。

謝辞

プラグイン開発にあたりトリアコンタンさんにご協力をいただきました。また本プラグインのベースもトリアコンタンさんの _BaseScript.js を利用しております。改めて御礼申し上げます。

ダウンロードはこちら

 

 

できる逆引き Googleアナリティクス Web解析の現場で使える実践ワザ240 ユニバーサルアナリティクス&Googleタグマネージャ対応