Badges are icons and labels that call attention to certain contributors or reviews so that people viewing your site can easily identify content that may be important to them. Enable badges when you want to call attention to the following:

  • People who are affiliated with your organization
  • Top content contributors
  • Experts about a product or service
  • Reviews that were verified as written by someone who purchased the product or service
  • Reviews written by someone who received the product or service for free in exchange for a review

Additionally, you can call attention to any review on your site by adding a featured badge.

Types of badges

Conversations includes the following badge categories and types:

  • Affiliation

    Indicates the contributor has an affiliation with the product or retail organization. There is one type of affiliation badge, Staff, which indicates that the person is employed by your company.

  • Featured

    Highlights reviews to consumers reading content on your site. These badges are assigned differently than the other badges in this list.

  • Merit

    Shows the quantity and helpfulness of contributors’ content submissions. These badges are automatically calculated and applied daily.

    • Top Contributor—Indicates the top contributor of useful content.
    • Top 10 Contributor—Indicates one of the top 10 contributors of useful content.
    • Top 25 Contributor—Indicates one of the top 25 contributors of useful content.
    • Top 50 Contributor—Indicates one of the top 50 contributors of useful content.
    • Top 100 Contributor—Indicates one of the top 100 contributors of useful content.
    • Top 250 Contributor—Indicates one of the top 250 contributors of useful content.
    • Top 500 Contributor—Indicates one of the top 500 contributors of useful content.
    • Top 1000 Contributor—Indicates one of the top 1000 contributors of useful content.
  • Token-based

    Provides a way to automatically assign a badge to a contributor or review based on data that is injected into the submission form. By default, two token-based badges are provided for you, which establish the authenticity of the contributor’s review and increase consumer trust in the content of the review:

    • Verified Purchaser—Indicates that the contributor actually purchased the product and/or service from your site.
    • Incentivized Review—Indicates that the contributor received a free product or service to review. Bazaarvoice requires this badge any time a consumer writes a review in exchange for something of value. Possible incentives include entry into a sweepstakes, coupons or discounts, loyalty reward points, and free products. Refer to Identify incentivized reviews for information about syndicated incentivized reviews.
  • Response-based

    Provides a way to automatically assign a badge to a contributor or review based on the answer to a submission form question. A response-based badge indicates that the person responded in a specific way to a custom people or product question on a submission form.

  • Rank

    Indicates a specific level of expertise or experience the contributor has with your products or services. There is one type of rank badge, Expert, which indicates that the person has a high level of expertise or experience with your products or services.

  • Syndicated review

    Indicates that the review was syndicated from another source within the Bazaarvoice network. For example, a consumer might write a review of a product on the website for that product’s manufacturer. That review could then be shared with retailers that sell the product. This badge is applied automatically by Bazaarvoice and cannot be disabled.

Note: Badges associated with a user's profile, such as affiliation, rank, and top contributor, will show up on any reviews written by that user. These badges will also show up on any comments left by that user, including comments on other users' reviews.

Badge display order

The following section lists the order in which badges are displayed when a piece of content has multiple badges. A maximum of three badges can be shown on a wide display. Only one badge is shown on a narrow display.

Ratings and Reviews badge order:

  1. Incentivized review (token-based badge)
  2. Verified purchaser (token-based badge)
  3. Featured
  4. Staff (affiliation badge)
  5. Top contributor
  6. Expert (rank badge)
  7. Response-based

Enable badges

Complete the following steps to enable badges for your implementation:

Note: These instructions do not apply to the featured badge, which is automatically enabled in implementations.
  1. Contact your Bazaarvoice representative or Client Care to enable affiliation badges, top contributor badges, rank badges, and token-based badges.
  2. From the Bazaarvoice Workbench, select Settings » Manage Applications to display the Manage Versions page of the Conversations configuration hub.

  3. Edit the implementation that you want to modify.
  4. In the User Experience section of the configuration hub, select Badge Editor. A list of available badges opens in the main window.
  5. Select the badges you want to enable for your site by clicking the on/off toggle switch to the far right of each badge name.
  6. Deploy the changes to the implementation.

Configure badges

