Skip to content

Create customer events

Use this endpoint to capture user activity throughout a session. A variety of event types are available which can be used to model specific user interactions, such as interacting with an offer, denoting an impression from an Ad and exploring a history of offer redemptions.

Some event types also require a metadata object to be provided in order to accurately represent the behavior being modeled. See the ClientEventMessage type definition for more information.

1
POST /v2/events/clientEvent

Input Parameters

Property Type Required Description
clientEvents ClientEventMessage[] Required A list of client event messages

Output

This endpoint returns an HTTP response indicating success or failure.

Example

Request

1
POST /v2/events/clientEvent

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
{
    "clientEvents": [
        {
            "clientEventId": "dde3b802-10fb-11ee-be56-0242ac120002",
            "clientEventType": "AdImpression",
            "clientEvent": "AdViewableImpression",
            "clientEventTimestamp": "2023-06-22T13:00:16Z",
            "clientEventMetadata": {
                "serveToken": "91e471aed3c04b81bee792f23ad4859d",
                "section": "SMS",
                "channel": "OLB",
                "imageSlots": ["logo", "smallRectangle", "largeRectangle"]
            }
        }
    ]
}

Response

1
2
3
{
    "requestId": "380052b4-3a64-4952-b640-ba696eb9f44b"
}