SAP Emarsys
Use GrowthLoop audiences and warehouse contact data for SAP Emarsys campaigns.
Connect this destination to export audience membership, or to write warehouse rows onto SAP Emarsys contacts, for use in Emarsys campaigns.
This destination writes to your SAP Emarsys account and is a good fit when you want to:
- Make GrowthLoop audiences available as Emarsys contact lists
- Create or update contact attributes from a warehouse table
This maps to GrowthLoop Audiences and Syncs:
| Use it for | Audiences | Syncs |
|---|---|---|
| Sending GrowthLoop audiences to Emarsys contact lists | ✓ | |
| Creating or updating Emarsys contacts from a warehouse table | ✓ |
Prerequisites
Make sure you have:
- An SAP Emarsys account with access to create or manage OpenID Connect API credentials.
- A Client ID and Client Secret for API access.
- Contact-related API permissions enabled for those credentials.
- Your SAP Emarsys Core API base URL. The default value is
https://api.emarsys.net/api/v3.
NoteSAP Emarsys shows the client secret only when you create the credentials. Store it before you leave that screen.
Set up SAP Emarsys as a destination
- In GrowthLoop, click the Destinations tab on the left sidebar.
- Click New Destination in the upper right corner.
- Search for SAP Emarsys and click Add SAP Emarsys.
- Enter the required information, then click Create.
| Field | Description |
|---|---|
| Destination Name | Name this destination in GrowthLoop. Use a name so your team recognizes its purpose, like "Emarsys Email". |
| Sync Frequency | Set the default export frequency (for example, daily or weekly). You can override this setting for individual exports and syncs. |
| Client ID | Client ID from your SAP Emarsys OpenID Connect API credentials. |
| Client Secret | Client secret you've created. |
| API URL | SAP Emarsys Core API v3 base URL. Leave blank to use https://api.emarsys.net/api/v3 unless your account uses a different base URL. |
GrowthLoop validates the connection by checking access to Emarsys contact lists. SAP Emarsys then appears in your list of connected destinations.
Export to SAP Emarsys
From within GrowthLoop, export from an audience. See Export an audience if you need more information on these steps.
After building or selecting an audience, click Export, then search for SAP Emarsys.
Map contact identifiers
Map Email. This destination requires email so Emarsys can match contacts.
You can also map additional fields to SAP Emarsys contact attributes, including custom attributes from the audience.
Configure the export
| Setting | Audience export |
|---|---|
| Export Name | Defaults to the audience name. |
| Campaign type | Choose a one-time or ongoing export. |
| Schedule | Set frequency, start date, end date, and days of the week for ongoing exports. |
Export behavior
This is what GrowthLoop writes when you export an audience.
| Behavior | What happens |
|---|---|
| What GrowthLoop writes | Membership on an SAP Emarsys contact list. Direction is GrowthLoop → SAP Emarsys. |
| When it runs | GrowthLoop sends the export as a batch on the next successful run. An export that starts Now runs within about 15 minutes. |
| Contact list | GrowthLoop creates or reuses a contact list for the audience. |
| Match field | Email is required. |
| Personalization | Additional fields write to Emarsys contact attributes. |
| One-time exports | GrowthLoop sends current membership once. |
| Ongoing adds and removals | Ongoing exports add contacts who enter the audience and remove contacts who leave the contact list. |
Create a sync in GrowthLoop
Create a sync from a warehouse table to write rows onto SAP Emarsys contacts. See Syncs for information on how to complete those steps.
Select an Object Type:
| Object | Use it for | Sync modes |
|---|---|---|
| Contacts | Create or update contacts in SAP Emarsys | Insert, Update, or Insert or update |
When you configure the sync:
- Connection: Select your SAP Emarsys destination.
- Object Type: Select Contacts.
- Update Rule: Choose Insert, Update, or Insert or update. Contacts supports all three modes. See Sync behavior.
- Dataset/Table: Select the warehouse table that holds the records.
- Match Field: Map a contact identifier such as
email.
After you map fields, click Update Sync. Enable the sync with the toggle at the top of the page.
Syncs update contact records. They do not add or remove contacts from an Emarsys contact list. To manage list membership, export an audience.
Contact fields
Map a match field, then map the contact attributes you want to write. GrowthLoop loads available contact fields from your SAP Emarsys account.
| Destination field | Description |
|---|---|
| Email address. Required to match contacts for most syncs. | |
| first_name, last_name, city, country, phone | Optional contact fields. |
| Custom contact fields | Fields available in your Emarsys account. |
Sync behavior
This is what GrowthLoop writes when you sync to SAP Emarsys contacts.
| Behavior | What happens |
|---|---|
| When it runs | GrowthLoop sends the sync as a batch on the next successful run. |
| Insert | GrowthLoop adds new contacts. Existing contacts are not updated. |
| Update | GrowthLoop updates mapped fields on contacts that already exist. New contacts are not added. |
| Insert or update | GrowthLoop adds new contacts and updates mapped fields that changed in the warehouse. |
| Contact match | Map a stable identifier such as email. |
| List membership | Syncs do not add or remove contacts from a contact list. |
| Deletes | GrowthLoop does not delete Emarsys contacts. |
| Missing identifier | Rows without the required identifier fail. |
Confirm the export was successful
When the run finishes, confirm you can use the data in SAP Emarsys.
- Audience export: Look up the contact list named after the export.
- Contact sync: Search for a contact and check the mapped attributes.
In GrowthLoop, review counts on the audience Exports tab, or confirm the sync appears in the Syncs table. See Export an audience or Syncs for more information.
Congrats on successfully exporting to SAP Emarsys!
Troubleshooting
These are the issues we see most often. You can always email us at [email protected] for help.
| Problem | Cause | Resolution |
|---|---|---|
| Connection fails to validate | The credentials are wrong, API URL does not match your account, or the credentials lack contact-list access | Confirm Client ID, Client Secret, and API URL. Enable contact-related API permissions |
| You cannot find the Client Secret | SAP Emarsys shows the secret only when you create the credentials | Create new OpenID Connect credentials and store the secret before you leave that screen |
| Rows fail to match | Email is not mapped | Map the warehouse column that contains the customer's email address |
| A sync did not change a contact list | Syncs update contact records only | Export an audience to add or remove list membership |
Updated 16 days ago