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）を通常通り読み込み続けます。
Help Centerへのスクリプト注入はクッキー同意およびConsent Management Platform (CMP)の実装のみサポートされます。他の種類のカスタムスクリプト注入リクエストはサポートされません。

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ドメイン要件

スクリプト提出前に、CMPが必要とするドメインを特定してください。これらはContent Security Policy (CSP)設定に追加する必要があります。これがないとブラウザがCMPのリクエストをブロックします。

必要なドメインの見つけ方

CMPプロバイダーの技術ドキュメントを確認してください。
「CSP要件」または「許可リストに追加するドメイン」を探してください。
ドキュメントに記載がない場合はCMPプロバイダーにお問い合わせください。

CMP固有の注意事項

OneTrust：追加ドメイン不要（組み込みサポート）。
Usercentrics、Cookiebot、CookieYes：必要なドメインはプロバイダーのドキュメントを確認してください。

注意：スクリプト提出時に必要なドメインリストを含めて、サポートチームが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を使用するとどうなりますか？

Help Centerにはカスタムドメインを使用する必要があります。このプロセスはIntercomのデフォルトdomain（例：intercom.help）では機能しません。

カスタムスクリプトを有効にすると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に複数のスクリプトを追加できますか？

はい。クッキー同意実装の一環として複数の<script>タグを提出できます。これはクッキー同意およびCMPスクリプトにのみ適用され、他の種類のカスタムスクリプトはサポートされません。

How do I add Intercom Messenger to my custom script?

詳細な手順については、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?

実装の詳細な手順については、記事Intercom Messenger Cookiesを参照してください。