Overview

With the Amplitude integration, you can send event and contact data from Cordial to Amplitude, giving your teams self-service product data to understand users, drive conversions, and increase engagement, growth, and revenue. 

You can also send cohorts of contacts from Amplitude to Cordial.

Event data

As events fire in Cordial, they are automatically sent to Amplitude. The data events listed on our system events reference page (along with all supporting metadata and contact identifiers) are included in the Amplitude integration.

Enable and authenticate Cordial as a source

Follow the steps below to enable Cordial to send data to Amplitude.

1. Ensure the HTTP API source is created for Cordial.

2. In your Amplitude account, navigate to Integrations and copy the Amplitude API key.

3. Ensure the Amplitude feature is enabled in your Cordial account. Request access from your CSM. 

4. Log in to Cordial, select Marketplace from the dropdown menu in the upper right corner, and select Enable on the Amplitude modal.

4. Select Configure from the Outbound Data Settings options, and then paste in your Amplitude API key.

Send data to Amplitude

Configure your Outbound Contact Settings and Data Settings to send the desired data to Amplitude. 

The Cordial Identifier that will be sent as the User ID to Amplitude is available in Outbound Contact Settings.

Configure allowed and blocked events

You can choose to block or allow specific events in each channel by selecting Configure in the Outbound Data Settings row. By default, Block all events is set for each case.

To prevent recursion, any event records that have Amplitude as their origin will be automatically blocked from getting sent back to Amplitude.

Data example

Below is an example of a message sent in Cordial and passed to Amplitude.

{
    "$insert_id": "99126-62a9c9791e435c700549ca7c",
    "$row_source": "realtime",
    "$schema": 12,
    "_time": 1655294334985,
    "adid": null,
    "amplitude_attribution_ids": null,
    "amplitude_event_type": null,
    "amplitude_id": 415960451260,
    "app": 374803,
    "city": null,
    "client_event_time": "2022-06-15T11:58:54.985",
    "client_upload_time": "2022-06-15T11:58:54.985",
    "country": "United States",
    "data": {
        "group_first_event": {},
        "group_ids": {}
},
    "device_brand": null,
    "device_carrier": null,
    "device_family": null,
    "device_id": "668ef082-1cb5-594a-ae3a-46dbdd7c5d2d",
    "device_manufacturer": null,
    "device_model": null,
    "device_type": null,
    "display_name": "message-sent",
    "dma": null,
    "event_id": 138837676,
    "event_properties": {
        "_id": "62a9c9791e435c700549ca7c",
        "action": "message-sent",
        "bmID": "99126:62a9c961fbaf2e35be325db7:ot",
        "cID": "62a9c94365136823cc63c76f",
        "chnl": "email",
        "chnl-type": "email",
        "mcID": "99126:62a9c961fbaf2e35be325db7:ot:62a9c94365136823cc63c76f:1",
        "name": "batch_383369841",
        "sp.ed": "gmail.com",
        "sp.mTags.0": "batch_383369841",
        "sp.stp": "sparkpost",
        "sp.tpIPpool": "shared2",
        "subject": "batch_383369841"
},
    "event_time": "2022-06-15T11:58:54.985",
    "event_type": "message-sent",
    "group_properties": {},
    "groups": {},
    "idfa": null,
    "ip_address": null,
    "is_attribution_event": false,
    "language": null,
    "library": "http/2.0",
    "location_lat": null,
    "location_lng": null,
    "os": "Apache-HttpClient/4.5.10 (Java/11.0.10)",
    "os_name": "Apache-HttpClient/4.5.10",
    "os_version": "(Java/11.0.10)",
    "partner_id": null,
    "paying": null,
    "plan": {},
    "platform": null,
    "region": null,
    "sample_rate": null,
    "server_received_time": "2022-06-15 11:58:54.985000",
    "server_upload_time": "2022-06-15T11:58:54.991",
    "session_id": -1,
    "start_version": null,
    "timeline_hidden": false,
    "user_creation_time": "2022-06-15T11:58:02.877",
    "user_id": "crdlqa+220615741121127@gmail.com",
    "user_properties": {
        "cordial_cID": "62a9c94365136823cc63c76f",
        "cordial_channels.email.address": "crdlqa+220615741121127@gmail.com",
        "cordial_channels.email.ss": "s"
},
    "uuid": "88f1470b-eca2-11ec-80ea-0a258bce7d9b",
    "version_name": null
}