コンテンツにスキップ

タグの設置

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

項目 内容
対象者 タグを設置する方(エンジニア、制作会社)
ページの概要 必須 4 項目のみを記述したタグで、検索結果ページに AI の回答を表示できます
前提条件 「設置前の準備」の準備が完了していること

設置するタグ

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

手順

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

    <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. 検索結果ページを開き、「タグ設置後の確認事項」に従って動作を確認します

設定タグの必須 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 を開いて、回答が表示されるかを確かめます。

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

見出しや固定メッセージを表示するには、「固定メッセージの変更」の項目を設定タグに追加します。公開する前に確かめることは、表示の確認にまとめています。

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

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

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

[項目名] には書き間違えた項目の名前が入ります。そのほかのメッセージは「パラメータ一覧」を参照してください。

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

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

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

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

    document.querySelector("[insertSelector に書いたセレクタ]");
    document.querySelector("[inputSelector に書いたセレクタ]");
    
  2. 要素が返るのに表示されない場合は、ブラウザの「ページのソースを表示」で 2 つの要素があるかを確かめます。ページのソースにない要素は、JavaScript で後から生成されています。検索結果ページの条件を満たしていないため、問合せ窓口にご相談ください

  3. 要素がページのソースにあるのに表示されない場合は、サービスが利用可能な状態かを、問合せ窓口にご確認ください。必須の 4 項目だけのタグでは、サービスが利用できる状態でないときも、コンソールにメッセージは出ず、表示領域は表示されません

ほかの症状は「表示されない場合・表示に異常がある場合」を参照してください。

設定上の制限と回避方法

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