TD JavaScript SDK(TD JS SDK)により、Treasure Dataはお客様のドメインのウェブサイトにfirst-party cookieを保存し、ウェブサイトのユーザーを他のプラットフォーム全体で追跡して情報を収集できます。TD JS 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に変更します。
詳細については、Web Trackingの開始およびTD JavaScript SDKを使用したWeb Trackingのチュートリアルをご覧ください。TD JS SDK version 2.5.0のセットアップと設定に関する追加情報は、GitHubで入手できます。
このトピックには以下が含まれます:
- Version 2.5.0の更新
- Consent Management拡張機能
- Treasure Data JavaScript SDK Version 2.5.0のログパラメータ
- Version 2.4.2の更新
TD SDK Consent拡張機能をconsent management活動に使用することもできます。これには、消費者のconsentを収集する機能、さまざまなデータ使用カテゴリを定義する機能、ブラウザに消費者のconsent設定を表示する機能が含まれ、ブラウザから閲覧できます。
Consent Managerの設定の詳細をご覧ください。
TD JS SDKは、trackPageview関数を使用して以下のパラメータをログに記録します。
| パラメータ | 説明 | デフォルト |
|---|---|---|
| td_version | td-js-sdkのバージョン | X |
| td_client_id | クライアントのuuid | NO |
| td_charset | 文字セット | X |
| td_description | descriptionメタタグ | X |
| td_language | ブラウザ言語 | X |
| td_color | 画面のcolor depth | X |
| td_screen | 画面解像度 | X |
| td_viewport | viewportサイズ | X |
| td_title | ドキュメントタイトル | X |
| td_url | ドキュメントURL | X |
| td_user_agent | ブラウザuser agent | X |
| td_platform | ブラウザplatform | X |
| td_host | ドキュメントhost | X |
| td_path | ドキュメントpathname | X |
| td_referrer | ドキュメントreferrer | X |
| td_ip | リクエストIP(server) | NO |
| td_browser | クライアントbrowser(server) | X |
| td_browser_version | クライアントbrowserバージョン(server) | X |
| td_os | クライアントoperating system(server) | X |
| td_os_version | クライアントoperating systemバージョン(server) | X |
| td_global_id | 3rd party cookie | NO |
| td_ssc_id | Server Side Cookie | No |
追跡されるデフォルトパラメータには、グローバルなプライバシー法への準拠を確保するためにtd_client_id、td.ip、およびtd_global_idが含まれていません。td.setコマンドを呼び出すことで有効にできます。
Cookie ID
Treasure Dataでは、1st party cookieはtd_client_idと呼ばれ、3rd party cookieはtd_global_idと呼ばれます。
ChromeとFirefoxは、secure-by-defaultのcookie分類システムを実施しています。このシステムは、SameSite値が宣言されていないcookieをSameSite=Laxとして扱います。SameSite=None; Secureとして設定されたcookieのみが、セキュアな接続からアクセスされる場合に限り、third-partyコンテキストで利用できます。Treasure Data JS SDK version 2.4.2は、新しいcookie実施に適応するために、デフォルトでSameSite=None; Secure cookieを使用します。TreasureData JS SDKをバージョン2.4.2にアップグレードする場合、新しい更新を有効にするにはresetUUIDまたはfetchGlobalIDを呼び出す必要があります。
さらに、version 2.4.2では、AnonymousモードでClient ID cookieが無効になります。startInSignedModeオプションがfalseの場合、またはtd.setAnonymousMode()が呼び出された場合、_td cookieは無効になります。これにより、ユーザーがデバイス識別をオプトアウトした場合に、_td cookieがrequestに添付されることを防ぎます。