To automatically remove California Consumer Privacy Act (CCPA) opt-outs that were completed on your website from our database, you will need to install the CCPA opt-out script:
geq.optevent()Add this script to fire on your CCPA opt-out page, and update 'email-address' and 'EmailFormID' in the script below to match the variable for email address and the class name for your specific form submission button:
<script type="text/javascript">
var gesubmitaction = function () {geq.optevent(document.getElementById('email-address').value)};
var s_classname = document.getElementsByClassName("EmailFormID");
for (let i = 0; i < s_classname.length; i++) {
s_classname[i].addEventListener('submit', gesubmitaction);
}
</script>You can also add 'geq.optevent()' directly to the submit button.
Have questions? Message us on chat, or email support[at]retention.com!
In this video, we'll share where to find your Retention.com snippet script code and how to add it to your GrooveFunnels site.
1. From your Retention.com Dashboard, click Code Script. Then, click View Your Script.
2. Check the box next to Collection, and then click Copy Code </>. You’ll see a green box in the top right-hand corner telling you the code was copied to your clipboard.
Remember: You can’t check multiple boxes for scripts or you will get an error message. You can only copy one at a time.
3. Once you’ve added the script to your domain, go back to Code Script and click the edit icon next to Authorized Domains.
4. Paste the domain/URL in the text box where you added the script, and click Save Changes.
It will be highlighted in green if the script is properly installed—and in orange if the script is not properly added.
1. From your GrooveFunnels' dashboard, click GroovePages under GrooveFunnels.
2. Click the site you want to add the collection snippet script to.
3. Choose which page you want the snippet script to be on (ex. Home) from the top drop-down menu. Or, you can choose between Pages in the left-hand navigation. Then, click Elements in the left-hand navigation. Next, click and drag Code Embed onto the page.
4. Click the Embed your code here box. Then, click the gear that appears on the left. (This code box will not be visible to visitors.)
5. Paste your Retention.com collection snippet script into the Edit source code box, and click Save.
6. You'll be taken back to the editor page. Remember to hit Save at the top right when you're finished.
7. From your Retention.com dashboard, click On next to Script Status to turn your script on.
1. To add your Retention.com collection script to your entire site, click the three lines in the top right of your editor page, and then click Site settings.
2. Paste your collection script into either the top or bottom boxes. Then, click the checkmark to save your changes.
3. From your Retention.com dashboard, click On next to Script Status to turn your script on. You will have access to this once you collect onboarding.
The suppression script can be added to your website on any pages that you do NOT want Retention.com to collect email addresses. Generally speaking, you would put this script on landing pages where the person has already converted, and therefore, you have already collected their email address.
Examples of pages you’d want to add the suppression script to are post-checkout, thank you, and confirmation pages.
1. From your GrooveFunnels' dashboard, click GroovePages under GrooveFunnels.
2. Click the site you want to add the suppression snippet script to.
3. Choose which page you want the snippet script to be on from the top drop-down menu. Then, click Elements on the left-hand navigation. Next, click and drag Code Embed onto the page.
4. Click the Embed your code here box. Then, click the gear that appears on the left. (This box will not be visible to visitors.)
5. Paste your Retention.com suppression snippet script into the Edit source code box, and click Save.
6. Remember to hit Save at the top right of the editor page when you're finished.
7. From your Retention.com dashboard, click On next to Script Status to turn your script on. You will have access to this once you collect onboarding.
You can setup rules that are used to automatically trigger a collection event based on the number of page views and/or seconds on a page. This allows you to collect higher-level contacts.
1. To setup the rules, click Code Script in the left-hand navigation and then click the edit icon next to Collection Rules.
2. Toggle to Yes to Auto collect the contact after X page views, and type the number of Page Views in the box. For example, if you want a visitor to have 2 page views before the collection script is triggered, type ‘2’ in the box.
Toggle to Yes to Auto collect the contact after X seconds on a single page, and type the number of Seconds in the box. For example, if you want the collection script to wait 10 seconds before it fires, type ’10’ in the box.
3. When you’re finished, click Save Changes.
Click here to learn how to test your script.
At Retention.com, we approach every interface with the idea of making it as clean and simple as possible, and our APIs are no different. One of the keys to Retention.com success is listening to its users and incorporating their feedback. For help with the API, please email support[at]retention[dot]com.
Click here for Retention.com API Docs
Getting Started:
1. You can create and find your API ID and Key under My Account > API Details in your Retention.com account.
2. If you don't currently have an API Key and API ID created, click New Credentials.
3. In the pop-up box, enter a Name and Description for your API Credentials. Click Create. (You can change these later.)
4. Your API Key and API ID will appear. Click the Copy icons.
Click here for Retention.com API Docs
In this video, we'll show you where to find your Retention.com snippet script code and how to add it to your Squarespace site.
1. From your Retention Dashboard, click Code Script. Then, click View Your Script.
2. Check the box next to Collection, and then click Copy Code </>.
1. Log in to your Squarespace account.
2. Click Settings on the left-hand side.
3. Scroll down, and click Advanced.
4. Click Code Injection.
5. Paste the HTML code copied from Retention.com into the Header or Lock Page box. Click Save.
4. From your Retention.com dashboard, click On next to Script Status to turn your script on. You will have access to this once you collect onboarding.
1. Log into your Squarespace account.
2. Click Pages.
3. Hover your cursor over the page where you want to add the code. Click the Settings icon.
4. A box will appear. Click Advanced and then Page Header Code Injection.
5. Paste the HTML code copied from Retention.com into the Page Header Code Injection box. Click Save.
Note: Code injection is a premium feature only available on Squarespace's Business or Commerce plans.
6. From your Retention.com dashboard, click On next to Script Status to turn your script on. You will have access to this once you collect onboarding.
The suppression script can be added to your website on any pages that you do NOT want Retention.com to collect email addresses. Generally speaking, you would put this script on landing pages where the person has already converted, and therefore, you have already collected their email address.
Examples of pages you’d want to add the suppression script to are post-checkout, thank you, and confirmation pages.
1. From your Retention.com Dashboard, click Code Snippet in the left navigation and then </> View Script. Then, check the box next to Suppression, and click Copy Code.
2. Follow the steps above to inject the code into a specific page (ex. post-checkout, thank you, and confirmation pages). You would choose one of those pages in Step 3 shown above and continue to Step 5.
3. From your Retention.com dashboard, click On next to Script Status to turn your script on. You will have access to this once you collect onboarding.
You can setup rules that are used to automatically trigger a collection event based on the number of page views and/or seconds on a page. This allows you to collect higher-level contacts.
1. To setup the rules, click Code Script in the left-hand navigation and then click the edit icon next to Collection Rules.
2. Toggle to Yes to Auto collect the contact after X page views, and type the number of Page Views in the box. For example, if you want a visitor to have 2 page views before the collection script is triggered, type ‘2’ in the box.
Toggle to Yes to Auto collect the contact after X seconds on a single page, and type the number of Seconds in the box. For example, if you want the collection script to wait 10 seconds before it fires, type ’10’ in the box.
3. When you’re finished, click Save Changes.
Click here to learn how to test your script.
In this video, we'll share where to find your Retention.com snippet script code and how to add it to your ClickFunnels site.
1. From your Retention Dashboard, click Code Script. Then, click View Your Script.
2. Check the box next to Collection, and then click Copy Code </>. You’ll see a green box in the top right-hand corner telling you the code was copied to your clipboard.
Remember: You can’t check multiple boxes for scripts or you will get an error message. You can only copy one at a time.
3. Once you’ve added the script to your domain, go back to Code Script and click the edit icon next to Authorized Domains.
4. Paste the domain/URL in the text box where you added the script, and click Save Changes.
It will be highlighted in green if the script is properly installed—and in orange if the script is not properly added.
1. Visit your ClickFunnels dashboard. Hold your cursor over Click Funnels and then click Funnels from the drop-down menu.
2. Choose one of your funnels from the list, and click the funnel title.
3. Click Settings.
4. Paste your script into the Head Tracking Code box.
5. Scroll down to the bottom, and click Save And Update Settings.
6. From your Retention.com dashboard, click On next to Script Status to turn your script on. You will have access to this once you collect onboarding.
The suppression script can be added to your website on any pages that you do NOT want Retention.com to collect email addresses. Generally speaking, you would put this script on landing pages where the person has already converted, and therefore, you have already collected their email address.
Examples of pages you’d want to add the suppression script to are post-checkout, thank you, and confirmation pages.
1. From your Retention.com Dashboard, click Code Snippet in the left navigation and then View Script. Then, check the box next to Suppression, and click Copy Code.
2. Visit your ClickFunnels dashboard. Hold your cursor over Click Funnels and then click Funnels from the drop-down menu.
3. Choose one of your funnels from the list, and click the funnel title.
4. Under the page you want to add the suppression script to (ex. post-checkout, thank you, or confirmation page), click Edit Page.
5. Click Settings > Tracking Code from the top left.
6. Paste your Retention.com suppression script into the Header Code box. Then, click Save in the top right.
7. From your Retention.com dashboard, click On next to Script Status to turn your script on. You will have access to this once you collect onboarding.
You can setup rules that are used to automatically trigger a collection event based on the number of page views and/or seconds on a page. This allows you to collect higher-level contacts.
1. To setup the rules, click Code Script in the left-hand navigation and then click the edit icon next to Collection Rules.
2. Toggle to Yes to Auto collect the contact after X page views, and type the number of Page Views in the box. For example, if you want a visitor to have 2 page views before the collection script is triggered, type ‘2’ in the box.
Toggle to Yes to Auto collect the contact after X seconds on a single page, and type the number of Seconds in the box. For example, if you want the collection script to wait 10 seconds before it fires, type ’10’ in the box.
3. When you’re finished, click Save Changes.
Click here to learn how to test your script.
In this video, we'll show you where to find your Retention.com snippet script and how to add it to your BigCommerce store.
1. From your Retention Dashboard, click Code Script. Then, click View Your Script.
2. Check the box next to Collection, and then click Copy Code </>. You’ll see a green box in the top right-hand corner telling you the code was copied to your clipboard.
Remember: You can’t check multiple boxes for scripts or you will get an error message. You can only copy one at a time.
3. Once you’ve added the script to your domain, go back to Code Script and click the edit icon next to Authorized Domains.
4. Paste the domain/URL in the text box where you added the script, and click Save Changes.
It will be highlighted in green if the script is properly installed—and in orange if the script is not properly added.
1. Log in to your BigCommerce account. From the left navigation, click Storefront.
2. Click Script Manager from the left navigation and then click Create a Script.
3. Name your script, give it a Description (optional), choose if you want it to be in the Footer or Head, select which pages you want to add it to (Store pages, Checkout, Order confirmation, or All pages), choose Script under Script type, and paste your Retention.com script in the Script contents box. Click Save.
The suppression script can be added to your website on any pages that you do NOT want Retention.com to collect email addresses. Generally speaking, you would put this script on landing pages where the person has already converted, and therefore, you have already collected their email address.
Examples of pages you’d want to add the suppression script to are post-checkout, thank you, and confirmation pages.
1. From your Retention.com Dashboard, click Code Snippet in the left navigation and then View Script. Then, check the box next to Suppression, and click Copy Code.
2. Log in to your BigCommerce account. From the left navigation, click Storefront. Then, Click Script Manager, and click Create a Script.
3. Name your script, give it a Description (optional), choose if you want it to be in the Footer or Head, choose to place it on the Order confirmation page, check the Script box, and then paste your Retention.com suppression script into the Script contents box. Click Save.
4. From your Retention.com dashboard, click On next to Script Status to turn your script on. You will have access to this once you collect onboarding.
You can setup rules that are used to automatically trigger a collection event based on the number of page views and/or seconds on a page. This allows you to collect higher-level contacts.
1. To setup the rules, click Code Script in the left-hand navigation and then click the edit icon next to Collection Rules.
2. Toggle to Yes to Auto collect the contact after X page views, and type the number of Page Views in the box. For example, if you want a visitor to have 2 page views before the collection script is triggered, type ‘2’ in the box.
Toggle to Yes to Auto collect the contact after X seconds on a single page, and type the number of Seconds in the box. For example, if you want the collection script to wait 10 seconds before it fires, type ’10’ in the box.
3. When you’re finished, click Save Changes.
Click here to learn how to test your script.
In this video, we’ll show you how where to find your Retention.com snippet script code and how to add it to your Wix site.
1. From your Retention Dashboard, click Code Script. Then, click View Your Script.
2. Check the box next to Collection, and then click Copy Code </>. You’ll see a green box in the top right-hand corner telling you the code was copied to your clipboard.
Remember: You can’t check multiple boxes for scripts or you will get an error message. You can only copy one at a time.
3. Once you’ve added the script to your domain, go back to Code Script and click the edit icon next to Authorized Domains.
4. Paste the domain/URL in the text box where you added the script, and click Save Changes.
It will be highlighted in green if the script is properly installed—and in orange if the script is not properly added.
1. Log in to your Wix account.
2. Click Settings from the left-hand Dashboard.
3. Under Advanced Settings, click Tracking & Analytics.
4. Click New Tool > Custom.
5. Paste the collection snippet script code into Paste the code snippet here box. Click Apply.
6. From your Retention.com dashboard, click On next to Script Status to turn your script on. You will have access to this once you collect onboarding.
1. Log in to your Wix account.
2. Click Settings from the left-hand Dashboard.
3. Under Advanced Settings, click Tracking & Analytics.
4. Click New Tool > Custom.
5. Paste the suppression snippet script code into Paste the code snippet here box. Then, click the Choose specific page bubble, and select the page where you want to add your suppression script. When you're finished, click Apply.
6. From your Retention.com dashboard, click On next to Script Status to turn your script on. You will have access to this once you collect onboarding.
You can setup rules that are used to automatically trigger a collection event based on the number of page views and/or seconds on a page. This allows you to collect higher-level contacts.
1. To setup the rules, click Code Script in the left-hand navigation and then click the edit icon next to Collection Rules.
2. Toggle to Yes to Auto collect the contact after X page views, and type the number of Page Views in the box. For example, if you want a visitor to have 2 page views before the collection script is triggered, type ‘2’ in the box.
Toggle to Yes to Auto collect the contact after X seconds on a single page, and type the number of Seconds in the box. For example, if you want the collection script to wait 10 seconds before it fires, type ’10’ in the box.
3. When you’re finished, click Save Changes.
Click here to learn how to test your script.
You can use your Retention.com's revenue tracking script to capture order information for your Retention.com contacts that land on your BigCommerce page. Tracking codes typically are used on the order status page. Once data is collected, your dashboard will display your week-over-week ROI from your Retention.com contacts.
Here's how to add your Retention.com revenue tracking script to your BigCommerce site.
1. You'll need to copy your revenue tracking script from Retention.com. From your Retention Dashboard, click Code Script. Then, click View Your Script.
2. Check the box next to Revenue Tracking, and click Copy Code.
1. From your BigCommerce dashboard, click Advanced Settings > Web Analytics. Check the box next to Affiliate Conversion Tracking, and click Save.
2. Click the Affiliate Conversion Tracking tab that appears. Paste your Retention.com revenue tracking script into the Conversion Tracking Code box.
3. You will need to replace ORDER_NUMBER, DOLLAR VALUE, and ORDER EMAIL in the code with BigCommerce’s variables.
Replace {{ ORDER_NUMBER}} with %%ORDER_ID%%. Replace {{DOLLAR VALUE}} with %%ORDER_AMOUNT%%. And replace ORDER EMAIL with %%ORDER_EMAIL%%. Click Connect when you’re finished.
4. You can then track your revenue, contacts, and ROI from your Retention.com dashboard.
If you use Klaviyo popups or forms, you can prevent collection of contacts who opt in via your popup or form. This can be done using Klaviyo's Event Listener.
Klaviyo forms send an event called klaviyoForms to the window each time a form is shown, closed, or submitted. You add one listener to your page for all Klaviyo form events. Below is the structure of the Klaviyo form event:
<script>
window.addEventListener("klaviyoForms", function(e) {
if (e.detail.type == 'submit') {
geq.suppress();
}
});
</script>
So the full script would look like this (NOTE this is not a script you can use/copy because the collection script is not specific to your account):
<script type="text/javascript">
!function(){var geq=window.geq=window.geq||[];if(geq.initialize) return;if (geq.invoked){if (window.console && console.error) {console.error("GetEmails snippet included twice.");}return;}geq.invoked = true;geq.methods = ["page", "suppress", "trackOrder", "identify", "addToCart"];geq.factory = function(method){return function(){var args = Array.prototype.slice.call(arguments);args.unshift(method);geq.push(args);return geq;};};for (var i = 0; i < geq.methods.length; i++) {var key = geq.methods[i];geq[key] = geq.factory(key);}geq.load = function(key){var script = document.createElement("script");script.type = "text/javascript";script.async = true;script.src = "https://s3-us-west-2.amazonaws.com/storejs/a/" + key + "/ge.js";var first = document.getElementsByTagName("script")[0];first.parentNode.insertBefore(script, first);};geq.SNIPPET_VERSION = "1.5.0";
geq.load("XXXXXXX");}();
</script>
<script>geq.page()</script>
<script>
window.addEventListener("klaviyoForms", function(e) {
if (e.detail.type == 'submit') {
geq.suppress();
}
});
</script>
More details on adding Custom JavaScript Events to Forms can be found here.
You can use your Retention.com's revenue tracking script to capture order information for your Retention.com contacts that land on your Shopify page. Tracking codes typically are used on the order status page. Once data is collected, your dashboard will display your week-over-week ROI from your Retention.com contacts.
Here's how to add your Retention.com revenue tracking script to your Shopify site.
1. You'll need to copy your revenue tracking script from Retention.com. From your Retention Dashboard, click Code Script. Then, click View Your Script.
2. Check the box next to Revenue Tracking, and click Copy Code.
1. From your Shopify admin page, click Settings > Checkout.
2. Under Order processing, go to the Additional scripts > Order status page text box. Paste your Retention.com revenue tracking script into the box.
3. You will need to replace ORDER_NUMBER, DOLLAR VALUE, and ORDER EMAIL in the script with Shopify's variables.
Replace ORDER_NUMBER with order_number. Replace DOLLAR VALUE with total_price | money_without_currency. And replace ORDER EMAIL with email. When you're finished, click Save in the top right.
So this section should look like this:
<script>geq.trackOrder({order_number: "{{ order_number }}", order_amount: "{{ total_price | money_without_currency }}", order_email: "{{ email }}"})</script>
4. You can then track your order information, revenue, contacts, and ROI from your Retention.com dashboard.