The configuration hub provides access to essential settings for getting started with Conversations. Using the configuration hub, you configure a product feed for your catalogs, integrate Bazaarvoice functionality onto your site, customize the look and feel of your consumer-generated content (CGC), submission forms, and email templates, and enable your site to benefit from SEO attributable to CGC. Watch the following video for a brief overview of the configuration hub:

If you are using the configuration hub for the first time…

You may be most interested in the following sections of this topic:

If you are completing the initial technical setup…

You may be most interested in the following sections of this topic:

If you are customizing the display of reviews, questions, or email messages…

You may be most interested in the following sections of this topic:

If you are verifying your setup before your site goes live…

You may be most interested in the following sections of this topic:

Log in to the configuration hub

You access the configuration hub through Bazaarvoice Workbench as shown in this video:

To log in to the configuration hub:

  1. Log in to Workbench.
  2. Select Settings » Manage Applications.

The Site Manager is displayed and lists the available deployment zones and implementations:

Site Manager screenshot

Implementations define how Bazaarvoice features display on your site, and deployment zones define which sites or pages the implementations apply to. To access the configuration hub for an implementation, click the Edit button next to the implementation. The configuration hub landing page is displayed.

To learn about the options available in the configuration hub, refer to the following sections of this topic:

Implementations

Before you can integrate Bazaarvoice content into your company’s website and start collecting consumer-generated content (CGC), you must set up your staging and production environments. The configuration hub helps you customize the features and design elements used to collect and display content.

An implementation defines the features, visual styles, and display options for displaying CGC on your site. In the configuration hub, you create and edit implementations that you can publish to staging and production environments through one or more deployment zones. By default, the primary implementation is called Main Implementation, but you can name implementations anything appropriate. By creating multiple implementations, you can vary the look and feel of your CGC across deployment zones (for example, for different brand sites, or whenever you redesign parts of your site for specific categories or promotions).

You manage and deploy your implementations on the Site Manager page of the configuration hub, as shown in the following example:

Site Manager page

Create and edit an implementation

To create an implementation, you must copy and modify an existing implementation as shown in this video.

Complete the following steps to create and edit an implementation:

  1. From the Bazaarvoice Workbench, select Settings » Manage Applications to display the Site Manager page of the configuration hub.
  2. Scroll down to the Implementations list.
  3. Click the Tools » Copy implementation button to the right of the list heading. The Copy Implementation pop-up window appears.
  4. Select the implementation you want to copy.
  5. Enter a name for the implementation.
  6. Click Copy.The new implementation appears in the Implementations list.
  7. Click the Edit button next to the implementation cell to customize the new implementation. You can click the home icon in the upper left corner of any configuration hub page to return to the Site Manager page.
  8. After you finish editing the implementation, you can add it to a deployment zone.

Publish an implementation to production

When you publish an implementation, you move the implementation from staging to production. This makes the changes to the implementation “live” in production.

Complete the following steps to publish an implementation:

  1. From the Site Manager page of the configuration hub, find the deployment zone with the implementations you want to publish.
  2. Click the green arrow button between the staging and production sections of the deployment zone. This publishes the implementation currently in staging to the production environment.

To publish an implementation to a secondary deployment zone, you must edit the bvapi.js script tag on every page where you want to exhibit the alternate display to include the deployment zone in the URL path. Use the following code example, substituting your values for <client_name>, <site_ID>, and <locale>:

<script type="text/javascript" src="https://display.ugc.bazaarvoice.com/bvstaging/static/<client_name>/<site_ID>/<locale>/bvapi.js"></script>

Delete an implementation

Complete the following steps to delete an implementation:

  1. From the Site Manager page of the configuration hub, scroll to the Deployment Zones list.
  2. For each deployment zone, check the installed implementation name to ensure that the implementation you intend to delete is not currently installed to a production environment.
  3. Scroll to the Implementations list.
  4. Click the Tools button next to the implementation you want to delete. From the drop-down menu, select Delete.The Delete Implementation pop-up window appears to confirm the deletion.
  5. Click OK. The implementation will no longer appear in the Implementations list.
Note: If you delete a deployment zone where an implementation is deployed, the implementation is automatically uninstalled from that deployment zone, but is not deleted.

If you need to restore the deleted implementation, contact Bazaarvoice Client Care .

Deployment zones

Use deployment zones to publish your implementations to staging and production environments. By default, the configuration hub includes one deployment zone called Main Site.

