Measurement Protocol のパラメータ リファレンス

すべての種類のヒットに必須です。

プロトコルのバージョンで、最新バージョンの値は「1」です。この値は後方互換性のない変更がある場合にのみ変わります。

すべての種類のヒットに必須です。

トラッキング ID またはウェブ プロパティ ID。UA-XXXX-Y の形式で指定します。収集されたすべてのデータはこの ID で関連付けられます。

省略可。

設定すると、送信者の IP アドレスがマスクされます。たとえば、&aip=、&aip=0、&aip=1 のいずれかのパラメータがペイロードに含まれている場合、IP はマスクされます。

省略可。

このパラメータを使用して、広告のパーソナライズを無効化するイベント（広告のパーソナライズを許可する設定になっているプロパティのイベントを含む）をマークします。たとえば、広告のパーソナライズを無効にするようマークされているトランザクションは、「過去の購入者」のリマーケティング オーディエンスへのユーザー入力には使用されません。

省略可。

ヒットのデータソースを示します。analytics.js から送られたヒットは、データソースとして「web」が設定され、モバイル SDK から送られたヒットは、データソースとして「app」が設定されます。

省略可。

オフラインのヒットまたは潜在的なヒットを収集する際に使用します。この値は、レポート対象のヒットが発生した時間とそのヒットが送られた時間とのデルタタイム（ミリ秒単位）を表し、0 以上の値になります。この値が 4 時間を超える場合、そのヒットは処理されていない可能性があります。

省略可。

ブラウザやプロキシでヒットをキャッシュしないよう、GET リクエストでランダムな値を送るために使用します。一部のサードパーティのインターネット フィルタリング ソフトウェアでは HTTP リクエストに他のパラメータが不適切に追加される場合があるため、リクエストの最後のパラメータとしてこの値を送る必要があります。この値はレポートでは使用されません。

省略可。

このフィールドは、リクエストでユーザー ID（uid）が指定されていない場合は必須です。これにより、特定のユーザー、デバイス、ブラウザのインスタンスが仮名化されて識別されます。ウェブの場合、この情報は通常、有効期間 2 年のファーストパーティ Cookie として保存されます。モバイルアプリの場合、この情報はインストールされたアプリの個々のインスタンスでランダムに生成されます。このフィールドの値はランダムな UUID（バージョン 4）である必要があります（http://www.ietf.org/rfc/rfc4122.txt を参照）。

省略可。

このフィールドは、リクエストでクライアント ID（cid）が指定されない場合は必須です。これはユーザーの既知の識別子として使用でき、サイトの所有者かライブラリの利用者から提供されます。ユーザー ID として個人情報を使うことはできません。また、Google アナリティクス Cookie など、アナリティクスのストレージにこの値を残すことはできません。

省略可。

セッション継続時間の調整に使用します。値を「start」にすると、新しいセッションがそのヒットで開始され、「end」にすると現在のセッションがそのヒットで終了するようになります。その他の値はすべて無視されます。

省略可。

ユーザーの IP アドレスで、IPv4 または IPv6 形式で有効な IP アドレスを指定する必要があります。この値は &aip（IP の匿名化）が使われた場合と同じように常に匿名化されます。

省略可。

ブラウザのユーザー エージェントです。Google には実際のユーザー エージェントを識別するためのライブラリが用意されています。ユーザー エージェントの文字列を自作すると、動作が停止する可能性があります。

省略可。

ユーザーが所在する地域です。地域 ID には、2 文字の国コード、または都市や地域を表す条件 ID を指定します（http://developers.google.com/analytics/devguides/collection/protocol/v1/geoid をご覧ください）。このパラメータは、IP オーバーライド パラメータなど、IP アドレスから取得した位置情報よりも優先されます。コードが無効である場合、地域ディメンションは「(not set)」に設定されます。

省略可。

ウェブサイトにトラフィックを送り込んだ参照ソースを指定します。この値はトラフィックの参照元の算出にも使用され、URL の形式になります。

省略可。

キャンペーン名を指定します。

省略可。

キャンペーンの参照元を指定します。

省略可。

キャンペーンのメディアを指定します。

省略可。

キャンペーンのキーワードを指定します。

省略可。

キャンペーンのコンテンツを指定します。

省略可。

