Shopper Profiles - Integration Guide

Learn how to capture cart totals utilizing our automatic survey collection tools to take advantage of the powerful new Shopper Profiles reporting.

Cart value can be captured using the ShopperStream Automatic Survey Collection System. This system includes collecting reviews using our Post Purchase JavaScript, BCC, Accelerator and our Invite API. With a simple update to each of the above mentioned collection methods, you can quickly begin syncing revenue data into ShopperStream. 

 

JavaScript

normally placed on your order confirmation or with other drop in tools such as Google Tag Manager, this code powers review collection at the time of checkout. The code snippet below incudes the updated line for cart_total which will need a variable to pull in the total value of the customer's cart at the time of checkout. Once this snippet has been updated, you will begin seeing revenue data tied to reviews in the ShopperStream dashboard. 

See our full guide for utilizing JavaScript at the time of checkout here.

<script type="application/javascript">
            var _rrES = {
                seller_id: XXXXXX ,
                email: "CUSTOMER EMAIL ADDRESS",
                invoice: "CUSTOMER ORDER NUMBER",
                sku: ["sku1", "sku2", "..."], /* Optional data for product review mailers */,
                cart_total: CART_TOTAL /* total dollar amount value of the order ie: 40.99 */ 
            };
            (function() {
                var s=document.createElement('script');s.type='application/javascript';s.async=true;
                s.src="https://qa1.resellerratings.dev/popup/include/load.js";var ss=document.getElementsByTagName('script')[0];
                ss.parentNode.insertBefore(s,ss);
            })();
</script>

 

BCC Review Collection

Our BCC review collection tool is tied to a post purchase email that triggers review invites using a ShopperStream BCC email. In order to utilize the Shopper Profiles feature, you will need to ensure that in addition to the BCC address, that the HTML snippet has been added to the header of the same email that triggers the BCC to ShopperStream. 

See our full guide for the BCC Review Collection Tool here.

Here is the sample BCC address:

qa01-surveys+c3f6ca0d8c548ac5458cbc395a1599fa@ingest.resellerratings.com

Here is the sample HTML snippet that includes the updated line for cart_total which will need a variable to pull in the total value of the customer's cart through the email it is being tied to. 

<!--#rsr.data:{ "email": "customer@example.com", "invoice": "AB12345-US", "transaction_date": "2024-08-07", "sku": ["sku1", "sku2", ...], "cart_total" : 40.99 }-->

 

Accelerator Tool

While our accelerator tool is only meant to jumpstart review collection at the time of onboarding or to capture customer orders that were missed due to an issue with your normal review collection tools, you can easily add cart value to your .CSV file to capture the data needed for Shopper Profiles. See the sample .CSV below for the updated column header and formatting. 

See our full guide for the Accelerator Tool here.

 

Invite API

Our Invite API tool gives you the ability to trigger your review requests utilizing the ShopperStream API. With a simple edition to the JSON data already being passed to ShopperStream, you can begin capturing the necessary data needed to drive the Shopper Profiles tool. This can happen for both Seller Ratings and Product Reviews, which each require to own individual API calls. See the samples below which include the updated JSON field for cart_total

See the full guide for our Invite API here.

 

Seller Ratings

[{"seller": 798367, "email":"carttotaltest6@email.com", "invoice":"AB12346", "purchase_date":"2024-04-01", "cart_total":"243.90"}]

 

Product Reviews

[{ "sku":"SKU1,SKU2", "email":"matt7@testingaccel.com", "invoice":"AB12349","purchase_date":"2016-07-01", "cart_total":"243.90"}]

 

If you are not currently implemented with our Automatic Survey Collection tools, please contact kevin.miller@resellerratings.com to schedule a meeting to cover implementation.