# タグの設置

検索結果ページに設定タグとタグマネージャーを記述すると、ページの URL に入っている検索キーワードで、AI の回答が表示されます。

| 項目 | 内容 |
| --- | --- |
| 対象者 | タグを設置する方（エンジニア、制作会社） |
| ページの概要 | 必須 4 項目のみを記述したタグで、検索結果ページに AI の回答を表示できます |
| 前提条件 | 「[設置前の準備](<https://docs.geniee-search.net/aisearch/install/prepare/index.md>)」の準備が完了していること |

## 設置するタグ

| タグ | 役割 |
| --- | --- |
| 設定タグ | サービスの ID、表示領域を置く場所、検索ボックスなどの設定を書くタグ |
| タグマネージャー（起動タグ） | GENIEE が用意し、AI SEARCH の JavaScript を読み込みます。設定タグの後に書きます |

## 手順

1. 検索結果ページの HTML の `head` 要素に、設定タグを書きます。`[ ]` の部分は、「[設定タグの必須 4 項目](<#required-parameters>)」の表に従って書き換えます

   ```
   <script>
     window.aisConf = window.aisConf || [];
     window.aisConf.push({
       uid: "[サービスの ID]",
       promptId: "[プロンプトの ID]",
       insertSelector: "[表示領域を置く要素の CSS セレクタ]",
       inputSelector: "[検索ボックスの CSS セレクタ]",
     });
   </script>
   ```
2. 設定タグの後に、GENIEE から受け取ったタグマネージャーを変更せずに記述します。タグマネージャーは次の形で、`[タグマネージャーの ID]` には GENIEE が発行した ID が設定されています

   ```
   <script>
     (function () {
       var script = document.createElement("script");
       script.setAttribute("src", "https://js.poplink.jp/[タグマネージャーの ID]/poptagmanager.js?ts=" + Date.now());
       script.setAttribute("defer", true);
       document.head.appendChild(script);
     })();
   </script>
   ```
3. 表示領域を置きたい場所に、`insertSelector` に書いたセレクタに合う空の要素を置きます（例: `<div id="ai-search"></div>`）
4. 検索結果ページを開き、「[タグ設置後の確認事項](<#verify>)」に従って動作を確認します

## 設定タグの必須 4 項目

| 項目 | 書く値 | 値の確認先 |
| --- | --- | --- |
| `uid` | サービスの ID | GENIEE がお知らせします |
| `promptId` | プロンプトの ID | GENIEE がお知らせします |
| `insertSelector` | 表示領域を置く要素の CSS セレクタ（例: `#ai-search`） | 検索結果ページの HTML |
| `inputSelector` | 検索ボックスの `input` 要素の CSS セレクタ（例: `#search-input`） | 検索結果ページの HTML |

- 4 項目とも、値には空でない文字列を指定します
- セレクタに該当する要素が複数ある場合、AI SEARCH はページ内の最初の要素を使用します
- 表示領域は `insertSelector` の要素の中に追加されます
- `inputSelector` の検索ボックスには、AI SEARCH が URL の検索キーワードを入力します

ほかに書ける項目は「[パラメータ一覧](<https://docs.geniee-search.net/aisearch/reference/parameters/index.md>)」を参照してください。

## タグ設置後の確認事項

必須の 4 項目だけのタグでは、見出し、注意書き、検索キーワードがないときの固定メッセージは表示されません。検索キーワードの入った URL を開いて、回答が表示されるかを確かめます。

1. 検索結果ページを、検索キーワードを付けて開きます（例: `https://example.com/search?q=[サイトの内容に関わるキーワード]`）
2. `insertSelector` の要素の中に、AI の回答が表示されることを確かめます
3. `inputSelector` の検索ボックスに、URL パラメータに設定されたキーワードが入っていることを確かめます

見出しや固定メッセージを表示するには、「[固定メッセージの変更](<https://docs.geniee-search.net/aisearch/install/appearance/text/index.md>)」の項目を設定タグに追加します。公開する前に確かめることは、[表示の確認](<https://docs.geniee-search.net/aisearch/install/verify/index.md>)にまとめています。

## 記述誤り時に表示されるメッセージ

設定タグに書き間違いがあると、ブラウザのコンソールに次のメッセージが出て、表示領域は表示されません。

| メッセージ | 原因 | 直し方 |
| --- | --- | --- |
| `Unknown parameter: [項目名]` | AI SEARCH に存在しない項目名を記述した | 項目名の綴りを、「[パラメータ一覧](<https://docs.geniee-search.net/aisearch/reference/parameters/index.md>)」と照合して修正します |
| `Invalid value for [項目名]` | 値が項目の規則に合致しない（文字列の項目に数値を書いた、空の文字列 `""` を書いた、0 より大きい数にする項目に 0 を記述した場合など） | 値を[パラメータ一覧](<https://docs.geniee-search.net/aisearch/reference/parameters/index.md>)の決まりに合わせて直します。必須の 4 項目は、空でない文字列にします |

`[項目名]` には書き間違えた項目の名前が入ります。そのほかのメッセージは「[パラメータ一覧](<https://docs.geniee-search.net/aisearch/reference/parameters/index.md>)」を参照してください。

必須 4 項目のいずれかを記述していない場合、その項目は空の値として扱われ、この表のメッセージは出ません。`insertSelector` か `inputSelector` を書き忘れた場合は、セレクタが空であることを示す `SyntaxError` がコンソールに表示されます。回答が表示されないときは、設定タグに 4 項目がそろっているかも確かめます。

## メッセージが表示されず、表示領域も表示されない場合

ページを読み込んだとき、AI SEARCH は `insertSelector` と `inputSelector` に合う要素を 1 回だけ探します。この時点で要素が存在しない場合、コンソールにメッセージは表示されず、表示領域も表示されません。

1. 開発者ツールのコンソールで次を実行し、`null` が返る場合は、セレクタまたは要素を修正します

   ```
   document.querySelector("[insertSelector に書いたセレクタ]");
   document.querySelector("[inputSelector に書いたセレクタ]");
   ```
2. 要素が返るのに表示されない場合は、ブラウザの「ページのソースを表示」で 2 つの要素があるかを確かめます。ページのソースにない要素は、JavaScript で後から生成されています。[検索結果ページの条件](<https://docs.geniee-search.net/aisearch/install/prepare/#page-requirements>)を満たしていないため、問合せ窓口にご相談ください
3. 要素がページのソースにあるのに表示されない場合は、サービスが利用可能な状態かを、問合せ窓口にご確認ください。必須の 4 項目だけのタグでは、サービスが利用できる状態でないときも、コンソールにメッセージは出ず、表示領域は表示されません

ほかの症状は「[表示されない場合・表示に異常がある場合](<https://docs.geniee-search.net/aisearch/troubleshooting/display/index.md>)」を参照してください。

## 設定上の制限と回避方法

| 制限事項 | 回避方法 |
| --- | --- |
| 必須 4 項目のみで、`q` 以外の URL パラメータに含まれるキーワードを使用すること | `queryParamName` を設定タグに追加します。書き方は「[検索キーワードの URL パラメータが q 以外の場合](<https://docs.geniee-search.net/aisearch/install/site/query-param/index.md>)」を参照してください |
| Ajax や SPA のように、ページを再読み込みせずに検索結果を切り替えるサイトで、検索のたびに回答を再生成すること | 問合せ窓口にご相談ください |

## 関連ページ

- [設置前の準備](<https://docs.geniee-search.net/aisearch/install/prepare/index.md>)
- [表示の確認](<https://docs.geniee-search.net/aisearch/install/verify/index.md>)
- [固定メッセージの変更](<https://docs.geniee-search.net/aisearch/install/appearance/text/index.md>)
- [デザインの選択](<https://docs.geniee-search.net/aisearch/install/appearance/theme/index.md>)
- [パラメータ一覧](<https://docs.geniee-search.net/aisearch/reference/parameters/index.md>)
- [表示されない場合・表示に異常がある場合](<https://docs.geniee-search.net/aisearch/troubleshooting/display/index.md>)
