REAID synchronization:
Raptor needs to update all users within your Salesforce Marketing Cloud 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.
In Salesforce, two data extensions called NoREAID and HasREAID must be created:
NoREAID:
Create a data extenstion in Salesforce Marketing Cloud to display only subscribers with no REAID assigned.
The list must contain 2 fields:
field 1: Subscriber Key
field 2: emailadresse
Screenshot from Salesforce Marketing Cloud:
⚠️ IMPORTANT!
The integration is old and the naming conventions are not ideal. Be aware of case sensitivity. The fields should be created with the exact names specified ‘emailaddresse’ and ‘Subscriber Key’
The External key from the Data Extension must be inserted into Raptor’s control panel in the parameter “NoReaId DataExtensionObject Name”
Find the External Key in Salesforce Marketing Cloud here:
Screenshot from Salesforce Marketing Cloud:
👀 If you change the name of the External key, you'll have to insert the name in the Raptor Controlpanel.
HasREAID:
Create a data extension in Salesforce with two fields
Field 1: Subscriber Key
Field 2: ReaID
Screenshot from Salesforce Marketing Cloud:
This list is updated by Raptor with unique REAIDs for all users.
⚠️ IMPORTANT!
The integration is old and the naming conventions are not ideal. Be aware of case sensitivity. The fields should be created with the exact names specified ‘Subscriber Key’ and ‘ReaID’
Find the External Key in Salesforce Marketing Cloud here:
Screenshot from Salesforce Marketing Cloud:
👀 If you change the name of the External key, you'll have to insert the name in the Raptor Controlpanel.
Set REAID as a global parameter in Salesforce Marketing Cloud:
The users’ REAIDs should be set as a global parameter for all outgoing links.
Ensure that @reaID is an available parameter in your email templates. Managing @reaID as a global parameter can be accomplished through Salesforce Parameter Management.
Screenshot from Salesforce Marketing Cloud:
Setup REAID in the Raptor Controlpanel:
Navigate to ‘Integrations’ and select ‘Email Marketing Integrations,’ then choose ‘Salesforce.’
Enter your Salesforce credentials in the form provided.
Create an installed package in Salesforce Marketing Cloud for Raptor to get the subdomain, clientid, client secret and account id.
Create an API user for Raptor in SFMC to get the SOAP username and SOAP password.
Screenshot from the Raptor Controlpanel:
👀NOTE!
The External key from the data extension NoReaid must be inserted in the parameter NoReaId DataExtensionObject Name
The External key from the data extension HasReaid must be insterted ine the parameter ReaId DataExtensionObject Name
If you have sister accounts, you can easily clone the integration across them.
How often does the REAID synchronization sync?
When a new integration has been activated the sync will run once after approximately 4 hours. After the third run it syncs every 24 hours.