Skip to content

Real-Time Messaging

Overview

Cardlytics supports a Real-Time Messaging (RTM) interface that posts certain events to publishers as soon as they are made available. As a publisher, you can use these events to drive a variety of marketing workflows in order to better engage your customers with the offers program.

How to Set up RTM

To set up RTM, you'll need to set an endpoint in your app to consume RTM events. Once you have done that, you can coordinate with Cardlytics to begin sending events to that endpoint. Contact your designated Cardlytics implementation consultant for more information.

Supported RTM Events

Redemption Notification

Property Type Description
event RealtimeMessagingEventType Type of RTM event
eventId string Unique uuid associated with the RTM event
eventTimestamp string ISO 8601 timestamp representing when the redemption event occurred
redemptions Redemption[] List of redemptions

Example

The following example represents a confirmed redemption event.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
{
    "event": "REDEMPTION_CONFIRMED",
    "eventId": "380052b4-3a64-4952-b640-ba696eb9f44b",
    "eventTimestamp": "2023-04-29T11:06:55.000Z",
    "redemptions": [
        {
            "redemptionId": "992745",
            "adId": "123",
            "amount": 5.00,
            "redemptionDate": "2023-03-21T12:58:34Z",
            "sourceCustomerId": "609a180c-c896-4ccb-8ef6-8b24fd6ef32b",
            "sourceAccountId": "388836454",
            "redeemingTransactionAmount": 34.46,
            "transactionId": "929994552",
            "rewardSettlementRunDate": "2023-03-23T10:44:23Z"
        }
    ]
}