最終更新日：2025年10月9日

データ連携・検索・レコメンド導入関連Q&A

主に導入技術者向けの内容になります。

カテゴリ Q A
データ連携 データ連携の方式はどのようなものがありますか？ 会員、注文、customデータは、弊社のSFTPサーバへ送信してください。
IP制限していますので、アクセスIPをご連絡ください。
商品データはHTTPSで取得できるところに配置してください。
データ連携 ファイル名の命名ルールはありますか？ item.tsv, member.tsv, order.tsvなど導入ガイドに記載しているファイル名を固定でお願いします。
データ連携 連携したデータの確認は出来ますか？ 会員データは、「顧客」メニューで参照可能です。
注文データは、「アナライズ」メニューから注文・注文商品のレポートを作成して確認してください。不明な場合はサポートまでご連絡ください。
データ連携 必須項目で原価など利用していない項目がありますが空でもいいでしょうか？ 数値項目で必須項目には必ず0などでも数値を設定してください。
データ連携 SFTPのデータ連携タイミングはどのように設定しますか？ 連携時間（AM4時など）をお知らせ下さい。
アイテム情報
ファイル連携		 アイテム情報ファイルの連携について、接続方式はHTTPアクセスのみでしょうか？SFTP、FTP等、他プロトコルも指定可能でしょうか？ SFTPも可能ですが、管理画面からの操作が可能なHTTPSアクセスでお願いします。
アイテム情報
ファイル連携		 ファイルの項目「img_url」「mb_img_url」の使用箇所、用途を教えていただけますでしょうか？ 検索とレコメンドの結果で商品のimage情報として表示されます。
アイテム情報
ファイル連携		 文字列のエスケープですが、シングルクォート（’）やダブルクォート（”）などのクォート文字はエスケープ不要でしょうか？ 不要です。改行文字のみエスケープが必要です。文字コードはUTF-8でお願いします。
アイテム情報
ファイル連携		 色・サイズ別などの商品がある場合、色・サイズ（SKU）別でなくアイテム単位でレコメンドや検索結果を表示するにはどのようにしますか？ 商品データでグループ商品で登録していただいた上で、レコメンドのトラッキングデータを親コードで送信していただくと、結果的に親商品がレコメンドとしてレスポンスされます。
アイテム情報
ファイル連携		 アイテム情報ファイルの更新頻度は？ 管理画面で設定可能です。
アイテム情報
ファイル連携		 アイテム情報ファイルは、全項目必要でしょうか？ 必須項目は、アイテムID、アイテム名、遷移先URLになります。
その他の項目は任意です。
必要な項目だけのファイルを作成してください。
アイテム情報
ファイル連携		 numberの項目で、値が無いレコードには値を設定しなくても構わないでしょうか？ 項目を利用する場合は、必ず全レコードに数値を入れてください。
ログ収集 アクセス履歴から自社のアクセス（特定IP）を除外することは可能でしょうか？ システムメニューのアクセス分析の設定で除外IP、除外ドメインを指定可能です。
ログ収集 ダブルクリックなどコンバージョンの重複を防ぐ仕組みはありますか？ 連続で来た重複は排除しています。
ログ収集 商品原価など持っていない値は設定しないと問題になりますか？ 必須項目は0などで設定してください。0で設定されると分析レポートの集計結果が0になります。
ログ収集 総注文金額の設定は、送料込みでしょうか？ポイント利用の場合はどのように設定しますか？ 設定する金額のルールはお客様で決定してください。設定された値で分析レポートに集計されます。
ログ収集 product_keyに設定する値はこちらで設定した商品コードですか？ アイテム情報ファイルで連携する「データファイルの項目」のidと同じ内容を設定してください。
レコメンド 閲覧、購買レコメンドの計算に利用するログの対象期間はどれぐらいでしょうか？ 標準では、3か月間のログを対象にしています。
レコメンド 閲覧、購買レコメンドの計算に利用するログの対象期間を変更することは可能でしょうか？ 可能です。
レコメンド レコメンドのロジックはどのようなものでしょうか？ 協調フィルタリングとテキストマイニングの組合せになります。
協調フィルタリングは閲覧レコメンドと購買レコメンドがあります。
閲覧レコメンドは、同じ訪問内で見た複数の商品の組合せから計算します。
購買レコメンドは、同じIDのユーザの購買履歴から商品の組合せを計算します。
レコメンド 閲覧ログの集計対象となるのは全件でしょうか？ デフォルトでは3秒以上滞在した閲覧商品ページのアクセスのみを対象としています。
レコメンド レコメンドに表示したくない商品は除外できますか？ 管理画面で除外する商品を設定可能です。
レコメンド 特定のカテゴリの商品のみを絞り込んで取得することは可能ですか？ 可能です。導入ガイドの要請パラメータを参照ください。
レコメンド ランキングの機能ですが、ランキングの対象とする期間を日付で範囲指定することは可能でしょうか？ 期間設定はparameterのfromとtoで設定してください。
形式はyyyyMMddHHです。
レコメンド 商品発売直後など、閲覧、購買が無い商品に対するレコメンドはどのようになりますか？ テキスト分析して、商品名、キーワード、カテゴリ名が類似する商品がレコメンドされます。
レコメンド 最近チェックした商品などと重複した商品をレコメンドから外すことはできますか？ 要請パラメータのxitemで指定してください。
レコメンド カテゴリを絞ったランキング情報は取得可能でしょうか？ ランキングを要請する際に、カテゴリを条件に付けることで可能です。
レコメンド ランキング情報はどのタイミングで更新されますか？ レコメンド情報を再計算するタイミングで更新されます。通常1日1回です。
ランキングは1時間に1回です。
レコメンド ランキングもレコメンドのように管理画面でテンプレートを作成する方法で実装できますか? ランキングの表示もレコメンドと同じ方法で出力できます。

