# Selligent Marketing Cloud Destination

## Destination Info

* Accepts [Page](/docs/segment/connections/spec/page), [Alias](/docs/segment/connections/spec/alias), [Group](/docs/segment/connections/spec/group), [Identify](/docs/segment/connections/spec/identify), [Track](/docs/segment/connections/spec/track) calls.
* Refer to it as **Selligent Marketing Cloud** in the [Integrations object.](/docs/segment/guides/filtering-data/#filtering-with-the-integrations-object)
* This integration is **partner owned.** Please reach out to the partner's support for any issues.

[Selligent Marketing Cloud](https://www.selligent.com/?utm_source=segment\&utm_medium=integrations-page\&utm_campaign=partners/) is a highly integrated, AI-powered omnichannel marketing automation platform which enables ambitious B2C marketers to maximize every moment of interaction with today's connected consumers. Delivers ultra-personalized, highly relevant customer experiences across channels and devices, providing value swiftly and at scale.

This Destination is maintained by *Selligent Marketing Cloud*. For any issues with the Destination, please reach out to their [Support team](https://support.selligent.com)

> \[!TIP]
>
> **Good to know**: This page is about the Selligent Marketing Cloud Segment destination, which receives data from Segment. There's also a page about the [Selligent Marketing Cloud Segment source](/docs/segment/connections/sources/catalog/cloud-apps/selligent-marketing-cloud/), which sends data *to* Segment!

## Getting Started

Before you enable Selligent Marketing Cloud in your Destination page, validate with your Selligent CSM that the segment components needed to start receiving information from the connector are set up on your account.

1. Login into your *Selligent Marketing Cloud* environment.
2. Within the *Selligent Marketing Cloud* module click the wheel icon at the bottom-left corner to access the general configuration panel:

   ![Selligent Marketing Cloud dashboard showing no data available for My Pins, Live Messages, Recently Sent, and Recent Drafts.](https://docs-resources.prod.twilio.com/97b5cd58fb12dfb637e27fc2499df3fa7577f28afa4557eb5d84edda022be69a.png)
3. Navigate to the "Access Management" tab and select "Service Accounts":

   ![Access Management tab with Service Accounts section in Selligent Marketing Cloud.](https://docs-resources.prod.twilio.com/f6c61f7a0a9bdc153102f68301c318a4fbe0ea6bb51e3f9ae86458dfcd1cc8d5.png)
4. To create a new account click on the "New" icon:

   ![Admin configuration screen showing service accounts with a highlighted 'New' button.](https://docs-resources.prod.twilio.com/efe3d0d9ecd3cc0f909d0e618e6f4570450666148f801b34ef073ad3fa4d454d.png)
5. Provide a "Name" and choose the type "Custom", confirm by clicking the Save button.
6. Set an expiration date. This indicates the period the key will be valid before it needs to be refreshed.
7. Copy the Key and Secret provided and click the save button:

   ![Admin configuration showing token expiration warning and expiration date set to 12 months.](https://docs-resources.prod.twilio.com/7980d51a561a95c270e1e23dab34494fd26893fcfc6d2ca30e8cdcba2e72c1a8.png)

You can then proceed to configure your destination.

1. From your Segment UI's Destinations page click on "Add Destination".
2. Search for "*Selligent Marketing Cloud*" within the Destinations Catalog and confirm the Source you'd like to connect to.
3. Enter the "*API Key*" and "*API Secret*" into your Segment Settings UI.
4. *SMC Admin URL* - Copy the link you use to log into the SMC admin should look like `https://{you company}.slgnt.us`

   ![Selligent Marketing Cloud homepage with My Pins section highlighted.](https://docs-resources.prod.twilio.com/463b2a54126a5e20ff16238f0e912d0f2f58d506523e46522b5659385563f8e5.png)
5. *Organization* - You will find the organization name on the top-right hand corner next to the menu icon.

   ![Selligent Marketing Cloud home screen with Segment Connector highlighted.](https://docs-resources.prod.twilio.com/e8e7f2f38b8b914ce5abff45a73edf3b9f589531bb82dcd60ba7845c2ea46ca1.png)
6. *Allowed Events* - Add the `track` event names that you would like to allowlist or send to SMC
7. *Events data list API name* - The default value is **segment\_events**, if you have any issue regarding the property please contact the *Selligent Marketing Cloud* [Support team](https://support.selligent.com).

## Identify

If you haven't had a chance to review the Segment spec, please take time to review and to understand what the [`identify` method](/docs/segment/connections/spec/identify/) does.

An example call can look like:

```js
analytics.identify('userId123', {
    property1: 1,
    property2: 'test',
    property3: true
});
```

The `userId` field, `userId123`, is mapped to the Business Key defined for the SMC database.

Identify calls will be sent to *Selligent Marketing Cloud* as an `identify` event.

## Track

If you haven't had a chance to review the Segment spec, please take time to review to understand what the [`track` method](/docs/segment/connections/spec/track/) can do.

An example call can look like:

```js
analytics.track('userId123', {
    property1: 1,
    property2: 'test',
    property3: true
});
```

Track calls will be sent to *Selligent Marketing Cloud* as a `track` event.

## Group

If you haven't had a chance to review the Segment spec, please take time to review to understand what the [`group` method](/docs/segment/connections/spec/group/) can do.

An example call can look like:

```json
{
  "type": "group",
  "groupId": "SegmentToSMCStatic",
  "userId": "segmenttest@selligent.com",
  "traits": {
    "matchkey": "MAIL",
    "method": "ADD",
    "userlist": "USERS_SEGMENT"
  }
}
```

Segment sends Group calls to *Selligent Marketing Cloud* as a `group` event. These calls are used to populate static segments in the *Selligent Marketing Cloud* platform. The static segment must be created in Selligent Marketing Cloud before you can use it. The call should adhere the above example and contain the following elements:

* groupId: The *api\_name* of the static segment to populate
* userId: The value on which the matching to populate the segment should happen
* traits:
  * matchkey: this is a mandatory trait and should contain the name of the field in the userlist on which the matching should be done
  * method: this trait is optional and indicates either a remove call or an add call to the *Selligent Marketing Cloud* segment. The two values possible are REMOVE or ADD but it will default to ADD. So it's only needed in case of a remove call
  * userlist: this is a mandatory trait and should contain the *api\_name* of the userlist in *Selligent Marketing Cloud*

## Alias

If you haven't had a chance to review the Segment spec, please take time to review to understand what the [`alias` method](/docs/segment/connections/spec/alias/) can do.

An example call can look like:

```js
analytics.alias("507f191e81");
```

Track calls will be sent to *Selligent Marketing Cloud* as a `alias` event.

## Page

If you haven't had a chance to review the Segment spec, please take time to review to understand what the [`page` method](/docs/segment/connections/spec/page/) can do.

An example call can look like:

```js
analytics.page("Home");
```

Track calls will be sent to *Selligent Marketing Cloud* as a `page` event.

## Screen

If you haven't had a chance to review the Segment spec, please take time to review to understand what the [`screen` method](/docs/segment/connections/spec/screen/) can do.

An example call in Objective C can look like:

```objc
[[SEGAnalytics sharedAnalytics] screen:@"Home"
                            properties:@{ @"Feed Type": @"private" }];
```

Track calls will be sent to *Selligent Marketing Cloud* as a `screen` event.

## Engage

You can send computed traits and audiences generated using [Engage](/docs/segment/engage) to this destination as a **user property**. To learn more about Engage, schedule a [demo](https://segment.com/contact/demo).

For user-property destinations, an [identify](/docs/segment/connections/spec/identify/) call is sent to the destination for each user being added and removed. The property name is the snake\_cased version of the audience name, with a true/false value to indicate membership. For example, when a user first completes an order in the last 30 days, Engage sends an Identify call with the property `order_completed_last_30days: true`. When the user no longer satisfies this condition (for example, it's been more than 30 days since their last order), Engage sets that value to `false`.

When you first create an audience, Engage sends an Identify call for every user in that audience. Later audience syncs only send updates for users whose membership has changed since the last sync.

> \[!NOTE]
>
> Real-time audience syncs to Selligent Marketing Cloud  may take six or more hours for the initial sync to complete. Upon completion, a sync frequency of two to three hours is expected.

## Settings

Segment lets you change these destination settings from the Segment app without having to touch any code.

| Field                     | Description                                                                                           | Required | Type    |
| ------------------------- | ----------------------------------------------------------------------------------------------------- | -------- | ------- |
| Allowed Events            | Add the track event names that you would like sent to SMC (or whitelisted)                            | Yes      | array   |
| API Key                   | Your API Key can be found in the admin configuration settings under apps                              | Yes      | string  |
| API Secret                | Your API Secret can be found in the admin configuration settings under apps                           | Yes      | string  |
| Events Data List API Name | Enter a description.                                                                                  | Yes      | string  |
| Organization              | Enter a description.                                                                                  | Yes      | string  |
| Send Alias Events         | Track Alias Events                                                                                    | No       | boolean |
| Send Group Events         | Track Group Events                                                                                    | No       | boolean |
| Send Page Events          | Track Page Events                                                                                     | No       | boolean |
| Send Screen Events        | Track Screen Events                                                                                   | No       | boolean |
| SMC Admin URL             | Just copy the link you use to log into the SMC admin should look like https://\{you company}.slgnt.us | Yes      | string  |
