Overview

Mapp is an omni-channel marketing tool for automated messaging via email, social, web, and mobile.

Integrating Lytics audiences with Mapp allows you to leverage the advanced segmentation features on Lytics to keep your Mapp audiences up to date in real-time. Push custom data fields and audience membership from Lytics to Mapp to improve your multi-channel marketing campaigns.

Authorization

If you haven't already done so, you will need to set up a Mapp account before you begin the process described below.

If you are new to creating authorizations in Lytics, see the Authorizations documentation for more information.

1. Select Mapp from the list of providers.

2. Select the method for authorization. Note that different methods may support different job types. Mapp supports the following authorization methods:

   • SFTP Server Username and Password: for SFTP Exports
   • API Integration Username and Password: for only importing Experience metrics
   • API Integration ID and Secret: for Audience Exports
   • API Username/Password, Integration ID, and Secret: for importing and activating Experiences

3. Enter a Label to identify your authorization.

4. (Optional) Enter a Description for further context on your authorization.

5. Complete the configuration steps needed for your authorization. These steps will vary by method.

6. Click Save Authorization.

SFTP Server Username and Password

1. Enter the following:

   • Host: address of SFTP server for external access.
   • Username: user name used to log into server.
   • Password: password used to log into server.
   • Folder: path in the SFTP server where files will be placed.

   

You are now ready to start a SFTP Export job.

API Username/Password