Complete the following steps to configure an enabled badge:

  1. From the Bazaarvoice Workbench, select Settings » Manage Applications to display the Manage Versions page of the Conversations configuration hub.
  2. Edit the implementation that you want to modify.
  3. In the User Experience section of the configuration hub, select Badge Editor. A list of available badges is displayed on the Badge Editor page.

    Note: If a badge is not available, contact your Bazaarvoice representative or Client Care. Affiliation, top contributor, rank, and token-based badges must be enabled.
  4. Click Edit on the far right of the badge name. The Edit Badge Details dialog box is displayed.
  5. If available, select a locale from the Currently Editing drop-down list to specify the locale for which the badge configuration will be displayed.
  6. If available, type text in the Label field, which will be used if the custom badge image is missing. This will also be used as the description if the description is missing and a custom badge has been uploaded.

    Note: You cannot customize the badge label and badge icon. If you specify a label, the default badge icon is used. If you upload a custom icon, the default badge label is used.
  7. In the Description text box, enter a brief explanation about why the badge applies to the associated contributor. This text displays when the person viewing your site hovers over the badge.
  8. To display an image with the badge, click Upload Image to add a custom image for the badge. If an image is already configured for the badge, click Edit » Upload New.

    Note: You cannot customize the badge label and badge icon. If you specify a label, the default badge icon is used. If you upload a custom icon, the default badge label is used.

    Valid image types are PNG, GIF, or JPG. Badge images must be a minimum of 50px in height (maximum of 100px) and have a minimum width-to-height ratio of 1:1 (maximum 6:1). The badge will display on the submission form at 25px high for retina display.

    By default, these images are displayed with the following badge types:

    Top contributor
    Staff (affiliation badge)
    Featured
    Incentivized review
    Expert (rank badge)
  9. Click Save Changes to save your edits.
  10. Deploy the changes to the implementation.

Add a token-based or response-based badge

By default, two token-based badges are provided—incentivized review and verified purchaser—but no response-based badges are provided. The type of badge you create depends on your needs:

  • Add a token-based badge if you want to assign a badge to a contributor or review based on data that is injected into the submission form. If the submission form question is hidden, you must create a token-based badge that passes the information through a simple submission URL (ssURL) or data injection.
  • Add a response-based badge if you want to assign a badge to a contributor or review based on the answer to a submission form question.

    Note: You cannot use a hidden submission question to apply a response-based badge to the submitted content. Instead, use a token-based badge.

For example, you may want to badge all reviews that are submitted on your website to indicate that the reviews are native and not syndicated. To achieve this, you can create a token-based badge, which are documented in detail below. Here is an overview of the steps:

  1. Create a product question on your submission form that is hidden and allows one value, such as “true.”
  2. If using hosted authentication, create an ssURL to be sent to consumers that links to the submission form. The value of the hidden question is injected into the submission form URL.

    If using site authentication, create a userToken that injects the value of the hidden question into the submission form.

  3. Create a token-based badge that is associated with the hidden question.
  4. Send the ssURL to consumers in a post-interaction email (PIE) message.

When a consumer clicks the link and fills in the form to submit a review, the injected data is captured and the review is tagged with the custom token-based badge.

Watch this short video to see the steps needed to create a response-based or token-based badge:

