Skip to content
Last updated

JavaScript SDKでのAnonymous Visitor ID

Visitor IDは、ウェブサイトへのvisitor用の永続的なcookieに関連付けることができます。誰かがサイトを訪問すると、HTTPレスポンスにcookieを含めることで、webサーバーによって永続的なcookieが設定されます。cookieがrequestに含まれていない場合、サーバーは一意のvisitor IDを生成し、HTTPレスポンスヘッダーでcookieとして設定し、requestと一緒に送り返します。

前提条件

  • JavaScript/HTMLの基礎知識

  • Treasure Dataの基礎知識

  • Treasure Data JavaScript SDKの基礎知識

Treasure Dataは、本番環境で使用を開始する前に、サイトでTreasure Data JavaScript SDK version 3を使用した新機能や機能の実装を検証することをお勧めします。cookieの管理方法が異なります。これらの記事のほとんどを参照する際は、提案されたeventコレクターとTreasure Data JavaScript SDK version 3の呼び出しをソリューション内で定義する必要があることに注意してください。たとえば、//cdn.treasuredata.com/sdk/2.5/td.min.jsを//cdn.treasuredata.com/sdk/3.0.0/td.min.jsに変更します。

Cookieの基本

Cookieは、訪問したウェブサイトのサーバーによってコンピューターのハードドライブに配置される小さなテキストです。cookieは、特定のbrowserを認識する目的、またはbrowserに固有の情報を記憶する目的で、同じサイトに戻る場合に配置されます。

First-Party CookieとThird-Party Cookieの違い

すべてのcookieには、cookieが誰に属するかを示す所有者がいます。所有者は、cookieで指定されたdomainです。

"third-party cookie"では、"party"という単語はcookieで指定されたdomain、つまりcookieを配置しているウェブサイトを指します。したがって、たとえば、widgets.comにアクセスし、コンピューターに配置されたcookieのdomainがwidgets.comの場合、これはfirst-party cookieです。

ただし、widgets.comにアクセスして、コンピューターに配置されたcookieがstats-for-free.comと表示される場合、これはthird-party cookieです。

Anonymous IDのリスト

Treasure DataのJavaScript SDKは、すべての新しいvisitor用に2種類のanonymous Cookie IDを生成します。

  • First-Party Cookie ID: td_client_id

  • Third-Party Cookie ID: td_global_id

_td_client_id_は、First-Party Cookieとして生成されるIDです。このIDの特性は次のとおりです:

  • IDは同じトップレベルdomainにわたって永続化されます(たとえば、a.example.comとb.example.comで同じID)

  • IDは異なるdomainにわたって永続化されません(たとえば、test.comとexample.comで異なるID)

  • IDはbrowserに応じてcookieに永続化されます:

BraveChromeEdgeFirefoxSafariCliqz
document.cookieで設定されたcookieの場合、有効期限は7日間に設定されます。それ以外の場合、最大有効期限は6か月に設定されます。
Cookieは最大400日の有効期間に制限されます。制限なし。すべてのストレージは、ユーザーが過去45日以内にfirst-partyコンテキストでサイトとインタラクションしていない限り、既知のtrackerから毎日パージされます。document.cookieで設定されたcookieの場合、サイトでのユーザーインタラクションなしでbrowserを7日間使用すると削除されます。document.cookieで設定されたcookieの場合、参照domainが既知のtrackerである場合、URL装飾(queryパラメータまたはfragment)を持つページで有効期限は24時間に設定されます。まれにfirst-partyインタラクションを持つtracker domainに設定されたcookieは7日後に期限切れになります。それ以外の場合、有効期限はサイトへの最後の訪問から30日後に設定されます。document.cookieで設定されたcookieの最大有効期限は7日間です。

td_client_idの取得

browserのJavaScriptコンソールから以下の関数を呼び出すことで、自分の_td_client_id_を受け取ることができます。

> td.getCookie('_td');
"9eeeed71-8eb8-40f3-9a41-bd8b1f096474"

_td_global_id_は、3rd Party Cookieとして生成されるIDです。このIDの特性は次のとおりです:

  • IDは同じトップレベルdomainにわたって永続化されます(たとえば、a.example.comとb.example.comで同じID)

  • IDは異なるdomainにわたって永続化されます(たとえば、test.comとexample.comで同じID)

  • ただし、PCおよびMobileを含むすべてのSafari browserでは、IDはまったく永続化されません。

  • 他のbrowserの場合、visitorがbrowserのcookieを明示的にクリアしない限り、IDはcookieに永続化されます

詳細については、Cross Domain Trackingを確認してください。

td_global_idの取得

コンテンツパーソナライゼーションなどを行うために、JavaScriptから_td_global_id_変数を受け取りたい場合があります。以下のコード例は、JavaScript endpointをタップして_td_global_id_を受け取ります。

// Configure an instance for your database
var td = new Treasure({
  host: 'in.treasuredata.com',
  writeKey: 'YOUR_WRITE_ONLY_APIKEY_IS_HERE',
  database: 'DATABASE_NAME'
});
// Enable cross-domain tracking
td.set('$global', 'td_global_id', 'td_global_id');

// Receive td_global_id
var successCallback = function(td_global_id) {
  console.log({
  'td_global_id': td_global_id
  });
};
var errorCallback = function(err) {
  console.log(err);
};

// Track pageview information to 'TABLE_NAME' table
var afterPageviewCallback = function() {
  td.fetchGlobalID(successCallback, errorCallback);
};
td.trackPageview('TABLE_NAME', afterPageviewCallback);

この関数は、browserがDo Not Track機能に設定されている場合は機能しません。_fetchGlobalID_関数に関する詳細な技術情報は、success-failure-forcefetchで入手できます。