awoo AI連携
目次
1.概要
2.商品をawoo AIに連携する条件と項目について
3.ユーザーウェブでの表示について
4.導入手順
5.テンプレートファイルについて
1.概要
「awoo AI」は、awoo Japan株式会社が提供する、商品理解を通して回遊と購買を生み出すAIサジェストプラットフォームです。
「awoo AI」のサービス内容は公式ホームページをご覧ください。
https://awoo.ai/ja/mechanism/
ECサイトから連携した商品データフィードを元に、自動で関連タグを生成し、
関連タグによるレコメンド表示・絞り込み・検索一覧表示が可能なawoo AIと連携します。
オプション導入にあたってのご留意事項
・ご利用には、別途awoo Japan様へのご利用申し込み手続きが必要です。
※お申し込みの際に、弊社からの連携である旨をお伝えください。
・本オプションをご利用いただくための最低商品数は、300商品です。詳しくはawoo Japan様にお問い合わせください。
・店舗様ごとのカスタマイズ内容や利用オプションとの併用可否については、導入時に影響調査が必要です。
・商品単位で連携をします。バリエーション単位で連携しないため、ご注意ください。
2.商品をawoo AIに連携する条件と項目について
商品とカテゴリの設定が以下の場合に、バッチで商品情報をawoo AIに連携します。
・商品マスタの登録区分を「本登録」にしている
・商品マスタの検索結果表示フラグを「表示」に指定している
・商品マスタの商品詳細表示フラグを「表示」に指定している
・商品マスタの表示期間が指定されていない、もしくは表示期間内である
・カートオプション商品ではない
・ノベルティ商品ではない
・商品マスタの公開会員ランクを設定していない
・商品マスタの会員タグを設定していない
・初期設定「awoo
AI:商品ディスクリプションカラム設定」に登録している商品マスタの項目に、値を設定している
・商品に対してカテゴリを指定している
・指定したカテゴリの登録区分を「本登録」にしている
・指定したカテゴリのカテゴリ表示フラグを「表示」に指定している
連携する割引価格については、商品のタイムセール価格のみ対応しています。（バリエーション単位のタイムセール価格は除く）
以下の割引価格は連携および反映されません。
ユーザーがログイン時に特徴別商品一覧ページ（ext/item_list_awoo.xhtml）を表示した場合、
awoo AIを利用して表示している商品情報には、以下の価格設定は反映されません。
・会員別商品価格
・会員ランク別商品価格
・会員ランク別割引率
バッチが実行されたタイミングでawoo AIに商品を連携するため、
商品情報を更新してから特徴別商品一覧ページ（ext/item_list_awoo.xhtml）に更新内容が反映されるまでに
時間がかかる場合があります。
例えば、商品を「本登録」から「仮登録」にした場合、
バッチで商品情報が連携されるまでは特徴別商品一覧ページ（ext/item_list_awoo.xhtml）に該当商品が掲載されます。
ただし、該当商品の商品詳細ページ(item_detail.xhtml)には遷移できず、エラーページが表示されます。
3.ユーザーウェブでの表示について
トップページ（top.xhtml）
任意の位置に商品の関連タグとレコメンド画像を表示できます。
商品一覧ページ(item_list.xhtml)
カテゴリ選択後のページにて、任意の位置に商品の関連タグを表示できます。
商品詳細ページ(item_detail.xhtml)
任意の位置に商品の関連タグとレコメンド画像を表示できます。
特徴別商品一覧ページ（ext/item_list_awoo.xhtml）
トップページ（top.xhtml）、商品一覧ページ(item_list.xhtml)、商品詳細ページ(item_detail.xhtml)にある商品の関連タグを選択したときに、
awoo AI用の新規ページである「特徴別商品一覧ページ（ext/item_list_awoo.xhtml）」に遷移します。
「金額の高い順」または「金額の低い順」で表示できます。
新着順について
特徴別商品一覧ページ（ext/item_list_awoo.xhtml）では「新着順」での表示も可能ですが、
商品一覧ページ（item_list.xhtml）の新着順と以下の差異があるため、
標準のテンプレートファイルでは「新着順」を非表示にしています。
| ページ | 新着順の詳細 |
|---|---|
| 特徴別商品一覧ページ（ext/item_list_awoo.xhtml） | awoo AI側のシステムに取り込みされた順 |
| 商品一覧ページ（item_list.xhtml） | 商品マスタの「新着順用更新日」順 |
「新着順」を表示したい場合は、弊社サポート窓口までご連絡ください。
在庫有無の表示について
標準で用意しているjsファイル（view/userweb/js/awooAI.js ）では対応していないため、
ご希望の場合は店舗様でご対応いただく必要があります。
金額の高い順を選択した場合
「金額の高い順」の並び順については、商品の在庫が優先順位に関係します。
■「金額の高い順」の並び順に関する優先度
1.在庫がある、かつ、販売価格（タイムセールが適用される場合、タイムセール価格）の高い順
2.在庫がない、かつ、販売価格（タイムセールが適用される場合、タイムセール価格）の高い順
金額の低い順を選択した場合
「金額の低い順」の並び順については、在庫が優先順位に関係します。
■「金額の低い順」の並び順に関する優先度
1.在庫がある、かつ、商品の販売価格（タイムセールが適用される場合、タイムセール価格）の安い順
2.在庫がない、かつ、商品の販売価格（タイムセールが適用される場合、タイムセール価格）の安い順
4.導入手順
| 環境 | 担当 | 内容 | |
|---|---|---|---|
| 1 | - | 店舗様 | 本オプション利用の申し込みの旨を、弊社担当営業またはサポート窓口までご連絡ください。 |
| 2 | 「awoo AI」利用の申し込みの旨を、awoo Japan様にご連絡ください。 ※お申し込みの際に、弊社からの連携である旨をお伝えください。 |
||
| 3 | デモ・本番 | 弊社 | awoo AI連携オプションを適用します。 |
| 4 | 店舗様 | 初期設定「awoo AI:商品ディスクリプションカラム設定」をご登録ください。 | |
| 5 | サイト基本情報で設定した「サイト名(店舗名)」と「メタタグディスクリプション」を awoo Japan様に連携してください。 特徴別商品一覧ページ（ext/item_list_awoo.xhtml）で使用する、 メタタグに設定する情報を作成するために必要です。 |
||
| 6 | 弊社 | バッチを実行しデータフィードファイルを作成します。 awoo Japan様にファイルを連携し、ファイルの取込とID発行を依頼します。 |
|
| 7 | awoo Japan様 | ファイルの取込とIDを発行をします。 | |
| 8 | デモ | 店舗様 | デモ環境のテンプレートファイルを反映してください。 反映後は商品情報が出力されることをご確認ください。 |
| 9 | 本番 | 弊社 | 商品情報をawoo AIへ連携するバッチを設定します。 |
| 10 | 店舗様 | 本番環境のテンプレートファイルを反映してください。 デモ環境に反映したテンプレートファイルを利用する際は、 デモ環境用のIDから本番環境用のIDに変更する必要があります。 反映後は商品情報が出力されることをご確認ください。 |
テンプレートのファイル名を変更する場合
ext配下にある本オプション専用の特徴別商品一覧ページ（item_list_awoo.xhtml）の
ファイル名（item_list_awoo.xhtml）を変更する場合、
awoo AI側の設定も変更いただく必要があるため、awoo Japan様にファイル名を変更する旨をご連絡ください。
5.テンプレートファイルについて
新規追加および追記するテンプレートファイルについて説明します。各テンプレートファイルに関する詳細は、クリックしてご確認ください。
新規追加するテンプレートファイル
awoo AIの機能を利用する各ページで必要なjsファイル(/js/awooAI.js)
1.「awooAI.js」は本オプション利用時に追加するjsファイルのため、
ショップ管理ツールサイドバーから「最新版テンプレート」をダウンロードしてください。
2.ショップ管理ツールの「コンテンツ管理 > 画像・テンプレート管理」に遷移し、
view(vew_preview)/userweb > jsフォルダ 配下に、新規のjsファイル「awooAI.js」を追加してください。
3.作成したjsファイルの記述を以下にしたがって、変更および記載してください。
・【awooJapan様に発行いただくID】を変更してください。
・デモ環境の場合は、【デモ環境の場合：店舗NO】に該当する店舗Noを記載してください。
デモ環境の場合
本番環境の場合
特徴別商品一覧ページ（ext/item_list_awoo.xhtml）
1.「item_list_awoo.xhtml」は本オプション利用時に追加するテンプレートファイルのため、
ショップ管理ツールサイドバーから「最新版テンプレート」をダウンロードしてください。
2.ショップ管理ツールの「コンテンツ管理 > 画像・テンプレート管理」に遷移し、
view(vew_preview)/userweb > extフォルダ 配下に、新規のテンプレートファイル「item_list_awoo.xhtml」を追加してください。
追記するテンプレートファイル
以下のうちいずれか、もしくは以下すべてのページに追記してください。
head内にjsの呼び出し処理を記載します。
※最新の詳細な記述は、ショップ管理ツールサイドバーから「最新版テンプレート」をダウンロードいただき、
body内のawoo AIの関連タグを表示したい箇所に記載します。
※最新の詳細な記述は、ショップ管理ツールサイドバーから「最新版テンプレート」をダウンロードいただき、
body内のawoo AIの関連タグを表示したい箇所に記載します。
※最新の詳細な記述は、ショップ管理ツールサイドバーから「最新版テンプレート」をダウンロードいただき、
トップページ(top.xhtml)
body内のawoo AIの関連タグを表示したい箇所に記載します。
body内のawoo AIのレコメンド画像を表示したい箇所に記載します。
view/userweb/top.xhtml をご参考ください。
商品一覧ページ(item_list.xhtml)
view/userweb/item_list.xhtml をご参考ください。
商品詳細ページ(item_detail.xhtml)
body内のawoo AIのレコメンド画像を表示したい箇所に記載します。
view/userweb/item_detail.xhtml をご参考ください。
当ページの記載内容は、標準機能に関するものです。
機能に関するカスタマイズをされている場合にはこの限りではありません。
