トラッキング コード: ドメインとディレクトリ

このリファレンスでは、Google アナリティクスのレポートが複数のドメイン間、ホスト間、またはウェブサイトのサブディレクトリ内でどのように機能するかをカスタマイズするために使用するメソッドについて説明します。

GATC ドメイン/ディレクトリ メソッド

メソッドの詳細

_cookiePathCopy()

_cookiePathCopy(newPath)

すべての GATC Cookie のパスを、新しく指定されたパスに変更します。この機能を使用して、同じドメイン上のあるディレクトリ構造から別のディレクトリ構造へのユーザーの行動を追跡します。

この関数が呼び出されると、すべての Cookie が新しい Cookie パスに直ちにコピーされます。そのため、_trackPageview() メソッドが呼び出されていない場合は、既存のアナリティクス Cookie の値が提供されます。そのため、このメソッドは _trackPageview() の後に呼び出すことをおすすめします。また、 _setCampaignCookieTimeout() や _setReferrerOverride() など、渡す Cookie 値やキャンペーン値に影響する可能性があるその他の設定メソッドも呼び出すことをおすすめします。

非同期スニペット（推奨） 
_gaq.push(['_cookiePathCopy', '/newSubDirectory/']);

パラメータ

String   newPath GATC Cookie を保存する新しいパスです。

_getLinkerUrl()

_getLinkerUrl(targetUrl, useHash)

このメソッドは _setDomainName() メソッドおよび _setAllowLinker() メソッドと組み合わせて使用され、特に iFrame と新しいウィンドウで開くリンクのクロスドメイン ユーザー トラッキングを有効にできます。このメソッドは、開始リンクからすべての GATC Cookie データの文字列を URL パラメータに追加して返します。これを別のサイトまたは iframe に渡すことができます。

非同期スニペット（推奨） 
  _gaq.push(function() {
    var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
    var linkerUrl = pageTracker._getLinkerUrl('http://www.my-example-iframecontent.com/');
  });

パラメータ

String   targetUrl Cookie 値を送信するターゲット サイトの URL。

Boolean   useHash トラッキング コード変数を渡すには、デフォルトの ? ではなく # アンカータグの区切り記号を true に設定します。true に設定します。

戻り値

String リンカー URL。

_link()

_link(targetUrl, useHash)

このメソッドは、_setDomainName() メソッドおよび _setAllowLinker() メソッドと連携して、クロスドメイン ユーザー トラッキングを有効にします。_link() メソッドは、GATC Cookie を URL パラメータ（HTTP GET）を介してこのサイトから別のサイトに渡します。また、document.location を変更し、ユーザーを新しい URL にリダイレクトします。

非同期スニペット（推奨） 
<a href="http://example.com/test.html"
onclick="_gaq.push(['_link', 'http://example.com/test.html']); return false;">click me</a>

パラメータ

String   targetUrl Cookie 値を送信するターゲット サイトの URL。

Boolean   useHash トラッキング コード変数を渡すには、デフォルトの ? ではなく # アンカータグの区切り記号を true に設定します。true に設定します。

_linkByPost()

_linkByPost(formObject, useHash)

このメソッドは、_setDomainName() メソッドおよび _setAllowLinker() メソッドと連携して、クロスドメイン ユーザー トラッキングを有効にします。_linkByPost() メソッドは、参照フォームから別のサイトに GATC Cookie を、そのフォームのアクション値（HTTP POST）に付加された文字列で渡します。通常、この方法は、あるサイトからサードパーティのショッピング カート サイトへのユーザー行動をトラッキングする場合に使用されますが、ポップアップや iFrame で他のドメインに Cookie データを送信するためにも使用できます。

非同期スニペット（推奨） 
    <form action="http://www.shoppingcartsite.com/myService/formProcessor.php"
    name="f" method="post" onsubmit="_gaq.push(['_linkByPost', this]);">
...
</form>

また、リンクが機能するには、リンク先のウェブページで _setAllowLinker() を true に設定する必要があります。

パラメータ

HTMLFormElement   formObject POST リクエストをカプセル化するフォーム オブジェクト。

