Procedure

  1. Go to the mapping you want to edit and click Edit.
  2. Edit the name in the pop-up window that appears. The description is optional.
  3. To configure the mapping, click Edit Field Mapping.
  4. Click the plus sign.
  5. The Edit Mapping Information window opens. Here you must define the details of the mapping for each source (data in your API call).

    1. Add source(s) lets you specify one or more data sources that are included in your API call. For example: email, phone number, etc.
    2. Source Transformation lets you define whether any data should be changed during import. Read more about data transformations here.
    3. Choose Mapping subtype lets you chose from four options: User, Email, SMS and Push. 

      This subtype matches the event type name from the API call. If there is no mapping for the even type, the call won't be processed.

      For example, to send an email, you have to define a mapping with the subtype Email.

    4. Destination attribute lets you specify where the imported data will be mapped. For every mapping subtype, all the required fields are already defined by default in Mapp Engage. All you need to do is add the matching name from your JSON payload (source), and if needed, add additional values. Your custom and member attributers must be defined in Mapp Engage (see Attributes).

      Mapping sources and destinations are case sensitive!

Example

JSON payloadUser mapping
{ 
   "subtype":"user",
   "first":"firstval",     
   "second":"secondval"
}
CODE


Edit User Attributes

  1. Under Choose Mapping subtype (location)  select User.

  2. Under Destination attribute select the type of attribute: Core (Standard), Addon, Custom, Member, or Related Data.
    1. Core (Standard) - select a standard attribute from the drop-down list.
    2. Addon - select an attribute, or create a new one.

      Addon attributes are not visible on the UI or email personalization. They can be used in Segmentation Builder.

    3. Custom - select a custom attribute from the list.
    4. Member - enter group_id:attribute_name
    5. Related Data - select the required related data table and select the column where you want to store the imported data.
  3. Click Save.

Mapping Subtypes

Subtype

Description

User

Allows you to map source data into a user profile using five attribute types: core, custom, member, and addon. 

EmailAllows you to send an email (prepared message) and optionally, map source data as an email parameter used in the prepared message template.
TransactionsAllows you to map source data with the default structure of the Transactional Related Data Table.
WishlistAllows you to map source data with the default structure of the Wishlist Related Data Table.
Abandoned CartAllows you to map source data with the default structure of the Abandoned Cart Related Data Table.
LocationAllows you to map source location data with the default structure of location in the metadata service for the geofence functionality. For more information about the geofence functionality, see Location Management.
SMS

Allows you to send an SMS (prepared message) to the contact using email or mobile number as an identifier.

PushAllows you to send a push notification (prepared message) to the contact using email as an identifier. This requires adding the mobile app ID in the API call.