コンテンツにスキップ

検索キーワードの 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 に修正します

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

確認方法

  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=料金)のキーワードを読む 対応していません