_gaq
グローバル オブジェクトは、push(...)
メソッドによる非同期のページ トラッキングに直接使用できます。これにはトラッカー オブジェクトを作成するメソッドがありますが、これらのメソッドは限られた状況でのみ使用する必要があります。
従来のページ トラッキングの場合は、代わりに _gat
グローバル オブジェクトを使用してください。
_gaq オブジェクトのメソッド
_createAsyncTracker(accountId, opt_name)
サポート終了_getAsyncTracker(opt_name)
サポート終了push(commandArray)
メソッドの詳細
_createAsyncTracker()
_createAsyncTracker(accountId, opt_name)
-
非同期トラッキング呼び出しの際に名前で参照できるトラッカー オブジェクトを作成します。名前を指定しない場合は空の文字列
''
になり、デフォルトのトラッカーを非同期構文で表します。指定した名前の非同期トラッカーがすでに存在する場合は、新しいトラッカーで上書きされます。注: このメソッドは通常、
_gaq
にプッシュされた関数内でのみ安全に使用できます。まれにしか使用しないでください。
_gaq._createAsyncTracker('UA-65432-1');
パラメータ
String accountId
トラッカー オブジェクトの完全なウェブ プロパティ ID(例: UA-65432-1)。
String opt_name
トラッカー オブジェクトを保存する名前。この名前は、後の非同期トラッキング呼び出しでトラッカー オブジェクトを参照する際に使用します。
戻り値
Tracker
作成されたトラッキング オブジェクト。_getAsyncTracker()
_getAsyncTracker(opt_name)
-
指定された名前で以前に作成されたトラッカー オブジェクトを返します。
名前を指定しない場合は、デフォルトのトラッカー名(空の文字列
''
)が使用されます。指定した名前のトラッカー オブジェクトが存在しない場合は、新しいトラッカーが作成され、その名前に割り当てて返されます。注: このメソッドは通常、
_gaq
にプッシュされた関数内でのみ安全に使用できます。まれにしか使用しないでください。
_gaq._getAsyncTracker();
パラメータ
String opt_name
取得するトラッカー オブジェクトの名前。
戻り値
Tracker
取得または作成されたトラッキング オブジェクト。push
push(commandArray)
-
指定された
command array
を実行します。これは単に、次の形式に従う JavaScript 配列です。配列の最初の要素は、文字列として渡されるトラッカー オブジェクト メソッドの名前にする必要があります。残りの配列要素は、関数に引数として渡される値です。一般的な使用方法は以下のとおりです。
var _gaq = _gaq || []; _gaq.push(['_setAccount', 'UA-65432-1']); _gaq.push(['_trackPageview']);
この関数は
_gaq
の代わりに配列を使用できます。アナリティクスの読み込み中に、コマンドは配列にプッシュまたはキューに入れられます。アナリティクスの読み込みが完了すると、配列が _gaq
オブジェクトに置き換えられ、キューに入っているコマンドがすべて実行されます。後続の _gaq.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
実行に失敗したコマンドの数。