Host MPS form on custom domains

Hosting the Multi-Product Submission (MPS) form on your custom domain allows you to embed the review process directly on your website. This ensures that consumers remain on your domain throughout the review process instead of being redirected to a Bazaarvoice-hosted page. Moving the submission process to your domain addresses several common consumer concerns and technical requirements:

• Reinforced brand trust: Consumers can submit feedback directly on your official website, thereby removing the hesitancy caused by unfamiliar domain redirects.
• Enhanced data privacy: By keeping the review process on your domain, you eliminate confusion regarding how personal data is shared with Bazaarvoice, satisfying compliance and privacy standards.
• Preserved analytics: Because the form is hosted on your domain, your internal tracking and analytics tools can monitor the consumer activity without losing data during a redirect.

Follow this guide to configure your site for client-hosted MPS.

• Host MPS form on your domain
• How MPS hosting works
• Implementation checklist
• FAQ

Before you begin

Before you begin, ensure you have completed the following in your configuration:

1. Set Enable Multi-Product Submission on Custom Domain to ON.
2. Enter your valid MPS host URL (Production) and MPS staging host URL.
3. Select either Popup (modal window) or Inline (embedded directly into your page layout).

Host MPS form on your domain

1. Create an MPS Page

   Create a page on your website to host the form. We recommend creating separate pages for staging and production.

   Example URLs:

   • Staging: https://staging.yourdomain.com/reviews/submit
   • Production: https://www.yourdomain.com/reviews/submit

2. Add BV loader

3. Add MPS container element

Bazaarvoice provides two display modes for client-hosted MPS.

Popup mode: The MPS form opens in a modal window. A shaded background appears behind the modal to keep the focus on the form. Your page content remains visible but is disabled until the consumer closes the modal.

Inline mode: The form embeds directly into a specific section on your page.

• Desktop (>768px): A shaded background appears behind the form for visual separation.
• Mobile and Tablet: The form displays full-width without a backdrop.

Note: Contact Bazaarvoice Support  to configure your preferred mode.

Implementation:

Insert the following HTML element where you want the form to appear:

Copy Code HTML

<div data-bv-show="multi_submission"></div>

• For Popup mode: Place this div anywhere on the page to trigger the form.
• For Inline mode: Place this div in the specific section where you want the form to appear within your layout.

Note: Do not apply custom styles, padding, or margins directly to this div. Bazaarvoice manages all layout and styling within the container.

4. Update Content Security Policy

   Update the Content Security Policy (CSP) rules to access Bazaarvoice domains. You can configure CSP by adding tags to your HTML page.

   Directive name	Directive Source
   script-src	apps.bazaarvoice.com*.bazaarvoice.com
   style-src	*.bazaarvoice.com
   img-src	*.bazaarvoice.com
   connect-src	*.bazaarvoice.com
   frame-src	*.bazaarvoice.com (Add if you use iframes for submission)

If you have enabled cookie consent for your Bazaarvoice integration, also add cdn.cookielaw.org to your script-src. To learn more about CSP guidelines, refer to CSP Support for V2 Applications.

5. Handle post-submission events (Optional)

When consumers close the form, Bazaarvoice triggers an mpsClose event. You can use this event to trigger custom actions on your site, such as automatically redirecting the consumer to a Thank You page or displaying a custom message after they complete the review.

window.bvCallback = function (BV) {
  BV.swat_submission.on('mpsClose', function (data) {
    console.log('Form closed', data);
    // data.completed: true if all products were reviewed
    // data.productsSubmitted: number of products reviewed

    if (data.completed) {
      window.location.href = '/thank-you';
    }
  });
};

How MPS hosting works

• Automatic redirects: If an existing Review Request Email points to a Bazaarvoice-hosted URL, we automatically redirect the consumer to your new custom domain page while preserving all URL parameters.

• Analytics: Because the form lives on your domain, your analytics tools (Google Analytics or Adobe Analytics) will automatically track the session without losing tracking parameters.

• Cookie consent: If you've enabled cookie consent for your Bazaarvoice integration, the banner behavior automatically adapts to your domain. Because the MPS form is now hosted on your website, cookies and local storage operate in a first-party context.

• Accessibility:

  • Popup mode: Keyboard focus is restricted within the form until it is closed. The Escape key closes the form.

  • Inline mode: The form handles navigation and keyboard focus automatically. If a consumer opens a sub-modal within the form (such as Terms & Conditions), focus is restricted to that modal until it is closed. Once the sub-modal is closed, focus returns to the main form.

Implementation checklist

FAQ: MPS hosting on custom domains