Bazaarvoice の統合

Bazaarvoiceの商品フィードは、広告フィードのように表示回数や費用対効果を重視するものではなく、正確性を重視しています。Bazaarvoice自身もカタログの目的を明確に説明しています。商品カタログフィードは、Bazaarvoiceに「各商品と消費者が作成したコンテンツを照合するため」に送信されます。フィード内の商品が欠落していたり​​、名前が間違っていたり、カテゴリが間違っていたりすると、Bazaarvoiceは受信したレビューを照合するための信頼できる基準を持たず、その結果、レビューが表示されなかったり、レビューが間違った商品に紐づけられたり、サイト上のレビュー投稿フォームが購入者がどの商品をレビューしているのかさえ認識できなかったりといった問題が発生します。

Bazaarvoiceのエンジニアリングチームは、これを下流工程における信頼性の観点から捉えています。明確で正確かつ一貫性のある商品名は、「APIが商品情報を正しく取得して表示できるようにし、レビューや評価が常に正しい商品に関連付けられるようにします」。カテゴリデータも、新規レビュー投稿において同様の役割を果たします。「ユーザーの投稿を適切な商品グループに誘導することで、シームレスなコンテンツ投稿を促進します」。Feedanceは、ストアの商品、名前、カテゴリが変更されても、カタログデータを自動的に最新の状態に保ち、Bazaarvoiceが古い一度のエクスポートデータに基づいて作業することを防ぎます。

Bazaarvoiceは、フィードで送信された識別子を使用して、すべてのレビューを製品に紐付けます。 ExternalId (NAIST) と ProductPageUrl — 商品ページにレビュー表示ウィジェットを読み込む際にサイトが渡す商品IDと照合されます。この2つが一致しない場合、Bazaarvoiceが記録している実際の結果は「間違ったUGCが返される」ことです。つまり、レビューが全く表示されないか、別の商品のレビューが表示されます。

