Create a MoEngage Events stream source

What this is

A MoEngage Events stream source brings data into Zeotap CDP. MoEngage streams the engagement events recorded on its platform out to Zeotap CDP, where they are ingested and can be mapped to the Catalogue and used alongside the rest of your customer data. For more about the integration, see Moengage Source. For the opposite direction — sending data out of Zeotap CDP to MoEngage — use a MoEngage destination instead: Moengage to sync users and send events from a journey, or Moengage Audience to sync an audience. Creating the source is the Zeotap CDP half of the integration. It generates two values — an API URL and a write key — that are needed to complete the integration on the MoEngage side. No MoEngage credentials are entered in Zeotap CDP.

Prerequisites

Before you start, confirm the following:

An active MoEngage account, and access within it to configure MoEngage Streams for your workspace. The MoEngage-side configuration is what starts the flow of events.
Access to the Sources application under Integrate in the Zeotap CDP app, so you can create a source.
The region and the data entity for this source, decided in advance. Both are required on the create form, and the data entity determines whether the source is treated as customer data or non customer data. See Supported Data Entities.

Create the MoEngage Events stream source

Open the Sources application

Log into the Zeotap CDP app and navigate to the Sources application under Integrate.

Start a new source

Click CREATE SOURCE.

Choose Customer Engagement Channels as the category

On the Data Source step, choose Customer Engagement Channels.

The CREATE SOURCE dialog on the Data Source step, listing the source categories with Customer Engagement Channels selected

Choose MoEngage Events stream as the data source

In the list of customer engagement channels, select MoEngage Events stream.

The customer engagement channel list in the CREATE SOURCE dialog, with the MoEngage Events stream entry selected

Enter the source details

On the Source Details step:

In Source Name, enter a short, descriptive name for the source.
Under Select your Region, select a region using the option button provided. The form links to a document that maps a country to a region if you are unsure which to pick.
Under Data Entity, depending on the type of data that you want to ingest, choose either Customer Data or Non Customer Data. To know more, refer to Supported Data Entities.

The Source Details step of the CREATE SOURCE dialog, showing the Source Name field, the Select your Region option buttons and the Data Entity option buttons

Create the source

Click CREATE SOURCE. On successful creation, an API URL and a write key are generated for this source and appear under its IMPLEMENTATION DETAILS tab. Both are essential to complete the integration.

The IMPLEMENTATION DETAILS tab of a MoEngage Events stream source, showing the source status alongside its data entity and region, above the Access Details section

Connect MoEngage to the source

Open the source and note the two values on its IMPLEMENTATION DETAILS tab:

The API URL establishes the connection between MoEngage and Zeotap CDP.
The write key is used to securely ingest data from MoEngage into Zeotap CDP.

Both values are generated for this source alone, so keep them to the MoEngage configuration that uses them. The same tab carries in-product instructions, under HOW TO INTEGRATE WITH MOENGAGE, that begin with logging in to your MoEngage account. Follow those to configure the events stream on the MoEngage side; that configuration is not documented here.

Verify the source is receiving data

The source’s status on the Sources listing tells you how far the integration has progressed:

Status	What it means
Created	The source exists in Zeotap CDP but has not received any data yet.
Integrated	Data has started flowing into the source, but taxonomy standardisation has not been applied yet. You can preview the incoming data on the source’s PREVIEW DATA tab.
Mapped	At least one data collection has been created on top of the integrated source, based on the common taxonomy.

For the full set of statuses and the other columns on the listing, see Components of the Source Listing Page. Once the status reaches Integrated, check the data itself:

The PREVIEW DATA tab shows a sample of the data that has been received. See Components of the Preview Data Tab.
The SOURCE REPORT tab gives the ingestion health and status of the source. See Exploring Source Reports.

Troubleshoot the source

What you see	What it means	What to do
The source stays at Created and no data arrives	The source has been created, but nothing has been sent to it yet	Confirm the MoEngage-side configuration uses the API URL and write key shown on this source’s IMPLEMENTATION DETAILS tab
No preview is available on the PREVIEW DATA tab	An error message is displayed stating the reason	Fix the issue reported and try again after some time, and confirm the source is implemented correctly
Records are arriving but some are rejected	There are errors in the data received, before Catalogue mapping — for example missing column names or a file format issue	Use View Error Log on the PREVIEW DATA tab to review the errors

If you need further assistance, contact Zeotap support at support@zeotap.com with the source name and its ID from the Sources listing.

​What this is

​Prerequisites

​Create the MoEngage Events stream source

​Connect MoEngage to the source

​Verify the source is receiving data

​Troubleshoot the source

​Next steps