ウェブ検索

• ウェブ検索機能とは

  ウェブ検索機能は、シングルページ（Block UI）やナビゲーションバーに検索窓を設置できる機能です。

  お客様のウェブサイトの検索機能への動線をアプリ上に設定することができ、検索結果表示後の再検索や、検索履歴の表示にも対応しています。

   

  本機能をご利用する前に

  利用開始には各アプリストアへのアップデート申請が必要です。設定後、管理画面の「アプリストア情報」より『再申請』を行なってください。
  Preview Yappliを用いたプレビュー確認には対応していません。アップデート完了後、本番アプリにてご確認いただけます。
  参考：『アプリを再申請する』

   

  対応アプリバージョン

  機能名	iOS	Android
  ウェブ検索機能	v13.01以降	v13.01以降

  参考：『各機能に対する対応アプリバージョン一覧』

   

  ご注意

  • 本機能への遷移元として、保証対象は以下の通りです。
    ・ナビゲーションバーからの遷移
    ・シングルページ（Block UI）からの遷移
  • シングルページ（Block UI）からの遷移では、以下ブロックに対応しています。
    ・ウェブ検索ブロック（リンク形式・モーダル形式どちらも対応）
    ・以下ブロック（リンク形式のみ対応）
    　＜基本ブロック＞
    　タイトル＋ボタンブロック / ボタンブロック / 画像ブロック
    　＜レイアウトブロック＞
    　グリッドブロック / 横スクロールブロック / カルーセルブロック
  • 上記以外の機能やブロックを遷移元として設定された場合、アプリが正常に動作しない場合があり動作保証外となります。

   

  更新履歴

  • 2026年1月21日 本ページ公開

• ウェブ検索機能を設定する

  機能を設定するための全体の流れとしては、下記2つの手順が必要となります。

  1. シングルページ（Block UI）またはナビゲーションバー内で表示させる「ウェブ検索機能」を作成します。
     参考：『ウェブ検索機能を作成する』
  2. 「ウェブ検索機能」を表示させたい「シングルページ（Block UI）」または「ナビゲーションバー」で設定します。
     参考：『作成したウェブ検索機能をシングルページ、またはナビゲーションバーに設定する』

   

  更新履歴

  • 2026年1月21日 本ページ公開

• ウェブ検索機能を作成する

  1. CMS（管理画面）内の「コンテンツ」より「ウェブ検索機能」を新規作成し、編集画面に移動します。
     参考：『コンテンツを追加する』
  2. 検索対象のウェブサイト（貴社ウェブサイトなど）にて、設定に必要なURL・文字列を確認します。
     1. ブラウザの別タブで検索対象のウェブサイト（貴社ウェブサイトなど）を開きます。
     2. 検索窓で任意の単語を検索します。
        本ページでは、弊社のサポートページ「https://support.yappli.co.jp/hc/ja」にて、単語「設定」で検索した場合を例にご案内します。
     3. ウェブサイトの検索結果が表示された状態で、ブラウザのアドレスバーからURL・文字列をコピーします。詳細は以下をご参照ください。

  3. CMS（管理画面）に戻り、「検索対象のURL」を設定します。
     手順「2-3」で確認したURLを全てコピー＆ペーストします。

     

  4. 「検索キーワード用のクエリパラメータ」を設定します。
     手順「2-3」で確認したURLのうち、「=入力文字列」の直前の文字列が対象となります。
     以下の画像の場合、「&」と「=設定」の間にある「query」が上記に該当します。

     

  5. 任意で文字コードを設定します。

  6. プレースホルダを設定します。
     プレースホルダを「検索キーワード」と設定された場合、アプリ上では以下のように表示されます。

     

  7. 任意でパラメータ設定を行い、保存します。
     参考：『パラメータを設定する - ウェブ検索機能』

   

  ヒント

  • ブラウザのアドレスバーに表示されたURLを全てコピー＆ペーストした際に、コピー前とURLの表示内容が異なる場合がございますが問題ありません。
  • 本ページの設定を行なった後、ウェブ検索機能の表示先（シングルページまたはナビゲーションバー）での設定が必要となります。
    参考：『作成したウェブ検索機能をシングルページ、またはナビゲーションバーに設定する』

   

  更新履歴

  • 2026年1月21日 本ページ公開

• パラメータを設定する - ウェブ検索機能

  クエリパラメータとは

  ウェブサイトURLの「?」の後に記述される特定の文字列です。検索サイト上のパラメータや、UTMパラメータがそれにあたります。

  
  例として、以下URLの場合は、赤字部分がクエリパラメータに該当します。

  • 例：https://example.com/search/?key1=value1&key2=value2

   

  パラメータは、キー（key）と値（value）のペアで構成されます。このkeyとvalueは「=」で結ばれます。

  • 例：key=value

  複数のパラメータを設定する場合は、それぞれのペアをアンパサンド（&）で区切ります。

  • 例：key1=value1&key2=value2

   

  設定方法

  • 検索サイト上のパラメータや、UTMパラメータなどを追加する場合は、「パラメータ設定」にある「Key」と「Value」欄に設定します。
    参考：『ウェブ検索機能を作成する』

  

  • 「検索対象のURL」で設定したクエリパラメータは、「パラメータ設定」で設定したクエリパラメータで上書きされます。

  

   

  ヒント

  • 以下の記載方法は、どちらも同じURLが生成されます。
    設定したいパラメータの数が多い場合は、入力枠を分ける「パラメータ設定」をご活用ください。

  検索対象のURLのみ
  パラメータ設定と合わせて記載

   

   

  更新履歴

  • 2026年3月9日 ヒントを追加
  • 2026年1月21日 本ページ公開

• 作成したウェブ検索機能をシングルページ、またはナビゲーションバーに設定する

  作成したウェブ検索機能を設置する場所に応じて、以下の設定を行なってください。

   

  シングルページに設置する場合

  1. CMS（管理画面）にて、「ウェブ検索機能」を設置するシングルページ（Block UI）の編集画面を開きます。
  2. 左側パネルの「追加」より、ウェブ検索ブロックを追加します。
     参考：『Block UI Editorとは - シングルページ（Block UI）』
     参考：『ブロックを追加する』
     
  3. 右側パネルの「アクション」欄より、ウェブ検索機能をリンク設定します。リンク形式・モーダル形式、どちらでも設定可能です。
     参考：『Block UI Editorとは - シングルページ（Block UI）』
     参考：『アクション設定・リンク設定とは』
     
  4. 任意で「虫眼鏡アイコン」の画像を登録します。
     ※設定しない場合は「虫眼鏡アイコン」のチェック欄を無効（灰色）にします。
  5. 保存後、Preview Yappliにて該当のシングルページ（Block UI）の動作を確認し、問題がなければ再構築を行なってください。
     参考：『アプリを再構築する』

   

  ナビゲーションバーに設置する場合

  1. CMS（管理画面）の「デザイン」＞「ナビゲーションバー」を押下します。
     参考：『ナビゲーションバー - デザイン設定』
  2. ウェブ検索機能を配置したい箇所（左アイコン / 右アイコン1 / 右アイコン2）に、ウェブ検索機能をリンク設定します。
     参考：『アクション設定・リンク設定とは』
     
  3. 保存後、Preview Yappliにてナビゲーションバーの動作を確認し、問題がなければ再構築を行なってください。
     参考：『アプリを再構築する』

   

  更新履歴

  • 2026年1月21日 本ページ公開