同意統合の検証とデバッグ
この記事では、Tealium iQ Consent Integrationsの検証とデバッグ方法について説明します。
公開前にConsent Integrationsを検証する
あなたの同意統合を検証し、デバッグするために、統合テンプレートを他の依存関係なしにサイトのJavaScriptコンソールに貼り付けます。Consent Integrationテンプレートは編集可能で、スタンドアロンで設計されているため、ウェブサイトのコンソールからデバッグが可能です。
テンプレートの使用は、カスタム統合の作成に役立ち、また、ベンダーID、目的キーを取得したり、構成前にデフォルトのテンプレートがCMPのインスタンスでカスタマイズなしで動作することを確認するためにも使用できます。現在のテンプレートには、検証スニペットが含まれており、ドキュメンテーションで提供されています。
公開後にデバッグモードを有効にする
Tealium iQのデバッグモードは、機能がアクティブである場合、あなたのConsent Integrationsからの詳細なステータスとエラーメッセージを含んでいます。ただし、免除が適用される場合は除きます。免除が適用されると、window.tealiumCmpIntegration
が定義され、window.tealiumCmpIntegration.exemptionMap
にアクティブな免除が表示されます。
コンソール出力でのフィルタとして/SENDING|****/
を使用して、関連するデバッグメッセージのみを表示します。
公開後にConsent Integrationsを検証する
Tealium iQ Consent Integrationsは、DOMにwindow.tealiumCmpIntegration
という名前のグローバルオブジェクトを作成し、デバッグに役立ついくつかのプロパティを持っています。また、デバッグと検証を容易にするために、コンポーネント関数を個別に呼び出すこともできます。コンポーネント関数の詳細については、カスタムCMP統合を参照してください。
例
この例では、CMP統合に関する重要な情報を取得する方法について説明します。
CMP統合に関する重要な情報を確認し、顧客の決定が正しくキャプチャされていることを確認するために、以下の手順を完了します:
- このデモサイトまたはアクティブな同意統合がある任意のサイトを訪れ、以下のスニペットをブラウザのコンソールに貼り付けます:
var outputString = `${tealiumCmpIntegration.cmpName} - ${tealiumCmpIntegration.cmpCheckIfOptInModel() ? 'Opt-in' : 'Opt-out'} Model Checks: - vendor id: ${tealiumCmpIntegration.cmpFetchCurrentLookupKey()} - well-formed decision: ${tealiumCmpIntegration.cmpCheckForWellFormedDecision(tealiumCmpIntegration.cmpFetchCurrentConsentDecision())} - explicit decision: ${tealiumCmpIntegration.cmpCheckForExplicitConsentDecision(tealiumCmpIntegration.cmpFetchCurrentConsentDecision())} - consented purposes: ${JSON.stringify(tealiumCmpIntegration.cmpConvertResponseToGroupList(tealiumCmpIntegration.cmpFetchCurrentConsentDecision()).sort(),null, 8)} ` console.log(outputString)
- 上記のスニペットをデモサイトのコンソールに貼り付けると、次のような結果が返されます:
OneTrust - Opt-in Model Checks: - vendor id: b38364e4-b2c4-4349-8e4e-48cf28a35db8 - well-formed decision: true - explicit decision: false - consented purposes: [ "C0001" ]
- Webページ上で全てのクッキーを承認するをクリックし、同じスニペットを再度貼り付けます。次の出力は、決定が統合によって正しく理解され、キャプチャされたことを示しています:
OneTrust - Opt-in Model Checks: - vendor id: b38364e4-b2c4-4349-8e4e-48cf28a35db8 - well-formed decision: true - explicit decision: true - consented purposes: [ "C0001", "C0002", "C0003", "C0004" ]
公開後に衝突とEnforcement Rulesをデバッグする
window.tealiumCmpIntegrations
には、ページ上でどの統合が強制されているかを理解するのに役立ついくつかの便利なプロパティがあります。例えば、loadRules
には、どの同意統合が強制されていて、衝突があったかどうか(これによりTealium iQとすべてのタグがブロックされます)を示す子プロパティがあります。
map
とtagBasedMap
は、タグUIDとPurpose Keysの関係の異なるビューを示します。tiqGroupName
は、Purpose KeyとTealium iQ自体のマッピングを示します。cmpName
は、現在アクティブなCMP(テンプレートによる)を示します。cmpIntegrationVersion
は、使用しているベンダー固有の統合テンプレートの現在のバージョンを示します。version
は、使用している基本的な同意強制フレームワークのバージョンを示します。
このオブジェクトに含まれる特定の統合機能の詳細については、カスタム統合の作成に関する関連ドキュメンテーションを参照してください。
最終更新日 :: 2024年May月15日