商品のバリエーション（例えば、色やサイズが異なる同じ商品）については、Bazaarvoiceのフィードスキーマは、2つのカスタム属性を使用した「商品ファミリー」メカニズムをサポートしています。 BV_FE_FAMILY 関連する SKU を共通のファミリー バリューの下にグループ化します (Bazaarvoice のサンプル フィードでは、タグ付けされた製品) Round (NAIST) と Green）、及び BV_FE_EXPAND Bazaarvoice にそのファミリーの他のすべての製品のレビューを取り込むように指示します (BV_FE_FAMILY:Round）そのため、買い物客は、ほぼ同じバリエーションのリストにまばらに散らばった少数のレビューではなく、集計された評価を見ることができます。

Bazaarvoiceのドキュメント化された製品フィードはXMLであり、単一の構造になっています。 <Feed> ルート要素は、以下の順序で3つの子セクションを持ちます。 <Brands>, <Categories> (NAIST) と <Products>Bazaarvoiceの公式サンプルフィードは名前空間を使用しています http://www.bazaarvoice.com/xs/PRR/ProductFeed/14.7 ルート要素の横に、 name クライアントを識別する属性、 incremental 属性 （true/false）、 と extractDate タイムスタンプ。

デフォルトでは、カタログ全体のアップロードのみがサポートされています。1 つのフィードあたり 750,000 製品の上限が文書化されているため、アカウント専用にデルタ/増分プロセスを構築していない限り、すべての送信は変更された部分だけでなく、現在のカタログ全体を表す必要があります。フィードは通常、ホストする URL から取得するのではなく、FTP/SFTP を介して Bazaarvoice アカウント用にプロビジョニングされた場所にパッケージ化され配信されます。Bazaarvoice の新しいソーシャル コマース API カタログ取り込み (特に Bazaarvoice–PowerReviews 製品ラインの統合後に一部のアカウントで使用) では、代わりに、異なる Google ショッピング スタイルのフィールド セットを使用した CSV、TSV、XML、RSS、または ATOM を受け入れることに注意してください。アカウントに適用されるパスは Bazaarvoice の設定によって異なるため、Feedance はここで説明する従来の XML 製品フィード構造を構築します。これは、Bazaarvoice のドキュメントで「製品フィード」と名付けられている形式です。

以下の表では、Bazaarvoiceの公式サンプル製品フィードXMLに記載されているとおり、Bazaarvoice独自のフィールド名を使用しています。Bazaarvoiceのエンジニアリングドキュメントでは、明示的にフィールド名が示されています。 ExternalId, Name およびカテゴリ識別（CategoryExternalIdそれに合う Name カテゴリセクションのエントリ）は必須項目です。残りのフィールドは同じスキーマのドキュメント化された部分であり、必須項目であることを確認できなかった場合は「推奨」とマークされています。

1. Feedanceにあなたのカタログを追加しましょう。 Feedanceダッシュボードで、ストアを接続するか、商品データをアップロードしてください。
2. Bazaarvoiceの製品フィードタグにフィールドをマッピングします。 Feedance はあなたの製品 ID をマッピングします ExternalIdタイトル Name正規の製品URL ProductPageUrlメイン画像へ ImageUrlカテゴリーとブランド CategoryExternalId / BrandExternalId — マッチング Category (NAIST) と Brand フィードのカテゴリとブランドセクションにエントリが生成され、それらの参照が解決されるようにします。
3. 識別子は自動的にサニタイズされます。 Feedance はスペース、記号、その他の文字を削除します。Bazaarvoice のドキュメントでは、 ExternalId (NAIST) と CategoryExternalId不正な識別子はエンコードの問題を引き起こす原因として知られているため、それらをハイフンやアンダースコアに置き換える。
4. レビュー集計のために、バリエーションはグループ化されます。 カタログに同じ基本製品の色/サイズバリエーションがある場合、Feedance は BV_FE_FAMILY (NAIST) と BV_FE_EXPAND そのため、Bazaarvoiceはレビューを各SKUに細かく分割するのではなく、ファミリー全体で集約します。
5. フィードを配信する。 Feedanceは、BazaarvoiceのXMLに一致するXMLとして結果をパッケージ化します。 Feed/Brands/Categories/Products 構造化して、Bazaarvoiceアカウントが受信するように設定されているSFTPロケーションに配信します。最初の配信が正常に完了したことを確認してください。インポートが失敗した場合は、アプリ内でエラーが表示されるのではなく、ログに記録され、メールアラートが送信されます。

デフォルトではカタログ全体のアップロードのみがサポートされているため、フィードの送信は、差分ではなく、現在の製品セット全体を表す必要があります。Bazaarvoice には、アカウント用にカスタム増分プロセスが構築されていない限り、「変更された部分のみ」を受け入れる標準的なメカニズムはありません。報告される頻度は統合によって異なります。一部の設定ではエクスポートを毎晩実行し、他の設定では毎日送信します。Bazaarvoice の新しいソーシャル コマース カタログ取り込みパスは、デフォルトで約 6 時間サイクルで更新されるように文書化されています。したがって、目標とする普遍的な数値はなく、共通の原則があるだけです。レビューを添付するには、新しい製品が送信されたフィードに含まれている必要があります。そのため、カタログの変更に事後的に対応するのではなく、固定された日次または夜間のスケジュールで、常に製品がサイトで公開される前に更新されたフィードを送信するのが最も安全な方法です。カタログが、文書化されているフル フィードの製品上限である 750,000 製品に達しているか、または近づいている場合は、送信が拒否されたときに制限を発見するのではなく、事前に差分/増分フィード プロセスを計画してください。

フィードの識別子をページコードと完全に一致させてください。 レビューが表示されない、または間違った商品に表示される最も一般的な原因は、 ExternalId または、フィードとサイト上のレビューウィジェットの間で商品URLが一致していない。

BazaarvoiceのID命名規則に従ってください。 ハイフンとアンダースコアのみを使用してください ExternalId (NAIST) と CategoryExternalId — Bazaarvoiceの技術ガイドライン自体にも、スペース、プラス記号、その他のHTML文字がエンコードの問題を引き起こす原因として挙げられています。

製品ファミリーと関連して、バリエーションをグループ化します。 　 BV_FE_FAMILY (NAIST) と BV_FE_EXPAND そのため、同じ商品の色やサイズのバリエーションごとにレビューが共有・集約され、少数のレビューが多数のほぼ重複した商品ページに分散されるのを防ぎます。

二次識別子を入手したら送信してください。 UPC, EAN (NAIST) と ManufacturerPartNumber これらはオプションですが、Bazaarvoiceがカタログを正しく照合するための追加情報を提供し、特に初期導入時やカタログ移行時に役立ちます。

発売前に提出してください。発売後に提出しないでください。デフォルトでは全商品カタログのフィードのみがサポートされているため、新商品は提出済みのフィードに登録されるまでレビューを収集したり表示したりすることはできません。

カテゴリ名とIDは、常に一貫性を保ってください。カテゴリデータは新しいレビュー投稿を適切な製品グループに振り分けるため、フィードを更新せずにカテゴリIDの名前を変更したり、並べ替えたりすると、受信したレビューが誤った方向に振り分けられる可能性があります。

Bazaarvoiceの製品フィードはどのようなフォーマットを使用していますか？
XML — <Feed> ルート要素を含む Brands, Categories (NAIST) と Products 各セクションは、FTP/SFTP経由でお客様のBazaarvoiceアカウントに配信されます。

これは広告フィードや価格比較フィードと同じものですか？
いいえ。Bazaarvoiceの商品フィードは、お客様のカタログを収集したレビューや評価と照合し、表示および配信するためのものであり、Google Merchant Centerや価格比較サイトのように広告掲載や価格比較に使用されるものではありません。

いくつの商品を掲載できますか？
全カタログフィードは、デフォルトで最大750,000万点の製品をサポートするように文書化されています。

カタログ全体ではなく、変更点のみを送信することはできますか？
デフォルトではサポートされていません。アカウントにカスタムの増分/差分プロセスが設定されていない限り、カタログ全体のアップロードのみがサポートされます。

フィードのインポートに失敗した場合はどうなりますか？
Bazaarvoiceはエラーをログに記録し、メールでアラートを送信しますが、インポートを自動的に再試行する機能はないため、修正済みのファイルを再送信する必要があります。

色やサイズ違いの商品レビューをまとめて管理するにはどうすればよいですか？
BV_FE_FAMILY グループバリアントSKUに属性を付け、 BV_FE_EXPAND 家族の他のメンバーからのレビューを集めるため。

なぜレビューが間違った商品に表示されるのでしょうか？
ほとんどの場合 ExternalId または、フィード内の商品URLと、ページコードがレビュー表示ウィジェットに渡す商品URLとの間に不一致がある場合。