Hightouch

Introduction

Hightouch is a modern data integration platform that enables you to sync customer, product, or proprietary data from your warehouse or data lake to any app of your choice, all without assistance from your IT or engineering teams.

MoEngage <> Hightouch

The MoEngage and Hightouch integration allows you to build better campaigns on MoEngage with up-to-date customer data from your data warehouse. By automatically syncing users and events into MoEngage, you no longer need to worry about data consistency and can focus on building customer experiences.

Use cases

Sync data about users into MoEngage to build personalized campaigns.
Sync Customer Events from Hightouch into MoEngage to keep the events consistent.
Deliver better experiences by bringing data from other customer touchpoints into MoEngage.

Integration Prerequisites

Ensure you have access to your Hightouch account.
We have revamped our dashboard settings UI. The Data API ID and Data API Key are available in the following navigations in the new and old UIs.
- Revamped UI - You can access the Data API ID in Settings -> Account -> APIs . The Data API ID is the same as the Workspace ID. The Data API Key is available in the same screen in the API Keys -> Data section.
- Old UI -> You can access the Data API ID and Data API Key in Settings -> App Settings -> APIs -> Data API Settings.

Step 1: Create MoEngage destination on Hightouch

On the Hightouch platform, in the Destinations section, click Add destination.
Select MoEngage from the list of available destinations.

Provide your MoEngage API ID and API Secret.

Field

Description

Data API ID

The Data API ID and the Workspace ID of your MoEngage account are the same.

The Workspace ID of your MoEngage account is available in the following navigations in the revamped and old UIs:

Revamped UI: Settings -> Account -> APIs -> Workspace ID.
Old UI: You can find this by navigating to Settings -> App Settings -> APIs -> Data API Settings.

API Secret

API Secret is the Data API Key.

The Data API key of your MoEngage account is available in the following navigations in the revamped and old UIs:

Revamped UI: Settings -> App Settings -> APIs -> API Keys -> Data
Old UI: You can find this by navigating to Settings -> App Settings -> APIs -> Data API Settings.

Screenshot_2022-03-14_at_10.52.39_PM.png

Step 2: Sync users

You can sync Hightouch objects (users) to the MoEngage users. You can also perform record matching to help unify data across the two platforms.

The integration supports upserting users. In this mode, new users will be inserted into MoEngage and all user attributes will be kept up-to-date within MoEngage. Upsert has three configuration parameters:

NAME	DETAILS
Hightouch Column Containing MoEngage User ID	The name of the Hightouch column (id, created_at, first_name) that acts as unique user identifier in MoEngage.
Hightouch to MoEngage Default Field Mappings	A list of common user attributes that will be pushed to new users in MoEngage.
Hightouch to MoEngage Custom Field Mappings	A list of custom user attributes that will be pushed to new users in MoEngage.

Step 3: Sync events

You can now also sync Customer's Events to MoEngage events.

Setting an Event Name

When creating a sync for events, you can specify the name of the event being tracked. You can either input a static name or use a column from your model.

Setting an Event Timestamp

Select a column that is used as the timestamp of when the event happened. If this field is empty, Hightouch will use the time of when the event arrives at the server.

Record Matching

Records can be matched from your source to your MoEngage workspace by Moengage Id.

Field Mapping

Hightouch allows you to sync columns from your source to the supported MoEngage resources.

Custom Field Mapping

Any mappings from this section will be synced as attributes in the event. MoEngage expects custom properties to follow a snake_case format.

For more information, please read the Hightouch docs.