カスタムCMP統合
この記事では、クライアントサイドの同意統合でカスタム同意管理プラットフォームを構成する方法について説明します。
仕組み
クライアントサイドの同意統合は、以下の二部分から構成されます:
- Tealium iQの同意強制フレームワーク(
utcm_frameworkテンプレート)。 - Tealium iQの同意強制フレームワークを活用するCMP特有の統合テンプレート。これらの統合テンプレートはできるだけ軽量に設計されています。
私たちの事前構築された統合は、様々な同意管理プラットフォーム(CMP)との統合をサポートしています。しかし、以下のような場合にはカスタム統合が推奨されます:
- 事前に構築された統合がないCMPを使用する場合。
- 同意をキャプチャするための内部ツールを使用する場合。
- 標準の統合を破壊する広範なカスタマイズを伴うサポートされているCMPを使用する場合。
このような場合、カスタム統合を使用できます。JavaScript関数を使用することで、任意の同意キャプチャツールが強制フレームワークを活用できます。
新しいカスタム統合を追加するには、既存の統合と提供されたテンプレートをガイドとして使用してください。
以下は、カスタム統合を作成するための基本的なワークフローを説明しています:
- Tealium iQの外部(CMPが実装されているウェブサイト)で統合を開発およびデバッグします。
- Tealium iQで新しいカスタム同意統合と目的グループを追加します。詳細については、同意統合と目的グループの管理を参照してください。
- Tealium iQと適切なタグを目的グループ内の目的に割り当てます。
- テンプレートを作成するために、プロファイルを保存します。
- 新しく作成されたテンプレートを編集します。詳細については、テンプレートの管理を参照してください。
- 開発環境またはテスト環境にテンプレートを公開して、すべてが期待通りに動作することを確認し、その後通常のテストおよび公開フローに従ってください。
統合機能
統合のCMP特有のコンポーネントは、window.tealiumCmpIntegration オブジェクトを使用して定義されます。
window.tealiumCmpIntegration オブジェクトは、名前 .cmpName、バージョン .cmpIntegrationVersion、および以下の関数で構成されます:
動作モードの決定
.cmpCheckIfOptInModel- 統合がopt-inモデルまたはopt-outモデルで動作するかどうかを決定します。ブール値を返します。
決定の取得
.cmpFetchCurrentConsentDecision- CMPからの同意決定の現在の生バージョンを取得します。結果はオブジェクトでなければならず、すべての後続の関数に引数として渡されます。
決定の検証と標準化
-
.cmpCheckForWellFormedDecision- 同意決定の生バージョンが適切に形成され、理解可能であるかどうかをチェックします。ブール値を返します。 -
.cmpCheckForTiqConsent- 生の同意決定にTealium iQによるデータ処理の許可が含まれているかどうかを決定します。falseの場合、何も実行されません。ブール値を返します。 -
.cmpCheckForExplicitConsentDecision- 生の同意決定が明示的か暗黙的かを決定します。ブール値を返します。 -
.cmpConvertResponseToGroupList- 生の決定を下流の強制のための許可された目的キーの単純な配列に変換します。同意された目的キーの配列を返します。
cmpConvertResponseToGroupList によって返される目的キーは、同意統合で構成された目的名と正確に一致する必要があります。Vendor ID フィールドは、Tealium iQ UIでテンプレートが関連するCMPクッキーまたは識別子を識別するために使用されます。この値はCMPの使用例でのクッキー名または識別子と一致する必要があります。大文字と小文字を区別します。
同意更新の監視とトリガー
-
.cmpAddCallbackToTriggerRecheck- CMPの同意ステータスが変更されるたびに呼び出されるコールバック関数を登録します。これにより、Tealium iQはポーリングに頼ることなく最新の同意決定を迅速に更新できます。cmpAddCallbackToTriggerRecheckは、CMPがコールバックまたは代替実装方法を通じて同意ステータスの変更を通知するたびにtriggerRecheck()を呼び出すように構成されていることを確認してください。バナーが暗黙的同意のために表示されるときやCMPの読み込み時の類似点でtriggerRecheck()を呼び出します。詳細は、カスタム統合テンプレート のコメントを参照してください。現在コールバックをサポートしている統合については、サポートされているベンダー統合を参照してください。
カスタム統合テンプレート
カスタムCMP統合を作成するには、以下の空白テンプレートを編集してCMPの要件に合わせます。テンプレートにはコメントが含まれており、動作例を参照してください。テンプレートの最後には、コンセント統合をデバッグおよび検証するために使用できるデバッグスニペットが含まれています。
開発とデバッグを行ってから公開する
カスタムCMPインテグレーションを作成するには、カスタムインテグレーションテンプレートを編集してCMPの要件に合わせます。カスタムテンプレートのコメントを参照して、動作例を確認してください。
開発中にデバッグを行うための次のステップを完了してください:
- カスタムインテグレーションテンプレートの最後にあるデバッグブロックのコメントを外します。
- テンプレートをサポートしたいCMPを実行しているウェブサイトのコンソールに貼り付けます。
- デバッグコードブロックが同意決定を出力します。
- あなたの決定をカスタマイズし、新しく解釈された同意決定を見るためにテンプレートを再度貼り付けます。
- テンプレートに満足したら、Tealium iQに貼り付けて公開する前に再びデバッグブロックをコメントアウトします。
デバッグスニペットは、プロファイルを保存してテンプレートを編集することで見つけることができます。
公開後の検証
公開後にテンプレートをデバッグして検証する方法は2つあります:デバッグモードを使用するか、window.tealiumCmpOutputオブジェクトを使用するかです。
デバッグモードを使用する
デバッグモードを使用するには:
- コンソールで
document.cookie = "utagdb=true"を構成してutagdbクッキーをtrueに構成します。 - 関連する出力のみを表示するようにコンソールフィルターを構成します(デバッグ出力で提案されているフィルターを使用します)。
- 期待通りに動作するかどうか、異なるオプションをテストします。
window.tealiumCmpOutputオブジェクトを使用する
window.tealiumCmpOutputオブジェクトを使用するには:
- テンプレートの最下部にコメントアウトされているデバッグコードブロックをコンソールに貼り付けて、あなたの決定と関連する出力のみを出力します。
- 必要に応じて、テンプレート内の関数を個別に呼び出すか、このオブジェクトの他の便利なプロパティにアクセスすることもできます。
プリビルトおよびカスタムインテグレーションのより詳細なデバッグのヒントについては、同意インテグレーションの検証とデバッグを参照してください。
最終更新日 :: 2026年April月22日