Treasure Data JavaScript Consent Extension (TD JS Consent Extension) は、クライアント側で consent 管理ソリューションを実装する API セットです。TD のお客様は、データ使用のカテゴリーと consent 収集のための異なる context を定義できます。

Consent Extension は、Web サイト訪問者が自分についてのデータの収集方法に関する consent 設定を制御およびカスタマイズできるようにします。訪問者は、完全にオプトアウトするか、データ使用の目的に同意しない場合は特定の context でのデータ収集を選択的にオプトアウトすることができます。UI で完全にカスタマイズ可能な consent 管理を構築できるアドオンもあります。

• TD JS SDK に精通していること

• Treasure Data Platform にアクセスするための Write API KEY

Treasure Data JavaScript Consent Extension には、Web サイトの consent 情報を定義できる以下の概念があります:

• Context
• Consent

例えば、consent の context_id と purpose のパラメータを含めて、consent を一意にすることができます。この組み合わせにより、Treasure Data で消費者の consent をクエリしてフィルタリングできます。

Context は、ブランド、ドメイン、consent 収集のタイプなどの一般的な情報を定義します。これらの情報は、ユーザーが consent に同意または拒否した context を識別します。Treasure Data は、context に対して以下のデフォルトフィールドを提供します。context を充実させるために、いつでも追加のフィールドを追加できます。

context_id| 各 context に対して自動生成される ID。

例えば、context のコードスニペットは次のようになります:

{
  brand: 'A brand',
  domain_name: 'abrand.com',
  collection_type: 'shopping_cart',
  collection_point_id: 'shopping_trnx_id',
  context_id: 'xxxxxxxxxx'
}

Consent は、消費者によって与えられた consent のセマンティクスを定義します。Consent フィールドは次のように定義されます。

例えば、consent のコードスニペットは次のようになります:

{
  purpose: 'analytics',
  status: 'given',
  datatype: 'Purchase',
  context_id: 'xxxxxxxxxx',
  identifier: 'client id',
  expiry_date: 'YYYY-MM-DD'
}

Consent Manager は、TD JS Consent Extension のメイン JS オブジェクトです。Consent Manager の設定は、TD JavaScript SDK の初期化と共にセットアップされます。database 名、API write key、およびお客様のリージョンに適した host を入力します。

TD Consent Manager を次のように設定します:

1. JS SDK を使用している新しい js file を開くか作成します。例えば、td_initializations.js です。 ファイルは次のようになります:

var td = new Treasure({
   database: 'database',
   writeKey: '1/xxxxxxxxxx',
   host: 'in.treasuredata.com',
   ...

2. 前述のパラメータに従って TD JS Consent Manager の設定を開始します。 例は次のようになります:

var td = new Treasure({
  database: 'database',
  writeKey: '1/xxxxxxxxxx',
  host: 'in.treasuredata.com',
  consentManager: {
    storageKey: 'storage key',
    successConsentCallback: function () {},
    failureConsentCallback: function () {},
    expiredConsentsCallback: function () {},
    consentTable: 'consent_table_name',
    contextTable: 'context_table_name',
    issuer: 'name of the consent management platform',
    dateFormat: 'YYYY-MM-DD'
  }
})

以下のパラメータを使用して TD Consent Manager を設定できます。

ページが読み込まれるたびに、TD JS Consent Manager は consent の有効期限をチェックし、期限切れの consent がある場合は expiredConsentCallback がトリガーされます。また、期限切れの consent のステータスを expired に更新します。

consent に context を追加すると、TD platform にデータを送信する際に context が含まれます。独自の context ID を指定できます。指定しない場合は、新しい context ID が戻り値として生成されます。

例えば、コードスニペットは次のようになります:

sdk.addContext({
  brand: 'A Brand',
  domain_name: 'abrand.com',
  collection_type: 'shopping_cart',
  collection_point_id: 'shopping_trnx_id'
  context_id: 'uuid'
})

context ID を持たない consent は、デフォルトの context に追加されます。

例えば、コードスニペットは次のようになります:

sdk.addConsents({
  'marketing': { // <--- purpose
description: 'description of consent',
datatype: 'Attibutes',
status: Given | Refused,
expiry_date: 'YYYY-MM-DD',
context_id: 'context_id'
  },
  'storing': { // <--- purpose
description: 'description',
datatype: 'datatype',
status: Given | Refused,
expiry_date: 'YYYY-MM-DD',
context_id: 'context_id'
  },
  'recommendations': { // <--- purpose
description: 'description',
datatype: 'datatype',
status: Given | Refused,
expiry_date: 'YYYY-MM-DD',
context_id: 'context_id'
  }
)

SDK は、consent が期限切れになった場合、consent が更新された場合、consent が Treasure Data に正常に送信された場合、または consent が失敗した場合など、さまざまな callback 関数を提供します。

これらの callback がトリガーされたときの動作を決定するために、追加のコードを追加できます。

例えば、コードスニペットは次のようになります:

function successCallback (preferences) {
  if (preferences['analytics'].status === 'given') {
td.setSignedMode()
td.unblockEvents()
  } else if (preferences['analytics'].status === 'refused') {
td.setAnonymousMode()
td.blockEvents()
  }

Web サイトに表示される cookie banner を作成してデプロイし、Web サイト訪問者から consent を求めることができます。cookie banner には通常、訪問者にデータが収集されていること、および consent に従って特定の目的に使用されることを知らせる短い声明が含まれています。さらに、サイト訪問者が consent 設定を直接制御できる Consent Manager UI へのリンクを追加できます。

cookie banner と Consent Manager UI の例については、Treasure Data GitHub repo を参照してください。

デフォルトの consent preferences を作成するのと同様に、ユーザーが特定のデータ使用の consent を承認または拒否した場合に、consent ステータスを更新できます。そのためには、デフォルトとして設定したときと同じ名前を consent に使用し、以下のパラメータで updateConsent (contextId, consentObject) を呼び出します:

Consent preferences を更新するための Parameters

例えば、コードスニペットは次のようになります:

sdk.updateConsent('xxxxxx-context-id', {
  'recommendations': {
status: 'refused'
  }
})

consent を更新すると、saveConsents を呼び出した後、更新された consent のみが successConsentCallback に送信されます。

既存の context を更新して、context を説明するための詳細情報を追加することもできます。

Context を更新するための Parameters:

sdk.updateContext('xxxxxx-context-id', {
  brand: 'Other brand',
  domain_name: 'otherdomain.com'
})

以下の呼び出しを使用して、consent と context を local storage と Treasure Data に保存できます:

saveConsents(success, error);
saveContexts(success, error);

Consent を保存するための Parameters:

例えば、コードスニペットは次のようになります:

function success () {
  // yay()
}

function error (err) {
  /**
  * err: { success: false, message: 'Timeout' }
  */
}
sdk.saveContexts(success, error)

Contexts を保存するための Parameters:

例えば、コードスニペットは次のようになります:

function success () {
  // yay()
}

function error (err) {
  /**
  * err: { success: false, message: 'Timeout' }
  */
}
sdk.saveContexts(success, error)

これらは、TD Consent Manager からローカルに consent 情報を取得するために呼び出すことができるその他のユーティリティ関数です。

| consent のリストを返します

| context のリストを返します

特定の consent の有効期限を取得します getExpiredConsents()

期限切れの consent を返します

getConsentExpiryDate の Parameters:

例えば、getConsentExpiryDate のコードスニペットは次のようになります:

sdk.getConsentExpiryDate('context_id', 'analytics')