Publishing an implementation to a single deployment zone is common and gives the Bazaarvoice content on your website a uniform design. However, you might want to use more than one deployment zone in the following scenarios:

  • You offer multiple brands
    You can create a deployment zone for each of your brands so that you can tailor the look and feel of the hosted display, as well as email messages that are generated by transactions completed on brand sites. Use a deployment zone for each brand to ensure that all outbound communication adheres to brand, style, copy, or campaign guidelines. In each deployment zone, you must configure Post-Interaction Email (PIE) settings and disable template inheritance so that email templates can be customized for each the deployment zone.
  • You want to send PIE messages for in-store purchases
    You can create different deployment zones that leverage different PIE strategies: one for in-store purchases that are captured in PIE feeds and one for online purchases that are captured by BV Pixel transactions. You must configure PIE settings in each deployment zone, and then you can disable template inheritance so that email templates can be customized for each deployment zone.
  • You want different styles on product pages according to the product category or subject
    For example, a retail company that sells children’s merchandise online uses yellow as the dominant color on product display pages (PDPs) for toys and furniture. The color of rating stars on these pages is yellow, as defined in the Main Site deployment zone. However, the site uses pink as the dominant color on PDPs that display girls’ clothes and blue on PDPs that display boys’ clothes. By creating two additional deployment zones, the site is able to display pink rating stars on the girls’ clothing pages and blue rating stars on the boys’ clothing pages.

  • You need to support different locales
    If you have websites in multiple countries or multiple languages and want a unique design for each one, you must implement multiple deployment zones. Each deployment zone would include a different implementation with customized, localized settings.

  • You have different page types and would like to capture content specific to each
    For example, a travel company wants to capture CGC about hotels and destinations on its site. By creating an additional deployment zone, the site can display different styles on each page and also customize the text to display on submission forms. The travel site can now include the text “How would you rate this hotel?” on its hotel pages, and “How would you rate this destination?” on its destination pages.
  • You want to collect reviews for past purchases
    You can use different deployment zones to configure PIE settings and email templates: one for past purchases that use a historical PIE feed and one for current purchases that use BV Pixel. In each deployment zone, you must configure PIE settings and disable template inheritance so that email templates can be customized for each the deployment zone.

Add deployment zones

If you add deployment zones, you must maintain each implementation in each deployment zone separately. When you enable a new Bazaarvoice feature, you must enable it in the implementation deployed to the Main Site deployment zone and in implementations deployed to additional deployment zones.

Complete the following steps to create and implement a deployment zone:

  1. From the Bazaarvoice Workbench, select Settings » Manage Applications to display the Site Manager page of the configuration hub.
  2. Click Add Deployment Zone in the top right corner to display the New Deployment Zone dialog.
  3. Enter a name for the new deployment zone. Bazaarvoice recommends that you use a descriptive but simple name with no spaces or special characters.
  4. Click Create. The new deployment zone appears on your Site Manager page.
  5. Publish implementations to the staging and production environments of the new deployment zone.
  6. If necessary, update your existing BV Pixel and PIE feed implementations to reference the new deployment zone.

Deploy an implementation to a deployment zone

Complete the following steps to publish an implementation to the staging or production environment of a deployment zone:

  1. From the Site Manager page of the configuration hub, scroll down to the Implementations list.
  2. Click the Deploy button next to the implementation you want to include. The Deploy Implementation pop-up window is displayed.
  3. Select the following options:

    • Deployment zone—Deployment zone you want to associate with the implementation, such as Main Site
    • Environment—The staging or production environment

      Tip: Bazaarvoice recommends that you deploy an implementation to staging so that you can review it before you deploy to production.

    Then, click Next.

  4. Verify changes that were made to the implementation since it was last deployed to the selected deployment zone and environment. Then, click Next.
  5. If the implementation passed validation, click Deploy to deploy it to the deployment zone and environment.

    If the implementation failed validation, a list of validation errors is displayed. For example, a missing or invalid host name will fail validation. Bazaarvoice recommends that you make note of the errors, click Cancel, and fix the issues before attempting to deploy the implementation again.

Watch this short video to see how to deploy an implementation to Staging and publish the implementation to Production:

Delete deployment zones

Complete the following steps to delete a deployment zone:

  1. Click the gear icon to the right of the deployment zone name. From the drop-down menu, select Delete.
  2. In the confirmation pop-up window, click OK to delete the deployment zone and uninstall its implementations.
Note: You cannot delete the Main Site deployment zone.

Technical setup

To enable Bazaarvoice functionality on your site, you must first complete a series of technical tasks. These tasks include configuring a product feed, adding enablement code to your site, and installing BV Pixel and BVSEO. The usual order for the required steps is as follows:

  1. Configure a product feed.

  2. Create a container page.
  3. Add enablement code to your site.
  4. Add BV Pixel to your site.

  5. Configure email templates.
  6. Enable Post-Interaction Email (PIE).

In general, your implementation team helps you complete these tasks (as well as other recommended tasks listed in this topic, such as tasks related to user experience and SEO) before your go-live date, but you can refer to these topics for more information about the process.

Within the configuration hub, the Technical Setup section in the left navigation menu contains the list of technical tasks you must complete before go-live. The tasks are organized within tabs, of which you can learn more about below.

