Sync Contacts and Profile Data
To be able to map and sync data make sure to enable the Enterprise integration first.
Complete setting up the integration by setting general Sync Conditions (optional), map data fields and consent and finally run the full sync.
In this Article
Sync Conditions
Note: Both Enterprise and APSIS One have the concept of a Profile and they mean different things.
A Marketing Profile (APSIS One) represents one individual.
A CRM Profile (Efficy Enterprise) represents a group of individuals.
In order to manage consent from the Contact Card in Efficy Enterprise, a CRM Profile (Efficy Enterprise) must be set up for each Subscription (APSIS One) that you want to work with. For information on how to set them up, go to the Efficy Enterprise Knowledgebase - specifically the chapter Consent Base.
How to add Sync Conditions
Use Sync Conditions to add general rules to the sync. By setting sync conditions only data for Contacts meeting the condition will be synced.
In example only sync Contacts data with the value "A" in the field Customer type.
You may add multiple sync conditions.
1. Head over to the Integrations tab in your Section, locate Enterprise, and click Edit.
2. Select the Sync Conditions tab.
3. Click Add New Rule.
4. Expand the drop-down menu under Enterprise and choose a field.
5. Under Value, enter the value for this field. Profiles will only be created and updated as long as the Contact data from Enterprise matches this value.
Repeat this process with as many conditions as you need.
6. When done, click Save.
Field mapping
Map fields from Contacts in Enterprise to Attributes on Profiles in APSIS One.
How to map fields
1. Head over to the Integrations tab, locate Enterprise, and click Edit.
2. Select the Field Mapping tab.
3. Email and ID Attributes will be mapped automatically.
4. Click Add new mapping to map another Attribute. Repeat the process for all the Attributes you wish to map.
5. When done, click Save.
Consent Mapping
Mapping consent from Contacts in Enterprise to Profiles in APSIS One is crucial to your marketing activities. It is only possible to send out emails and SMS' to Profiles with consent.
Before you begin the Consent Mapping:
Create the needed CRM Profiles in Enterprise.
Create the needed Subscriptions in APSIS One.
Do not use any system other than Enterprise to manage the consent of the Profiles.
Check these guides if you have doubts on how to set up your Subscriptions and corresponding Enterprise CRM Profiles.
How to Set up Consent Mapping
1. Head over to the Integrations tab in, locate Enterprise, and click Edit.
2. Select the Consent Mappings tab.
3. Under Enterprise, expand the Contact Card drop-down menu and select one of the fields you have set up for consent.
4. Expand the Subscriptions dropdown and select a Subscription.
Note: If you wish to add consent for both email and SMS channels, repeat this step. Both channels cannot be selected in the same mapping.
6. Click Add new mapping to map another Subscription. Repeat the process above for all the Subscriptions you wish to map.
6. Click Save.
Are you setting this up for the first time it is essential to run a Full Sync. Find out how to do this by reading the next step below. When to run a full sync?.
How to Start a Full Sync
1. Head over to the Integrations tab, locate Enterprise, and click Edit.
2. Select the Full sync tab.
3. Click Start sync.
Now, Profiles in APSIS One will begin to sync with customer entries in Enterprise. This might take a while, depending on the amount of Contacts in Enterprise.
The real-time sync will make sure existing Marketing Profiles are continuously updated as changes are made in Enterprise.
Completely new Contacts will be created daily.
4. If you want to cancel the sync while it's in progress, click the Cancel Sync.
5. Check the results of the full sync by click on the full sync.
And that's it! You are now ready to start your data driven marketing activities in APSIS One.
When to run a full sync?
First time you configure the integration? Yes, run a full sync.
When changing field and consent mapping? Yes, we strongly recommend it/require it is because data inAPSIS One would not be reflected properly otherwise.
When changing Sync Conditions? If your integration is configured to delete profiles that no longer meet sync conditions, then, Yes. We advise you to run a full sync so that profiles that no longer meet sync conditions get deleted right away.
When adding new CRM Profiles & Queries? No, you do not need to run a full sync if you change Queries, full syncs are not affected by that. If you add/remove contacts to an Query in Enterprise, you need to either manually run an import for the Query under Queries, or if you have set it up to be recurring, wait until the next morning for it to be reflected.
Note: Get more out of the integration - create Queries in Enterprise and sync them to APSIS One. Read more.
Real-time Sync & Full Sync
Real-time Sync: Enterprise only sends the contents of the created or updated persons to APSIS One. To handle this message, APSIS One utilises its integration middle layer to handle the operations related to consents and handling merging.
Full Sync: Enterprise is not responsible for sending any of the data to APSIS One as a part of a Full Sync. Instead, APSIS One downloads all of the persons using Enterprise API.
Real-time messages received during a full sync are processed only after the full sync is completed in order to ensure eventual consistency between Enterprise and APSIS One.