To create a token-based or response-based badge, complete these steps:

  1. From the Bazaarvoice Workbench, select Settings » Manage Applications to display the Manage Versions page of the Conversations configuration hub.
  2. Edit the implementation in which you want to create the badge.
  3. On the left side of the configuration hub under User Experience, click Submission Form Editor and then add or edit a submission form question whose answer or contributor can be badged. When adding or editing the badge, be aware of the following:

    Be sure to make note of the question ID, which you will use in step 6.

  4. On the left side of the configuration hub under User Experience, click Badge Editor.
  5. In the Response-based Badges or Token-based Badges section of the page, click the Add a new badge button.
  6. Provide the following details:

    • From the Question drop-down list, select the submission form question that will be associated with the new badge.
    • From the Answer drop-down list, select the answer whose contributor or review will be badged.
    • Type text in the Label field, which will be used if the custom badge image is missing. This will also be used as the description if the description is missing and a custom badge has been uploaded.

      Note: You can customize the badge label or the badge icon, but you cannot customize both. If you specify a label, the default badge icon is used. If you upload a custom icon, the default badge label is used.
    • In the Description text box, enter a brief explanation about why the badge applies to the associated contributor. This text displays when the person viewing your site hovers over the badge.
    • Click Upload Image to add a custom image for the badge. Valid image types are PNG, GIF, or JPG. Badge images must be a minimum of 50px in height (maximum of 100px) and have a minimum width-to-height ratio of 1:1 (maximum 6:1). The badge will display on the submission form at 25px high for retina display.

    Click Save Changes to save your edits.

  7. If using hosted authentication, construct a simple submission URL (ssURL) that includes the bvinjecteddata parameter. This ssURL will inject data into the submission form and trigger badging. Here is an example of an ssURL that includes the “NativeReview” question ID and the “true” answer value:

    https://display.ugc.bazaarvoice.com/static/Apples/en_US/container.htm?bvaction=rr_submit_review&bvproductId=GS-1234&bvcampaignId=GranniesReview&bvinjecteddata=%7b%22NativeReview%22%3a%22true%22%7d
    

    If using site authentication, construct a UAS token that include a custom key that specifies the question and answer IDs and then include the UAS token in the userToken property. Refer to the UAS steps in Site authentication for details. Here is an example of an unhashed and unencoded UAS token that includes the “NativeReview” question ID and “true” answer value:

    date=20161225&userid=shopper123&NativeReview=true
    
  8. Deploy the changes to the implementation.

Assign a badge to a contributor or review

The method of assigning badges varies depending on the type of badge. The following sections provide information about assigning the various badges and explain how to assign a badge to more than one contributor or review at a time.

Tip: Before beginning, be sure to enable badges.

Affiliation and rank badges

You can manually assign these badges to specific contributors by modifying a contributor’s role designation:

  1. From the Workbench, select Settings » Modify Contributor Roles under the Contributor Settings section.
  2. Search for the contributor you want to assign a badge by either entering the beginning of their user ID or display name (nickname) or by searching for them by their current contributor role status.
  3. From the table, select the contributor to whom you want to assign a badge. A list opens showing the user ID, display name, and badge statuses.
  4. Select whether the contributor is a staff member, expert, or eligible for one of the top contributor badges.
  5. Click Save. The table that lists all of the contributors and their roles is updated.

Complete the following steps to assign a featured badge to a review:

  1. From the Workbench, select Content » Ratings & Reviews under the Content Dashboards section.
  2. Click the calendar icon to the right of the Date filter. Select a predefined range from the drop-down menu or enter a custom range of dates. You can further refine the search using the Product, Content, and Moderation filter categories, all located beneath the Date filter. Hover over the category and select a filter from the drop-down menu. Each filter includes additional options to narrow the search parameters.
  3. Click Show Reviews.
  4. Hover over the review you want to feature and click Show Details.
  5. In the pop-up dialog box, set Featured to Yes.
  6. Click Save.

The review is displayed with the featured badge, as shown in the following image.

Response-based and token-based badges

For custom response-based and token-based badges, the badges are automatically assigned to contributors or reviews based on the answer that is chosen when the badge is created.

Verified purchaser badges are assigned in two ways:

Incentivized review badges are assigned to reviews in two ways:

You do not need to perform additional steps to assign verified purchaser or incentivized review badges.

Top contributor badges

Top contributor badges are automatically assigned to contributors based on qualifications that Bazaarvoice has defined for that specific badge. The winners of these badges are calculated nightly. You do not need to perform additional steps to assign top contributor badges.

Assign badges to multiple users

Complete the following steps to assign staff (affiliation), expert (rank), or merit badges for more than one contributor at a time:

  1. From the Workbench, select Settings » Assign Contributor Roles in the Contributor Settings section.
  2. In the User IDs text box, enter the user IDs of contributors to which you want to assign badges.
  3. From the drop-down lists below the text box, choose the badge(s) to assign to the users:
    • Select Staff from the Assign User IDs to the following staff status drop-down list to assign the staff badge to the users.
    • Select Expert from the Assign User IDs to the following expert status drop-down list to assign the expert badge to the users.
    • Select Eligible from the Merit Badge Eligibility drop-down list to enable the system to assign the merit (top contributor) badges to the users.
  4. Click Preview. A page is displayed that shows your changes.
  5. Click Assign. The badge eligibility is applied to the contributors. If a user ID you entered in step 2 is not in the Bazaarvoice database, that user ID is added to the database.