Site Profile

The Site Profile tab contains settings that establish essential links between your site and Bazaarvoice. Your implementation team specifies most of these settings for you, but you can specify a few yourself, including your company display name and homepage URL. Refer to the following table for details about the settings on this tab:

Name Description
Company Display Name Your company name as it displays in account websites, forms, emails, and other Bazaarvoice tools.
Home Page URL The landing page for your company's retail or brand site.
Shared Encoding Key The secret key used to encrypt user information. Your implementation team provides this key.
Test Product ID A product ID for testing prior to go-live. Your implementation team helps you identify a suitable product.
API Host Name The Bazaarvoice API host that your site and applications connect to. Your implementation team provides this information.
Legacy Host Name The Bazaarvoice API host that your legacy applications connect to, if you have any. Your implementation team provides this information.
Container URL

The URL of the container page for submission forms (like a Ratings and Reviews form) to use on your production deployment.

To learn about container pages, refer to the Container page topic.

Staging Container URL

The URL of the container page for submission forms (like a Ratings and Reviews form) to use on your staging (testing) deployment.

To learn about container pages, refer to the Container page topic.

Product Feeds

The Product Feeds tab allows you to upload XML documents that match your products with related CGC in the Bazaarvoice network. This is an essential step that you must complete prior to go-live. Refer to the Product catalog topic to learn how to configure your product feed.

Display Integration

The Display Integration tab describes the process that your implementation team completes to integrate enablement code into your site. The enablement code configures your site to communicate with Bazaarvoice and is essential for gathering and displaying CGC. You must add the code to every page that will display Bazaarvoice content. To learn about the process for integrating this code, refer to the Display integration topic.

You can choose to display inline ratings on your category pages so that consumers can see the average rating and number of reviews for a product before opening the product display page. Enabling inline ratings also involves adding code to pages on your site. To learn about inline ratings, refer to the Inline ratings topic

BV Pixel

The BV Pixel tab introduces you to BV Pixel, which is an analytics beacon capable of providing a great deal of value to your business. BV Pixel captures transactional and non-transactional events, such as product purchases and newsletter signups, respectively, that occur on your site when consumers interact with Bazaarvoice content. With BV Pixel, you can gather valuable insights into your CGC program and discover key information about the impact of Bazaarvoice content on your business.

Like enablement code, you must integrate BV Pixel by adding code to every page where you intend to collect and track events. Your implementation team assists you with this process, but you can refer to the BV Pixel topic for detailed information.

SEO Integration

The SEO Integration tab describes how the JavaScript used to display CGC on your website is invisible to search engines like Google and Bing. By integrating the Bazaarvoice server-side solution (BVSEO) into your site alongside the client-side JavaScript integration (provided by default with the Bazaarvoice hosted solution), you can capitalize on the SEO potential of your CGC and drive organic search traffic to your site.

Your implementation team guides you through the process of maximizing SEO with the available Bazaarvoice solutions, but you can refer to the BVSEO topic for a detailed description of the process.

Mobile SDK

The Mobile SDK tab provides links for downloading and installing device fingerprinting libraries on applications built using the Mobile SDK. These authenticity measures allow you to increase conversion on mobile apps while ensuring consumers trust the CGC displayed on the apps as much as they do the content on your main site.

The Mobile SDK tab includes learning resources specific to integrating device fingerprinting in the available SDKs. To learn more about the SDKs themselves, refer to the Mobile SDK topic.

User experience

You can customize how Bazaarvoice content is displayed on your site, from the colors and styles of the web elements that contain your CGC to the exact text your consumers see when interacting with CGC. You can customize the submission forms that contributors use to submit content and the badges available on your website to differentiate your contributors from one another. Making good design choices when implementing these customizations is important for ensuring that consumers on your site have a consistent and pleasurable user experience.

Within the configuration hub, the User Experience section contains the list of customizations you can complete for your implementation. The customizations are organized within tabs, of which you can learn more about below.

Style Detector

The Style Detector page enables you to pull fonts, styles, and colors from your website and apply them to your Bazaarvoice implementation. This saves you time when trying to match the style of Bazaarvoice content to the style of your site. To learn how to use the Style Detector, refer to the Style the display section.

Style Editor

The Style Editor page enables you to customize style details related to Bazaarvoice display elements and preview how they look on your site. For example, you can customize fonts, icons, backgrounds, margins, colors, and more. To learn about customizing these details, refer to the Customize display details section.

Display Options

The Display Options page lets you customize a variety of options for your CGC, such as the icons consumers see next to CGC, whether a review requires a title and what minimum length that title must be, and what terms and conditions display along CGC, among other options. To learn about these options, refer to the Hosted display configuration topic.

Submission Form Editor

