 |
| Install: Kibo eCommerce App Marketplace Platforms: Legacy eCommerce, UCP eCommerce and eCommerce+OMS |
Bazaarvoice Conversations provides services to track and display customer interactions with your products. With Bazaarvoice Conversations, you can leverage multiple types of shopper-generated content, including ratings and reviews, questions and answers, and campaigns. By displaying this content on your store site(s), you can increase customer engagement, your SEO rankings, and ultimately your ROI.
The Bazaarvoice Conversations application seamlessly integrates your Bazaarvoice Conversations account with eCommerce so you can display captured content on your storefront.
Application Features
- Exports product and category data from eCommerce to Bazaarvoice to set the available products for tracking in Bazaarvoice.
- Imports and displays the Bazaarvoice Conversations data of your choice on your eCommerce sites. You can display ratings summaries, customer reviews, and Q&A.
- Supports faceting by ratings, so customers can filter displayed products by rating.
- Imports SEO data from Bazaarvoice to eCommerce.
- Provides detailed logs for import/export jobs.
When a shopper enters a review or rating, the following occurs between eCommerce and Bazaarvoice:
- Customer enters a review, selects a rating, asks a question, or posts an answer on your site.
- eCommerce exports new customer content to the Bazaarvoice FTP server daily, or according to the schedule you specify in Bazaarvoice.
- Bazaarvoice Conversations saves the captured data with the associated product and category.
- eCommerce imports new data from Bazaarvoice daily, or according to the schedule you specify in Bazaarvoice.
Install the App
You can install the Bazaarvoice Conversations Application by eCommerce directly from the App Marketplace:
- Go to www.kibocommerce.com/marketplace
- In the Search field, enter: Bazaarvoice
- Click the app icon.
- On the app page, click Install Now.
Configuration Requirements
- You must have the Bazaarvoice Conversations Application installed on your tenant.
- You must have an active Bazaarvoice Conversations account.
- You must have access to modify and update your storefront theme.
Configure the App
- In Admin, go to System > Customization > Applications.
- Click Mozu Bazaarvoice Conversations Application.
- Click the Configuration link to open the configuration dialog.
- Enter your Bazaarvoice credentials on the Configuration tab. For more information on the options available in the Configuration tab, refer to the following sections:
Edit Clients
On the Clients page, you can edit credentials and configurations for your Bazaarvoice clients. The following table describes the options on the options available on the Clients page:
| Field | Description |
|---|---|
| New Client | Select to add a new Bazaarvoice client to the list of clients available in the Clients table. |
| Name | Bazaarvoice client name. |
| Master Catalog | The number of the master catalog linked to this Bazaarvoice client. |
| Edit | Select to edit a client. When you select this option, eCommerce displays the Client Settings configuration page. For more information, refer to the Edit Client Settings section below. |
| Delete | Select to delete this client from the Clients table. |
Edit Client Settings
When you select Edit on the Clients page, eCommerce displays the Client Settings configuration page. Here you can edit credentials associated with your selected Bazaarvoice client.
The following table describes the options on the Client Settings configuration page:
| Field | Description |
|---|---|
| Environment | Specifies the site you are configuring for Bazaarvoice content. If you have multiple sites, you can enter different settings for each site. |
| Master Catalog | Specifies whether the site can exchange data with Bazaarvoice Conversations. You must enable this option for your Bazaarvoice content to remain up-to-date. |
| Client Name | Name used to identify a Bazaarvoice client. Usually the same as your FTP Username. |
| FTP Username | Your username for the Bazaarvoice FTP server. The FTP server is used for imports and exports of data. This name is provided to you by Bazaarvoice and is typically the same as your Client Name. |
| Use Client Name | Select to use the current client name as your FTP username. |
| FTP Password | Your password for the Bazaarvoice FTP server. |
| Deployment Zone | (Optional) The Bazaarvoice deployment zone you want to use. Most configuratons have one zone, Main Site. However, you can configure multiple deployment zones in Bazaarvoice if you have multiple product detail page types. |
| SEO Cloud Key | (Optional) This key allows eCommerce to access your SEO data in Bazaarvoice SEO. Bazaarvoice SEO features can include user-generated content in addition to your own site content for purposes of SEO. You can find this key on the Settings > SEO page of the Bazaarvoice Configuration Hub:
|
Edit Groups
In the Site Groups section of the Client Settings page, you can view groups associated with your Bazaarvoice client and add, edit, or delete an individual group. Group contain sites that Bazaarvoice will import/export data from.
The following table describes the fields for the Site Groups section and table:
| Field | Description |
|---|---|
| Add New Group | Select to add a new group |
| (unlabeled) Group Name | Name of the group. Group names must be alphanumeric and contain no spaces. |
| (unlabeled) Group Domain | Indicates the domain associated with this group. If you do not enter a domain for a group, it will default to the domain for your site. |
| Edit | Select to edit a group. When selected, eCommerce displays the Sites table. For more information, see the Edit Group Sites section below. |
| Delete | Select to delete a group from the Site Groups table. |
| Save Client | Select to save client settings. |
Edit Group Sites
When you select Edit in the Site Groups section of the Client Settings page, eCommerce displays the Sites table. Here you can edit the sites associated with a group.
The following table describes the field in the group sites table:
| Field | Description |
|---|---|
| Add New Site | Select to add a new site to this group. |
| Site ID | Site ID for the site associated with this group. |
| Enabled | Indicates whether the site is enabled for Bazaarvoice to pull data from it. Note: A client will export if at least one site is enabled, but the export will only include information from the enabled sites. |
| Variant | Indicates whether to export data for product variants in addition to base products. |
| Delete | Select to remove a site from this group. |
| Save Group | Select to save changes to this group's settings. |
Enable the App
- In Admin, go to System > Customization > Applications.
- Click Mozu Bazaarvoice Conversations Application.
- Click Enable App.
Edit Your Theme
This feature requires changes to your core theme. Ask your theme developer to make the changes outlined in this GitHub pull request.
Enable Live Edit
Enabling Live Edit for products allows you to make immediate edits to products that are live on your storefront even if product publishing is set to staged. The Bazaarvoice Application uses this functionality to ensure your products display the latest ratings and reviews. To enable the live editing feature:
- In Admin, go to System > Settings > Publishing.
- Ensure your product publishing setting is set to Staged.
- Check Live Edit.
Import and Export Data
After you configure the Bazaarvoice Application for the first time, you must manually import and export data between the systems. After this initial sync, imports and exports occur automatically. Data transfers go through the Bazaarvoice FTP server, using the credentials and Environment you specified on the Configuration tab. Remember to switch the Environment to Production when you are ready to display live data on your site.
Product Exports
Exporting products updates all products in Bazaarvoice to capture with ratings, reviews, questions and answers, and so on that have come in through your site.
Assign Products to Bazaarvoice Categories
You must assign a Bazaarvoice category to each product in your catalog before you can complete a successful export:
- In Admin, go to System > Schema > Product Attributes.
- Create a new property and name it Bazaarvoice Category.
- For each product you want to export, go the product page in Admin and enter a value for the Bazaarvoice Category.
Export Product Data
- In the app configuration dialog, go to the Product Export tab.
- If this is your first export, or if you want to manually force an export, click Export Now. Future exports will occur automatically. By default, Kibo exports product data to the Bazaarvoice FTP server daily, at 2:00 AM CST. Bazaarvoice accesses the files at 3:00 AM CST.
- (Optional) If an error occurs, click the link in the Errors column to view the error log.
Ratings Import
Importing ratings gets the latest customer rating info for all configured products:
- In the app configuration dialog, go to the Ratings Import tab.
- If this is your first import, or if you want to manually force an import, click Get Ratings. Future imports will occur automatically. By default, Kibo imports ratings data daily, at 1:00 PM CST.
- (Optional) If an error occurs, click the link in the Errors column to view the error log.
You can view the imported ratings for a product in Admin. Go to Main > Catalog > Products and select a product. In the Properties section, a Rating field appears. The populated rating data is synced from Bazaarvoice using a calculated average rating from all calculated shopper ratings entered through the storefront. The theme widgets use the Rating property as an option for faceting and filtering products on your storefront. For example, a shopper can choose to only view products with a certain rating.
SEO Import
The SEO Import tab displays a log of imports of SEO tracked data. You must enter your SEO Cloud Key on the Configuration tab to import this data. By default, Kibo imports data files from the FTP at 3:00 AM CST daily from Bazaarvoice.
To manually start a job, select the tab and click Import SEO Ratings.
Add the Theme Widgets
Shoppers interact with Bazaarvoice in your storefront through widgets you add to your product pages in Site Builder. For the widgets to appear, you must add them to your Kibo theme. Code for the widgets is available on GitHub.
Once you have added the Bazaarvoice widgets to your Kibo theme, you can view them in Site Builder:
- In Admin, go to Site Builder > Editor.
- In the site tree, go to Pages > Templates > Product.
- Switch to the Widgets view:
- Drag the Bazaarvoice Conversations Ratings widget to a dropzone on the page. A configuration screen appears:
- Select the type of widget to add:
- Summary—Displays a detailed summary of reviews. You can enter JavaScript in the Tab Code to have the summary open the Reviews or Q&A tabs on-click by shoppers.
- Customer Reviews—Displays all customer reviews and ratings entered for the product.
- Q&A—Displays questions and answers about the product.
- SEO—Tracks SEO ratings. This widget does not display content to the page. It simply captures and saves data for SEO.
- Note: You can stack multiple widget types on the page, such as Summary followed by Customer Reviews.
- Click Save to save the widget configuration.
- Click Save in the Editor to save the template changes. You can now preview the changes on your storefront.