Integrating RightMessage with Customer.io

Once you’ve integrated your RightMessage account with Customer.io, you’ll be able to use us to capture new contacts, segment your Customer.io contacts, and personalize your website with Customer.io segments and attributes.

In this guide, we cover everything you need to know about segmenting and personalizing with Customer.io + RightMessage.

Linking RightMessage with Customer.io

From your Customer.io dashboard, click on Settings → Account Settings.

Now click on API Credentials.

You’re going to need to create two sets of API credentials: a Tracking API Key along with an App API Key. The tracking key will handle identifying and pulling information about specific people, and the app handles general account-level operations, like pulling a list of all of your available segments.

Once you’ve created these two sets of keys, you’ll have the following information that RightMessage needs:

  • Site ID (Tracking)
  • API Key (Tracking)
  • API Key (App)

API credentials in Customer.io

Now, back in RightMessage, click the ‘gear’ icon and select Integrations.

Choose Customer.io and enter in the Site ID, API Key, and App Key.

Finally, click Connect with Customer.io.

Identifying Customer.io subscribers on your website

There are a handful of ways that RightMessage “knows” when someone on your website is also in your Customer.io account.

For information on how we identify visitors, you’re going to want to read this crash course guide first. Once you’ve read that, here are the nuances specific to Customer.io…

An even easier way to accomplish the above is to have every link sent from Customer.io include your rm_cio query parameter.

Head over to Settings → Workspace Settings from within your Customer.io dashboard and find URL Parameters under the Sending Options section. Click Get Started.

Now click on Edit Parameters, click Add URL Parameter, and set rm_cio equal to {{ customer.id }}.

Enabling Customer.io URL parameters

Finally, make sure you click Enable to have Customer.io start automatically including this, and any other parameters you’ve mapped out, in your links.

Manually ID’ing when you send an email

When including a link in a Customer.io-sent email, you’re going to want to make sure that the current person’s id attribute is included in your links.

This is done by adding ?rm_cio={{ customer.id }} to the end of every link.

Adding rm_cio to Customer.io links

Customer.io’s templating engine will replace {{ customer.id }} with the actual Contact ID of the recipient, so that someone (say, Contact #12345) will get an email that links to something like https://yoursite.com/new-blog-post?rm_cio=12345

RightMessage will strip out the rm_cio=... bit so that should they share your latest blog post on social media, their unique ID won’t be included.

Manually setting the contact’s ID

You can also manually link a visitor with a person record in Customer.io.

Write a cookie named contact_id with the value equal to the person’s unique ID.

Best practices for capturing new contacts

Because Customer.io doesn’t include any native form capture tools, RightMessage is a great option for not only generating leads to add to Customer.io – but also for segmenting these leads and displaying personalized messaging and calls-to-action.

When using RightMessage to capture leads, we recommend setting up one manual segment in Customer.io per specific “offer” that you’re going to show someone. (Check out our guide to RightMessage offers for more on how we handle opt-in offers.)

Attributing opt-ins with a manual segment

Each RightMessage offer should map to a respective Customer.io manual segment, and this makes it easy to handle attribution (you’re able to see who submitted each “form” by verifying assignment to one of these manual segments.)

The Customer.io data we can use to segment website visitors

When a visitor is back on your website, RightMessage has immediate access to:

  • Their list of segments
  • Their attributes

Check out our sections on segmentation, website personalization, and CTA Funnels for guidance on how to use this data.

Outputting attributes (like someone’s first name) on your website

With RightMessage, you can output known data (like custom fields) directly to your website. In our guide to adding contextual data and merge tags, we cover how to do this. But below is a bit of Customer.io-specific context.

In Customer.io, there’s no concept of built-in “native” attributes.

So to output an attribute about a particular contact, you’ll use {{ customerio.customFields.favorite_color }}, replacing favorite_color with your custom field of choice. (This field should not have any spaces. Either include underscores, your_favorite_color, or leave it as a single word, industry.)

And to output someone’s email address: {{ customerio.email }}

Next up

Drip

Once you've integrated your RightMessage account with Drip, you'll be able to use us to capture new subscribers, segment your Drip subscribers, and personalize your website with Drip tags and custom fields.