Moengage connection

Last update: 2024-01-08
  • Created for:
  • Developer
    User
    Admin
    Leader

Overview

Use the Moengage destination to connect and map your Adobe data (user attributes, segments and events) to MoEngage in real-time. Customers can then act on this data, delivering personalized, targeted experiences.

With Adobe, the integration is very simple and intuitive. Simply take any Adobe user profile, and map it to a MoEngage user attribute.

IMPORTANT

This destination connector and documentation page are created and maintained by the Moengage team. For any inquiries or update requests, please contact them directly at https://help.moengage.com/hc/en-us.

Use cases

A marketer wants to target a user segment (built in Adobe Experience Platform) via Moengage campaigns. Also, they want to personalize campaign content based on attributes from Adobe Experience Platform profiles. With this integration, users and attributes are updated in MoEngage as soon as segments and profiles are updated in Adobe Experience Platform.

Prerequisites

Before you can send your Adobe Experience Platform data to Moengage, note the following prerequisites:

  • To use the MoEngage destination with Adobe Experience Platform, users must first have access to their Moengage Account. Visit the following page to sign up or login to your MoEngage account: https://app.moengage.com

Supported identities

Moengage supports the activation of identities described in the table below.

Target Identity Description Considerations
user_id Unique identifier that uniquely identifies a user profile in the Moengage system. This identifier supports string type. Either one of user_id or anonymous_id is required
anonymous_id Another identifier for an unknown user profile - meaning a profile that does not exist in the system. This identifier supports string type. Either one of user_id or anonymous_id is required

Export type and frequency

Refer to the table below for information about the destination export type and frequency.

Item Type Notes
Export type Profile-based You are exporting all members of a segment (audience) with the identifiers (user_id, anonymous_id) along with custom attributes defined by you exported to Moengage.
Export frequency Streaming Streaming destinations are “always on” API-based connections. As soon as a profile is updated in Experience Platform based on segment evaluation, the connector sends the update downstream to the destination platform. Read more about streaming destinations.

Connect to the destination

IMPORTANT

To connect to the destination, you need the View Destinations and Manage Destinations access control permissions. Read the access control overview or contact your product administrator to obtain the required permissions.

To connect to this destination, follow the steps described in the destination configuration tutorial. In the configure destination workflow, fill in the fields listed in the two sections below.

Authenticate to destination

To authenticate to the destination, fill in the required fields and select Connect to destination.

Moengage Destination Authentication

Fill in destination details

To configure details for the destination, fill in the required and optional fields below. An asterisk next to a field in the UI indicates that the field is required.
Moengage Destination Authentication

  • USERNAME: DATA APP ID of settings page of Moengage dashboard.
  • PASSWORD: DATA APP KEY from settings page of Moengage dashboard.

Moengage Destination Authentication

  • Name: A name by which you will recognize this destination in the future.
  • Description: A description that will help you identify this destination in the future.
  • Region: Your app data center.

Enable alerts

You can enable alerts to receive notifications on the status of the dataflow to your destination. Select an alert from the list to subscribe to receive notifications on the status of your dataflow. For more information on alerts, see the guide on subscribing to destinations alerts using the UI.

When you are finished providing details for your destination connection, select Next.

Activate segments to this destination

IMPORTANT

To activate data, you need the View Destinations, Activate Destinations, View Profiles, and View Segments access control permissions. Read the access control overview or contact your product administrator to obtain the required permissions.

See Activate audience data to streaming segment export destinations for instructions on activating audience segments to this destination.

Map attributes and identities

To correctly send your audience data from Adobe Experience Platform to the Moengage destination, you need to go through the field mapping step.

Mapping consists of creating a link between your Experience Data Model (XDM) schema fields in your Platform account, and their corresponding equivalents from the target destination.

To correctly map your XDM fields to the Moengage destination fields, follow these steps:

In the Mapping step, select Checkbox.

Moengage Destination Add Mapping

In the Mapping step, select Add new mapping.

Moengage Destination Add Mapping

In the Source Field section, select the arrow button next to the empty field.

Moengage Destination Source Mapping

In the Select source field window, you can choose between two categories of XDM fields:

  • Select attributes: use this option to map a specific field from your XDM schema to Moengage attribute.

Moengage Destination Mapping Source Attribute

Choose your source field, then select Select.

In the Target Field section, select the mapping icon to the right of the field.

Moengage Destination Target Mapping

In the Select target field window, you can choose between two categories of target fields:

  • Select identity namespace: Use this option to map Platform identity namespaces to Moengage identity namespaces.
  • Select custom attributes: Use this option to map XDM attributes to custom Moengage attributes that you defined in your Moengage account.
    You can also use this option to rename existing XDM attributes into Moengage. For instance, mapping a lastName XDM attribute to a custom Last_Name attribute in Moengage, will create the Last_Name attribute in Moengage, if it doesn’t already exist, and map the lastName XDM attribute to it.

Moengage Destination Target Mapping Fields

Choose your target field, then select Select.

You should now see your field mapping in the list.

Moengage Destination Mapping Complete

To add more mappings, repeat the previous steps.

Exported data / Validate data export

To verify if data has been exported successfully to the Moengage destination, go to the user profile on your Moengage account. You will see a user attribute called AEP Segment.

Moengage Destination Mapping Complete

Data usage and governance

All Adobe Experience Platform destinations are compliant with data usage policies when handling your data. For detailed information on how Adobe Experience Platform enforces data governance, read the Data Governance overview.

On this page