タグの設置¶
検索結果ページに設定タグとタグマネージャーを記述すると、ページの URL に入っている検索キーワードで、AI の回答が表示されます。
| 項目 | 内容 |
|---|---|
| 対象者 | タグを設置する方(エンジニア、制作会社) |
| ページの概要 | 必須 4 項目のみを記述したタグで、検索結果ページに AI の回答を表示できます |
| 前提条件 | 「設置前の準備」の準備が完了していること |
設置するタグ¶
| タグ | 役割 |
|---|---|
| 設定タグ | サービスの ID、表示領域を置く場所、検索ボックスなどの設定を書くタグ |
| タグマネージャー(起動タグ) | GENIEE が用意し、AI SEARCH の JavaScript を読み込みます。設定タグの後に書きます |
手順¶
-
検索結果ページの HTML の
head要素に、設定タグを書きます。[ ]の部分は、「設定タグの必須 4 項目」の表に従って書き換えます<script> window.aisConf = window.aisConf || []; window.aisConf.push({ uid: "[サービスの ID]", promptId: "[プロンプトの ID]", insertSelector: "[表示領域を置く要素の CSS セレクタ]", inputSelector: "[検索ボックスの CSS セレクタ]", }); </script> -
設定タグの後に、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> -
表示領域を置きたい場所に、
insertSelectorに書いたセレクタに合う空の要素を置きます(例:<div id="ai-search"></div>) - 検索結果ページを開き、「タグ設置後の確認事項」に従って動作を確認します
設定タグの必須 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 の検索キーワードを入力します
ほかに書ける項目は「パラメータ一覧」を参照してください。
タグ設置後の確認事項¶
必須の 4 項目だけのタグでは、見出し、注意書き、検索キーワードがないときの固定メッセージは表示されません。検索キーワードの入った URL を開いて、回答が表示されるかを確かめます。
- 検索結果ページを、検索キーワードを付けて開きます(例:
https://example.com/search?q=[サイトの内容に関わるキーワード]) insertSelectorの要素の中に、AI の回答が表示されることを確かめますinputSelectorの検索ボックスに、URL パラメータに設定されたキーワードが入っていることを確かめます
見出しや固定メッセージを表示するには、「固定メッセージの変更」の項目を設定タグに追加します。公開する前に確かめることは、表示の確認にまとめています。
記述誤り時に表示されるメッセージ¶
設定タグに書き間違いがあると、ブラウザのコンソールに次のメッセージが出て、表示領域は表示されません。
| メッセージ | 原因 | 直し方 |
|---|---|---|
Unknown parameter: [項目名] |
AI SEARCH に存在しない項目名を記述した | 項目名の綴りを、「パラメータ一覧」と照合して修正します |
Invalid value for [項目名] |
値が項目の規則に合致しない(文字列の項目に数値を書いた、空の文字列 "" を書いた、0 より大きい数にする項目に 0 を記述した場合など) |
値をパラメータ一覧の決まりに合わせて直します。必須の 4 項目は、空でない文字列にします |
[項目名] には書き間違えた項目の名前が入ります。そのほかのメッセージは「パラメータ一覧」を参照してください。
必須 4 項目のいずれかを記述していない場合、その項目は空の値として扱われ、この表のメッセージは出ません。insertSelector か inputSelector を書き忘れた場合は、セレクタが空であることを示す SyntaxError がコンソールに表示されます。回答が表示されないときは、設定タグに 4 項目がそろっているかも確かめます。
メッセージが表示されず、表示領域も表示されない場合¶
ページを読み込んだとき、AI SEARCH は insertSelector と inputSelector に合う要素を 1 回だけ探します。この時点で要素が存在しない場合、コンソールにメッセージは表示されず、表示領域も表示されません。
-
開発者ツールのコンソールで次を実行し、
nullが返る場合は、セレクタまたは要素を修正しますdocument.querySelector("[insertSelector に書いたセレクタ]"); document.querySelector("[inputSelector に書いたセレクタ]"); -
要素が返るのに表示されない場合は、ブラウザの「ページのソースを表示」で 2 つの要素があるかを確かめます。ページのソースにない要素は、JavaScript で後から生成されています。検索結果ページの条件を満たしていないため、問合せ窓口にご相談ください
- 要素がページのソースにあるのに表示されない場合は、サービスが利用可能な状態かを、問合せ窓口にご確認ください。必須の 4 項目だけのタグでは、サービスが利用できる状態でないときも、コンソールにメッセージは出ず、表示領域は表示されません
ほかの症状は「表示されない場合・表示に異常がある場合」を参照してください。
設定上の制限と回避方法¶
| 制限事項 | 回避方法 |
|---|---|
必須 4 項目のみで、q 以外の URL パラメータに含まれるキーワードを使用すること |
queryParamName を設定タグに追加します。書き方は「検索キーワードの URL パラメータが q 以外の場合」を参照してください |
| Ajax や SPA のように、ページを再読み込みせずに検索結果を切り替えるサイトで、検索のたびに回答を再生成すること | 問合せ窓口にご相談ください |