Cordova Google Analytics プラグイン
この Cordova プラグインは、Google のユニバーサルアナリティクス SDK に接続するために使用されます。
- Plugin ID/Package Name:
cordova-plugin-google-analytics - Tested Version: 1.8.6
- 1.IDE メニューから
設定 → Cordova プラグインの管理へ移動します。 - 2.
Cordova プラグインのインポートボタンをクリックします。 次に、[ZIP ファイル] または [パッケージ名 / URL] を使用してプラグインをインポートします。
プラグインをプロジェクトへインポート後、トラッキングID の初期化を開始することができます。[deviceready] イベント後にプラグイン API を使用します。
//Replace your app tracking id here
var trackingID="YOUR_APP_TRACKING_ID";
document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady(){
console.log('Google analytics is ready now');
window.ga.startTrackerWithId(trackingID);
}
Analytics トラッカーを設定します。
window.ga.startTrackerWithId(trackingId, [interval]);
パラメーター
パラメーター名 | 型 | 説明 |
trackingId | String | Google Analytics モバイルアプリのプロパティ |
interval | Number | [オプション] 秒単位でのディスパッチ期間 (default: 30) |
戻り値
Promise
例
window.ga.startTrackerWithId('UA-XXXX-YY', 30);
画面を追跡します。
window.ga.trackView(title, campaignUrl, [newSession]);
パラメーター
パラメーター名 | 型 | 説明 |
title | String | 画面のタイトル |
campaignUrl | String | 参照を測定するためのキャンペーンURL |
newSession | Boolean | [オプション] 新しいセッションを作成するには true を設定します。 |
戻 り値
Promise
例
//To track a Screen (PageView):
window.ga.trackView('Screen Title')
//To track a Screen (PageView) w/ campaign details:
window.ga.trackView('Screen Title', 'my-scheme://content/1111?utm_source=google&utm_campaign=my-campaign')
//To track a Screen (PageView) and create a new session:
window.ga.trackView('Screen Title', '', true)
イベントを追跡します。
window.ga.trackEvent(category, action, [label], [value], [newSession])
パラメーター
パラメーター名 | 型 | 説明 |
category | String | イベントカテゴリー (例：'Video') |
action | String | Action type (例： 'play') |
label | String | [オプション] イベントラベル (例：'Fall Campaign') |
value | Number | [オプション] イベントに関連付けられた数値 (例：42) |
newSession | Boolean | [オプション] 新しいセッションを作成するには true を設定します。 |
戻り値
Promise
例
//To track an Event
window.ga.trackEvent('Videos', 'play', 'Fall Campaign', 42)
//To track an Event and create a new session:
window.ga.trackEvent('Videos', 'play', 'Fall Campaign', 42, true)
UserId を設定します.
window.ga.setUserId(id);
パラメーター
パラメーター名 | 型 | 説明 |
id | String | 特定のユーザーに関連付けられた一意の識別子は、ヒットごとに送信する必要があります |
戻り値
Promise
例
//user ID for testing purpose
var myUserId="35009a79-1a05-49d7-b876-2b884d0f825b";
window.ga.setUserId(myUserId);
特定のアプリのバージョンを設定します。
window.ga.setAppVersion(appVersion)
パラメーター
パラメーター名 | 型 | 説明 |
appVersion | String | アプリバージョン |
戻り値
Promise
例
window.ga.setAppVersion('1.33.7');
冗長ロギングを有効にします。
window.ga.debugMode()
戻り値
Promise
例
window.ga.debugMode();