RudderStack lets you send your event data to Engage via the cloud mode.

Identify

You can use the identify call to create or update a user in Engage. To update a user's email, you need to provide the Engage Private Key in the dashboard settings.

RudderStack uses the Create or update a User API to add a new user to your Engage account.

The following table lists the RudderStack attributes and their mappings with the Engage properties:

Deleting a user

You can delete a user in Engage using the Suppression with Delete regulation of the RudderStack Data Regulation API.

A sample regulation request body for deleting a user in Engage is shown below:

Copy
{
  "regulationType": "suppress_with_delete",
  "destinationIds": [
    "2FIKkByqn37FhzczP23eZmURciA"
  ],
  "users": [{
    "userId": "1hKOmRA4GRlm",
    "phone": "+1-202-555-0146",
    "email": "alex@example.com"
  }]
}

RudderStack deletes the user account in Engage using the Delete User API.

Track

The track call lets you capture user events along with the associated properties and send them to Engage.

RudderStack uses the Add User events API to send the user events to Engage.

A sample track call is shown below:

Copy
rudderanalytics.track(
  "Order Completed", {
    revenue: 30,
    currency: "USD",
    userId: "1hKOmRA4el9Z" 
  })

The following table lists the RudderStack attributes and their mappings with the Engage properties:

Page

The page call lets you record your website's page views with any additional relevant information about the viewed page.

RudderStack sends the page-related information to Engage using their Add User events API.

The following table lists the RudderStack event properties and their mappings with the Engage properties:

Group

You can use the group call to link an identified user to a specific Engage list.

RudderStack subscribes the user to the Engage list using their Subscribe to a List API.

A sample group call is shown below:

Copy
rudderanalytics.group("group01", {
"userId": "1",
"name": "Capsule Corp.",
"subscriber_status": "false",
"operation": "add"
});

You can pass the following parameters in the group event along with the userId (if known):

The following table lists the additional property mappings with the Engage properties:

When sending group events to Engage, it is important to note the following:

• To remove a user from a group ("operation": "remove"), you need to provide the userId or externalId in the event.
• If the user's ID is not known, then either email or phone is required for looking up the user in Engage.
• If a user is found with an associated email or phone (in that priority), then Engage links the user to the provided Engage List ID. Otherwise, it creates a new user with the provided details and then links them to the List ID.