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

このリファレンスでは、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 に設定します。

戻り値

String リンカーの URL

_link()

_link(targetUrl, useHash)

このメソッドは、_setDomainName() メソッドおよび _setAllowLinker() メソッドと組み合わせて使用し、クロスドメイン ユーザー トラッキングを有効にします。_link() メソッドは、URL パラメータ（HTTP GET）を介してこのサイトから別の GATC Cookie を渡します。また、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 に設定します。

_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 トラッキング コード変数をデフォルトの #? アンカー セパレータ（# ではなく）を使用してクエリ文字列の区切り文字。

_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 パスを設定します。デフォルトでは、Google アナリティクスは 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（ブール値）

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

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