Direct mail configuration direct-mail-configuration

Journey Optimizer allows you to personalize and generate the files required by direct mail providers to send mail to your customers.

When creating a direct mail message, you define the targeted audience data, including the chosen contact information (postal address for example). A file containing this data will then be automatically generated and exported to a server, where your direct mail provider will be able to retrieve it and take care of the actual sending.

Before being able to generate this file, you need to create:

  1. A file routing configuration to specify the server where the file will be exported and encrypt the file, if necessary.

    note caution
    CAUTION
    To create a file routing configuration, you need to have the Manage file routing built-in permission. Learn more.
  2. A direct mail surface that will reference the file routing configuration. If you have not configured any file routing option, you will not be able to create a direct mail surface.

Configure file routing file-routing-configuration

NOTE
Currently Amazon S3, SFTP and Azure are supported in Journey Optimizer.

To deliver a direct mail message, Journey Optimizer generates and exports the file containing your targeted audience data to a server.

You need to specify that server details so that your direct mail provider can access and use that file for delivering mail.

To configure the file routing, follow the steps below.

Amazon S3
  1. Access the Administration > Channels > File routing configuration > File Routing menu, then click Create routing configuration.

    {align="center" width="800"}

  2. Set a name for your configuration.

  3. Select Amazon S3 as the Server type to use for exporting the direct mail files.

    {align="center" width="800"}

  4. Fill in the details and credentials for your server

    • AWS bucket name:To know where to find your AWS bucket name, refer to this page.

    • AWS access key: To know where to find your AWS access key ID, refer to this page.

    • AWS secret key: To know where to find your AWS secret key, refer to this page.

    • AWS region: choose the AWS region where the server infrastructure will be located. AWS regions are geographic areas that AWS uses to host its cloud infrastructures. As a general practice, it is preferred to choose the region that is closest to you direct mail provider’s location.

    {align="center" width="800"}

  5. To encrypt the file, copy-paste your encryption key in the PGP/GPG encryption key field.

  6. Select Submit. The file routing configuration is created with the Active status. It is now ready to be used in a direct mail surface.

    You can also select Save as draft to create the file routing configuration, but you will not be able to select it in a surface until it is Active.

SFTP
  1. Access the Administration > Channels > File routing configuration > File Routing menu, then click Create routing configuration.

    {align="center" width="800"}

  2. Set a name for your configuration.

  3. Select SFTP as Server type to use for exporting the direct mail files.

    {align="center" width="800"}

  4. Fill in the details and credentials for your server:

    • Account: Account name used to connect to the SFTP server.

    • Server address: ​URL of the SFTP server.

    • Port: FTP connection port number.

    • Password:​ Password used to connect to the SFTP server.

  5. To encrypt the file, copy-paste your encryption key in the PGP/GPG encryption key field.

  6. Select Submit. The file routing configuration is created with the Active status. It is now ready to be used in a direct mail surface.

    You can also select Save as draft to create the file routing configuration, but you will not be able to select it in a surface until it is Active.

Azure
  1. Access the Administration > Channels > File routing configuration > File Routing menu, then click Create routing configuration.

    {align="center" width="800"}

  2. Set a name for your configuration.

  3. Select Azure Server type to use for exporting the direct mail files.

    {align="center" width="800"}

  4. Fill in the details and credentials for your server:

    • Azure Connection String: To find your Azure Connection String, refer to this page.

      The Azure Connection String should follow the format below:

      DefaultEndpointsProtocol=[http|https];AccountName=myAccountName;AccountKey=myAccountKey

    • Container Name: To find your Container Name, refer to this page.

      The Container Name should contain only the container’s name without any slashes. To specify a path within the container for saving the file, update the Direct Mail Campaign’s file name to include the desired path.

  5. To encrypt the file, copy-paste your encryption key in the PGP/GPG encryption key field.

  6. Select Submit. The file routing configuration is created with the Active status. It is now ready to be used in a direct mail surface.

    You can also select Save as draft to create the file routing configuration, but you will not be able to select it in a surface until it is Active.

Create a direct mail surface direct-mail-surface

To be able to deliver direct mail with Journey Optimizer, you need to create a channel surface to define the settings for the formatting of the file that will be used by the mail provider.

A direct mail surface must also include the file routing configuration which defines the server where your direct mail file will be exported.

  1. Create a channel surface. Learn more

  2. Select the Direct mail channel.

    {align="center" width="800"}

  3. Define the direct mail settings in the dedicated section of the channel surface configuration.

    {align="center" width="800"}

  4. Select the file format: CSV or Text delimited.

  5. If you select Text delimited, define the column separator of your choice: tabulation, semicolon, pipe, or ampersand.

  6. Select the File routing configuration amongst the ones that you created. This defines where the file will be exported for your direct mail provider to use.

    note caution
    CAUTION
    If you have not configured any file routing option, you will not be able to create a direct mail surface. Learn more

    {align="center" width="800"}

  7. Submit the direct mail surface.

You can now create a direct mail message inside a campaign. Once the campaign is started, the file containing the targeted audience data will automatically be exported to the server that you defined. The direct mail provider will then be able to retrieve that file and proceed with the direct mail delivery.

NOTE
Duplicate rows where all the values in the row are the same are automatically removed from the file.
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76