This guide walks you through integrating Bazaarvoice into a Brij Experience. Once enabled, any review submitted through your Brij Review Module will be sent to Bazaarvoice for syndication.
What this integration does
When a customer submits a review in your Brij Experience (using Brij’s Review Module), Brij triggers a webhook event (Review Submission) and forwards the review data to Bazaarvoice using your brand-specific Bazaarvoice credentials.
Before you start (read this first)
Most setup issues happen because of one of these items. Skim this section before building anything.
Integration requirements & limitations
- Use Brij’s existing Review Module. You can’t add or remove steps, and you can’t change their order. You can edit the visible wording/labels (example: “Submit your review” → “Tell us what you think!”).
- Video uploads are not supported in this integration (photos only).
- Registration must happen before review submission and an email address is required.
Review validation rules (important)
- Under 50 characters = ratings-only. If the review text is under 50 characters, Bazaarvoice will treat it as a ratings-only submission and the text will be discarded.
- Review title must be 1–255 characters.
- Name privacy: If a user enters their full name, the review will be anonymized. We recommend prompting for first name + last initial (e.g., “Maria S.”).
- Name length must be at least 4 characters.
Bazaarvoice eligibility (required)
- The customer must have signed the “Bazaarvoice Brand Client Partner Consent Form for Shared Clients.”
- After it’s signed, Bazaarvoice will send Brij the brand-specific API key needed for the integration.
Requirements
1) You must be a Bazaarvoice customer
This integration is intended for customers who already use Bazaarvoice. There’s no specific Bazaarvoice account tier required to use it.
2) Your Brij Experience must use the Brij Review Module
Your Experience must include a Review Module, recognizable by the thumbs-up + stars icon.
The Review Module can be placed either:
- In the Modules section (with Registration Required), or
- Directly inside a Registration Form / Survey
3) Keep the default 5 steps (same order)
The Review Module must keep the default 5 steps in the same order Brij provides. Think of this as “the structure stays the same.”
What you can change:
- The wording/labels on each step (example: “Submit your review” → “Tell us what you think!”)
- Whether the photo upload step is required or optional (photos only; video isn’t supported)
What you cannot change:
- Removing steps
- Adding extra steps
- Reordering the five default steps
4) Make sure your Experience has the right Bazaarvoice ProductId
Bazaarvoice attaches reviews to products using a ProductId. In Brij, this value lives in Experience details → Product, Style, or SKU Number.
Rule: the value you enter in Brij must match the Bazaarvoice ProductId in the Bazaarvoice product catalog exactly (same spelling, same capitalization, same format).
How to find the ProductId on your site (quick check)
The fastest way to confirm the ProductId is to look at a product page where Bazaarvoice reviews should show, then find the ProductId in the page’s HTML.
- Open a product page (PDP) in your browser where Bazaarvoice reviews should appear.
- Open the HTML:
- Chrome / Edge: right-click → View page source (or Inspect)
- Safari: enable Developer tools, then Show Page Source or Inspect Element
- Search for
data-bv-product-id(useCtrl + F/Cmd + F). - Copy the value you find (example:
data-bv-product-id="12345-ABC"), then paste that exact value into: Experience details → Product, Style, or SKU Number.
Tip: If reviews aren’t showing later, this ProductId mismatch is the #1 thing to re-check.
What you need before you start
Have the following ready:
- A Brij Experience that contains the Review Module
- Your brand-specific Bazaarvoice API key (get this from your Bazaarvoice rep)
- The Brij-provided webhook URL (get this from your Brij rep)
- Your Bazaarvoice Encoding key (provided by Bazaarvoice)
Setup steps in Brij
Step 1 - Publish the Experience
Publish the Experience that contains your Review Module. Make sure:
- The Review Module still has the default 5 steps in the same order
- Review submission happens after registration (email required)
- Your Product, Style, or SKU Number matches the correct Bazaarvoice ProductId
Step 2 - Create an Automation (Webhook)
In Brij:
- Go to Automations
- Click Create a New Automation
- Choose Webhook
- Name it something like:
Bazaarvoice Integration(any name is fine)
Step 3 - Create Authentication (External)
When configuring the webhook, you’ll create an authentication that points to Brij’s webhook URL.
- Click Create a New Authentication
- Set it as External
- Paste the webhook URL provided by Brij
- Name it something like:
Bazaarvoice Webhook(any name is fine)
Step 4 - Select the Experience + Event
Now you’ll tell the automation which Experience to listen to, and which event should trigger the webhook.
- In Filters, choose the Experience that contains the Review Module
- On the Triggers & Properties step, unselect all events
- Select only: Review Submission
- Ensure all available data points for the event are included in the trigger (as available in the UI)
Step 5 - Configure delivery settings
This is where you tell Brij which Bazaarvoice credentials to use.
- Leave HMAC signing key blank (it’s not used here)
- Set Web Connector Type to Internal
- Fill in the HTTP Body (below)
HTTP Body (copy/paste)
Paste the template below, then replace the placeholders with your own values.
{"BVAPIKEY":"<YOUR_BV_API_KEY>","BVENCODKEY":"<YOUR_BV_ENCODING_KEY>"}
Double-check you didn’t leave any placeholder text behind.
Step 6 - Save + Activate
Click Save, then Activate. After activation, new reviews will start sending to Bazaarvoice.
What to expect after activation
- Any review submitted via the selected Experience’s Review Module will be sent to Bazaarvoice.
- Bazaarvoice will syndicate the reviews to the retailer platforms you're subscribed to.
- Inside the Bazaarvoice platform, you can tell which reviews came from Brij by checking the review’s source.
Troubleshooting (quick fixes)
- Reviews aren’t showing on PDPs: re-check the ProductId in Brij matches the site’s
data-bv-product-idand the Bazaarvoice catalog exactly. - Review text is missing: the review text may be under 50 characters (ratings-only rule).
- Reviews are anonymized: users may be entering full names.
- Nothing is being delivered: confirm the HTTP body contains valid
BVAPIKEYandBVENCODKEYvalues for the brand/site.