ヘルプセンターにカスタムJavaScriptを追加する

Notiondesk ヘルプセンターにカスタム JavaScript を追加して、サードパーティのサービスを統合したり、カスタムイベントを追跡したり、すぐには利用できないインタラクティブな機能を追加したりできます。

セキュリティ上の理由から、カスタム JavaScript はカスタムドメインでのみ許可されます。

カスタムJavaScriptでできること

JavaScriptを使用すると、ヘルプセンターのデフォルト機能を超えて拡張できます。一般的な使用例は次のとおりです。

サードパーティの統合: Notiondesk がネイティブにサポートしていないサービスを接続します。

カスタム分析トラッキング: Mixpanel、Hotjar、Segment などのツールにイベントを送信して、特定のユーザーアクションを追跡します。

インタラクティブ機能:ツールチップ、お知らせバナー、カスタムナビゲーション動作などの動的な要素を追加します。

マーケティングおよびコンバージョンツール:リターゲティングピクセル、A/B テストスクリプト、またはリードキャプチャウィジェットを埋め込みます。

カスタムJavaScriptを追加する方法

[設定]→[カスタマイズ]に移動します。

詳細設定セクションを開きます。

「カスタム JavaScript」テキストボックスに JavaScript コードを貼り付けます。

[変更を保存]をクリックします。

次にページを更新すると、ヘルプセンターのすべてのページにスクリプトが読み込まれます。

例

Hotjarトラッキングスクリプトを追加する

YOUR_HOTJAR_ID を実際の Hotjar サイト ID に置き換えます。

カスタムアナウンスバナーを表示する

カスタムイベントで記事の閲覧数を追跡する

ベストプラクティス

<script>
  (function(h,o,t,j,a,r){
    h.hj=h.hj||function(){(h.hj.q=h.hj.q||[]).push(arguments)};
    h._hjSettings={hjid:YOUR_HOTJAR_ID,hjsv:6};
    a=o.getElementsByTagName('head')[0];
    r=o.createElement('script');r.async=1;
    r.src=t+h._hjSettings.hjid+j+h._hjSettings.hjsv;
    a.appendChild(r);
  })(window,document,'https://static.hotjar.com/c/hotjar-','.js?sv=');
</script>

<script>
  document.addEventListener('DOMContentLoaded', function() {
    var banner = document.createElement('div');
    banner.innerHTML = 'We are currently experiencing delays. <a href="/status">Check status</a>';
    banner.style.cssText = 'background:#FEF3C7;padding:10px;text-align:center;font-size:14px;';
    document.body.prepend(banner);
  });
</script>

<script>
  document.addEventListener('DOMContentLoaded', function() {
    var title = document.title;
    var path = window.location.pathname;
    // Replace with your own analytics call
    console.log('Article viewed:', title, path);
  });
</script>

公開する前にテストしてください。まずブラウザコンソールでスクリプトを試して、エラーを早期に発見してください。

スクリプトは軽量にしてください。重いスクリプトはページの読み込み時間を遅くし、読者のエクスペリエンスを損なう可能性があります。

コア要素の変更は避けてください。ヘルプセンターのメインレイアウトやナビゲーションをJavaScriptで変更すると、将来のNotiondeskアップデートで機能しなくなる可能性があります。

目次