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）が指定されない場合は必須です。これはユーザーの既知の識別子として使用でき、サイトの所有者かトラッキング ライブラリの利用者から提供されます。User 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 の場合は必須です。

このパラメータは、任意でウェブ プロパティに設定します。ただし、モバイル プロパティでのスクリーンビューのヒットには必須で、スクリーンビューのヒットの「スクリーン名」に使用されます。ウェブ プロパティの場合は、&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 の正の整数を指定する必要があります。

省略可能です。

このパラメータでは、このユーザーが特定の ID でテストの対象となっていることを指定します。テストパターンのパラメータとともに送信する必要があります。

省略可能です。

このパラメータでは、このユーザーが特定のテストパターンの対象となっていることを指定します。テスト ID のパラメータとともに送信する必要があります。