Skip to main content
All CollectionsIntegrating our serviceSet up
Shopper Approved Seller Review Integration Overview
Shopper Approved Seller Review Integration Overview

Here is a detailed step-by-step overview for the integration of Merchant reviews.

Ryley Freideman avatar
Written by Ryley Freideman
Updated over a week ago

Shopper Approved Seller Review Integration

Step 1 - Add the seller survey code to your order confirmation page

To begin collecting seller reviews, you will place a code snippet onto your order confirmation page. This code snippet is what populates the checkout (initial) survey after a customer checks out so they can leave a seller review.

You can find the code snippet in your Shopper Approved account within the top left navigation under Setup > Seller Ratings > “Copy and paste Initial Survey code on your ‘Thank You’ page” section (3rd section down).

Here is an example code for your reference.

Note: Please do not use this code snippet as is. You will need to replace the variables such as siteID and token.

<script type="text/javascript"> var sa_values = { "site":siteID, "token":"token" }; function saLoadScript(src) { var js = window.document.createElement("script"); js.src = src; js.type = "text/javascript"; document.getElementsByTagName("head")[0].appendChild(js); } saLoadScript("") </script>

The site and token variables are unique to your account. You will notice that they are prefilled for you within your dashboard code snippet. If you want to verify, you can check under your Account Settings by clicking on your name in the upper right-hand corner under Settings > Domain Information.

Note: Make sure you use the initial survey token and not the API token or it will result in incorrect review submission.

We have other values you can add to this code snippet if desired. To add these variables to your code snippet, select the checkbox next to the value you would like added. You can find this under Auto Populate Values on the "Seller Ratings" page under "Setup" (see image below). Selecting these checkboxes will only add the value with dummy variable data into the code snippet. Please make sure to configure the correct variables from your site.

The order ID, name, and email have been added to the code snippet and filled with dummy data.

var sa_values = { "site":siteID, "token":"token", 'orderid':'ORDER123', 'name':'John Doe', 'email':'[email protected]' }

We recommend selecting the following:

  • Order ID: Attaching an order ID to a review makes it easier for you to cross-reference the order with a customer review. It is especially useful when you are searching for a particular review.

  • Name: The customer's name will be auto-filled in the name field, making it easier for your customer to fill out the survey. The name will be attached to the review. Note: If the customer doesn’t add a name, or removes the name, the review will show “Anonymous Customer”.

  • Email: The customer's email address will also be auto-filled in the email field on the survey. For us to send a follow-up email to your customers, we must have their email address. This is also a required value if you want us to send emails to all customers who place an order on your site whether they fill out the checkout (initial) survey or not. If you are interested in this, make sure you have “email all” turned on and that your privacy policy states you will share information with a third party. To locate the “email all” setting, navigate to Set Up > Seller Ratings and scroll down to find the “email all” toggle.

Optional Values

  • Country

  • State/Province

  • Days to delivery: This dynamically allocates the days to delivery based on a dynamic value.

After selecting the values you want, copy the code snippet to your site. Remember to replace the dummy data with data from your checkout page using your cart’s variables.

Note: If you are not able to auto-populate any of the variables such as order ID, name, and email address from your cart/platform, the survey code will still populate a survey. Make sure that the values that you are not able to fill, are not selected so they are not included in the code snippet. Remember to include the site ID and token. If the email variable is not passed, this will prohibit you from using the email-all feature and may lead to a lower review conversion rate.

Step 2 - Place a Test Order (and set the follow-up days)

Once you have added the code snippet to your order confirmation page with the correct values, you will want to place a test order to ensure the survey submission passes the correct values onto the review.

After checking out, you should see this survey on your order confirmation page.

Note: If you have uploaded your logo in your settings, your logo will appear on the top.

If you are passing the order ID, name, and email, the name and email should be auto-filled in the fields on the survey.

Fill out the survey as if you were a customer and submit the review.

To verify the review came through with the correct values, log in to your Shopper Approved account to see your review under the main navigation > Seller Ratings > Manage Seller Ratings.

You should see a review similar to this with the values.

Please note that if your review is not marked as a “test”, you should reach out to [email protected] to prevent any issues with your account.

To test the follow-up email, you can set the follow-up days to 0 days before submitting the initial review. This will send a follow-up email within a few hours to the email address from the survey. From that email, you can fill out the post-fulfillment (full) survey as well.

Note: After placing a successful test order, you will want to change the follow-up days to the average days to delivery. Keep in mind these are calendar days.

Step 3 - Add a seller reviews page

Now that your customers can leave a review, you will want to display these reviews on your site. Adding a dedicated seller reviews page to your site gives you an organic search result in Google and drives traffic directly to your site.

Start by creating a new page on your website titled “Reviews” and add a link to your site footer.

Here is what a reviews page will look like:

Customizations for the review page widget are located within the Shopper Approved dashboard under Seals and Widgets > Review Page Widget which includes changing the star, graph, text color, and display options. After customizing your widget to your liking hit Save and then copy and paste the code snippet to your newly created Reviews page.

This will automatically add all your seller reviews to this page. You can change the default sort order and choose to hide the customer location.

Note: It’s recommended to add the reviews page after you have received 10 or more reviews since the reviews page will be an average of all seller reviews.

Step 4 - Add a seal

The seal is very beneficial to add to your site because it shows Google the relationship between your certificate page and your website when they crawl your site, helping you rank higher in Google. It is also used as social proof. The certificate page also gives you organic stars on Google. Your customers can also click on the seal and be directed to the certificate page to see reviews.

To find the seal code, navigate to Seals and Widgets > Manage Seals in your Shopper Approved account to customize. There are a variety of customizations you can make such as color, style, width, and more. The seal can either be dynamic, rotating between your review count and overall rating, or static. A preview of your seal will display on the right-hand side as you customize your settings.

Once you are done customizing to your liking, copy and paste the code snippet onto the desired location on your site. The most common locations are in the header and/or footer of your website.

We have found that clients get the best conversion when they place the seal somewhere in the top right of their website in the header. You can also create a floating seal so the seal is always visible on your site when a customer scrolls.

Note: For security, the seal should never be placed on pages where credit card information is entered.

Step 5 - Add a rotating widget

This is optional but gives you the option to highlight some of your best-seller reviews on your site. You can select 5-star reviews, 4- and 5-star reviews, or your favorite reviews. To learn how to favorite a review, reach out to our support team to get a walk-through of that feature.

Note: Only reviews with comments can be displayed.

To find the code for the rotating widget, navigate to Seals & Widgets > Rotating Widget. From here, go through the settings to customize it to your liking and just like the reviews page and seal, copy and paste the code to the location on your home page.

Step 6 - Add a milestone award

Once you collect 100 5-star reviews, you will see a Milestone Award under Seals & Widgets.

If you want to add the milestone to your site, select your desired style and copy and paste the code in the desired location of your site.

You’re all set! If you have any questions about your integration, please reach out to [email protected].

Happy Collecting!

Did this answer your question?