Retention.com - Integration Guide for Yotpo SMS & Email

Connect your Retention.com account with Yotpo SMS to send more abandoned checkout events into your abandoned cart SMS flows. Retention.com can identify more checkout abandoners than your ESP alone and will pass all possible events through to the Yotpo platform.

About Retention.com

Retention.com helps DTC eCommerce brands harness the power of identity to rapidly expand abandonment revenues. Retention.com's identity resolution software helps Shopify merchants recover lost shoppers and increase revenue.

Before you start

To integrate Yotpo with Retention.com, you must have the most recent version of their script on your website.

You can find the script in your Retention.com account under Code Script > View Script.

Setting up the integration

To set up the integration between Retention.com and Yotpo SMS:

1. In your Retention.com account, go to Integrations > Available Integrations and search for Yotpo SMS.
2. Click on it and choose Connect. This will open a window to give Retention.com access to Yotpo. If you're not logged into your Yotpo account via Shopify, you will need to log in first.
3. Go through the connection process.
4. Once the connection is complete, click Enable. You can also Remove the integration from this page at the top.

Install ‘Add to Cart’ and ‘Viewed Product’ scripts

Add to Cart

Inside your site builder, add the ‘Add to Cart’ script to fire when someone clicks to add an item to their cart:

geq.addToCart(item);

Next, edit the snippet:

Generic code for buttons defined by a button ID:

<script type="text/javascript"> document.getElementById("AddToCart").addEventListener('click',function (){ geq.addToCart(item) });</script>

Generic code for button defined by a class notation:

<script type="text/javascript">

var item_classnames = document.getElementsByClassName("AddToCart");

for (var i = 0; i < item_classnames.length; i++) {

item_classnames[i].addEventListener('click', function () {

geq.addToCart(item);

});

}

</script>

Viewed Product

Inside your site builder, add the ‘Viewed Product’ script to fire when someone views a product:

<script>geq.event('Viewed Product Reclaim', item);</script>

If you do not have an existing Viewed Product tracking script, add this to your theme:

<script type="text/javascript">

var item = {

Name: {{ product.title|json }},

ProductID: {{ product.id|json }},

ImageURL: "https:{{ product.featured_image.src|img_url:'grande' }}",

URL: "{{ shop.secure_url }}{{ product.url }}",

Brand: {{ product.vendor|json }},

Price: {{ product.price|money|json }},

CompareAtPrice: {{ product.compare_at_price_max|money|json }}

};

geq.event('Viewed Product Reclaim', item);

</script>

Setting up SMS flows

1. From your Yotpo SMS main menu, go to Flows > Create flow from scratch.

2. Choose the trigger relevant to the script you’ve installed:

• For your ‘Add to Cart’ flow, click Add to Cart Reclaim under Retention.com to set it as the trigger
• For the ‘Viewed Product’ flow, click Viewed Product Reclaim under Retention.com to set it as the trigger

3. Click Add step > Add delay and set a 30-minute delay.

4. Add a Condition step to check if:

• Is an SMS subscriber > is true

• If No, End Flow.

6. If Yes, check if:

Made an order after flow started > is false

7. If No, End Flow. For Yes, set the condition to

Country and address > Any country and address match > Country > is > United States

8. If No, End Flow. If Yes, add a step.

9. Choose action for SMS/MMS message.

10. Edit the existing text message to include our shortcodes, like in this example for the ‘Add to Cart’ flow:

The events include these shortcodes:

• {price}
• {image Url}
• {product Id}
• {name}
• {brand}
• {url}

An example of how that would look in a ‘Viewed Product’ flow:

11. Name the flow ‘Retention.com’ and save your changes. The final flow should look like this:

View ‘Add to Cart’ and ‘Viewed Product’ events

You can also view these events successfully passing through in your Retention.com account by going to Event Details > Added to cart.

This is an easy way to confirm that our events have been successfully implemented. You can also see the Viewed Product Reclaim option populate under Event Details.