> ## Documentation Index
> Fetch the complete documentation index at: https://moengage-unity-sdk-initialization-split.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Send events from MoEngage to SFMC

> Use MoEngage Streams to send campaign interaction events to Salesforce Marketing Cloud Data Extensions for segmentation, personalization, and journey decisioning.

## Integration

<Info>
  **Prerequisites**

  * Follow the steps mentioned in [Set up MoEngage activity in SFMC](/partner-guide/message-orchestration/marketing-cloud/salesforce-marketing-cloud-sfmc/setup-moengage-activity) to set up the MoEngage Custom Activities on Salesforce Marketing Cloud.
  * This is a part of the Streams add-on. Please reach out to your dedicated MoEngage CSM (customer success manager) to get it enabled for your account.
</Info>

### Step 1: Set up Streams on SFMC

To set up streams on SFMC, perform the following steps:

1. Go to the "Homepage".

2. Click on "Web Studio", and then click on "CloudPages".

   <img src="https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43084946697620.png?fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=36705a7369e5e6d0ad5f6f13400c9ec4" alt="Navigating to Web Studio > CloudPages in SFMC" data-og-width="1146" width="1146" data-og-height="616" height="616" data-path="images/partner_43084946697620.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43084946697620.png?w=280&fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=858c9185288bfeafe061b3ecc938470f 280w, https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43084946697620.png?w=560&fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=2ed61c72d3ad26505dbad17e9d80ed0f 560w, https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43084946697620.png?w=840&fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=186eeb9d992a62f540b36ee093a64f07 840w, https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43084946697620.png?w=1100&fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=7174fc105c4fbbb104ee1ee2e27debb9 1100w, https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43084946697620.png?w=1650&fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=e588e13b31396762bbe19a475891b862 1650w, https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43084946697620.png?w=2500&fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=c1da426bb5a45cfa9ff8113271c85d06 2500w" />

3. Click on "CloudPages", then on "MoEngage Credentials" subfolder and finally on "MoEngage Workspace and Data Tracking Credentials".

4. Click on the "arrow" to open the dropdown list and then click on "Edit".

   <img src="https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43084946698644.png?fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=cf98a1452cb962ed99927fb186c55219" alt="Edit option from the dropdown list on the CloudPage" width="1150" height="670" data-path="images/partner_43084946698644.png" />

5. Click on the "Page URL" to open the Authentication Page.

   <img src="https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43084946699924.png?fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=b02bfc66bc005fbc4207b574be073508" alt="Opening the Page URL to access the Authentication Page" width="1050" height="584" data-path="images/partner_43084946699924.png" />

6. Select the "Data Center", then enter the "Workspace Name", "Workspace ID", "Data API Key", and "Campaign/Push API Key" from the MoEngage Platform.

7. Click on "Submit" once all the details are filled.

   <img src="https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43084969575828.png?fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=47a85623cc6e0193a10646556a3db986" alt="Submitting MoEngage workspace credentials in SFMC CloudPage" width="1048" height="484" data-path="images/partner_43084969575828.png" />

8. After submitting the credentials, they will be validated with MoEngage and securely encrypted before being stored in the **Credentials Data Extension**.

9. The second part of the CloudPage focuses on **Data Tracking Credentials**.

10. Please enter your desired **Username** and **Password** for data tracking. This information will be required when raising a support ticket with MoEngage Streams.

    <img src="https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43085147292308.png?fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=231e51de6d6529b291b3e692686b5765" alt="Entering Username and Password for Data Tracking credentials" width="396" height="320" data-path="images/partner_43085147292308.png" />

11. Ensure you remember the password you enter, as it will be encrypted and stored in the **Data Tracking Data Extension** and cannot be retrieved in plain text later.

### Step 2: Set up Streams on MoEngage

To create a [support ticket](/user-guide/contact-support/raise-a-support-ticket-through-moengage-dashboard) with MoEngage, share the following details:

* **Username**: This is the unique identifier assigned to your MoEngage account, used for authentication purposes.
* **Password**: The unencrypted password entered in the **CloudPage**. Although the password is encrypted and stored in the **Data Extension** for security, the unencrypted version is required when raising the support ticket.
* **URL**: The URL of the published MoEngage Campaign Tracking **CloudPage**.

Ensure all information is accurate before sharing it with MoEngage Support.

### Step 3: Activate Streams Data Simplification Automation on SFMC

This process converts the raw event data MoEngage sends into a structured, usable format for SFMC segmentation, personalization, and journey creation.

#### Automation function

The automation performs the following key functions:

* It reads new rows from the Raw MoEngage Data Track Data Extension.
* It parses and simplifies the nested event data JSON.
* It writes the processed records into the final MoEngage Data Track Data Extension.
* It marks the original raw records as processed to prevent data duplication in subsequent runs.

#### Activation steps

To enable the data simplification process in SFMC, perform the following steps:

