> ## Documentation Index
> Fetch the complete documentation index at: https://moengage-doc-2312-standard-user-attributes.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-doc-2312-standard-user-attributes/infPm9BsS1FnrZYA/images/partner_43084946697620.png?fit=max&auto=format&n=infPm9BsS1FnrZYA&q=85&s=6a120192361ca364833f7b51729c0ee0" 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-doc-2312-standard-user-attributes/infPm9BsS1FnrZYA/images/partner_43084946697620.png?w=280&fit=max&auto=format&n=infPm9BsS1FnrZYA&q=85&s=d83be23328f320ed5fbf8ad2b7d113f9 280w, https://mintcdn.com/moengage-doc-2312-standard-user-attributes/infPm9BsS1FnrZYA/images/partner_43084946697620.png?w=560&fit=max&auto=format&n=infPm9BsS1FnrZYA&q=85&s=aacc8b438fa7f04970787cd24d8df6d3 560w, https://mintcdn.com/moengage-doc-2312-standard-user-attributes/infPm9BsS1FnrZYA/images/partner_43084946697620.png?w=840&fit=max&auto=format&n=infPm9BsS1FnrZYA&q=85&s=9b7aee36b8ac508db6c98bf7b1db4436 840w, https://mintcdn.com/moengage-doc-2312-standard-user-attributes/infPm9BsS1FnrZYA/images/partner_43084946697620.png?w=1100&fit=max&auto=format&n=infPm9BsS1FnrZYA&q=85&s=f1dbe7bc804c8b4f083a0e0b8865bd5e 1100w, https://mintcdn.com/moengage-doc-2312-standard-user-attributes/infPm9BsS1FnrZYA/images/partner_43084946697620.png?w=1650&fit=max&auto=format&n=infPm9BsS1FnrZYA&q=85&s=890f82df2491553574ad3b9d6b2c4971 1650w, https://mintcdn.com/moengage-doc-2312-standard-user-attributes/infPm9BsS1FnrZYA/images/partner_43084946697620.png?w=2500&fit=max&auto=format&n=infPm9BsS1FnrZYA&q=85&s=0c8d58b4210ad6c2afa005e29dc53b9d 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-doc-2312-standard-user-attributes/infPm9BsS1FnrZYA/images/partner_43084946698644.png?fit=max&auto=format&n=infPm9BsS1FnrZYA&q=85&s=37a93790180d0c5a2c8e1ec170101de3" 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-doc-2312-standard-user-attributes/infPm9BsS1FnrZYA/images/partner_43084946699924.png?fit=max&auto=format&n=infPm9BsS1FnrZYA&q=85&s=37a4bf61d2a3a1e9995542c994d57d52" 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-doc-2312-standard-user-attributes/infPm9BsS1FnrZYA/images/partner_43084969575828.png?fit=max&auto=format&n=infPm9BsS1FnrZYA&q=85&s=587fcb2c7a6725c868a2be17cff5d6c8" 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-doc-2312-standard-user-attributes/infPm9BsS1FnrZYA/images/partner_43085147292308.png?fit=max&auto=format&n=infPm9BsS1FnrZYA&q=85&s=aa56c7a070824223e242b2b8bb9a999b" 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-doc-2312-standard-user-attributes/vsMNXbmU9fmJjPWh/images/partner_43459030334996.png?fit=max&auto=format&n=vsMNXbmU9fmJjPWh&q=85&s=1dcd062b6fc541b4e52bf00f3896a4ad" 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-doc-2312-standard-user-attributes/vsMNXbmU9fmJjPWh/images/partner_43459030334996.png?w=280&fit=max&auto=format&n=vsMNXbmU9fmJjPWh&q=85&s=8870ae3af7f6ea8ccdd7d7bc437b7406 280w, https://mintcdn.com/moengage-doc-2312-standard-user-attributes/vsMNXbmU9fmJjPWh/images/partner_43459030334996.png?w=560&fit=max&auto=format&n=vsMNXbmU9fmJjPWh&q=85&s=818c32e18664730a62a25488d2d83e45 560w, https://mintcdn.com/moengage-doc-2312-standard-user-attributes/vsMNXbmU9fmJjPWh/images/partner_43459030334996.png?w=840&fit=max&auto=format&n=vsMNXbmU9fmJjPWh&q=85&s=07514f3ddd77f3956d1aad174e72451e 840w, https://mintcdn.com/moengage-doc-2312-standard-user-attributes/vsMNXbmU9fmJjPWh/images/partner_43459030334996.png?w=1100&fit=max&auto=format&n=vsMNXbmU9fmJjPWh&q=85&s=10225c12f1ee8655000e8fdad4a04f65 1100w, https://mintcdn.com/moengage-doc-2312-standard-user-attributes/vsMNXbmU9fmJjPWh/images/partner_43459030334996.png?w=1650&fit=max&auto=format&n=vsMNXbmU9fmJjPWh&q=85&s=356c7a27f4715a9f84dac81fed7c8f57 1650w, https://mintcdn.com/moengage-doc-2312-standard-user-attributes/vsMNXbmU9fmJjPWh/images/partner_43459030334996.png?w=2500&fit=max&auto=format&n=vsMNXbmU9fmJjPWh&q=85&s=9301462cf4f0f710ad9bab31b8415ff8 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-doc-2312-standard-user-attributes/infPm9BsS1FnrZYA/images/partner_43459000846868.png?fit=max&auto=format&n=infPm9BsS1FnrZYA&q=85&s=4cfc175de7df14a4fc9e3d1f082754b3" 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-doc-2312-standard-user-attributes/vsMNXbmU9fmJjPWh/images/partner_43459030335380.png?fit=max&auto=format&n=vsMNXbmU9fmJjPWh&q=85&s=b02a514a49239acbeabca0eb7c25d3a0" 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-doc-2312-standard-user-attributes/vsMNXbmU9fmJjPWh/images/partner_43459030335380.png?w=280&fit=max&auto=format&n=vsMNXbmU9fmJjPWh&q=85&s=5678e957924127de4b22ea37e556e04f 280w, https://mintcdn.com/moengage-doc-2312-standard-user-attributes/vsMNXbmU9fmJjPWh/images/partner_43459030335380.png?w=560&fit=max&auto=format&n=vsMNXbmU9fmJjPWh&q=85&s=f1bba307a623fd6c82fa2bf1542766bd 560w, https://mintcdn.com/moengage-doc-2312-standard-user-attributes/vsMNXbmU9fmJjPWh/images/partner_43459030335380.png?w=840&fit=max&auto=format&n=vsMNXbmU9fmJjPWh&q=85&s=5c60d48e35266b13fdb94aee6b673ae8 840w, https://mintcdn.com/moengage-doc-2312-standard-user-attributes/vsMNXbmU9fmJjPWh/images/partner_43459030335380.png?w=1100&fit=max&auto=format&n=vsMNXbmU9fmJjPWh&q=85&s=487a0f9e7ee9df78e941777b88e17a7b 1100w, https://mintcdn.com/moengage-doc-2312-standard-user-attributes/vsMNXbmU9fmJjPWh/images/partner_43459030335380.png?w=1650&fit=max&auto=format&n=vsMNXbmU9fmJjPWh&q=85&s=cfd09a0c0422a1bbfceb973ed8d8feab 1650w, https://mintcdn.com/moengage-doc-2312-standard-user-attributes/vsMNXbmU9fmJjPWh/images/partner_43459030335380.png?w=2500&fit=max&auto=format&n=vsMNXbmU9fmJjPWh&q=85&s=54526ecc8b21f615acc3da5b2fd2dde4 2500w" />

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

   <img src="https://mintcdn.com/moengage-doc-2312-standard-user-attributes/infPm9BsS1FnrZYA/images/partner_43459000847636.png?fit=max&auto=format&n=infPm9BsS1FnrZYA&q=85&s=1efeca4632ff70e0b6d97c6935d08599" 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-doc-2312-standard-user-attributes/vsMNXbmU9fmJjPWh/images/partner_43459030335892.png?fit=max&auto=format&n=vsMNXbmU9fmJjPWh&q=85&s=7a50f7d9d144e73970f41400deb6f577" 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-doc-2312-standard-user-attributes/vsMNXbmU9fmJjPWh/images/partner_43459030335892.png?w=280&fit=max&auto=format&n=vsMNXbmU9fmJjPWh&q=85&s=f551041197272dc8fd7aa805b2c61d93 280w, https://mintcdn.com/moengage-doc-2312-standard-user-attributes/vsMNXbmU9fmJjPWh/images/partner_43459030335892.png?w=560&fit=max&auto=format&n=vsMNXbmU9fmJjPWh&q=85&s=9b4d4de9ba7acac543a55bdc1698bae7 560w, https://mintcdn.com/moengage-doc-2312-standard-user-attributes/vsMNXbmU9fmJjPWh/images/partner_43459030335892.png?w=840&fit=max&auto=format&n=vsMNXbmU9fmJjPWh&q=85&s=3cbe9fed94d5bc469a7f9c8a7a27ab8d 840w, https://mintcdn.com/moengage-doc-2312-standard-user-attributes/vsMNXbmU9fmJjPWh/images/partner_43459030335892.png?w=1100&fit=max&auto=format&n=vsMNXbmU9fmJjPWh&q=85&s=e8928eb01d26e7f034ab5ead4d1d80c6 1100w, https://mintcdn.com/moengage-doc-2312-standard-user-attributes/vsMNXbmU9fmJjPWh/images/partner_43459030335892.png?w=1650&fit=max&auto=format&n=vsMNXbmU9fmJjPWh&q=85&s=3958d2d5c297cac53aaebd4cb5349ff2 1650w, https://mintcdn.com/moengage-doc-2312-standard-user-attributes/vsMNXbmU9fmJjPWh/images/partner_43459030335892.png?w=2500&fit=max&auto=format&n=vsMNXbmU9fmJjPWh&q=85&s=33c891a5222e2237aa37eb5d6d7b5604 2500w" />

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

   <img src="https://mintcdn.com/moengage-doc-2312-standard-user-attributes/infPm9BsS1FnrZYA/images/partner_43459000848916.png?fit=max&auto=format&n=infPm9BsS1FnrZYA&q=85&s=67a48984661e5b745190d165ccf6956d" alt="Test MoEngage Data Track Data Extension folder" width="1596" height="590" data-path="images/partner_43459000848916.png" />
