Emarsys Direct Mail - powered by yours truly

Integrate optilyz Direct Mail into your customer journey and seamlessly automate the offline marketing channel.

STEP 1. Make the connection


In order to connect your Emarsys account with optilyz, we need to request that the channel first be activated.

To do this, we will ask Emarsys to share your Account ID with us.


Please provide the company account name associated with your Emarsys account.

STEP 2. Name your automation

Give your automation a meaningful name. This will help you keep track of it.  (You can always change this later.)

Select the delivery country; this will help us perform more accurate address validation and determines which products and pricing apply.

STEP 3. Configure the triggers for your automation. You have two options:

(1) On a regular, time basis: Every day or once a week (you decide which day)

(2) After a minimum number of recipients have been collected

STEP 4. Map your data

Your automation data will be transferred to optilyz directly. Please help us map the Emarsys data field names to optilyz fields so that we know what to do with it when it arrives.

The following fields are available within optilyz.

All fields on the left should be mapped with the corresponding field in the dropdown menu (source Emarsys field editor). This mapping needs to be done once and will then be saved for future campaigns. 

STEP 5. Add individualization fields

If you want to add further individualization fields, you can select them in the 'OTHER VARIABLE DATA' section. Choose, for example: Individualisation1 and assign it to a text individualisation (e.g. a date of birth, a personal salutation, an individual text module etc.).

5.1 Personalization service

In addition to standard data fields, you can further customize your mailings with data from 5 additional sources.

  • Data from an Emarsys contact database

  • Vouchers

  • External data using the API and external events.

  • The Relational Data Service

  • Predict


More information on using the personalization service can be found at here.

You can add personalization service data by selecting "Content personalization" in the field dropdown under OTHER VARIABLE DATA.

STEP 6. Address Validation

Tell us how to handle your addresses during the validation process.
You can choose to include recipients that generate suspicious- or missing-name warnings as well as those addresses that we were unable to definitively verify.

STEP 7. Voucher codes

Adding voucher codes to your mailings is crucial to tracking your campaign’s performance.

> How can I assign voucher codes?

STEP 8. Testing


Before going into production mode, let’s test that we’ve configured everything correctly.

Create an automation on the optilyz platform called ‘Emarsys Integration Test’.


Our operations department knows to ignore any campaigns created by these automations.

1.    Create a test segment from your available contacts.

Tip: Be sure to add a filter, otherwise you will not be able to use the segment. We suggest setting zip code as not empty.


2.    Within the Automation Center, create a new program using the newly created segment as the entry point.

3.   Attach the optilyz API node and select your Emarsys Integration Test automation.


4.    Select the button [Program is In Design] on the upper right corner of the program builder. Press [Activate] and confirm the Launch by clicking [OK].

Within the Emarsys Automation Center, select to view the summary of your test program. The report indicates how many contacts should have been sent to the automation.

Navigate to automations and confirm that the correct number of recipients are enqueued for the test automation.

Congratulations - This concludes your test.

You can delete the program in Emarsys and the optilyz automation. To delete the automation, select the automation from the automations list; change its state to ‘Edit’.  Return to the automations list where you are now able to delete the automation.

You are now ready to start automating direct mail with Emarsys and optilyz.

Important: Offline Mail Opt-In
Please read this article for more information.