# 設置前の準備

タグを設置する前に、GENIEE から受け取る 2 つの値とタグマネージャーを入手し、検索結果ページの条件を満たしていることを確認します。

| 項目 | 内容 |
| --- | --- |
| 対象者 | タグを設置する方（エンジニア、制作会社） |
| ページの概要 | タグの設置に必要な値とタグ、検索結果ページの条件を確認できます |
| 前提条件 | AI SEARCH を契約していること |

## GENIEE から受け取る値とタグマネージャー

GENIEE は、設定タグに記述する 2 つの値とタグマネージャーを通知します。届いていない場合は、問合せ窓口にお問い合わせください。

| 受け取るもの | 使う場所 |
| --- | --- |
| サービスの ID | 設定タグの `uid` |
| プロンプトの ID | 設定タグの `promptId` |
| タグマネージャー（起動タグ） | 設定タグの後に、変更を加えずに記述します |

## 検索結果ページの条件

AI SEARCH は検索結果ページを開いたときに、ページの URL に入っている検索キーワードで回答を作ります。検索結果ページが次の条件を満たしているかを確認します。

| 条件 | 例 | 満たしていないとき |
| --- | --- | --- |
| 検索キーワードが URL パラメータ `q` に含まれている | `https://example.com/search?q=料金` | パラメータ名が `q` 以外の場合は、[検索キーワードの URL パラメータが q 以外の場合](<https://docs.geniee-search.net/aisearch/install/site/query-param/index.md>)の設定を追加します |
| 検索のたびに、キーワードを含む URL で検索結果ページが開く | 検索ボックスで「料金」と検索すると、`https://example.com/search?q=料金` が開く | ページを再読み込みせずに検索結果を切り替えるサイトの場合は、問合せ窓口にご相談ください |
| 表示領域を配置する要素がある | `<div id="ai-search"></div>` | 表示領域を置きたい場所に、空の `div` 要素を追加します |
| 検索ボックスが `input` 要素である | `<input type="text" id="search-input" name="q">` | 検索結果ページに検索ボックスがない場合は、問合せ窓口にご相談ください |
| 表示領域を置く要素と検索ボックスが、ページの HTML に書かれている | なし | JavaScript で動的に検索ボックスと表示領域を描画するサイトの場合は、問合せ窓口にご相談ください |

表示領域を置く要素と検索ボックスは、設定タグに CSS セレクタ（`#ai-search`）で記述します。書き方は「[タグの設置](<https://docs.geniee-search.net/aisearch/install/tag/#required-parameters>)」を参照してください。

## サイト側で事前に決定する事項

| 決めること | 設定タグの項目 | 詳しい説明 |
| --- | --- | --- |
| 表示領域を置く場所 | `insertSelector` | [タグの設置](<https://docs.geniee-search.net/aisearch/install/tag/#required-parameters>) |
| デザイン | `theme` | [デザインの選択](<https://docs.geniee-search.net/aisearch/install/appearance/theme/index.md>) |
| 見出し、注意書き、状態ごとの固定メッセージ | `headerText` など | [固定メッセージの変更](<https://docs.geniee-search.net/aisearch/install/appearance/text/index.md>) |

デザインと固定メッセージは、表示を確認した後に設定タグを書き換えて変更することもできます。

## CSP 設定済みサイトで許可するドメイン

サイトで Content Security Policy（CSP）を設定している場合は、次のドメインを許可します。許可していない場合、表示領域が表示されず、ブラウザのコンソールに CSP のエラーが表示されます。

| ドメイン | 読み込むもの・通信 | 許可するディレクティブ |
| --- | --- | --- |
| `https://js.poplink.jp` | タグマネージャーが読み込む JavaScript と CSS | `script-src`、`style-src` |
| `https://ais.g-cdn.net` | AI SEARCH の JavaScript と、デザインの CSS | `script-src`、`style-src` |
| `https://ais-app.geniee-search.net` | 回答を取得する通信 | `connect-src` |

- CSP の hash と nonce には対応していないため、指定しないでください
- AI SEARCH が送信する情報については、「[セキュリティと送信する情報](<https://docs.geniee-search.net/aisearch/getting-started/security/index.md>)」を参照してください

## 関連ページ

- [タグの設置](<https://docs.geniee-search.net/aisearch/install/tag/index.md>)
- [表示の確認](<https://docs.geniee-search.net/aisearch/install/verify/index.md>)
- [導入の流れと担当](<https://docs.geniee-search.net/aisearch/getting-started/flow/index.md>)
- [セキュリティと送信する情報](<https://docs.geniee-search.net/aisearch/getting-started/security/index.md>)
