レビュー
まるっと検索は、検索と一緒に商品レビューを扱えます。他のレビューアプリをお使いのままでも、星を検索結果に出し、評価で絞り込み・並び替えができます。まるっと検索でレビューを集めることもできます。
| できること | プラン |
|---|---|
| 他のレビューアプリの星を検索結果に出す | Basic 以上 |
| 評価での絞り込み（★4以上・★3以上）・並び替え | Basic 以上 |
| まるっと検索でレビューを集めて表示する | Basic 以上 |
| レビューの言葉で商品を見つける（レビュー検索） | Pro |
他のレビューアプリと一緒に使う
Judge.me・Loox などのレビューアプリは、商品の評価を Shopify 標準のメタフィールド reviews.rating・reviews.rating_count に書き込みます。まるっと検索はこの値を商品の同期で読み、次のように使います。
- 検索結果・ヘッダー検索・コレクションの商品に星と件数を出します
- 「★4以上」「★3以上」で絞り込めます。判定は、カードに描く星の数と同じです
- ストアフロントの検索結果で「評価が高い順」に並べられます。件数の少ない商品が上に来すぎないよう、件数で重みを付けています。評価のない商品は最後です
レビューアプリが評価を変えても Shopify から通知は来ないため、評価が変わった商品は1時間ごとに、全商品は1日1回読み直します。まるっと検索で集めたレビューがある商品は、そちらを優先します。
Judge.me のレビューの言葉で探す（Pro）
Pro のレビュー検索では、Judge.me のレビューの言葉でも商品が見つかります。Judge.me が商品ごとに保存している新しいレビュー（Judge.me の既定では5件）の本文とタイトルを、評価と一緒に読みます。
- 「レビュー → 設定 → 商品検索への活用」のタイトル・本文の設定に従います。両方ともオフなら読みません
- 星・評価順・評価での絞り込み・レビューのキーワードは変わりません。これらは Judge.me が書いた評価（
reviews.rating）から出します - ★1・★2 のレビューの言葉では見つけません（まるっと検索のレビューと同じです）
- 検索結果のカードに、見つかった言葉を含むレビューの抜粋が出ます。投稿者名は出しません
- まるっと検索で集めたレビューがある商品は、そちらだけを使います
- 分析画面の「レビューの言葉で見つかった検索」にも数えます
- 1ストアあたり5,000件までです（商品を古い順に読み、上限に達したら残りの商品は入りません）
- Basic に変えると、読み込んだ Judge.me の本文は検索から消えます
Judge.me の保存形式について
Judge.me がこの値の形式を公開していないため、Judge.me 側の変更で読めなくなることがあります。そのときは Judge.me の言葉で見つからなくなるだけで、星や並び替えには影響しません。Loox・Junip などの本文は、いまは読みません。
検索API v1 について
検索API v1 の契約には評価の項目と評価順の並び替えは含まれません。ストアフロントのブロックでお使いください。
テーマへの置き方
レビューはテーマのブロックで表示します。管理画面の「レビュー → 設定 → ストアでの表示」に、公開中のテーマのどこに置かれているかと、置き方が出ます。
| ブロック | 置く場所 | 内容 |
|---|---|---|
| 商品レビュー | 商品テンプレート | 星の分布・本文の検索・並び替え・写真付きのみ・写真の拡大・「参考になった」 |
| レビューバッジ | 商品テンプレート | 商品名の近くに星と件数 |
| お客様の声（カルーセル） | トップページなど | ストア全体の新しいレビュー。写真付きだけにもできます |
| お客様の声（レビュー一覧ページ） | ページのテンプレート | ストア全体のレビューを、語句・星・写真で探せる一覧 |
| レビューへのタブ | アプリ埋め込み（全ページ） | 画面の端に、一覧ページへのタブ |
レビュー一覧ページは、先に「お客様の声」などのページを作り、ページのテンプレートにブロックを置いてから、ブロックの「表示するページ」で作ったページを選びます。既定のページテンプレートに置いても、選んだページにだけ表示されます。
他のアプリから移す（CSV）
レビューアプリが書き出した CSV を、そのまま取り込めます。アプリごとの書き出し方と、取り込んだあとの手順は、設定ガイドのほかのレビューアプリから乗り換えるにあります。
- 対応する形式: Judge.me・Loox・Junip・Yotpo・Okendo・Stamped・Shopify Product Reviews・まるっと検索の書き出し。見出しが日本語（商品ハンドル・評価・本文など）の表も読めます
- 列は見出しの名前で読みます。並び順や大文字・小文字は問いません
- 文字コード: UTF-8 と、Excel で保存した Shift_JIS
- 公開状態: 取り込み元で公開していたレビューを、公開のまま取り込むか選べます。スパム判定のレビューと、ストアへのレビュー（商品なし）は取り込みません
- 写真: ストアのファイルに移します。ファイルの保存の許可が要ります（取り込みの欄の「画像アップロードを有効にする」）
- 同じレビューは二重に入りません。同じファイルや、期間の重なる書き出しを取り込み直しても、増えるのは新しいレビューだけです
- 上限: 1ファイル5万行・20MB。取り込みは裏で進み、画面に進み具合と、取り込めなかった行の理由（行番号つき）が出ます
- メールアドレス・IP アドレスなどの個人情報は読みません
Excel で開いた CSV
商品 ID が 7.01E+12 のような指数表記になっている行は、正しい ID に戻せないため取り込めません。レビューアプリから書き出したファイルを、Excel で保存し直さずにお使いください。
レビュー依頼
まるっと検索は依頼のメールを送りません。発送から設定した日数（3・7・14・30日、既定7日）が経った注文ごとに、Shopify Flow のトリガー「レビュー依頼の時期」を開始します。メールや LINE は、お使いのアプリの Flow アクションで送ってください。
| Flow の変数 | 内容 |
|---|---|
order | 対象の注文（参照） |
customer | 注文のお客様（参照） |
reviewUrl | 投稿リンク |
productTitles | まだレビューしていない商品の名前（「、」区切り） |
productCount | その件数 |
eventId | 重複の判定に使う ID |
- 投稿リンクはログインの代わりになります。リンクから開いたお客様は、その注文の商品をログインせずに「購入確認済み」としてレビューできます。リンクは発送から180日有効です
- 書き終えると、同じ注文の他の商品へ案内します
- 全部レビュー済みの注文には送りません
- 管理画面に、メールと LINE の文面のひな形があります
同梱用の QR コードも出せます。どの荷物にも同じコード（/apps/marutto-search/r）を使い、読み取ったお客様はログインすると、まだレビューしていない商品の投稿画面に進みます。
公正な表示
ステルスマーケティング規制（景品表示法）と米国 FTC の規則に沿って、次のように作っています。
- 好意的なレビューだけを選んで載せる設定はありません。まとめての公開・非表示も、評価で絞り込んでいる間は使えません
- 投稿に特典（クーポンなど）を付けている間のレビューには「特典あり」と表示します。特典は、評価や内容によらず全員に同じものを渡してください
- 承認待ちのまま設定した日数が経ったストアフロントのレビューを、評価によらず自動で公開できます（任意）
- 商品ページに「購入確認済み」「インポート」「特典あり」の意味を説明する欄があります
管理画面
- 絞り込み: 状態・評価・購入確認・返信の有無・商品
- まとめて公開・非表示: 絞り込んだ結果に対して（一度に500件）
- 非表示にするときは理由を選び、操作の記録に残ります
- 返信の削除（元の文面は記録に残ります）
- Shopify の顧客詳細ページに、そのお客様のレビューを表示するブロック
- 分析画面に「レビューの言葉で見つかった検索」（Pro）: 商品名や説明にはない言葉で、レビューから商品が見つかった検索と、その後のクリック・注文（参考値）