Introduction

Steps

Setup MoEngage Custom Activity 

1. Login to your Salesforce Marketing Cloud (SFMC)
2. Access SFMC settings 
   
3. Once you click on “Installed Packages”, this tab will be visible on the right side of the page 
   
4. Create a new package
5. Add package details. You can name it "MoEngage Custom Activity" and add description as "Used to send one-time push notifications and run Event Trigger campaigns."  
   
6. Add MoEngage Components
   
7. Click Add Component
   
8. Select “Journey Builder Activity” and click on “Next”.
   
9. Click Save. 
10. Repeat the same steps for MoEngage Event Destination. 
    

Setup Cloud page and Data Extension 

You need to setup a cloud page along with data extension to capture MoEngage workspace details. These can then be used while configuring a MoEngage destination in Journey Builder. 

1. Navigate to SFMC Home page 
2. Click “Platform” >> “Package Manager”. 
   
   Once you click on the “Package Manager”, it will be redirected to the Package Manager page.
3. Click on “Deployment” tab
4. Click "Deploy"
   
5. Upload JSON 
   [Optional] If applicable, select a “CloudPages Domain” and click “Next”.
   
6. The system will validate the setup and check for any issues. Once validated, click Deploy. 
   
   

   Publish Data Extensions and CloudPages

7. Go to the “Homepage”
8. Click on “Web Studio”, and then click on “CloudPages”
   
9. Once you click “CloudPages”, it will be directed to this page. Click on “CloudPages”, then on “MoEngage Data Tracking” subfolder and finally on “MoEngage Campaign Tracking CloudPage”.
10. Click on the “arrow”to open the dropdown list and then click on “Edit”.
    
11. Click on “Save” and then on “Schedule/Publish”.
    
12. Return to the “CloudPages” page, click on “MoEngage Credentials” subfolder and then on “User Authentication Page”.
13. Click on the “arrow”to open the dropdown list and then click on “Edit”
    
14. Click on “Save” and then on “Schedule/Publish”.
    

Verify Data Extension and External Keys

Ensure the following Data Extensions (DEs) are properly named and configured:

A. MoEngage Tracking Data

It stores campaign tracking information.

1. 1. Go to the “Homepage”
   2. Click on “Audience Builder”, and then click on “Contact Builder”.
      
      
   3. Select “Data Extensions” tab
      
   4. Click on “Data Extensions” folder, and then click on “MoEngage Data Track” subfolder.
   5. Select “MoEngage Tracking data” extension.
      
      Here you can find the “External Key”, please ensure it is accurate. [Optional] If external key needs to be entered or changed, click on “External Key” input field, paste or enter the external key and click on “Done”.

B. MoEngage Credentials

It stores the credential for the Data Tracking CloudPage

1. 1. Go to the “Homepage”
   2. Click on “Audience Builder”, andthen click on “Contact Builder”.
      
      
   3. Select “Data Extensions” tab.
   4. Click on “Data Extensions” folder, and then click on “MoEngage Data Track” subfolder.
   5. Select “MoEngage Tracking Credential”
      
      Here you can find the “External Key”, please ensure it is accurate. [Optional] If external key needs to be entered or changed, click on “External Key” input field, paste or enter the external key and click on “Done”.

C. MoEngage Event Activity Log

It logs Event Custom Activity information.

1. Go to the “Homepage”
2. Click on “Audience Builder”, andthen click on “Contact Builder”.
   
3. Select “Data Extensions” tab.
4. Click on “Data Extensions” folder, and then click on “MoEngage Event DE”” subfolder.
5. Select “MoEngage Tracking Credential”
   
   
6. Select “MoEngage Event Activity Log”

D. MoEngage Push Activity Log

It logs Push Custom Activity information. 

1. Go to the “Homepage”
2. Click on “Audience Builder”, andthen click on “Contact Builder”.
   
3. Select “Data Extensions” tab.
4. Click on “Data Extensions” folder, and then click on “MoEngage Push DE”” subfolder.
5. Select “MoEngage MoEngage Push Activity Log”
   

Connect your MoEngage Workspace

A. Access the credentials cloud page 

On your SFMC dashboard, 

1. Navigate to “Web Studio” >> “CloudPages” >> “MoEngage Credentials” subfolder. Finally click on “MoEngage Authentication Page”. Click Edit.
2. Click on the “Page URL” to open the Authentication Page. 
   
3. Enter details of your MoEngage workspace. And click Submit. 

   Field	Value
   Data center	Select your MoEngage data center. Refer to the guide here for details- https://help.moengage.com/hc/en-us/articles/360057030512-Data-Centers-in-MoEngage
   Workspace Name	Enter your workspace name. Its present in the header on your MoEngage dashboard.
   Workspace ID	Navigate to Settings >> Accounts >> APIs.
   Data API key
   Campaign (Push) API Key

   [Optional] Once done, you can also validate if the newly added workspace is present in the Data Extension.