導入ガイドの5.2.5 HTML出力機能の_rank(rankSet)をご参考ください。

作成例)
_scq.push([‘_rank’,{
index: 1, //閲覧
from: ‘2016100100’,
limit:10,
// Recommend template id
tmpId: ‘2’,
// HTML element id to render.
renderId: ‘rankDiv’
}]);
検索 １商品を複数カテゴリに属させることは可能でしょうか？ 商品データファイルでcategory項目があります。
セミコロン区切りで複数登録が可能です。
例）大カテゴリ名1:中カテゴリ名1:小カテゴリ名1;大カテゴリ名2:中カテゴリ名2:小カテゴリ名2;…
検索 商品データを手動でアップロードすることは可能ですか？ 管理画面から手動アップロードが可能です。
検索 価格帯別の価格レンジを変更することは可能でしょうか？ 価格帯集計は下記の方法に対応しております。
固定価格帯別集計 : 価格帯別検索結果数表示
可変価格帯別集計 : 検索結果から最高、最低価格を均等に分割
Parmaterで動的に指定可能 ： pr=1000,2000,5000
検索 発売日順はどの項目でソートをしますか？ 商品データ項目のstart_datetimeの値でソートします。
検索 number1~5の項目に対して、比較演算子は使えますでしょうか？ 比較演算子は利用できませんが、範囲での指定は可能です。
例) number1=1000:4000
number1が1000から4000の商品が対象になります。
検索 検索結果を複数のキーでソートして取得できますか？ 複数指定することが可能です。
検索 商品データは全件でしょうか？差分更新でしょうか？ 全件更新と差分更新のモードがあります。モードの切り替えはサポートまでご連絡ください。
検索 検索リクエストで、複数カテゴリを要請することは可能ですか？ 例category=A&category=B
カテゴリA OR Bの商品を検索
検索 ファセットのヒットした値の表示数には、何か制限がありますか？ 名前順またはヒット数順にソートして最大20個まで表示しています。
最大表示件数は変更できます。
検索 人気検索語は、レスポンスとして取得可能でしょうか？ JsonまたはXMLで取得可能です。
検索 ファセット及びカテゴリの並び順は何によるものでしょうか？ ファセットとカテゴリの並び順は文字順とHit順の2種類あります。
カテゴリ別アイテムのソート順番を設定する時、
後ろに’|’順番を付けてください。
例）大カテゴリ名1:中カテゴリ名1:小カテゴリ名1|1;大カテゴリ名2:中カテゴリ名2:小カテゴリ名2|3
検索 「もしかして」のワードは管理画面での登録が必要ですか？ 検索履歴から自動的に生成します。
検索 「その他のキーワード」は管理画面での登録が必要ですか？ 検索履歴から自動的に生成します。
検索 サジェストワードはどのような情報を基に出力されますか？ 過去の検索履歴でヒットしたワードで検索数が多い順に出力されます。
検索 アクセス順でのソートは可能ですか？ レコメンドで取得するアクセスランキング順のソートが可能です。
検索 売上順のソートは可能ですか？ レコメンドで取得する売上（受注件数）ランキング順のソートが可能です。
検索 フィールドに対して、複数の値を検索条件指定することは可能でしょうか？
例＞シャツで（青か赤）		 http://localhost/search?q=シャツ&attribute1=青&attribute1=赤
のようにfield nameをparameter nameで複数してするとfieldに対してOR検索になります。
検索 １つの商品に対して、複数の価格が設定されている場合に場合によって、価格検索のフィールドを分けることは可能でしょうか？
例１＞通常価格と会員価格がある場合
例２＞１つの商品を複数サイトで異なる価格で販売する場合		 価格fieldをpf parameterで指定できます。
pfを指定すると検索とfacetも指定した価格fieldで表示されます。http://localhost/search?pf=number1検索APIを使うと例１＞
商品ファイルのprice,number1にそれぞれ通常価格、会員価格を設定します。
会員がログインした場合は、検索時にパラメ-タ pf(price field)にnumber1を指定します。
if(login) {
searchService.addParam(“pf”, “number1”);
}例２＞
商品ファイルのprice,number1にそれぞれショップ１の価格、ショップ２の価格を設定します。
ショップ２で検索する時、パラメ-タ pf(price field)にnumber2を指定します。
if(shop is “shop2”) {
searchService.addParam(“pf”, “number2”);
}
検索 色、サイズなどAttribute項目で絞り込んだときの商品表示は代表商品が表示されますか？ １つのAttributeのみで検索した際は、代表商品が表示されます。
２つのAttributeで検索した際は、商品が特定されますので、子商品が検索表示されます。
検索 多言語への対応は可能でしょうか？ 可能です。
対応言語、機能の詳細はお問い合わせください。
検索 複数ショップの対応は可能でしょうか？ shop_idを条件に付けて検索することでショップを絞り込んだ検索が可能です。
検索 検索結果のアクセス順、売上順ソートについてアクセス数・売上数の基準となる期間は指定できますか？ 検索時の期間指定はできません。設定された集計対象期間で集計されます。
デフォルトは、アクセスは7日間、売上は30日間です。
検索 一文字検索で結果がヒットしたりしなかったりします。
また、検索結果0件の一文字検索に、別の文字を追加するとヒットすることがあります。
一文字検索について、なにか仕様・制限がありましたら、お教えください。		 検索エンジンは文章を意味ある単語で分解します。
QD112はQD、112でインデクスされます。日本語は形態素分析とBigram分析で方法し、インデクスを作ります。
例) 私は学校へ行きます
「形態素分析」
私, は, 学校, へ, 行く、 ます
「Bigram分析」
私は, は学, 学校, 校へ, へ行, 行き, きま, ます
検索 管理画面 > レコメンド > レコメンドで表示されるTの意味は? T – Total：テキスト分析結果を協調フィルタリングに反映したスコア
score – 0から1まで、　1が最高点
検索 管理画面 > レコメンド > レコメンドで表示されるCの意味は? C – 協調フィルタリングの結果(score, 商品1のアクセス件数、商品2のアクセス件数、商品1のアクセス件数、
商品1と商品2をの全部アクセスしたsession件数)
score – 0から1まで、1が最高点
検索 管理画面 > レコメンド > レコメンドで、Tのみが表示されていて、
Cが表示されていないものがあります。これはなぜでしょうか？		 商品1と商品2をの全部アクセスしたsession件数がないことを意味します。
その結果、テキスト分析のみでレコメンドされます。
検索 レコメンドの利用レポートに表示される「アクセス」の数は
何を表しているのでしょうか？		 レコメンドの要請APIのリクエスト件数です。
検索 レコメンドの除外アイテムは、一覧に表示されている商品を「OFF」にすると、
閲覧レコメンドからも購買レコメンドからも表示されなくなるのでしょうか？		 次回、商品データ更新時から表示されなくなります。
検索 古い商品が上にあがってきてしまいます。
新しい商品を上に表示したいです。検索ヒットのスコアは、同じだと思うのですが、新しい商品を上に
上げる方法はありませんでしょうか？		 ソート条件は複数指定ができますので
既存のソート条件にdate-descを追加してください。例)s=score&s=date-descまた、新しい商品順でTSVファイルを作成していただくと
同じスコアの時、新しい商品順で表示されます。
検索 同じ言葉が入っていますが、スコアが違っています。違う理由は何でしょうか？ 文字数もスコアに反映されます。

