Tealium同意登録 | 同意 | Tealiumドキュメント

Tealium同意登録は、Tealium iQ Consent IntegrationsおよびConsent Managerによって使用され、ウェブサイトのコード全体に同意信号を公開します。また、Google同意モードタグがこれらの信号に直接アクセスし、適切な反応を可能にします。

主な特徴

ユニバーサル同意イベント: 最新のConsent Manager（cmGeneralテンプレートv3.1.0から）とConsent Integrations（フレームワークテンプレートv1.2.0から）は、同意構成が読み込まれたり更新されたりしたときにイベントを発生させるために同意登録を使用します。これらの変更はページ上のwindow.tealiumConsentRegisterオブジェクトで全世界的にアクセス可能です。詳細については、MDN Web Docs: イベントの紹介を参照してください。
すべての同意信号のサポート: implicitおよびexplicitの両方の同意信号を発行および保持します。
イベントリスニング: ページ上の任意のタグまたはスクリプトがconsent_loadedおよびconsent_changedイベントをリッスンできます。これにより、同意状態の変更に基づいて反応的なアクションが可能になります。詳細については、MDN Web Docs: EventTarget addEventListener() メソッドを参照してください。
拡張のための堅固な基盤: Tealium同意登録は、高度なカスタマイズオプションを提供し、将来の新機能の追加を容易にする堅牢な新システムを導入します。

動作原理

Tealium同意登録は、同意決定をウェブサイトのコード全体で共有することにより、同意管理を改善します。これにより、Google同意モードなどの機能がこれらの決定にアクセスして適切なアクションを取ることが可能になります。これは同意信号の標準化層として機能し、それらの標準化された同意信号をウェブページ上で簡単に利用できるようにします。

Google同意モード

基本的な背景とコンテキストについては、Google同意モードを参照してください。ページにGoogleタグを統合する適切なタイミングと方法については、リーダーシップチームおよび法務チームと相談することが重要です。

前提条件

CMPから既存の同意モード機能を無効にして、競合を防ぎます。
使用事例に基づいて、Consent IntegrationsフレームワークまたはConsent ManagerのcmGeneralテンプレートの最新バージョンに更新します。
同意モードマッピングのためのJavaScript拡張を追加します。詳細については、同意目的マッピングを参照してください。
Google同意モードタグをインストールします。同意目的マッピング拡張からの変数名を使用する場合、追加のマッピングは必要ありません。
同意モードタグ（および関連するすべてのGoogleタグ）を適切に分類します。高度な同意モードを実装している場合は常に発火を許可し、適切な同意がある場合のみ発火を許可するようにします。

高度な使用事例

同意決定へのアクセス

window.tealiumConsentRegister.currentDecisionオブジェクトを使用すると、ウェブページ上の現在の同意決定に直接アクセスできます。これにより、次のようなカスタムアクションの実装が簡素化されます：

ベンダーへのオプトアウトイベントの送信により、オーディエンスからの削除と完全な下流での非アクティブ化を可能にします。
CMPが提供するものに加えて、Tealium iQ拡張を使用した同意ログの追加レイヤー。
同意変更の追跡により、JavaScript APIコールを通じて現在の決定にアクセスします。

Consent IntegrationsおよびConsent Managerの場合、配列内の目的IDは特定の構成ごとに異なります。

// 現在の決定を取得
var currentDecision = window.tealiumConsentRegister.currentDecision

// 現在のページが読み込まれてから登録されたすべての決定を取得
var allDecisionsOnThisPage = window.tealiumConsentRegister.decisions

OneTrustを使用したConsent Integrationsの例

この例では、オプトインモデル（暗黙の決定）で開始し、説明のためにオプトインおよびオプトアウトを行います。

同意変更の監視

同意登録は、ページ上でimplicitまたはexplicitの同意信号が最初に検出されたとき、または同意決定が更新されたときにイベントを発生させます。

// 同意変更を表面化するためのイベントリスナーの例を構成

// ページコードごとに一度実行できるように実装できます - 使用事例に応じてPre LoaderまたはDOM Readyを使用できます
window.addEventListener('consent_loaded', (event) => {
  console.log('Consent loaded:', event.detail.decision);
});