キャンペーン ID を指定します。

省略可。

Google 広告 ID を指定します。

省略可。

Google ディスプレイ広告 ID を指定します。

省略可。

画面の解像度を指定します。

省略可。

ブラウザと端末の表示領域を指定します。

省略可。

ページやドキュメントのエンコードに使用する文字セットを指定します。

省略可。

画面の色深度を指定します。

省略可。

言語を指定します。

省略可。

Java が有効かどうかを指定します。

省略可。

Flash のバージョンを指定します。

すべての種類のヒットに必須です。

ヒットの種類。「pageview」、「screenview」、「event」、「transaction」、「item」、「social」、「exception」、「timing」のいずれかを指定する必要があります。

省略可。

ヒットを非インタラクションとして処理するよう指定します。

省略可。

対象コンテンツが掲載されているページの完全な URL（ドキュメントの場所）を送る際に、このパラメータを使用します。&dh パラメータと &dp パラメータを使用すると、ドキュメントの URL のホスト名とパス + クエリの部分を上書きできます。JavaScript クライアントでは、document.location.origin + document.location.pathname + document.location.search browser のパラメータを連結して、このパラメータを判別します。URL にユーザーの認証情報やその他の個人情報が含まれている場合は、必ず削除してください。ヒットが「pageview」（ページビュー）の場合、有効にするには、&dl のみを指定するか、&dh と &dp の両方を指定する必要があります。

省略可。

コンテンツがホストされているホスト名を指定します。

省略可。

ページの URL のパス部分。「/」で始まる必要があります。「pageview」ヒットの場合、&dl または &dh と &dp の両方を指定しないと、そのヒットは有効になりません。

省略可。

ページやドキュメントのタイトルです。

ヒットタイプが screenview の場合は必須です。

このパラメータは、任意でウェブ プロパティに設定します。ただし、モバイル プロパティでの screenview のヒットには必須で、screenview のヒットの「スクリーン名」に使用されます。ウェブ プロパティの場合は、&dl パラメータをそのまま使用するか &dh と &dp を組み合わせることで、ページ固有の URL をデフォルトとして設定します。

省略可。

コンテンツ グループを最大 5 つまで設定できます。それぞれのグループには、1～5 つのインデックスが関連付けられています。各コンテンツ グループには最大 100 個のコンテンツ グループを含めることができます。コンテンツ グループの値は「/」で区切られる階層付きテキストです。先頭と末尾のスラッシュはすべて削除され、スラッシュが繰り返される場合も表示されるのは 1 つだけです。たとえば、「/a//b/」と入力しても、「a/b」に変換されます。

省略可。

クリックされた DOM 要素の ID。プロパティで拡張リンクのアトリビューションが有効化された場合に、ページ解析レポートで複数のリンクを同一の URL に明確化するために使用されます。

省略可。

アプリケーション名を指定します。このフィールドは、アプリ関連のデータ（アプリのバージョンやアプリ ID、アプリ インストーラ ID など）を持つあらゆるヒットに必須です。ウェブ プロパティに送信されるヒットの場合、このフィールドはオプションです。

省略可。

アプリケーションの識別子。

省略可。

アプリケーションのバージョンを指定します。

省略可。

アプリケーション インストーラの識別子。

ヒットタイプが event の場合は必須です。

イベントのカテゴリを指定します。空白にすることはできません。

ヒットタイプが event の場合は必須です。

イベントのアクションを指定します。空白にすることはできません。

省略可。

イベントのラベルを指定します。

省略可。

イベントの値を指定します。必ず負以外の値にしてください。

ヒットタイプが transaction の場合は必須です。
ヒットタイプが item の場合は必須です。

トランザクション固有の識別子です。この値は、個々のトランザクションに関連するトランザクション（transaction）とアイテム（item）の両方のヒットで同じ値にする必要があります。

省略可。

アフィリエーションやショップの名前を指定します。

省略可。

トランザクションに伴う収益の合計額を指定します。この値には送料や税金も含める必要があります。

省略可。

トランザクションに伴う送料の合計額を指定します。

省略可。

トランザクションに伴う税金の合計額を指定します。

ヒットタイプが item の場合は必須です。

アイテムの名前を指定します。

省略可。

1 つのアイテムやユニットの価格を指定します。

