SparkLoop’s easy 2-click integration lets you connect SparkLoop to your Customer.io account within seconds, no developer or complicated Zapier hacks required!

This is a first and necessary step in setting up your campaign.

SparkLoop needs to access your email list in order to generate unique referral links and referral codes for each individual subscriber, thus ensuring they’re tracked and rewarded properly for referrals.

Don’t worry, however. This is an entirely seamless process and once you’ve selected your ESP and your list (two clicks!), your job is done.

The steps for Customer.io integration

When you sign up for SparkLoop, you will be asked to select your ESP.

From here, choose your ESP and follow the steps to import your list.

How long will the integration take?

Once you’ve selected your ESP, you'll need to choose your list/segment. You can either import all subscribers in the account or only from one manual segment.

How long will the import take?

It’s hard to say, but basically, it comes down to the size of your list.

For small lists of up to 50,000 subscribers, it’s unlikely to take more than half an hour, but if you’ve got a million subscribers on your list, then a couple of days (or more) wouldn’t be out of the question.

If it’s been more than 24 hours and your list hasn’t yet finished importing, feel free to contact us on the status. You can do so here.

What happens in Customer.io after you import your list

After you create a campaign in SparkLoop and import your list, a bunch of custom fields are automatically created in your HubSpot account.

These include:

Custom field

Merge tag

Description

RH_SUBID

{{ customer.RH_SUBID }}

Subscriber's ID.

RH_CODE

{{ customer.RH_CODE }}

Subscriber's referral code.

RH_REFLINK

{{ customer.RH_REFLINK }}

Subscriber's referral link.

RH_ISREF

{{ customer.RH_ISREF }}

Whether or not the subscriber has been referred. "YES" or "NO".

RH_ISSHARER

{{ customer.RH_ISSHARER }}

Whether or not the subscriber has shared the link. "YES" or "NO".

RH_TOTREF

{{ customer.RH_TOTREF }}

Subscriber's total number of referrals since last reset.

RH_GLOBREF

{{ customer.RH_GLOBREF }}

Subscriber's all-time total number of referrals.

RH_LASTREF

{{ customer.RH_LASTREF }}

Date of the last subscriber's referral.

RH_LASTREWARD

{{customer.RH_LASTREWARD }}

The ID of the last reward won by this subscriber.

RH_SUBPAGE

{{ customer.RH_SUBPAGE }}

Whether or not the subscriber signed up from a SparkLoop Subscribe page. "YES" or "NO".

Before launching, we need to ensure that all of your newsletter subscribers have had their referral links generated and stored in the RH_REFLINK custom field in your ESP.

You can do this by filtering or segmenting your subscribers in your ESP to only show subscribers who have an RH_REFLINK custom field with no value (also sometimes called blank or empty).

If everything is set up correctly, there should be at most 1-2 subscribers with an empty RH_REFLINK field.

If your subscribers haven’t synced, check out this guide for the reasons why they haven’t, and what you can do about it.

⚠️ Make sure to wait until the list has finished importing completely before running checks.

What happens when subscribers are deleted or unsubscribe?

SparkLoop syncs with your ESP, which means that any new subscribes and unsubscribes are updated in SparkLoop automatically.

However, deleted and unsubscribed subscribers will continue to show up in SparkLoop.

Unsubscribed contacts don’t count towards pricing, but they’ll still be inside of SparkLoop to preserve historical data and for anti-fraud protection.

⚠️ Only active subscribers count towards your billing.

And that’s it. Once your Customer.io account is integrated with SparkLoop, you’re ready to start putting together your referral program.

For instructions on changing your the email list/segment for your SparkLoop campaign, go to this page.

To change your ESP, follow these instructions.

Did this answer your question?