同じ条件だと長い文書より短い文章の方が、スコアが高くなります。

例えば、
商品名が「東京名物お菓子」と「東京銘菓」の商品がある場合、
ユーザが東京で検索すると「東京銘菓」のスコアが高くなります。

 

また、下記の項目で1 > 2 > 3の順で検索結果の上位に表示されるように加重値が付与されます。
1. id, title
2. keyword, summary, category
3. content, string, attribute
検索 boost項目に対して、質問させて下さい。

>1ヶ月以内 -> boost : 10
>3ヶ月以内 -> boost : 5
>他 -> 1
boostの設定ですが、検索キーワードにヒットしたスコアに対して、
boostの項目が、スコア×boostになるイメージでしょうか？

 total score = A() * (単語のscore*boost)の合計
のイメージです。
A（）の値は0から1の範囲です。
total scoreはだいたい1より小さい値になります。最終的に表示scoreは一番高い商品のtotal scoreで割った数値です。例)
A : 0.1234 -> 1
B : 0.101 -> 0.818Boostでの表示コントロールは制御が難しいため、必ず上に表示したい商品がある場合はフラグなどを立てソート機能で制御してください。
検索 検索結果にヒットしたカテゴリの全階層を取得することは可能ですか？ &ce=trueをパラメータに付けることで全カテゴリの情報を取得します。
検索・
レコメンド		 売上順の並び替えおよびランキングの基準は、受注件数、受注数量、受注金額のうち何になりますか？ 受注件数になります。1回の注文で数量2個注文した場合も1でカウントします。

EC Intelligence カスタマーサポートへのお問い合わせはこちら

この情報は役に立ちましたか？