Introduction

Amperity is an Intelligent Customer Data Platform that empowers global consumer brands by unlocking customer data. Amperity provides intelligent capabilities across data management, unification, analytics, insights, and activation.

This integration is maintained by Amperity.

MoEngage <> Amperity

Using the MoEngage and Amperity integration, you can create a unified view of your customers and run hyper-personalized campaigns. With this integration, you can:

• Sync customer profiles: Send customer profiles and custom attributes from Amperity directly to MoEngage in real time.
• Sync customer audiences: Build segments in Amperity and push them to MoEngage for targeted campaigns.
• Manage data updates: Control the frequency and scope of attribute updates sent to MoEngage.

Integration Methods

MoEngage supports two methods for integrating with Amperity:

Method 1: Native Connector (Recommended)

Prerequisites

Step 1: Collect Your MoEngage Configuration Details

Before setting up the destination in Amperity, collect the following credentials from your MoEngage workspace.

Step 2: Add MoEngage as a Destination in Amperity

1. On your Amperity dashboard, navigate to Destinations >> Add Destination.
2. Search for and select MoEngage from the list of available plugins.

3. In the Select credential dialog, select an existing credential from the dropdown or choose Create new credential and fill in the following fields:

4. Define the User Identifier that Amperity will use to match records in MoEngage. Select the identifier that aligns with how your workspace identifies users:

5. Save the destination configuration.

Step 3: Add a Data Template

1. In the Destinations tab, open the menu for the MoEngage destination you just created and select Add Data Template.
2. Enter a name and description. For example:

• Name: MoEngage Audience Attributes
• Description: Send audience attributes to MoEngage.

3. Verify business user access settings and review all configuration details.
4. Ensure the template is enabled for Campaigns so AmpIQ users can access it.
5. Save the data template.

Step 4: Send Data to MoEngage

Once MoEngage is configured as a destination, data can be sent via two paths depending on your Amperity product access.

• Sync Queries via Amp360
• Sync Audiences via AmpIQ

Amp360 users can write SQL queries and configure orchestrations to send results to MoEngage on a schedule.

Step 1: Create a query in Amperity

Navigate to the Queries section and write an SQL query that returns the customer attributes you want to send to MoEngage. Include the user identifier field you selected in Step 2.

For query examples, refer to the Amperity Queries Reference.

Step 2: Add an orchestration

1. Go to the Orchestrations section and click Add Orchestration.
2. Select the SQL query you created as the data source.
3. Select MoEngage as the destination.
4. Define the run frequency (for example, daily at a set time).
5. Save the orchestration.

Step 3: Run the orchestration

Trigger the orchestration manually to validate data delivery. Once confirmed, rely on the schedule for automated syncs.

info	To avoid stale data, ensure the Amperity export schedule runs before any downstream processing in MoEngage. Amperity only sends attributes that have changed since the last sync, keeping your payloads efficient.

AmpIQ users can build segments using a no-SQL interface and push them to MoEngage. Amperity will automatically re-sync the segment to MoEngage each time the campaign runs, keeping your MoEngage cohorts dynamically updated.

Step 1: Build a segment in Amperity

Use the Segment Editor in Amperity to define your audience using dropdowns and picklists. Ensure the segment includes all custom attributes you want to update in MoEngage.

Step 2: Build a campaign in Amperity

1. Navigate to the Campaigns section and click Create Campaign.
2. Give the campaign a descriptive, unique name.
3. Select the segment you created as the target audience.
4. Define any exclusions or sub-audiences as needed.

5. Select MoEngage as the destination.
6. Use the Edit Campaign Attributes panel to choose which customer attributes to send.
7. Set the campaign schedule (one-time or recurring).
8. Save the campaign and run a test.

Step 3: Run the campaign

Run the campaign manually to validate delivery. Once confirmed, the recurring schedule will keep your MoEngage audiences updated automatically.

Data Mapping

Both standard and custom attributes can be sent from Amperity to MoEngage. To ensure data flows correctly into MoEngage user profiles, map Amperity attributes to MoEngage's exact API keys.

Standard Attributes

When sending standard attributes from Amperity, use the MoEngage API keys below so they are parsed into the correct user profile fields:

• ID: uid
• First Name: u_fn
• Last Name: u_ln
• Full Name: u_n
• Birthday: u_bd (ISO 8601 format, for example, 2023-05-21T03:47:35Z)
• Email Address: u_em
• Mobile Number: u_mb
• Gender: u_gd

Custom Attributes

Custom attributes are fields defined by your brand (for example, loyalty tiers, purchase history, or location). Unlike standard attributes, custom attributes can be named freely — but must exactly match the names already configured in your MoEngage workspace to avoid duplication. Examples include:

• loyalty_status
• lifetime_value
• last_purchase_date
• city
• state

Data Points

Amperity tracks what has changed between syncs. Only attributes updated since the last sync are sent to MoEngage — minimizing unnecessary data point consumption and keeping payloads efficient. Custom attributes will only be updated for users with a matching primary identifier (customer_id) in MoEngage.

Method 2: S3 Import (Alternative)

Prerequisites

Step 1: Create an S3 Destination in Amperity

1. On your Amperity Dashboard, go to Destinations >> Add Destination.

Configure the following mandatory fields:

You can read more about adding Amazon S3 as a destination in the Amperity documentation.

Step 2: Add a Data Template

1. On your Amperity Dashboard, go to Destinations >> Add Destination.

Configure the following fields for your data template:

Step 3: Create a New Import in MoEngage

Follow these instructions to set up S3 Imports in MoEngage.

Data Mapping

During the mapping step, you can map the following attributes from your S3 CSV columns: Names, Birthdates, Email addresses, Phone numbers, and any other custom attribute.

Data Types

Supported data types include: Boolean, Datetime, Number, and String.

Step 4: Send Data to MoEngage via S3

Once your S3 bucket is configured to capture exports from Amperity, choose a sync method based on your Amperity product access.

• Sync Queries via Amp360
• Sync Audiences via AmpIQ