検索キーワードの URL パラメータが q 以外の場合¶
設定タグの queryParamName に URL パラメータ名を記述すると、q 以外の名前のパラメータに入っている検索キーワードで回答を生成できます。
| 項目 | 内容 |
|---|---|
| 対象者 | タグを設置する方(エンジニア、制作会社) |
| ページの概要 | 検索キーワードが含まれる URL パラメータ名を、サイトに合わせて指定できます |
| 前提条件 | タグの設置の手順で、設定タグとタグマネージャーを書いていること |
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 の # 以降にキーワードがある場合」を参照してください |
- 値は、URL に表示されているパラメータ名と同じ綴りで記述します。大文字と小文字は区別されます
- 値は空でない文字列で書きます
- URL エンコードされたキーワード(
%E6%96%99%E9%87%91など)は、元の文字(料金)にデコードして使用します。+は空白として解釈されます
queryParamName の記述方法¶
タグの設置で書いた設定タグに queryParamName を足します。queryParamName 以外の [ ] の部分は、タグの設置 › 設定タグの必須 4 項目で説明している値です。
<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 に修正します |
どちらのメッセージが表示された場合も、表示領域は表示されません。
確認方法¶
- 検索結果ページを、検索キーワードを付けて開きます(例:
https://example.com/search?[パラメータの名前]=[サイトの内容に関わるキーワード]) insertSelectorの要素の中に、AI の回答が表示されることを確かめますinputSelectorの検索ボックスに、URL のキーワードが入っていることを確かめます- ブラウザの開発者ツールでコンソールを開き、
Invalid value for queryParamNameなどのメッセージが出ていないことを確かめます
キーワードを付けて開いたのに noInputBodyText の固定メッセージが表示される場合は、queryParamName の値が URL のパラメータ名と一致していません。綴りと大文字・小文字を照合して修正します。
設定上の制限と回避方法¶
| 制限事項 | 回避方法 |
|---|---|
| 1 つの設定タグに、複数のパラメータ名を記述すること | 検索結果ページごとに名前が違う場合は、ページごとの設定タグに、そのページの名前を書きます |
URL のパス(https://example.com/search/料金 など)に含まれるキーワードを取得すること |
対応していません |
| URL に入っていないキーワード(フォームを POST で送る検索など)を読む | 対応していません |
# の後ろに ? がない形(#kw=料金)のキーワードを読む |
対応していません |