---
title: "積分方法"
slug: "integration-methods"
abstract: "実装にSitecore Searchを加えるためのさまざまな統合手法について学びましょう。"
---
# 積分方法

Sitecore Searchは以下の統合方法から選択可能です。

-   [Sitecore Cloud SDK](https://doc.sitecore.com/sdk/en/developers/005/cloud-sdk/sitecore-cloud-sdk-for-javascript.html) - もし組織にJSS Next.jsやJSS AngularアプリケーションがSitecore XM Cloudに接続されているなら、Sitecore Search関連機能をXM Cloudに実装してくださいSitecore Cloud SDKを利用したサイト。クラウド [SDKとSitecore Search REST APIの比較](https://doc.sitecore.com/sdk/en/developers/005/cloud-sdk/en/cloud-sdk-comparison-charts.html)もご覧ください。
-   [JavaScript SDK React](https://doc.sitecore.com/search/ja/developers/search-developer-guide/integrating-using-search-js-sdk-for-react.html "Integrating using Search JS SDK for React") - 統合とは、コンポーネントや機能を含むSDKパッケージをプロジェクトに追加することです。Reactアプリケーション向けに特別に構築されたSDKは、Searchと統合する最速の方法であり、開発時間と労力も最小限で済みます。
-   [JavaScript Dataパッケージ](https://doc.sitecore.com/search/ja/developers/search-developer-guide/integrating-using-search-js-data-package.html "Integrating using Search JS Data package") - バニラのJavaScriptや任意のJSフレームワークで使用できます。これは検索クエリを迅速に行い、Searchから回答を得る方法です。
-   [REST API](https://doc.sitecore.com/search/ja/developers/search-developer-guide/integrating-using-rest-apis.html "Integrating using REST APIs") - 統合には、Searchサービスを公開するエンドポイントへのアクセスが含まれます。Searchに送りたいリクエストを設定してください。また、回答を管理し、それをSearch体験に変換する必要があります。

> !注JavaScript SDKはクッキーを設定し、イベントを追跡する際にUUIDも含めます。検索結果をパーソナライズするために訪問者情報(UUID)が必要です。

SDKと比べて、API統合は通常時間がかかり、開発にも多くの労力が必要ですが、完全な柔軟性を提供します。

## 統合前

統合前に管理者がドメインの設定を行います。 [属性](https://doc.sitecore.com/search/en/users/search-user-guide/en/attributes.html)の追加、[コンテンツのインデックス](https://doc.sitecore.com/search/en/users/search-user-guide/index-items.html)作成、機能の設定、ウィジェットの設定などを行います。これらすべては、ドメインの統合準備のために行われます。

統合する前に、最低限以下のことを確認してください:

-   リクエストのテストやイベント監視ができるSaaSワークベンチの[Sitecore Search](https://doc.sitecore.com/search/ja/developers/search-developer-guide/the-sitecore-search-interface.html "The Sitecore Search interface")にアクセスできます。また、Sitecore Searchを使ってドメインに設定された属性、機能、ウィジェットを表示し、名前やIDなどの詳細も取得できます。
    
-   必要なスコープを持つAPIキーにアクセスできるようにしましょう。管理者がサブドメインを設定していない場合、認証のためにこれが必要です。
    
-   検索結果ウィジェットをどこに表示するか、どこでpreview search widgetを表示するかを知っておくこと。例えば、会社のホームページには全ページ検索を表示しつつ、各垂直分野ごとにpreview searchのみを表示したい場合もあります。
    
-   facetsやソートなど、各検索体験に必要な機能やそれらの構成方法を理解しましょう。
    
    > !注管理者がSearchのほとんどの機能を設定しますが、実行時に設定を渡す必要があるかもしれません。
    
-   各検索体験で検索可能にすべきコンテンツを把握しましょう。これは、すべての [インデックスコンテンツ](https://doc.sitecore.com/search/en/users/search-user-guide/index-items.html) がすべての検索で利用可能である必要はないためです。
    

これらの情報が得られない場合は、管理者に連絡してください。

## 統合中

統合時には、アプリケーションやウェブサイトにSearch固有のコードを追加します。このコードはSearchにリクエストを送信し、応答を受け取ります。

例えば、訪問者が検索バーにキーワードを入力してエンターをクリックした場合、一致する結果を表示する必要があります。これらの結果を得るには、検索ウィジェットのコンテンツ取得をSearchにリクエストしてください。Searchはドメインのインデックスされたコンテンツの中を調べ、アルゴリズムを適用して検索結果を返します。また、訪問者の行動に基づいてイベントを送る必要があります。