# Cordova Google Analytics プラグイン

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

* Repo: <https://github.com/danwilson/google-analytics-plugin>
* Plugin ID/Package Name: `cordova-plugin-google-analytics`
* Tested Version: 1.8.6

{% hint style="info" %}
サードパーティー製 Cordova プラグインを確認する場合は、カスタムビルドデバッガー ( [Android 版](https://ja.docs.monaca.io/products_guide/debugger/installation/debugger_android#kasutamubirudo-monaca-debaggnobirudotoinsutru) または [iOS 版](https://ja.docs.monaca.io/products_guide/debugger/installation/debugger_ios#kasutamubirudo-monaca-debaggnobirudo) ) を作成する必要があります。
{% endhint %}

## デモ

[<img src="https://docs.monaca.io/images/common/import_img.png" alt="" data-size="line">プロジェクトをインポート](https://monaca.mobi/directimport?pid=5ac33902e7888548428b4567)

![](https://3046938759-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MfWrOnV1iKerkfShm9O%2F-MgxvzUI1SgIYmfHaCbA%2F-MgxwK0WDsaUMK_sopqs%2Fimage.png?alt=media\&token=fa043189-83f6-4fa6-b950-d54192655778)

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

1. IDE メニューか&#x3089;**`設定 → Cordova プラグインの管理`**&#x3078;移動します。
2. `Cordova プラグインのインポート`ボタンをクリックします。 次に、\[ZIP ファイル] または \[パッケージ名 / URL] を使用してプラグインをインポートします。

## 使い方

プラグインをプロジェクトへインポート後、トラッキングID の初期化を開始することができます。\[deviceready] イベント後にプラグイン API を使用します。

```javascript
//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 リファレンス

ここでは、[デモ](https://monaca.mobi/directimport?pid=5ac33902e7888548428b4567) で使用されている主な API について説明します。 完全なAPIリファレンスについては、[こちら](https://github.com/danwilson/google-analytics-plugin) を参照してください。

### startTrackerWithId()

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

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

**パラメーター**

| パラメーター名      | 型      | 説明                                     |
| ------------ | ------ | -------------------------------------- |
| `trackingId` | String | Google Analytics モバイルアプリのプロパティ         |
| `interval`   | Number | \[オプション] 秒単位でのディスパッチ期間 (default: `30`) |

**戻り値**

* `Promise`

**例**

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

### trackView()

画面を追跡します。

```javascript
window.ga.trackView(title, campaignUrl, [newSession]);
```

**パラメーター**

| パラメーター名       | 型       | 説明                                      |
| ------------- | ------- | --------------------------------------- |
| `title`       | String  | 画面のタイトル                                 |
| `campaignUrl` | String  | 参照を測定するためのキャンペーンURL                     |
| `newSession`  | Boolean | \[オプション] 新しいセッションを作成するには `true` を設定します。 |

**戻り値**

* `Promise`

**例**

```javascript
//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()

イベントを追跡します。

```javascript
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`

**例**

```javascript
//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 を設定します.

```javascript
window.ga.setUserId(id);
```

**パラメーター**

| パラメーター名 | 型      | 説明                                       |
| ------- | ------ | ---------------------------------------- |
| `id`    | String | 特定のユーザーに関連付けられた一意の識別子は、ヒットごとに送信する必要があります |

**戻り値**

* `Promise`

**例**

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

### setAppVersion()

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

```javascript
window.ga.setAppVersion(appVersion)
```

**パラメーター**

| パラメーター名      | 型      | 説明       |
| ------------ | ------ | -------- |
| `appVersion` | String | アプリバージョン |

**戻り値**

* `Promise`

**例**

```javascript
window.ga.setAppVersion('1.33.7');
```

### debugMode()

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

```javascript
window.ga.debugMode()
```

**戻り値**

* `Promise`

**例**

```javascript
window.ga.debugMode();
```