省略可。

購入されたアイテムの数を指定します。

省略可。

SKU かアイテムコードを指定します。

省略可。

アイテムが属するカテゴリを指定します。

省略可。

商品の SKU。商品のインデックスには 1～200 の正の整数を指定する必要があります。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

商品の名前。商品のインデックスには 1～200 の正の整数を指定する必要があります。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

商品に関連するブランド。商品のインデックスには 1～200 の正の整数を指定する必要があります。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

商品が属するカテゴリ。商品のインデックスには 1～200 の正の整数を指定する必要があります。商品カテゴリ パラメータは階層化できます。区切り文字として「/」を使用し、最大 5 レベルの階層を指定します。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

商品のバリエーション。商品のインデックスには 1～200 の正の整数を指定する必要があります。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

商品の単価。商品のインデックスには 1～200 の正の整数を指定する必要があります。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

商品の数量。商品のインデックスには 1～200 の正の整数を指定する必要があります。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

商品に関連するクーポンコード。商品のインデックスには 1～200 の正の整数を指定する必要があります。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

リストやコレクションでの商品の位置。商品のインデックスには 1～200 の正の整数を指定する必要があります。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

商品レベルのカスタム ディメンション。インデックスは 1～200 の正の整数です。商品のインデックスには 1～200 の正の整数を指定する必要があります。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

商品レベルのカスタム指標。インデックスは 1～200 の正の整数です。商品のインデックスには 1～200 の正の整数を指定する必要があります。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

ヒットに含まれる商品の役割。商品アクションを指定しないと、そのヒットに含まれる商品の定義はすべて無視されます。このパラメータの値には、「detail」（詳細情報）、「click」（クリック）、「add」（追加）、「remove」（削除）、「checkout」（決済）、「checkout_option」（決済オプション）、「purchase」（購入）、「refund」（払い戻し）のいずれかを指定します。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

トランザクション ID。このパラメータは、商品アクションとして「purchase」か「refund」を指定した場合に追加パラメータとして指定できます。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

トランザクションが発生したショップまたはアフィリエーション。このパラメータは、商品アクションとして「purchase」か「refund」を指定した場合に追加パラメータとして指定できます。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

トランザクションの合計額（税金と送料を含む）。このパラメータを指定しなかった場合、同じヒットのすべての商品の数量フィールドと価格フィールドを使って、収益が自動的に計算されます。このパラメータは、商品アクションとして「purchase」か「refund」を指定した場合に追加パラメータとして指定できます。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

トランザクションで発生した合計税額。このパラメータは、商品アクションとして「purchase」か「refund」を指定した場合に追加パラメータとして指定できます。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

トランザクションで発生した送料。このパラメータは、商品アクションとして「purchase」か「refund」を指定した場合に追加パラメータとして指定できます。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

トランザクションで使用されたクーポン。このパラメータは、商品アクションとして「purchase」か「refund」を指定した場合に追加パラメータとして指定できます。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

商品アクションが発生したリストまたはコレクション。このパラメータは、商品アクションとして「detail」か「click」を指定した場合に追加パラメータとして指定できます。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

決済目標到達プロセスにおけるステップ番号。このパラメータは、商品アクションとして「checkout」を指定した場合に追加パラメータとして指定できます。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

決済ステップに関する追加情報。このパラメータは、商品アクションとして「checkout」を指定した場合に追加パラメータとして指定できます。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

商品が属するリストまたはコレクション。表示された商品リストのインデックスには 1～200 の正の整数を指定する必要があります。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

商品 ID または SKU。表示された商品リストのインデックスには 1～200 の正の整数を指定する必要があります。商品のインデックスには 1～200 の正の整数を指定する必要があります。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

商品の名前。表示された商品リストのインデックスには 1～200 の正の整数を指定する必要があります。商品のインデックスには 1～200 の正の整数を指定する必要があります。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

商品に関連するブランド。表示された商品リストのインデックスには 1～200 の正の整数を指定する必要があります。商品のインデックスには 1～200 の正の整数を指定する必要があります。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

商品が属するカテゴリ。表示された商品リストのインデックスには 1～200 の正の整数を指定する必要があります。商品のインデックスには 1～200 の正の整数を指定する必要があります。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

