Help Centerにクッキー同意バナーを追加する方法を、直接Consent Management Platform (CMP)統合またはGoogle Tag Manager (GTM)を使う方法で学びます。このガイドは要件、手順、コンプライアンスと機能維持の重要な注意点をカバーします。
始める前に
重要：
Help Centerにはカスタムドメインを設定する必要があります。このプロセスはIntercomのデフォルトdomain（例：intercom.help）では機能しません。
カスタムスクリプトを有効にすると、カスタムスクリプトを提供した場合に限り、Help CenterからIntercom MessengerとGoogle Analyticsが削除されます。MessengerとGoogle Analyticsをカスタムスクリプトで引き続き使用したい場合は、それらをカスタムスクリプトに含める必要があります。詳細は以下のHow do I add Intercom Messenger to my custom script?セクションを参照してください。
注意：カスタムスクリプトがないHelp Centerは、機能が有効でも通常通りIntercom MessengerとGoogle Analyticsを読み込み続けます。
提供するカスタムスクリプトはHelp Centerページの
<head>セクションでのみ実行されます。ワークスペースでカスタムスクリプトが有効な場合：
カスタムスクリプトがあるHelp Center：カスタムスクリプトのみが読み込まれます。デフォルトのIntercomスクリプト（Messenger、Google Analytics）は読み込まれません。
カスタムスクリプトがないHelp Center：デフォルトのIntercomスクリプト（Messenger、Google Analytics）が通常通り読み込まれます。
CMPごとの統合方法の違い
すべてのCMPはHelp Centerで動作しますが、実装方法はプロバイダーによって異なります。
OneTrust
Help Centerとの組み込み統合があります。
クッキー設定ボタンは自動的にOneTrustのモーダルに接続されます。
スクリプトにはOneTrustの設定を含める必要があります。
追加のボタン操作コードは不要です。
その他のCMP（Usercentrics、Cookiebot、CookieYesなど）
開発チームによる追加コードが必要です。
スクリプトはHelp Centerのクッキー設定ボタンに接続する必要があります。
詳細は以下のクッキー設定ボタンのセクションを参照してください。
クッキー設定ボタン
Help Centerは訪問者が設定を管理するためのID ot-sdk-btn を持つクッキー設定ボタンを自動的に作成します。
OneTrustの場合
ボタンは自動的にOneTrustの同意モーダルに接続されます。
追加のコードは不要です。
その他のCMPの場合
スクリプトにはこのボタンのクリックを監視するコードを含める必要があります。
クリックされると、コードはCMPの設定表示を起動します。
このコードがなければ、ボタンは機能しません。
注意：開発チームはot-sdk-btn要素のイベントリスナーを追加する必要があります。具体的な実装はCMPのAPIによります。正しい同意設定を開く関数についてはCMPプロバイダーのドキュメントを参照してください。
クッキー同意バナーの実装方法
クッキーバナーを追加するには2つのオプションがあります：
オプション1：直接CMP統合
このオプションは、選択したConsent Management Platform (CMP)を実装するエンジニアリングチームのスクリプトが必要です。
ステップ1：スクリプトの準備
エンジニアリングチームは以下を満たすスクリプトを準備する必要があります：
選択したCMPを実装する。
適用されるプライバシー法の下でユーザー同意が得られた後にのみクッキーを設定することを保証する。
注意：カスタムスクリプトを有効にするとHelp CenterからIntercom MessengerとGoogle Analyticsが削除されます。これらを使い続けたい場合はカスタムスクリプトに含める必要があります（詳細はHow do I add Intercom Messenger to my custom script?を参照）。
ステップ2：スクリプトの注入を依頼する
スクリプトが準備できたら、サポートチームに連絡してスクリプトを提供してください。彼らがHelp Centerに注入します。
注意：このプロセスはサポートチームによる手動注入が必要であり、セルフサービス設定ではありません。
ステップ3：実装の検証
スクリプトの注入が確認された後、Help Centerの訪問者から必要なすべての同意を得た後にのみクッキーが設定されていることを検証してください。
オプション2：Google Tag Manager (GTM) + CMP
Google Tag Managerを使用している場合、GTMは別途注入されるのではなくカスタムスクリプト内に含まれます。Help CenterはGTMの<noscript>ボディ要素を別途注入できますが、メインのGTM JavaScriptを<head>で独立して注入することはできません。
ステップ1：GTMの設定
カスタムスクリプトには以下すべてを含める必要があります：
- CMP設定。
- GTM初期化。
- Intercom Messenger（必要に応じて、以下のFAQ参照）。
- OneTrustを使わない場合はクッキー設定ボタンの接続（上記クッキー設定ボタンセクション参照）。
GTMの<noscript>ボディ要素はスクリプト提出時に別途提供してください。チームがHelp Centerの<body>に注入します。
ステップ2：GTMスクリプトの注入を依頼する
GTMスクリプトが準備できたら、サポートチームに連絡して提供してください。彼らがHelp Centerに注入します。
注意：このプロセスはサポートチームによる手動注入が必要であり、セルフサービス設定ではありません。
ステップ3：実装の検証
スクリプトの注入が確認された後、Help Centerの訪問者から必要なすべての同意を得た後にのみクッキーが設定されていることを確認してください。
CSP domain要件
スクリプト提出前に、CMPが必要とするdomainを特定してください。これらはContent Security Policy (CSP)設定に追加する必要があります。これがないとブラウザがCMPのリクエストをブロックします。
必要なdomainの見つけ方
CMPプロバイダーの技術ドキュメントを確認してください。
「CSP requirements」または「domains to whitelist」を探してください。
ドキュメントに記載がない場合はCMPプロバイダーに問い合わせてください。
CMP固有の注意点
OneTrust：追加のdomainは不要（組み込みサポート）。
Usercentrics、Cookiebot、CookieYes：必要なdomainはプロバイダーのドキュメントを確認してください。
注意：スクリプト提出時に必要なdomainリストを含めて、サポートチームがCSP設定に追加できるようにしてください。
技術的詳細
カスタムスクリプトはページの<head>の上部で読み込まれます。document.createElement("script")やinnerHTMLで新しいスクリプト要素を作成するとnonceが継承されずCSPでブロックされます。互換性を確保するため、新しいスクリプト要素を注入するのではなくJavaScriptコードを直接実行してください。この方法が合わない場合はお問い合わせください。
Help Centerには複数の<script>タグを追加できます。例えば：
<script src="https://..." />
<script>
console.log("test");
</script>
Body noscript要素のサポート：
Help Centerページの<body>にnoscript要素（例：Google Tag Managerのnoscriptタグ）を追加する必要がある場合、追加したいbody要素を提供できます。
例：
<noscript>
<iframe src="https://www.googletagmanager.com/ns.html?id=GTM-XXXXXX"
height="0" width="0" style="display:none;visibility:hidden">
</iframe>
</noscript>
よくある質問
デフォルトのIntercom domainを使うとどうなりますか？
デフォルトのIntercom domainを使うとどうなりますか？
Help Centerにはカスタムドメインを使用する必要があります。このプロセスはIntercomのデフォルトdomain（例：intercom.help）では機能しません。
カスタムスクリプトを有効にするとIntercom MessengerやGoogle Analyticsは削除されますか？
カスタムスクリプトを有効にするとIntercom MessengerやGoogle Analyticsは削除されますか？
カスタムスクリプトを有効にすると、カスタムスクリプトを提供した場合に限りHelp CenterからIntercom MessengerとGoogle Analyticsが削除されます。カスタムスクリプトがないHelp Centerは通常通りIntercom MessengerとGoogle Analyticsを読み込み続けます。カスタムスクリプトを提供しMessengerとGoogle Analyticsを使い続けたい場合は、それらをカスタムスクリプトに含める必要があります。詳細はHow do I add Intercom Messenger to my custom script?を参照してください。
Help Centerに複数のスクリプトを追加できますか？
Help Centerに複数のスクリプトを追加できますか？
はい。Help Centerページに複数の<script>タグを追加できます。
How do I add Intercom Messenger to my custom script?
How do I add Intercom Messenger to my custom script?
Messengerをカスタムスクリプトに追加する方法の詳細は、Messengerインストールガイドを参照してください。
重要：Messengerをカスタムスクリプトに追加する際は、ユーザー同意に基づいてMessengerのクッキーを制御するためにConsent Management Platform (CMP)と統合する必要があります。実装の詳細は以下のHow can I control Intercom Messenger cookies with my consent banner?を参照してください。
How can I control Intercom Messenger cookies with my consent banner?
How can I control Intercom Messenger cookies with my consent banner?
実装の詳細な手順については、記事Intercom Messenger Cookiesを参照してください。