window.addEventListener('consent_updated', (event) => {
  console.log('Consent updated:', event.detail.decision);
});

初回訪問時にオプトインするヨーロッパのユーザーのConsent Managerの例

透明性のため、これらの決定には常にalways_onカテゴリが含まれます。なぜなら、省略されたタグは常に許可されるからです。

タグが発火を許可されているかどうかを確認

isTagAllowedメソッドを使用すると、現在の同意構成とユーザー決定に基づいて特定のTealium iQタグが発火を許可されているかどうかを確認できます。この方法の主な使用事例は、以前に許可されていたタグの同意が取り消された場合のフォールバック動作です。

window.tealiumConsentRegister.isTagAllowed(tagId);

tagId（整数または文字列）: Tealium iQでタグに表示されるタグのUIDです。この方法は、数値または数値に変換可能な文字列（例えば「7」）を受け入れます。
戻り値はブール値: タグが必要な同意を持っている場合はtrue、タグが許可されていない、存在しない、または同意が与えられていない場合はfalseです。

どちらの条件も当てはまらない場合、またはtagIdが存在しない場合、メソッドはfalseを返します。

オプトアウト処理

isTagAllowedメソッドをTealium iQタグテンプレートに統合するには、テンプレートを編集するか、タグスコープの拡張を使用します。同意が取り消されたときにベンダー固有のオプトアウトアクションを処理するコールバックを構成します。以前に許可されていたタグが後でブロックされた場合、コールバックは次のことができます：

ベンダーへのオプトアウトリクエストをトリガーします。
ページからベンダーのオブジェクトを削除して、さらなるデータ送信を停止します。
ベンダー固有のクッキーを削除します。
その他の関連するクリーンアップアクションを実行します。

これらのコールバックをタグスコープの拡張または直接タグテンプレートに追加します。

タグ内での統合例（タグスコープの拡張、ハードコードされたUID）

// コールバックを一度だけ追加することを確認してください（新しいタグスコープのブール値を使用）
if (!u.consent_callback_initialized) {
  u.consent_callback_initialized = true;
  window.addEventListener('consent_updated', (event) => {
    var exists = window.tealiumConsentRegister &&
                 typeof window.tealiumConsentRegister.isTagAllowed === "function";
    if (exists && !window.tealiumConsentRegister.isTagAllowed(7)) {
      console.log("Opt-out signal triggered for tag 7.");
      // Implement appropriate, vendor-specific opt-out logic here,
      // deduplicating if needed
    }
  });
}

タグ内の例示的な統合（テンプレートコード、動的UID）

文字列 ##UTID## はタグの一意のIDを表す動的なプレースホルダーです。この値は実行時にTealiumによって自動的に実際のタグIDに置き換えられます。手動で ##UTID## を自分の値に置き換える必要はありません。

// コールバックを一度だけ追加するようにしてください（新しいタグスコープのブール値を使用）
if (!u.consent_callback_initialized) {
  u.consent_callback_initialized = true;
  window.addEventListener('consent_updated', (event) => {
    var exists = window.tealiumConsentRegister &&
                 typeof window.tealiumConsentRegister.isTagAllowed === "function";
    if (exists && !window.tealiumConsentRegister.isTagAllowed("##UTID##")) {
      console.log("タグ " + "##UTID##" + " に対するオプトアウト信号がトリガーされました");
      // ここで適切なベンダー固有のオプトアウトロジックを実装し、
      // 必要に応じて重複を排除します
    }
  });
}

同意イベントとリスナーのフローダイアグラム

新しいイベントとリスナーを説明するためのフローの簡略化された概要です。

Tealium 同意レジスタの抑制

Pre Loader拡張機能で suppressConsentRegister フラグを構成することにより、同意レジスタを抑制できます。

同意レジスタを抑制するには、Pre LoaderスコープのJavaScriptコード拡張機能に次のコードを追加します：

window.tealiumCmpIntegration = window.tealiumCmpIntegration || {};
window.tealiumCmpIntegration.suppressConsentRegister = true;

この構成はすべての同意レジスタ機能を抑制するため、慎重に使用してください。