Raptor needs to update all users within your Klaviyo Account with a REAID (Raptor Email Address ID). The REAID is an arbitrary ID created by Raptor’s server and represents the user’s email. When a user clicks on a newsletter, the REAID must be included in the URL sent, and subsequently, the same REAID should be set in the tracking for Raptor.
To establish communication between Klaviyo and Raptor's Email Marketing System, you need the following information:
- Email Marketing API Key
- Segment/List ID
You will also need to carry out an extra step in Klaviyo if you wish to utilize Raptor's REAID system for Email Marketing.
NB: Keep this browser page open through the whole setup.
API Key
In your Klaviyo Account, click on the Account-menu in the lower left corner, then select Settings and navigate to the API Keys tab. You will need a Private Key that is suitable for Email Marketing - if you do not already have one, use the Create Private API Key button to make a new one, giving it all relevant Access-rights.
Segment/List ID
A Segment or List ID from the Klaviyo account is also needed. To find this, navigate to the ‘Lists & Segments’ view using the sidebar, and select the appropriate list from the menu. This list should ideally contain all relevant subscribers. For more information on how to make a list, see Klaviyo’s documentation.
Within the list or segment, select ‘Settings’ from the top-bar – this will take you to a view where the List ID is displayed and can be copied into the Activations-process.
REAID Synchronization Setup
The process for REAID setup is slightly different, depending on whether you simply want to engage it for an existing list, or wish to create a new segment based on it.
1: If you want the REAID synchronization set up for an already existing list/segment:
Go to Klaviyo, select the segment/list you want the REAID synchronization set up for and then add a property named “RaptorReaId” on a random user. Set the Value = 0.
2: If you want the REAID synchronization set up for a new segment/list:
Go to Klaviyo and add a property named “RaptorReaId” on a random user. Set the Value = 0.
Now go to Lists & segments and create a new segment, then find all the users where the “RaptorReaId” property is not set and click on Create Segment.
Activating the Integration
Once you have finished inserting all the relevant data and clicked Next, there are two more quick, simple steps you need to go through.
Firstly, you have the option of expanding your new Email Integration to cover Sister Accounts as well. You can select as many as you like, or none at all and just click through. keep in mind, however, that each account can only have one Email Marketing Integration - if you attempt to include a Sister Account that already has a different Integration in place, the activation will fail at the final step.
The final step before finishing will be a simple radio-button, labeled 'Enable Email Synchronization' - on by default, this allows you to disable Raptor's proprietary REAID system, which is used to secure customer e-mail addresses that are being used as ID's. If you did not set up REAID synchronization earlier, you'll probably want to disable this.
With these steps aside, your Email Marketing Integration should be set up, and beginning its first sync!