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, navigate to Integrations > Partners, and select Enable on the Amplitude modal.

4. Select Edit from the Outbound Data Settings options.

5. Paste in your Amplitude API key.

Set upload limits

In Outbound Data Settings, you can set upload limits to control how Cordial uploads data to Amplitude. In case your data job experiences throttling, you can choose to Use Batch API in case of throttling.

The Growth and Enterprise option is only available to customers subscribed to that service through Amplitude.

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 Edit 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": "mailgun",
        "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
}