トラッキング コード: _gaq グローバル オブジェクト

_gaq グローバル オブジェクトは、push(...) メソッドを介して非同期ページ トラッキングに直接使用できます。これにはトラッカー オブジェクトを作成するメソッドがありますが、これらのメソッドは限られた状況でのみ使用する必要があります。

従来のページ トラッキングには、代わりに _gat グローバル オブジェクトを使用します。

_gaq オブジェクトのメソッド

ルーティング方法の詳細

_createAsyncTracker()

    _createAsyncTracker(accountId, opt_name)
    非同期トラッキング呼び出しを行うときに名前で参照できるトラッカー オブジェクトが作成されます。名前を指定しない場合は、空の文字列 '' が使用されます。これは、非同期構文のデフォルトのトラッカーを表します。 指定した名前の非同期トラッカーがすでに存在する場合は、新しいトラッカーで上書きされます。

    注: このメソッドは通常、_gaq に push された関数内でのみ安全に使用できます。まれなケースでのみ使用してください。 
    _gaq._createAsyncTracker('UA-65432-1');

    パラメータ

      String accountId トラッカー オブジェクトの完全なウェブ プロパティ ID（例: UA-65432-1）。
      String opt_name トラッカー オブジェクトを保存する名前。この名前は、後で非同期トラッキング呼び出しでトラッカー オブジェクトを参照する場合に使用します。

    戻り値

      Tracker 作成されたトラッキング オブジェクト。

_getAsyncTracker()

    _getAsyncTracker(opt_name)
    指定された名前で以前作成されたトラッカー オブジェクトを返します。 名前を指定しない場合は、デフォルトのトラッカー名（空の文字列 ''）が使用されます。指定された名前のトラッカー オブジェクトが存在しない場合は、新しいトラッカーが作成され、その名前に割り当てられて返されます。

    注: このメソッドは通常、_gaq に push された関数内でのみ安全に使用できます。まれなケースでのみ使用してください。 
    _gaq._getAsyncTracker();

    パラメータ

      String opt_name 取得するトラッカー オブジェクトの名前。

    戻り値

      Tracker 取得または作成されたトラッキング オブジェクト。

push

    push(commandArray)
    指定された command array を実行します。これは、次の形式に準拠した JavaScript 配列です。配列の最初の要素は、文字列として渡されるトラッカー オブジェクト メソッドの名前である必要があります。残りの配列要素は、関数に引数として渡す値です。

    通常、次の用途があります。
    var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-65432-1']);
_gaq.push(['_trackPageview']);

    この関数には push という名前が付けられます。これにより、アナリティクスが完全に読み込まれる前に _gaq の代わりに配列を使用できます。アナリティクスの読み込み中は、配列にコマンドがプッシュされ、キューに入れられます。アナリティクスの読み込みが完了すると、配列が _gaq オブジェクトに置き換えられ、キューに入れられたコマンドがすべて実行されます。以降の _gaq.push の呼び出しはこの関数に解決され、push されたコマンドが実行されます。

    トラッカーに名前を付けるには、メソッド名の前にトラッカー名（ピリオドを付けて）を追加します。関数名がトラッカー名で修飾されている場合、そのトラッカーで実行されます。

    次の例では、myTracker というトラッカーを自由に作成して使用します。
    var _gaq = _gaq || [];
_gaq.push(['myTracker._setAccount', 'UA-65432-2']);
_gaq.push(['myTracker._setDomainName', 'foo.com']);
_gaq.push(['myTracker._trackPageview']);

    注: トラッカーは、コマンドで初めて参照されるときに作成されます。デフォルトのトラッカーは、最初のコマンドで作成されます。このトラッカーには明示的に名前が付けられません。デフォルトのトラッカー名は空の文字列 '' です。

    コマンド配列を push するだけでなく、関数オブジェクトを push することもできます。これは、値を返すトラッカー メソッドに特に便利です。これらの関数は、_gat と _gaq の両方を参照できます。
    var _gaq = _gaq || [];
_gaq.push(function() {
  var tracker = _gat._getTracker('UA-65432-1');
  tracker._trackPageview();
});

    ページの HTML に push 構文を直接使用することもできます。
    onclick="_gaq.push(['_trackEvent', 'name', value]);"

    リンク上に非同期のアナリティクス スニペットがある場合は、クリック時にアナリティクスが完全に読み込まれていなくても、エラーなしでクリックがキャプチャされます。これが非同期トラッキングの多くのメリットの 1 つです。

    最後に、コマンド配列ごとに _gaq.push(...) を入力する代わりに、すべてのコマンドを一度にプッシュできます。次のコードは、この手法を示しています。詳しくは、非同期スニペットの使用ガイドをご覧ください。 

    _gaq.push(
  ['_setAccount', 'UA-XXXXX-X'],
  ['_setDomainName', 'example.com'],
  ['_setCustomVar', 1, 'Section', 'Life & Style', 3],
  ['_trackPageview']
);

      パラメータ

        Array commandArray 実行されるコマンド。これらの 1 つ以上を同じ呼び出しで push できます。

      戻り値

        Number 実行に失敗したコマンドの数。