Identify incentivized reviews

If a consumer receives an incentive and then submits a review, that review is called an incentivized review. An incentive might include a free or discounted product or service, an entry into a sweepstakes, and loyalty reward points.

You must inform consumers when reviews are incentivized. Online shoppers expect this level of transparency, and disclosing incentivized reviews helps build trust between consumers and your company. In addition, Bazaarvoice is committed to content authenticity. We believe consumers have a right to trust the reviews they read, and that businesses have a responsibility to ensure that reviews they present about their products and services are legitimate. Refer to the Bazaarvoice Authenticity Policy for more information about content authenticity guidelines.

How does it work?

You can identify incentivized reviews on your website with badges. A badge is an icon that is displayed next to the review if incentivized review badges are enabled on your site. The following example shows an incentivized review badge:

Incentivized review badges are assigned to reviews in two ways:

For syndicated reviews, the reviews do not include the incentivized review badge. Instead, Bazaarvoice appends the following text to each syndicated review:

[This review was collected as part of a promotion.]

Configure incentivized review badges

To configure an implementation to assign incentivized review badges to reviews, complete these steps:

  1. From the Bazaarvoice Workbench, select Settings » Manage Applications to display the Manage Versions page of the Conversations configuration hub.
  2. Edit the implementation where you want to use incentivized review badges. If you are using a single deployment zone, click Edit next to the implementation file on the Site Manager page. If you have multiple deployment zones, determine which implementation to edit by examining the URL that is referenced on your website:
    1. Locate the container page on your site.
    2. View the page source and locate this element:

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

      The URL maps to the implementation that you need to modify. Replace <client_name>, <site_ID>, and __ with your values, and remove **bvstaging/** if the URL points to a production environment.

    3. In the configuration hub, select the implementation for the identified deployment zone (site ID).
  3. Enable the incentivized review badge, which is a type of token-based badge:
    1. In the configuration hub, click Badge Editor on the left side of the page under User Experience.
    2. In the Token-based Badges section of the page, click the Incentivized Review toggle switch to enable the badges.
    3. If you want to add hover text to the badge, or if you want to display custom artwork for the icon, click Edit next to Incentivized Review and edit the badge details.
  4. Enable Bazaarvoice to match incentivized review badges to reviews submitted by contributors who received free products or services:
    1. In the configuration hub, click Submission Form Editor on the left side of the page under User Experience.
    2. Click at the top of the editor and select the product category or subcategory of the submission form you want to modify. Your product feed generates the list of categories. The editor automatically displays the All Products submission form. If you add, edit, or delete questions in the All Products submission form, the editor applies those changes to all linked forms.
    3. In the Product section of the page, click the New Question button and then click Add This Question next to Received free product on the Add a New Product Question form. The “Received free product” question is the default question that is configured with the IncentivizedReview question ID.

      Note: If the "Received free product" question is not available in the list of default questions, the question is already defined for the implementation. You cannot add a custom question for incentivized content because the "Received free product" question already uses the appropriate question ID.

      It is also important to remember that the "Received free product" question should be added as a product question and not a people question.

    4. If you are using a site-wide campaign to collect incentivized reviews, such as a sweepstakes, it is recommended that you indicate this in the question’s text. Edit the question you added in step c and modify the text in the Display Label field to indicate that the reviewer is opting into a campaign. For example, you could type this text: ”I would like to be entered into the sweepstakes.”
    5. If you are collecting incentivized reviews only through an email campaign, you might want to hide the question on the submission form. Click the Hide on submission option in the Global Question Settings section of the page.
    6. Click Save Changes.
  5. If you are using a simple submission URL (ssURL) to request reviews through an email campaign, make sure the ssURL includes the bvinjecteddata and IncentivizedReview parameters. Refer to the Incentivized reviews example in Simple submission URLs for more information.
  6. Deploy the changes to the implementation.