検索クローラーまたはAPIを使用してヘルプセンターに横串検索を設定する方法

Elizabeth Williams

Zendesk Documentation Team

編集日時：2025年3月06日

現在のプランを確認

Suite

EnterpriseまたはEnterprise Plus

Support

+ Guide Enterprise

検索クローラーまたは横串検索APIのいずれかを使用して、ヘルプセンターに横串検索を設定することができます。

検索クローラーを使用することで、開発者の手を借りずに、横串検索を実装することができます。ヘルプセンターで複数のクローラーを設定して、同一Webサイトまたは異なるWebサイトのさまざまなコンテンツをクロールし、インデックスを作成することができます。
開発者リソースがあれば、横串検索APIを利用できます。このREST APIを使用すると、外部コンテンツのレコードをZendesk検索インデックスに取り込み、ヘルプセンターで横串検索を実装できます。

横串検索を設定したら、ヘルプセンターの検索結果に含めるコンテンツを設定する必要があります（「ヘルプセンターの検索結果に外部コンテンツを含める方法」を参照）。

メモ：ヘルプセンターのテーマが2019年9月25日以前に作成されたものである場合、横串検索を使用するようにテーマを変更する必要があるかもしれません。

この記事では、以下のトピックについて説明します。

検索クローラーを使用してヘルプセンターの横串検索を設定する
APIを使用してヘルプセンターの横串検索を設定する

検索クローラーを使用してヘルプセンターの横串検索を設定する

検索クローラーを使用することで、開発者の手を借りずに、ヘルプセンターに横串検索を実装することができます。ヘルプセンターで複数のクローラーを設定して、同一Webサイトまたは異なるWebサイトのさまざまなコンテンツをクロールし、インデックスを作成することができます。

メモ：ヘルプセンターの検索クローラーは、適用されるすべての法律および関連するWebサイトの利用規約を遵守して使用する必要があります。サイトマップの追加は、そのようなサイトマップに関連付けられたドメインを所有している場合にのみ行ってください。ヘルプセンターの検索クローラーを使用することにより、クローラーに追加されたすべてのサイトマップのドメインを所有していること、およびそのようなWebサイトをクロールする権利があることを確認するものとします。

検索クローラーを使用して横串検索を設定するには

Guideで、サイドバーの設定アイコン（）をクリックし、「検索設定」をクリックします。
「クローラー」の「管理」をクリックします。
「クローラーを追加」をクリックします。
「このクローラーに名前を付ける」で、以下の内容を入力します。
- 名前：クローラーに割り当てる名前。これは、クローラー管理リストで検索クローラーを識別するための内部名です。
- オーナー：クローラーのメンテナンスとトラブルシューティングを担当するGuide管理者のユーザー名。デフォルトでは、クローラーオーナーはクローラーを作成するユーザーですが、任意のGuide管理者に変更できます。
  クローラーのオーナーには、クローラーが正常に実行されたときと、ドメイン検証やサイトマップの処理、ページのクロールなどで問題が発生してエラー通知があるときに、メール通知が届きます。
「クロールするWebサイトを追加する」で、次のように設定してドメインのオーナーシップを確認します。
- WebサイトURL：クロールするWebサイトのURLを入力します。
- ドメイン所有権の確認：「コピー」をクリックしてHTMLタグをクリップボードにコピーし、サイトの認証されていないホームページのHTMLコードの<head>セクションにタグを貼り付けます。この作業は、クローラーの設定が完了した後に行うことができ、確認タグはクローラーの編集ページでいつでも見つけることができます。詳しくは、「検索クローラーの管理」を参照してください。
  メモ：クローラーは実行するたびにドメイン認証を正常に完了する必要があるため、一度設置したタグは削除しないでください。
「サイトマップを追加する」では、「サイトマップURL」に、サイトのクロール時にクローラーが使用するサイトマップのURLを入力します。
サイトマップは、sitemaps XMLプロトコルに従い、クロールするサイト内のすべてのページのリストを含んでいる必要があります。サイトマップには、サイトのすべてのページを含む標準のサイトマップと、クロールしたいページをリストする専用のサイトマップがあります。すべてのサイトマップは、クローラーがクロールするように設定されたドメインにホストされている必要があります。検索クローラーはサイトマップインデックスに対応していません。

同じサイトに複数のクローラーを設定し、それぞれが異なるサイトマップを使用することで、検索クローラーにクロールさせたいページを定義できます。
「フィルターを追加してこのコンテンツを見つけやすくする」で、エンドユーザーが検索結果のフィルタリングに使用するソースフィルターとタイプフィルターを設定します。ソースとは、フォーラム、問題のトラッカー、学習管理システムなどの外部コンテンツのソースを指します。タイプとは、ブログ投稿、テクニカルノート、バグレポートなど、コンテンツの種類を示します。
- ソース：矢印をクリックし、リストからソースを選択するか、「+新しいソースを作成する」を選択して、このコンテンツの場所を示す名前を付けます。
- タイプ：矢印をクリックし、リストからタイプを選択するか、「+新規タイプを作成」を選択して、コンテンツのタイプを示す名前を付けます。
「終了」をクリックします。
検索クローラーが作成され、保留になっています。24時間以内に、クローラーはドメインのオーナーシップを確認し、指定されたサイトマップを取得して解析します。サイトマップ処理に成功すると、クローラーはページのクロールとコンテンツのインデックス作成を開始します。ドメインの検証中またはサイトマップの処理中にクローラーが失敗した場合、クローラーのオーナーは、問題の解決に役立つトラブルシューティングのヒントを含むメール通知を受け取ります。クローラーは24時間後に再試行します。
メモ：Zendesk/External-Contentは、検索クローラーのユーザーエージェントです。ファイアウォールがリクエストをブロックすることでクローラーが失敗しないようにするには、Zendesk/External-Contentを許可リストに登録します。