The Submission Form Editor page allows you to customize the submission form that consumers use to submit reviews. A well-designed submission form that is simple and easy to complete maximizes the number of contributions on your site and minimizes abandonment. Maximizing the number of contributions is important because consumers have more confidence in a product’s ratings and reviews when the product has a large volume of reviews. To learn how to effectively configure your submission forms, refer to the Submission forms topic.

Copy Editor

The Copy Editor page lets you customize the text and labels that display alongside Bazaarvoice content on your site. Examples include the labels for sorting CGC, such as “Most helpful answers” or “Most relevant”, and the labels for buttons, such as the View Comments button. To learn about the Copy Editor, refer to the Customize labels and text section.

Badge Editor

The Badge Editor page allows you to configure badges for your implementation. Badges visually differentiate content from certain contributors, such as top content contributors, product experts, verified purchasers, and more, allowing consumers to easily find information that will convince them to complete a transaction. Using the Badge Editor tab, you can enable badges, customize how they display, and assign badges to specific contributors. To learn about the Badge Editor, refer to the Badges and incentivized reviews topic.

Seller Ratings Display

The Seller Ratings Display page enables you to enable the Seller Ratings display module. Then, you can insert the display module on your company’s home page, which shows four- and five-star reviews that rate your company. Refer to Seller Ratings to learn more about this feature and its accompanying Post-Interaction Email feature.

Settings

After completing setup tasks and customizing the user experience for Bazaarvoice content, you should configure settings related to user authentication, email messages, SEO, and specific features or integrations.

Within the configuration hub, the Settings section contains the list of settings to configure. The settings are organized within tabs, of which you can learn more about below:

User Authentication

The User Authentication page provides settings for verifying a user’s identity, thus ensuring that legitimate users create content on your site. The main authentication options are hosted authentication and site authentication. To learn about these options, refer to the User authentication topic.

Email Configuration

The Email Configuration page provides settings for submission form links, notifications, Post-Interaction Email (PIE), and Seller Ratings PIE.

  • On the General tab under the Email Submission Links section, you can select whether to enable or disable product pages for submission. When enabled, the system redirects email submission links to the product page and automatically loads the submission form. When disabled, the submission form appears on a blank page before redirecting to the product page.
  • On the General tab under the Notifications section, you can enable email messages that inform users about the status of their reviews, questions, answers, and comments. These updates tell users their content has been accepted or rejected, or they request users authenticate before publishing information.
  • On the PIE & Seller Ratings PIE tab under the Email Sending Times section, you can specify a time of day when Bazaarvoice will begin to send PIE and Seller Ratings PIE messages. Refer to the Post-Interaction Email (PIE) topic to learn about PIE, and refer to Seller Ratings to learn about Seller Ratings PIE and display.
  • On the PIE & Seller Ratings PIE tab under the Post-interaction Email (PIE) section, you can configure options for PIE. These email messages invite your customers to leave reviews for online and offline purchases and service interactions. PIE is essential to driving review volume, and it adds significant product coverage, content freshness, and search engine optimization (SEO) value.

  • On the PIE & Seller Ratings PIE tab under the Seller Ratings PIE section, you can enable Post-Interaction Email so that you can collect ratings and reviews about your company from consumers who purchase your products.

Email Templates

The Email Templates page lets you brand and customize the email messages sent to your customers. You can customize the standard templates provided by Bazaarvoice or create entirely custom templates. To learn about email templates, refer to the Email templates topic.

SEO

The SEO page provides settings for Bazaarvoice’s server-side SEO solution (BVSEO), which integrates into the top-level domain of your website and provides better results and support for search engines other than Google. To learn about the SEO options on this tab, refer to the Configure SEO options section of the SEO topic.

Web Analytics

The Web Analytics page lets you enable and disable third-party analytics integrations, such as Adobe Analytics and Google Analytics. To learn about available analytics integrations, refer to the Analyze data topic.

Ask a Product Owner

The Ask a Product Owner page enables you to ask consumers who bought a product to answer questions from other consumers shopping the product. When a new question is published to a product page, Bazaarvoice sends an email requesting answers from a group of verified purchasers. To learn how to configure this feature, refer to the Enable and configure Ask a Product Owner section.

Spotlights

The Spotlights page enables you to configure how Spotlights are displayed on your pages. You can configure what products are included in the Spotlights display module, how many products are displayed, and advanced settings such as randomization and encoding options. Refer to the Spotlights topic for details.

Resources

The Resources section in the configuration hub contains useful tools and links for using your Bazaarvoice products. Run through the checklist before and after your launch, and bookmark the help and support links for future reference.

Launch Prep

This page contains pre-launch checklists, best practices for setting up content moderation, and training resources for using Bazaarvoice Workbench.

Post-Launch Checklist

This page provides a checklist for verifying your implementation after go-live.

This page provides several useful online resources, including links to the knowledge base, the support portal, white papers, case studies, and more.