If you are onboarding on or after Nov 1, 2023, use these instructions.
This feature can identify abandoned cart contents for known, non-logged in customers. If you use this feature, we will send all of those Add to Cart events to you.
To use this feature, you must first ensure that you’re using the most recent version of our script on your website. You can find your script in your account under Code Script > View Script. Click here for a link to all our tutorials on how to add the script to your site, in case you need a refresher.
If you're using our custom Shopify Integration app, the Add to Cart script will automatically be installed. For those not using this app, view the "On your website" section at the bottom.
Set up Added to Cart flow
Once you setup the custom Shopify Integration app and we've enabled the feature for you, you will see our additional unique identifier, CartSource: GE, as seen below in a contact profile in Klaviyo:
Additionally, you can see these events successfully passing through in your Retention.com account when you see the Added to Cart option populate under Event Details. This is an easy way to confirm that our events have been successfully implemented.
Step 1
Copy your existing Add to Cart abandonment flow in Klaviyo (not Abandoned checkout or Product/browse abandonment!) and name it Reclaim Add to Cart.
Edit the Trigger Filter to include Dimension where CartSource> Equals > GE and Save. If you're creating a new flow from scratch, use the Added to Cart event and use the same Trigger Filter specified in the previous sentence.
If you don't already have them, you should add flow filters to exclude anyone who has:
Placed Order zero times since starting this flow
ANDHas not been in flow in the last 7 days
ANDReceived Email zero times in the last 7 days where $flow equals (existing add to cart flow)
ANDPlaced Order zero times in the last 1 days
If flows are triggered off of Checkout Started and/or Checkout Started Reclaim, add these additional flow filters:
Checkout Started zero times since starting this flow
Checkout Started Reclaim zero times since starting this flow
Step 2
You will also need to adjust your existing added to cart flow to prevent contacts from being in multiple flows at the same time.
If flows are triggered off of Checkout Started Reclaim, add these flow filters:
Checkout Started Reclaim zero times since starting this flow
Step 3
Extend the existing delay. For example, if your current Add to Cart delay is 15 minutes, set this delay for 30 minutes.
Step 4
Modify your original abandoned cart flow to exclude any contacts with CartSource equals GE. This will be a Trigger Filter where the Dimension should be set to CartSource is not set:
Step 5
Contact us at support[at]retention.com and request that we enable Add to Cart events for your account. If you're working with our onboarding team, this will already be enabled.
Add SMS to your flow [Optional]
If you want to send an SMS to customers triggering the Added to Cart metric, you can add an SMS step to the same flow created above.
Step 1
If your original Added to Cart flow also includes SMS, add the following flow filter:
Received SMS zero times in the last 7 days where $flow equals (existing added to cart/cart abandonment flow)
Step 2
In your existing Added to Cart Flow, add a Conditional split after the first Time delay, to check whether or not there is consent to receive SMS. Drag your first Email Step over to the beginning of the No branch.
Step 3
Add an SMS Step at the start of the Yes branch. Reconnect both branches after the SMS Step, by dragging the Rejoin icon from the No branch to the Yes branch.
Step 4
Configure your SMS content. Short and sweet is best for SMS! Don't forget to set them live!
Dynamic Field List
These variables can be used in your email templates to dynamically populate information about your products.
For R! Added to Cart events, the table with your product information should be set to Static.
The fields below are based on data sent from our Shopify Integration. Field names and variables may differ when using other eCommerce platforms or a custom setup.
Field Name | Example Value | Dynamic Variable Markup |
Currency | USD | {{ event.Currency|default:'' }} |
CurrencyPrice | $30 | {{ event.CurrencyPrice|default:'' }} |
Price | 30 | {{ event.Price|default:'' }} |
Formatted Price (displays $ only) | $30.00 | {% currency_format event.Price %} |
ImageURL | {{ event.ImageURL|default:'' }} | |
Name | Black V-Neck T-Shirt | {{ event.Name|default:'' }} |
ProductID | 3891613401160 | {{ event.ProductID|default:'' }} |
Quantity | 1 | {{ event.Quantity|default:'' }} |
URL | {{ event.URL|default:'' }} | |
item_category (when available) | V-Neck Tees | {{ event.item_category|default:'' }} |
variant | S | {{ event.variant|default:'' }} |
variant_id | 29276152856648 | {{ event.variant_id|default:'' }} |
On Your Website
If you aren't using our custom Shopify Integration app, you will need to add our Add to Cart script to your site builder:
geq.addToCart(item);
Next, edit the snippet.
Snippet 1: For buttons without redirects
You should update your script from this:
<script type="text/javascript"> var _learnq = _learnq || []; function addedToCart() { fetch(window.location.origin + '/cart.js') .then(res => res.clone().json().then(data => { var cart = { total_price: data.total_price/100, $value: data.total_price/100, total_discount: data.total_discount, original_total_price: data.original_total_price/100, items: data.items } if (item !== 'undefined') { cart = Object.assign(cart, item) } _learnq.push(['track', 'Added to Cart', cart]) })) } (function (ns, fetch) { ns.fetch = function() { const response = fetch.apply(this, arguments); response.then(res => { if ((window.location.origin + '/cart/add.js').includes(res.url)) { addedToCart() } }); return response } }(window, window.fetch)) $(document).ajaxComplete(function(event, request, settings){ if((typeof settings != "undefined") && settings.url == "/cart/add.js"){ addedToCart() } })
to this:
<script type="text/javascript"> var _learnq = _learnq || []; function addedToCart() { fetch(window.location.origin + '/cart.js') .then(res => res.clone().json().then(data => { var cart = { total_price: data.total_price/100, $value: data.total_price/100, total_discount: data.total_discount, original_total_price: data.original_total_price/100, items: data.items } if (item !== 'undefined') { cart = Object.assign(cart, item) } _learnq.push(['track', 'Added to Cart', cart]) geq.addToCart (item); })) } (function (ns, fetch) { ns.fetch = function() { const response = fetch.apply(this, arguments); response.then(res => { if ((window.location.origin + '/cart/add.js').includes(res.url)) { addedToCart() } }); return response } }(window, window.fetch)) $(document).ajaxComplete(function(event, request, settings){ if((typeof settings != "undefined") && settings.url == "/cart/add.js"){ addedToCart() } })
Snippet 2: For buttons with redirects defined by a button ID
You should update your script from this:
<script type="text/javascript"> var _learnq = _learnq || []; document.getElementById("AddToCart").addEventListener('click',function (){ _learnq.push(['track', 'Added to Cart', item]); });</script>
to this:
<script type="text/javascript"> var _learnq = _learnq || []; document.getElementById("AddToCart").addEventListener('click',function (){ _learnq.push(['track', 'Added to Cart', item]); geq.addToCart(item); });</script>
Snippet 3: For buttons with redirects defined by class notation
You should update your script from this:
<script type="text/javascript"> var _learnq = _learnq || []; var classname = document.getElementsByClassName("add-to-cart"); var addToCart = function() { _learnq.push(['track', 'Added to Cart', item]); }; for (var i = 0; i < classname.length; i++) { classname[i].addEventListener('click', addToCart, false); } </script>
to this:
<script type="text/javascript"> var _learnq = _learnq || []; var classname = document.getElementsByClassName("add-to-cart"); var addToCart = function() { _learnq.push(['track', 'Added to Cart', item]);
geq.addToCart(item); }; for (var i = 0; i < classname.length; i++) { classname[i].addEventListener('click', addToCart, false); } </script>