| Knowledge Base

Integrate Privy with Retention Rocket

  • Updated

The Privy integration with Retention Rocket allows the Email Address, First Name, Last Name, and Phone Number of a contact collected by Privy campaigns to be used for SMS marketing in Retention Rocket. The combination provides an opportunity to expand your brand's reach beyond the traditional email channel and meet your customers with compelling promotions in other areas.

Configuration

Compatible campaigns must be created, and a custom script must be added to your account settings before contact information collected via Privy can be shared to Retention Rocket.

Create compatible campaigns

The first thing you will need to do is create a Form Builder campaign in your Retention Rocket admin. After saving the campaign defaults, note the resulting Shop ID and Campaign ID at the bottom of the campaign page. In the example below, the Shop ID is 4, and the Campaign ID is 16. 

Retention_Rocket_campaign.png

Next, you need to set up a campaign in Privy. To create the campaign: 

  • Navigate to Campaigns and select or create a new campaign that includes a form. 
  • In the Create step of the campaign builder, edit the form and ensure that the Phone number and Text Opt-In fields are included. If not, use the Add Field dropdown menu to include and Save them. Feel free to keep or add the Email and Name fields if you would like to pass along that information as well. 

Add_form_fields.gif

  • Next, it's recommended that expand the default disclaimer for the campaign so that it is also applicable to SMS messaging. A common addition is something like, "A text opt-in indicates that I agree to receive recurring automated text messages at the phone number provided. Consent is not a condition to purchase. Msg & data rates may apply. Click to view our Terms of Service."

Expand_the_disclaimer.gif

  • After finalizing the design of your display, click Save in the upper right. 
  • Finish customizing the campaign's settings and click Publish in the upper right. 

Add the custom script

To enable the Privy - Retention Rocket connection:

  • Navigate to Account > Business Settings.
  • In the sidebar, select Customizations under the Business Settings header.
  • Next, paste the code provided below into the Conversion Pixels field, scroll down, and Save.

Add_the_Retention_Rocket_script.gif

Note: You need to input the Shop ID and Campaign ID that you created in the Create compatible campaigns section of this guide into the bolded areas of the script below (e.g., var rrShopId = '4';).

<script>
var rrShopId = '<Your Retention Rocket Shop Id>';
var rrCampaignId = '<Your Retention Rocket Campaign Id>';
var rrSmsOptin = true; //must reflect the user's SMS Opt-in preference
var rrEmail = '{{contact.email}}';
var rrFirstName = '{{contact.first_name}}';
var rrLastName = '{{contact.last_name}}';
var rrPhone = '{{contact.phone_number}}';
var rrXhr = new XMLHttpRequest();
rrXhr.open('POST', 'https://api-prod.retentionrock.com/rocketsdk/form_submit.json');
rrXhr.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded');
rrXhr.onload = function() {
if (rrXhr.status === 200) {console.log('Retention Rocket ' + rrXhr.responseText);
}
else if (rrXhr.status !== 200) {
console.log('Retention Rocket request failed. ' + rrXhr.status);
}
};
var qs = encodeURI('shop_id=' + rrShopId + '&campaign_id=' + rrCampaignId + '&first_name=' +
rrFirstName + '&last_name=' + rrLastName + '&phone_number=' + rrPhone + '&email=' + rrEmail +
'&sms_optin=' + rrSmsOptin);
console.log(qs);
rrXhr.send(qs);
</script> 

Test the connection

After following the steps outlined above, you should be all set to pass contact information from your Privy campaigns to your Retention Rocket account. More specifically, all of your Privy campaigns should be connected to the Retention Rocket form builder campaign.

You can test this connection by submitting a Privy campaign on your website. You should then receive an SMS confirmation from Retention Rocket if that is enabled on your Retention Rocket form campaign.

Related articles