Microsoft Clarity タグ構成ガイド

Microsoft Clarity は、ウェブサイトの訪問の行動をよりよく理解することで、ウェブサイトの体験を改善するのを支援するために作られた無料の分析製品です。

タグのヒント

• プロジェクトIDの値を動的に上書きするためにマッピングを使用する
• 詳細については、Bing: Microsoft Clarity が一般公開されましたを参照してください

タグの構成

タグマーケットプレイスにアクセスして新しいタグを追加します。タグの追加方法についての詳細は、タグの管理を参照してください。

タグを追加する際には、以下の構成を行います：

• プロジェクトID：Clarity プロジェクトID。プロジェクトIDは、Clarity プロジェクトのURLから見つけることができます。例：https://clarity.microsoft.com/projects/view/PROJECT_ID/。
• 広告保存の同意：広告保存のデフォルト同意を構成します。ad_storageパラメータをデータマッピングセクションでマッピングすることにより、この値を動的に更新します。
• 分析保存の同意：分析保存のデフォルト同意を構成します。オプションは未構成、許可、拒否です。未構成に構成されている場合、分析保存は広告保存の同意構成に従います。analytics_storageパラメータをデータマッピングセクションでマッピングすることにより、この値を動的に更新します。
• Tealium 同意クッキーから自動的に読み取る：trueに構成されている場合、同意はTealium 同意マネージャーに基づいて構成されます。

同意モード

このタグは、独立した広告および分析保存の信号を送信するClarityの同意API v2を使用します。同意API v2は、EEA、英国、スイスの訪問に対して適用されます。

このタグの同意モードを実装するには2つのオプションがあります：

• クライアントサイドの同意管理を使用し、Tealium 同意クッキーを自動的に読み取る。
• JavaScript コード拡張を追加して、同意管理プラットフォーム（CMP）からこのタグに同意選択とカテゴリマッピングをマップします。

訪問が同意選択を行うと、タグは第一者および第三者クッキーに対して適切なアプローチを選択します：

• 許可：第一者および第三者クッキーの両方を読み書きできます。
• 拒否：第一者クッキーは読み書きされず、第三者クッキーは詐欺およびスパム目的でのみ読み取り可能で、広告目的ではありません。

クライアントサイドの同意管理

このタグの同意モードをクライアントサイドの同意管理を使用して実装するには、タグ構成でTealium 同意クッキーから自動的に読み取るをtrueに構成します。

JavaScript コード拡張

エンドユーザーの同意選択をMicrosoft同意モード構成にマッピングするには、JavaScript コード拡張を使用します。拡張を次のように構成します：

• スコープを**ロードルール後（デフォルト）**に構成
• 発生を常に実行に構成
• CMPのためのロジックでCUSTOM_LOGICを置き換えることにより、CMP用の以下のJavaScriptコードテンプレートをカスタマイズします。

b.consent_decision = (tealiumConsentRegister && tealiumConsentRegister.currentDecision) || [];
b.microsoft_ad_storage_consent = CUSTOM_LOGIC ? 'granted' : 'denied';

例えば、以下のコードはOneTrust用です。

// ロードルール後 - 常に実行
b.consent_decision = (tealiumConsentRegister && tealiumConsentRegister.currentDecision) || [];
b.microsoft_ad_storage_consent = b.consent_decision.indexOf('C0004') !== -1  ? 'granted' : 'denied';

これらの正確な変数名を使用する場合、追加のマッピングは必要ありません。タグの最新バージョンはデフォルトでこれらの変数を使用します。特定のケースの属性にad_storageパラメータをマッピングすることにより、これらの変数を上書きします。

ロードルール

すべてのページでタグをロードするか、タグがロードされる条件を構成します。詳細については、ロードルールについてを参照してください。

データマッピング

マッピングは、データレイヤー変数からベンダータグの対応する宛先変数にデータを送信するプロセスです。詳細については、データマッピングについてを参照してください。

利用可能なカテゴリは以下の通りです：

標準

イベント

イベントをマッピングするには、イベントマッピングの作成を参照してください

イベントタブで構成されたカスタムイベント名は、カスタムイベントとしてClarityに転送されます。イベント固有のマッピングには、カスタムイベントカテゴリのcustom_event_name宛先を使用します。

クッキー同意

クッキー同意宛先にマッピングして、ユーザーの同意状態に基づいてクッキー同意を制御します。

識別

以下の宛先にマッピングして、各タグ発火時にClarity 識別APIを呼び出します。custom_user_idがマッピングされており、空でない場合にのみ識別APIが呼び出されます。

カスタムタグ

カスタムイベント

アップグレード