Boolean   useHash トラッキング コード変数を渡すには、デフォルトの ? ではなく # アンカータグの区切り記号を true に設定します。クエリ文字列の区切り文字。

_setAllowHash()

_setAllowHash(bool)

ドメイン ハッシュを許可するフラグを設定します。デフォルトでは、この値は true に設定されています。Google アナリティクスのドメイン ハッシュ機能は、ドメインからハッシュ値を作成し、その番号を使って訪問者の Cookie の整合性をチェックします。複数のサブドメイン（example1.example.com と example2.example.com など）があり、これら両方のサブドメインでユーザー行動をトラッキングする場合は、ドメイン ハッシュを無効にすると、あるドメインから別のドメインに送信されるユーザー Cookie が Cookie の整合性チェックで拒否されなくなります。また、この機能をオフにすると、ページごとのトラッキング パフォーマンスを最適化できます。

パラメータ

Boolean   true または false デフォルト値は true です。このパラメータが true に設定されている場合、ドメイン ハッシュが有効になります。それ以外の場合、ドメイン ハッシュ化は無効になります。

_setAllowLinker()

_setAllowLinker(bool)

クロスドメイン ユーザー トラッキングの有効化の一環として、リンカー機能フラグを設定します。デフォルトでは、このメソッドは false に設定され、リンクは無効になっています。クロスドメイン トラッキングを有効にするには、_link() メソッド、_linkByPost() メソッド、_setDomainName() メソッドもご覧ください。ターゲット サイトで _setAllowLinker メソッドを使用して、標準のセッション ロジックではなく URL パラメータの Cookie データを使用するようにします。

非同期スニペット（推奨） 
_gaq.push(['_setAllowLinker', true]);

パラメータ

Boolean  true または false デフォルト値は false です。このパラメータが true に設定されている場合、リンカーは有効になります。それ以外の場合、ドメインのリンクは無効になります。

_setCookiePath()

_setCookiePath(newCookiePath)

サイトの新しい Cookie パスを設定します。デフォルトでは、Cookie パスはルートレベル（/）に設定されますが、ほとんどの場合はこの方法が適しており、ウェブサイトやブログ、企業ウェブ ディレクトリにインストールしたトラッキング コードと正しく連動します。ただし、ユーザーのアクセスがドメインのサブディレクトリのみに制限されている場合、この方法では、サブディレクトリをすべてのトラッキングのデフォルト パスとして設定することで、トラッキングの問題を解決できます。

これは通常、データがトラッキングされておらず、ブログサービスに登録していて、定義されたサブディレクトリにのみアクセスできる場合、または企業または大学のネットワークを使用してホーム ディレクトリにのみアクセスできる場合に使用します。

非同期スニペット（推奨） 
_gaq.push(['_setCookiePath', '/myBlogDirectory']);

パラメータ

String   newCookiePath 設定する新しい Cookie パス。

_setDomainName()

_setDomainName(newDomainName)

GATC Cookie のドメイン名を設定します。このメソッドには 3 つのモード（("auto" | "none" | [domain])）があります。デフォルトでは、このメソッドは auto に設定され、DOM の document.domain プロパティに基づいてドメイン名の解決を試みます。

ドメインの指定

この手法でドメインを指定するケースとその方法について、さまざまな例については、クロスドメイン トラッキング ガイドをご覧ください。次の例は、ドメイン名を example.com に設定する方法を示しています。

非同期スニペット（推奨） 
_gaq.push(['_setDomainName', 'example.com']);

トップレベル ドメインの分離

このメソッドを none に設定すると、特定のドメインの Cookie にどのサブドメインからもアクセスできなくなります。

非同期スニペット（推奨） 
_gaq.push(['_setDomainName', 'none']);

パラメータ

String   newDomainName 設定する新しいデフォルト ドメイン名。

_storeGac(bool)

GAC Cookie を作成するかどうかを指定します。GAC Cookie は、デフォルトではスクリプトによって書き込まれるため、何もする必要はありません。この Cookie の設定を無効にするには、以下のコマンドを使用します。

非同期スニペット（推奨） 
_gaq.push(['_storeGac', false]);