Cordova Google Analytics プラグイン

この Cordova プラグインは、Google のユニバーサルアナリティクス SDK に接続するために使用されます。

サードパーティー製 Cordova プラグインを確認する場合は、カスタムビルドデバッガー ( Android 版 または iOS 版 ) を作成する必要があります。

デモ

Monaca クラウド IDE でプラグインを有効にする

  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);
}

API リファレンス

ここでは、デモ で使用されている主な API について説明します。 完全なAPIリファレンスについては、こちら を参照してください。

startTrackerWithId()

Analytics トラッカーを設定します。

window.ga.startTrackerWithId(trackingId, [interval]);

パラメーター

パラメーター名

説明

trackingId

String

Google Analytics モバイルアプリのプロパティ

interval

Number

[オプション] 秒単位でのディスパッチ期間 (default: 30)

戻り値

  • Promise

window.ga.startTrackerWithId('UA-XXXX-YY', 30);

trackView()

画面を追跡します。

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)

trackEvent()

イベントを追跡します。

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)

setUserId()

UserId を設定します.

window.ga.setUserId(id);

パラメーター

パラメーター名

説明

id

String

特定のユーザーに関連付けられた一意の識別子は、ヒットごとに送信する必要があります

戻り値

  • Promise

//user ID for testing purpose
var myUserId="35009a79-1a05-49d7-b876-2b884d0f825b";
window.ga.setUserId(myUserId);

setAppVersion()

特定のアプリのバージョンを設定します。

window.ga.setAppVersion(appVersion)

パラメーター

パラメーター名

説明

appVersion

String

アプリバージョン

戻り値

  • Promise

window.ga.setAppVersion('1.33.7');

debugMode()

冗長ロギングを有効にします。

window.ga.debugMode()

戻り値

  • Promise

window.ga.debugMode();

最終更新