商品のバリエーション。表示された商品リストのインデックスには 1～200 の正の整数を指定する必要があります。商品のインデックスには 1～200 の正の整数を指定する必要があります。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

リストやコレクションでの商品の位置。表示された商品リストのインデックスには 1～200 の正の整数を指定する必要があります。商品のインデックスには 1～200 の正の整数を指定する必要があります。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

商品の価格。表示された商品リストのインデックスには 1～200 の正の整数を指定する必要があります。商品のインデックスには 1～200 の正の整数を指定する必要があります。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

商品レベルのカスタム ディメンション。インデックスは 1～200 の正の整数です。表示された商品リストのインデックスには 1～200 の正の整数を指定する必要があります。商品のインデックスには 1～200 の正の整数を指定する必要があります。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

商品レベルのカスタム指標。インデックスは 1～200 の正の整数です。表示された商品リストのインデックスには 1～200 の正の整数を指定する必要があります。商品のインデックスには 1～200 の正の整数を指定する必要があります。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

プロモーション ID。プロモーションのインデックスは 1～200 の正の整数で指定する必要があります。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

プロモーションの名前。プロモーションのインデックスは 1～200 の正の整数で指定する必要があります。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

プロモーションで使用しているクリエイティブ。プロモーションのインデックスは 1～200 の正の整数で指定する必要があります。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

プロモーションで使用したクリエイティブの位置。プロモーションのインデックスは 1～200 の正の整数で指定する必要があります。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

ヒットに含まれるプロモーションの役割を指定します。プロモーション アクションを指定しなかった場合、プロモーション アクションはデフォルトの「view」と見なされます。プロモーションに対するユーザーのクリックを測定する場合は、このパラメータの値を「promo_click」にしてください。analytics.js でこのフィールドを使用する場合は、事前に拡張 e コマース プラグインをインストールしておいてください。

省略可。

このパラメータを指定すると、すべてのトランザクションの通貨の値が指定したローカル通貨になります。この値は ISO 4217 の有効な通貨コードで指定する必要があります。

ヒットタイプが social の場合は必須です。

ソーシャル ネットワーク（Facebook や Google+ など）を指定します。

ヒットタイプが social の場合は必須です。

ソーシャル インタラクションのアクションを指定します。たとえば Google プラスでユーザーが +1 ボタンをクリックした場合は、ソーシャル アクションとして「plus」を指定します。

ヒットタイプが social の場合は必須です。

ソーシャル インタラクションのターゲットを指定します。通常、この値は URL になりますが、どのようなテキストでも指定できます。

ヒットタイプが timing の場合は必須です。

カスタム速度のカテゴリを指定します。

ヒットタイプが timing の場合は必須です。

カスタム速度の変数名を指定します。

ヒットタイプが timing の場合は必須です。

カスタム速度の値を指定します。値はミリ秒単位です。

省略可。

カスタム速度のラベルを指定します。

省略可。

ページの読み込みにかかった時間を指定します。値はミリ秒単位です。

省略可。

DNS ルックアップにかかった時間を指定します。値はミリ秒単位です。

省略可。

ページのダウンロードにかかった時間を指定します。値はミリ秒単位です。

省略可。

発生したリダイレクトにかかった時間を指定します。値はミリ秒単位です。

省略可。

TCP 接続の確立にかかった時間を指定します。値はミリ秒単位です。

省略可。

接続が確立されてからサーバーが応答するまでにかかった時間を指定します。値はミリ秒単位です。

省略可。

Document.readyState が「interactive」になるまでにかかった時間を指定します。値はミリ秒単位です。

省略可。

DOMContentLoaded イベントが発生するのにかかった時間を指定します。値はミリ秒単位です。

省略可。

例外の説明を指定します。

省略可。

例外が致命的かどうかを指定します。

省略可。

それぞれのカスタム ディメンションにはインデックスが関連付けられています。カスタム ディメンションの最大数は 20 個（アナリティクス 360 アカウントの場合は 200 個）です。ディメンションのインデックスには 1～200 の正の整数を指定する必要があります。

省略可。

それぞれのカスタム指標にはインデックスが関連付けられています。カスタム指標の最大数は 20 個（アナリティクス 360 アカウントの場合は 200 個）です。指標のインデックスには 1～200 の正の整数を指定する必要があります。