Skip to content

Commit 90c68a2

Browse files
Coordial Action destination doc updates
1 parent 5bf5352 commit 90c68a2

File tree

1 file changed

+4
-4
lines changed
  • src/connections/destinations/catalog/actions-cordial

1 file changed

+4
-4
lines changed

src/connections/destinations/catalog/actions-cordial/index.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ hide-dossier: true
1515
Cordial (Actions) provides the following benefits over the classic Cordial destination:
1616

1717
- **Transparent data mapping**. Classic Cordial destination receives data from Segment as is. Cordial backend then converts those Segment events to Cordial's format and clients have limited control over this conversion. Cordial (Actions) destination allows clients to fully define their own mappings of Segment events, making sure they receive data structured specifically for their needs.
18-
- **Sending only the data you need**. With Cordial (Actions) you can define only those destination actions and mappings that make sense for your use cases while Cordial Classic always sends four predefined API calls: identify, track, group, and page.
18+
- **Sending only the data you need**. With Cordial (Actions) you can define only those destination actions and mappings that make sense for your use cases, while Cordial Classic always sends four predefined API calls: identify, track, group, and page.
1919
- **Sending Personas components to Cordial**. With Cordial (Actions) it is possible to define action mappings that will send audiences and user computed traits defined in Segment Personas platform to Cordial.
2020

2121
## Getting started
@@ -34,17 +34,17 @@ Cordial (Actions) provides the following benefits over the classic Cordial desti
3434

3535
### User Identities Mappings
3636

37-
Every Cordial destination action needs to be invoked with a data identifying a Cordial contact. To identify a contact every destination action has `User Identities` field, which maps Segment event fields to Cordial contact identifiers. Each entry in the list represents a contact identifier and how it maps from a Segment event. For example, `channels.email.address <- userId` or `customerId <- traits.customerId`. At least one identifier should be valid otherwise the contact will not be identified and the request will be ignored.
37+
Every Cordial destination action needs to be invoked with data identifying a Cordial contact. To identify a contact every destination action has a `User Identities` field, which maps Segment event fields to Cordial contact identifiers. Each entry in the list represents a contact identifier and how it maps from a Segment event. For example, `channels.email.address <- userId` or `customerId <- traits.customerId`. At least one identifier should be valid, otherwise the contact will not be identified and the request will be ignored.
3838

39-
Typically `User Identities` field will map Segment event's `userId` field to Cordial secondary identifier field. For example, if Segment's `userId` field is known to be an email, the mapping will be `channels.email.address <- userId`, meaning the value of `userId` will be sent as `channels.email.address` to Cordial.
39+
Typically `User Identities` field will map Segment event's `userId` field to Cordial secondary identifier field. For example, if Segment's `userId` field is known to be an email, the mapping will be `channels.email.address <- userId`, meaning the value of `userId` will be sent as `channels.email.address` to Cordial.
4040

4141
### Updating contacts
4242

4343
If you plan to create and update contacts in Cordial, define `upsertContact` destination action. In addition to `User Identities` field, the action defines `Contact Attributes` field. This field defines an exclusive set of attributes that will be updated in a contact. Typically you map them from Segment traits, for example, `customerId <- traits.customerId`. For Cordial Classic destination these mappings are stored in Cordial's database, for Cordial (Actions) destination they become explicit in the `upsertContact` destination action mappings.
4444

4545
### Sending events
4646

47-
To send events define `createContactactivity` destination action. In addition to `User Identities` field, it defines additional fields such as `Event name`, `Event timestamp`, and `Event properties`. Refer to documentation for each field when defining the destination action.
47+
To send events define `createContactactivity` destination action. In addition to `User Identities` field, additional fields such as `Event name`, `Event timestamp`, and `Event properties` may be defined. Refer to documentation for each field when defining the destination action.
4848

4949
### Adding users to and removing from lists
5050

0 commit comments

Comments
 (0)