1. Enter the following:
   • REST API URL: REST API URL of the Mapp instance to which you want to export. This is the host component of the Mapp instance URL and the path to your Mapp instance (i.e. https://staging11.shortest-route.com/qatest).
   • Username: user name used to log into your Mapp instance.
   • Password: password used to log into your Mapp instance.

You are now ready to start an Experience job. Use this authorization to only import Experience metrics.

API Integration ID and Secret

1. Enter the following:
   • Async API URL: Async API URL of the Mapp instance to which you want to export. This is the host component of the Mapp instance URL and the path to your Mapp instance (i.e. https://charon-test.shortest-route.com).
   • Integration ID: your Mapp Connect Integration ID.
   • Secret: your Mapp Connect Integration Secret.

You are now ready to start an Audience Export job.

API Username/Password, Integration ID, and Secret

1. Enter the following:
   • Async API URL: Async API URL of the Mapp instance to which you want to export. This is the host component of the Mapp instance URL and the path to your Mapp instance (i.e. https://charon-test.shortest-route.com).
   • Integration ID: your Mapp Connect Integration ID.
   • Secret: your Mapp Connect Integration Secret.
   • REST API URL: REST API URL of the Mapp instance to which you want to export. This is the host component of the Mapp instance URL and the path to your Mapp instance (i.e. https://staging11.shortest-route.com/qatest).
   • Username: user name used to log into your Mapp instance.
   • Password: password used to log into your Mapp instance.

You are now ready to start an Experience job. Use this authorization to import Experience metrics and activate your Experiences.

Export Audiences

Export Lytics audiences to Mapp to add behavior-rich attributes to your Mapp user base including Lytics behavioral scores, content affinities, and cross-channel data.

Integration Details

• Implementation Type: Server-side Integration.
• Implementation Technique: REST API Integration - Audience Trigger Integration.
• Frequency: Real-time Integration with option to run an initial Backfill.
• Resulting data: A group-level attribute is added to each user in Mapp. The name of the attribute is equal to the Mapp Attribute Name or the name of the Lytics audience if left empty. The attribute value is "true" if the user is in the audience or "false" if the user has exited the audience. The attribute name must be a pre-existing attribute in your Mapp account that is mapped for use with Mapp Connect.

This integration utilizes the Mapp Rest API to export users. Once the export is started the job will:

1. As users enter or exit the Lytics audience, the users' group-level audience attribute will be added or updated to "true" or "false."
2. If you select the Existing Users option during the Configuration, users who currently exist in the selected Lytics audience will be immediately exported to Mapp.
3. If you opt for a one-time export by selecting the Backfill Only option during the Configuration, the job will stop after sending the existing users in the audience.
4. Otherwise, these updates occur continuously as the Lytics audience membership changes.

Fields

By default, Lytics exports the following fields to Mapp.

Configuration

Follow these steps to set up an export job for Mapp. If you are new to creating jobs in Lytics, see the Destinations documentation for more information.

1. Select Mapp.
2. Select the Audience Export job type from the list.
3. Select the authorization you would like to use or create a new one.
4. Enter a Label to identify this job you are creating in Lytics.
5. (Optional) Enter a Description for further context on your job.
6. Select the audience to export.
7. Complete the configuration steps for your job.
8. From the Identifier Field input, select select the field that contains a user's identifier.
9. In the Group ID text box, enter the Mapp Group ID you wish to export to.
10. (optional) Select the Enable Dynamic Attributes checkbox to select to create member attributes dynamically in Mapp.
11. (optional) In the Dynamic Attribute Prefix text box, enter enter the custom dynamic attribute prefix associated with your Group ID. Value must end with '_'. If Enable Dynamic Attributes is selected and this is left blank, the Group ID will be used as the prefix.
12. (optional) In the Mapp Attribute Name text box, enter enter the name of the Mapp user attribute to update profiles with. If this is empty, the workflow will attempt to use the Lytics audience slug as the attribute name. Note that unless Enable Dynamic Attributes is selected, this attribute name must be mapped to an existing member attribute in Mapp Connect.
13. Select the Existing Users checkbox to immediately push users who currently exist in the selected Lytics audience. Deselecting will only push users as they leave or enter the audience.
14. (optional) Select the Backfill Only checkbox, to do a one-time export of the selected audience. Note that if this option is selected, Existing Users must also be selected.
15. Click Start Export.

Export Audiences (SFTP)

The SFTP Export allows you to export your Lytics audiences to an SFTP server in a CSV format, which can then be consumed by Mapp and used to create lists.

Integration Details

• Implementation Type: Server-side Integration.
• Implementation Technique: File Based Transfer Integration.
• Frequency: Batch Integration daily at a specified time, or once only.
• Resulting data: User Fields are written to a file. New users are added to subsequent file uploads, and no users are removed.

This integration utilizes the SSH File Transfer Protocol to send user data. The file name needs to be formatted as follows: export-lytics-{audience name}-{timestamp}.csv. This will be transferred to the SFTP server and the file needs to contain headers in a format readable by Mapp. Once the export is started the job will:

1. Scan the audience for all currently existing members.
2. Write the users and any mapped fields to a CSV file.
3. Upload the CSV file to the user-specified SFTP server.
4. If Keep Updated is selected in the configuration process, steps 1-3 will occur daily at the defined time.

Fields

By default, Lytics exports the following fields to Mapp.

Configuration

Follow these steps to set up and configure an export of Mapp in the Lytics platform. If you are new to creating jobs in Lytics, see the Destinations documentation for more information.

1. Select Mapp.
2. Select the Mapp SFTP Export job type.
3. Select the authorization you would like to use.
4. From the Audience input, select the Lytics audience that contains the users to export.
5. From the Fields Mapping, select the Lytics fields you want to map to Mapp fields.
6. (Optional) Toggle Show Advanced Options to expand the following options.
7. Select the Keep Updated checkbox to continuously run this export.
8. From the Time of Day input, select the time of day to run the export. Note this is only available if Keep Updated is selected.
9. From the Timezone input, select the timezone for time of day.
10. Click Start Export.
    

Experiences

Lytics Experiences supports Mapp marketing campaign single sends. This Experience can be run as stand-alone campaigns such as group emails.

Experience Import

Like all Experience enabled providers, you can import Experiences from Mapp to Lytics. During the import process, you will be asked to select an authorization. Read the Mapp authorization documentation for more information.

Before you can import, you will need to provide the Group ID of the messages you wish to import.

Once you've entered a Group ID, you can import eligible messages as Lytics Experiences.

Only messages prepared or sent within the last 31 days are available via Mapp's API.

Tactics

Mapp Experiences in Lytics support the following tactic:

• Single Send - Sync a Lytics audience for a one-time email blast.

The tactic for an Experience is determined by the type of email created in Mapp, single send. The import list only contains NORMAL, SPLIT_MAIN and SPLIT_TEST messages from Mapp.

Configuration

After importing a Mapp Experience you can configure it for activation.
This tactic for Mapp Experiences has two configuration steps within the Experience Editor:

1. Target - select the target audience for your Experience.
2. Configure Mapp - set up how the audience for your Experience will be exported. This step will match the configuration instructions of the following jobs based on tactic:
   • Export Audiences for Single Send tactics.
     The activation will generally function the same as the corresponding job, but without the Audience selection, as that is configured by the Target step in the Experience editor.

Once you've finished configuring the Experience you can save and activate it.

Activation

Single Send activation pushes users to a Mapp Group and functions similarly to the Export Audiences. Once exported,
the experience audience can be assigned to your message in Mapp.

Single Send Tactics

When you activate this Experience, users will be pushed to a Mapp Group.

1. Ensure that that your selected Group was populated in your Mapp account. Navigate to Groups.
2. Next it's expected that you will assign this Group to your Email Message. This is the message that metrics will be collected on.
3. Proceed with the sending process once your email message is ready.

Metrics

Experience Metrics are collected for Mapp Experiences by launching an Experience Metrics collection workflow. Metrics are collected every hour for Mapp Messages via the Message getStatistics API.

Lytics metrics are recorded using the following fields provided by the Message getStatistics API:

• Reach: confirmedOpener The number of confirmed people who opened your email message.
• Converted: uniqueClickers The number of people who performed a click.
• Conversion Rate: clickToOpenRate The percentage of people who open your email message and performed a unique click.

These events are also mapped to the Lytics user fields Reached with Mapp Experience and Converted on Mapp Experience, which are available in the audience builder so that you can create audiences of users who have been reached by or converted on your Mapp Experiences.