1. Go to "Automations" and navigate to the "MoEngage-SFMC" folder.

   <img src="https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43459030334996.png?fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=a95373878eb73ae154d9a6c723a2746f" alt="Navigating to Automations > MoEngage-SFMC folder in SFMC" data-og-width="1364" width="1364" data-og-height="726" height="726" data-path="images/partner_43459030334996.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43459030334996.png?w=280&fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=93ab7103700199a9e49a1b03439c29be 280w, https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43459030334996.png?w=560&fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=3d57b0686beac7e84b3bf7d52d3e0f2a 560w, https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43459030334996.png?w=840&fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=fc3342f0995c3d7555b46df6077ee8ce 840w, https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43459030334996.png?w=1100&fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=a1f7371d4a079fabeb8e1eb9ce1020c0 1100w, https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43459030334996.png?w=1650&fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=27149f51b637fdfbb065b6937eef44af 1650w, https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43459030334996.png?w=2500&fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=01ed71bcd957d58bda2b35c1c73569f3 2500w" />

2. Navigate to the Automations tab and open the designated "MoEngage-SFMC" folder.

3. Locate the automation named "MoEngage Streams Data Simplification".

   <Note>
     This automation must be scheduled no more frequently than once every 15 minutes to ensure optimal performance and avoid throttling SFMC resources. A 30-minute or hourly schedule is generally recommended. You can also run it on demand.
   </Note>

   <img src="https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43459000846868.png?fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=ff54c2368809248343bc8590e0e1fd62" alt="MoEngage Streams Data Simplification automation in the folder" width="1578" height="552" data-path="images/partner_43459000846868.png" />

### Step 4: Verify configuration

To verify the configuration, perform the following steps:

1. Confirm all required fields are correctly filled in the **MoEngage Tracking Credentials Data Extension**.
2. Verify that the MoEngage Support team has received the required credentials and that the campaign tracking setup is complete.
3. After MoEngage Streams is configured, interaction data will be sent to the specified **CloudPage** if the **Event Name** is included in the Streams config.
4. Make sure the **Test MoEngage Data Track** Data Extension is set up, so it receives test tracking data from **Streams** via the **CloudPage**.
5. Ensure the **MoEngage Streams Data Simplification** automation is active.
6. Confirm that the **MoEngage Data Track Data Extension** is properly configured and accessible.

### Step 5: View Streams data in SFMC

This section helps you validate that events sent from MoEngage are successfully processed within your SFMC Data Extensions.

#### Simplified Data Target: MoEngage Data Track DE (Data Extension)

This Data Extension stores a simplified version of event data after it has been parsed and processed by the MoEngage Streams Data Simplification automation. Use this Data Extension in your Journey Builder for personalization, decision-making, and so on.

To access the MoEngage Data Track Data Extension, perform the following steps:

1. Go to "Data Extensions" and navigate to the "MoEngage Data Track" folder.

   <img src="https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43459030335380.png?fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=7abe30f14ee007d94575a37a66e93314" alt="Navigating to Data Extensions > MoEngage Data Track folder" data-og-width="1574" width="1574" data-og-height="754" height="754" data-path="images/partner_43459030335380.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43459030335380.png?w=280&fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=0d953907e8e042a0b60a5dd8eeb16069 280w, https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43459030335380.png?w=560&fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=f26abecbdb027eb3acf444c8b88aac20 560w, https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43459030335380.png?w=840&fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=48d19bb93e115263ccd13d90b6fa84c4 840w, https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43459030335380.png?w=1100&fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=2f698da99a8d20c2cc33793946e45101 1100w, https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43459030335380.png?w=1650&fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=3e0f2a3bc424099b0080ac26fff1b2e8 1650w, https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43459030335380.png?w=2500&fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=e37e103eec49d72dd3b02d314839fb70 2500w" />

2. Locate the Data Extension folder named "MoEngage Data Track".

   <img src="https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43459000847636.png?fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=316ae19352a3d241bdb9f743f82b8c18" alt="MoEngage Data Track Data Extension folder" width="1572" height="606" data-path="images/partner_43459000847636.png" />

#### Raw Event Storage: Test MoEngage Data Track DE (Data Extension)

This Data Extension stores the raw event data exactly as received from the MoEngage Streams HTTP POST payload captured in JSON format.

To test the MoEngage Data Track Data Extension (DE), perform the following steps:

1. Go to "Data Extensions", then select "MoEngage Data Track".

   <img src="https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43459030335892.png?fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=247e88af61c776501fdad7df407f0b7f" alt="Navigating to Data Extensions > MoEngage Data Track for testing" data-og-width="1366" width="1366" data-og-height="710" height="710" data-path="images/partner_43459030335892.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43459030335892.png?w=280&fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=df117da01788c4a0d93aa3b2a8590fd0 280w, https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43459030335892.png?w=560&fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=320daad12092db53aff29b2e58f3fdcc 560w, https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43459030335892.png?w=840&fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=38070a2a961c34c2cf89c9eed6931cd2 840w, https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43459030335892.png?w=1100&fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=312dd7047df4e8a9134372c5fe43166f 1100w, https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43459030335892.png?w=1650&fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=343970aacd80b21f6b3f280ec706f59f 1650w, https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43459030335892.png?w=2500&fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=16669dbfff91f104f21325bcd830a526 2500w" />

2. Locate the Data Extension folder named "Test MoEngage Data Track".

   <img src="https://mintcdn.com/moengage-unity-sdk-initialization-split/HZOI6PpkQoBSnt-5/images/partner_43459000848916.png?fit=max&auto=format&n=HZOI6PpkQoBSnt-5&q=85&s=0deaf19baf3676c485877fc7ee6bca24" alt="Test MoEngage Data Track Data Extension folder" width="1596" height="590" data-path="images/partner_43459000848916.png" />
