# 検索キーワードの URL パラメータが q 以外の場合

設定タグの `queryParamName` に URL パラメータ名を記述すると、`q` 以外の名前のパラメータに入っている検索キーワードで回答を生成できます。

| 項目 | 内容 |
| --- | --- |
| 対象者 | タグを設置する方（エンジニア、制作会社） |
| ページの概要 | 検索キーワードが含まれる URL パラメータ名を、サイトに合わせて指定できます |
| 前提条件 | [タグの設置](<https://docs.geniee-search.net/aisearch/install/tag/index.md>)の手順で、設定タグとタグマネージャーを書いていること |

## queryParamName の値

| 項目 | 書く値 | 初期値 |
| --- | --- | --- |
| `queryParamName` | 検索キーワードが入っている URL パラメータの名前 | `q` |

| 検索結果ページの URL | `queryParamName` |
| --- | --- |
| `https://example.com/search?keyword=料金` | `"keyword"` |
| `https://example.com/search?q=料金` | 記述不要です。初期値の `q` が使用されます |
| `https://example.com/search#/result?kw=料金` | `"kw"`。URL の `#` の後ろを読む決まりは「[URL の \# 以降にキーワードがある場合](<#hash>)」を参照してください |

- 値は、URL に表示されているパラメータ名と同じ綴りで記述します。大文字と小文字は区別されます
- 値は空でない文字列で書きます
- URL エンコードされたキーワード（`%E6%96%99%E9%87%91` など）は、元の文字（`料金`）にデコードして使用します。`+` は空白として解釈されます

## queryParamName の記述方法

[タグの設置](<https://docs.geniee-search.net/aisearch/install/tag/index.md>)で書いた設定タグに `queryParamName` を足します。`queryParamName` 以外の `[ ]` の部分は、[タグの設置 › 設定タグの必須 4 項目](<https://docs.geniee-search.net/aisearch/install/tag/#required-parameters>)で説明している値です。

```
<script>
  window.aisConf = window.aisConf || [];
  window.aisConf.push({
    uid: "[サービスの ID]",
    promptId: "[プロンプトの ID]",
    insertSelector: "[表示領域を置く要素の CSS セレクタ]",
    inputSelector: "[検索ボックスの CSS セレクタ]",
    queryParamName: "[検索キーワードが入っている URL パラメータの名前]",
  });
</script>
```

AI SEARCH は検索結果ページを開いたときに URL から検索キーワードを 1 回だけ取得し、そのキーワードで回答を作ります。取得したキーワードは `inputSelector` の検索ボックスにも入力します。

## URL の \# 以降にキーワードがある場合

URL の `?` から `#` の前までに `queryParamName` のパラメータがない場合は、`#` 以降の `?` より後ろの部分も取得します。

| 検索結果ページの URL（`queryParamName` が `"kw"` の場合） | 読むキーワード |
| --- | --- |
| `https://example.com/search#/result?kw=料金` | `料金` |
| `https://example.com/search?kw=料金#/result?kw=送料` | `料金`。`#` より前にあるパラメータを使用します |
| `https://example.com/search?kw=#/result?kw=料金` | なし。`#` より前に `kw` があると、値が空でも `#` 以降は取得しません |
| `https://example.com/search#kw=料金` | なし。`#` の後ろに `?` がない形は取得しません |

- キーワードを読むのは、検索結果ページを開いたときの 1 回だけです。ページを再読み込みせずに `#` 以降だけを変更して検索結果を切り替えるサイトでは、回答は最初のキーワードのまま変わりません。この場合は、問合せ窓口にご相談ください
- キーワードを取得できない場合は、検索キーワードがない場合と同じ表示になります。設定タグに `noInputBodyText` を書いた場合は、その固定メッセージが表示されます

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

| メッセージ | 原因 | 直し方 |
| --- | --- | --- |
| `Invalid value for queryParamName` | 値が文字列でない、または空の文字列（`""`）を書いた | URL パラメータ名を、引用符で囲んだ文字列で記述します |
| `Unknown parameter: [項目名]` | `queryParamName` の綴りを誤った（`queryParamname` など） | 項目名を `queryParamName` に修正します |

どちらのメッセージが表示された場合も、表示領域は表示されません。

## 確認方法

1. 検索結果ページを、検索キーワードを付けて開きます（例: `https://example.com/search?[パラメータの名前]=[サイトの内容に関わるキーワード]`）
2. `insertSelector` の要素の中に、AI の回答が表示されることを確かめます
3. `inputSelector` の検索ボックスに、URL のキーワードが入っていることを確かめます
4. ブラウザの開発者ツールでコンソールを開き、`Invalid value for queryParamName` などのメッセージが出ていないことを確かめます

キーワードを付けて開いたのに `noInputBodyText` の固定メッセージが表示される場合は、`queryParamName` の値が URL のパラメータ名と一致していません。綴りと大文字・小文字を照合して修正します。

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

| 制限事項 | 回避方法 |
| --- | --- |
| 1 つの設定タグに、複数のパラメータ名を記述すること | 検索結果ページごとに名前が違う場合は、ページごとの設定タグに、そのページの名前を書きます |
| URL のパス（`https://example.com/search/料金` など）に含まれるキーワードを取得すること | 対応していません |
| URL に入っていないキーワード（フォームを POST で送る検索など）を読む | 対応していません |
| `#` の後ろに `?` がない形（`#kw=料金`）のキーワードを読む | 対応していません |

## 関連ページ

- [設置前の準備](<https://docs.geniee-search.net/aisearch/install/prepare/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/reference/parameters/index.md>)
- [表示されない場合・表示に異常がある場合](<https://docs.geniee-search.net/aisearch/troubleshooting/display/index.md>)
