このリファレンスでは、Google アナリティクスのレポートが、ドメイン間、異なるホスト間、またはウェブサイトのサブディレクトリ内でどのように機能するかをカスタマイズする方法について説明します。
GATC ドメイン/ディレクトリ メソッド
_cookiePathCopy(newPath)
_getLinkerUrl(targetUrl, useHash)
_link(targetUrl, useHash)
_linkByPost(formObject, useHash)
_setAllowHash(bool)
(非推奨)_setAllowLinker(bool)
_setCookiePath(newCookiePath)
_setDomainName(newDomainName)
_storeGac(bool)
ルーティング方法の詳細
_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]);