[Tech] Streaming events via API

4 min

In this exercise we will use a streaming connection to ingest XDM-formatted JSON records in real-time to the Adobe Experience Platform.

We will use Postman to send these events to the Streaming endpoint.

In our example, we will send a product purchase event to the dataset Demo System - Event Dataset for Website (Global v1.1)

Open Postman and expand the Collection.
Select the POST request Sending Events via Streaming API (Product View).
Click on Body to see the JSON payload we are sending.

You will see that the payload is in the XDM format as defined by the Schema. We've included:

The product list items array to give context to which product has been viewed.
The timestamp which specifies when the product view event occured.
The event type which is recognised as the product view event in AEP.
The _id which is the unique ID of the event.
The Schema and Dataset IDs for where we want to send the data.

The full payload:

{
    "header": {
        "schemaRef": {
            "id": "https://ns.adobe.com/demopotemea/schemas/d9b88a044ad96154637965a97ed63c7b20bdf2ab3b4f642e",
            "contentType": "application/vnd.adobe.xed-full+json;version=1.0"
        },
        "imsOrgId": "8AB51935659C10E40A495FA2@AdobeOrg",
        "datasetId": "681b32239973b72aefce2bdc",
        "source": {
            "name": "Streaming dataflow - Website Events"
        }
    },
    "body": {
        "xdmMeta": {
            "schemaRef": {
                "id": "https://ns.adobe.com/demopotemea/schemas/d9b88a044ad96154637965a97ed63c7b20bdf2ab3b4f642e",
                "contentType": "application/vnd.adobe.xed-full+json;version=1.0"
            },
            "identityMap": {
                "Ecid": [
                    {
                        "id": "58603221885344320682417072105764913825",
                        "primary": true
                    }
                ]
            }
        },
        "xdmEntity": {
            "_demopotemea": {
                "identification": {
                    "core": {
                        "ecid": "58603221885344320682417072105764913825"
                    }
                },
                "interactionDetails": {
                    "core": {
                        "channel": "api"
                    }
                }
            },
            "_id": "wk1hsz97v160632289959130",
            "commerce": {
                "productViews": {
                    "value": 1
                }
            },
            "environment": {
                "type": "external"
            },
            "eventType": "commerce.productViews",
            "implementationDetails": {
                "environment": "server",
                "name": "https://ns.adobe.com/experience/alloy",
                "version": "1.2"
            },
            "productListItems": [
                {
                    "SKU": "35345958",
                    "name": "valladolid-v-girona",
                    "quantity": 1,
                    "productAddMethod": "api",
                    "_demopotemea": {
                        "core": {
                            "description": "spanish-la-liga > valladolid-v-girona",
                            "mainCategory": "Football"
                        }
                    }
                }
            ],
            "timestamp": "2025-05-13T13:20:39+00:00"
        }
    }
}

Click Send to execute this request and send the event to the Experience Platform.
You will see a response with status 200 OK if the event has been received successfully.

You can now check the Dataset Activity UI to see if your event has been ingested successfully.

Navigate to Datasets from the main left hand navigation.
Click the dataset Demo System - Event Dataset for Website (Global v1.1).
Look in the recent batches for successfully ingested records.
Select Preview Dataset to see what data has been ingested, look for your product view event.

With this, you’ve now successfully ingested product view events to Adobe Experience Platform via the Streaming API!