Skip to main content

​
Introduction

This guide provides detailed instructions for creating a MoEngage Event custom activity in SFMC.
Prerequisites
  • Salesforce Marketing Cloud Access: Ensure you have access to SFMC.

​
Integration

The integration leverages MoEngage event custom activity in SFMC to trigger an Event Triggered Campaign on MoEngage.
ContextDescription
MoEngage Event Triggered CampaignThese allow you to automatically send personalized messages (like push, email, or SMS) when a specific event is tracked in MoEngage. These campaigns can be configured to send immediately after the event happens (for example, an order confirmation) or after a specific delay, potentially based on a sequence of events.
MoEngage Event Activity in SFMCMoEngage event custom activity is a component added to the SFMC canvas. When a contact reaches this activity in a journey, it triggers a specified event via MoEngage’s event API, which in turn registers an event against that contact in MoEngage.
So, when a contact reaches this activity in a journey, it sends an event to MoEngage, which can then initiate related campaigns configured within MoEngage.

​
Steps

​
Step 1: Create a MoEngage Event Triggered Campaign

Refer to the guide here to create an event triggered campaign in MoEngage. You can choose an event that you want to send from SFMC as your trigger criteria. Any personalisation that you want to use in the campaign content can be passed from SFMC as event attribute.

​
Step 2: Configure MoEngage Event

  1. In your SFMC journey, drag and drop the “MoEngage Event” activity. Drag and drop MoEngage Event activity in SFMC
  2. Click on “MoEngage Event”.
  3. Fill in the relevant details for the Event.
FieldField nameDescription
Workspace detailsWorkspace NameEnter your workspace name. It is present in the header on your MoEngage dashboard.

Workspace name displayed in the MoEngage dashboard header

Note: Workspace name must be the same as the one entered on the “MoEngage User Authentication Page” CloudPage. To verify the Workspace name, go to the Data Extension titled “MoEngage Credentials DE” and open “MoEngage Credentials”.
Event DetailsEvent NameName of the event that you have used to create an Event Triggered campaign in MoEngage.

Note: Ensure the Event Name matches the Event Trigger Campaign.
Event DetailsUser IdentifierSelect the attribute and value that needs to be used to identify the user in MoEngage.
Event AttributesCampaign ID [Optional]ID of your event triggered campaign on MoEngage. You can use this as a filter criteria while creating your campaign. This is only to ensure that you are triggering the right campaign.
Event AttributesCampaign Name [Optional]Name of your event triggered campaign on MoEngage. You can use this as a filter criteria while creating your campaign. This is only to ensure that you are triggering the right campaign.
Event AttributesCustom Attributes [Optional]Any other data points from your SFMC Data Extension that needs to be passed to MoEngage for hyper-personalisation or targeting.
  • Key Value pairs can be added manually.
  • Structure:
    • Key: Type in the key name that you want to be available as an event attribute in MoEngage.
    • Value: It can be a hardcoded value or any value from the Data Extension specific to the contact.
    • Dynamic value format: You can use the Data Extension field name in mustache syntax, formatted as {{Field Name}}.
Note: Ensure that the field name exactly matches the target DE. If the field name is correct, it will populate with the corresponding value from the target DE; otherwise, it will display the placeholder {{Field Name}} as is.
Once the custom activity is set up, you can continue with your Journey.

​
Step 3: View campaign on MoEngage

You can navigate to the All Campaigns page and view all the created campaigns. These will be created as API triggered Push Campaigns on MoEngage.