The configuration hub provides access to essential settings for getting started with Brand Edge. 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 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.

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 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 BVSEO. The usual order for the required steps is as follows:

  1. Configure a product feed.

  2. Configure email templates.
  3. 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.

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.

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.

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:

Email Configuration

The Email Configuration page provides settings for submission form links, notifications, and Post-Interaction Email (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 messages. Refer to the Post-Interaction Email (PIE) topic to learn about PIE.
  • 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.

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.

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.