Create Custom Events

You can extend the eventing platform by creating your own storefront events to collect data unique to your industry. When you create and configure a custom event, it is sent to the Adobe Commerce Events Collector.

Handle Custom Events

Custom events are supported for the Adobe Experience Platform only. Custom data is not forwarded to Adobe Commerce dashboards and metrics trackers.

For any custom event, the collector adds a personId (ecid) to customContext and wraps an xdm object around it before forwarding to the Edge.

Example:

Custom event published through Adobe Commerce Events SDK:

mse.publish.custom({
    customContext: { customStrAttr: "cheetah", customNumAttr: 128 },
});

In Experience Platform Edge:

{
    xdm: {
        personId: 'ecid1234',
        customStrAttr: 'cheetah',
        customNumAttr: 128
    }
}

Handle Event Overrides (custom attributes)

Attribute overrides for standard events are supported for the Experience Platform only. Custom data is not forwarded to Commerce dashboards and metrics trackers.

For any event with a set customContext, the collector overrides personId and Adobe Analytics counters, and forwards all other attributes set in customContext.

Examples:

Product view with overrides published though Adobe Commerce Events SDK:

mse.publish.productPageView({
    customContext: { customCode: "okapi" },
});

In Experience Platform Edge:

{
    xdm: {
        eventType: 'commerce.productViews',
        personId: 'ecid1234',
        customCode: 'okapi',
        commerce: {
            productViews: {
                value : 1
            }
        }
    }
}

Product view with Adobe Commerce overrides published though Adobe Commerce Events SDK:

mse.publish.productPageView({
    customContext: { commerce: { customCode: "mongoose" } },
});

In Experience Platform Edge:

{
    xdm: {
        eventType: 'commerce.productViews',
        personId: 'ecid1234',
        commerce: {
            customCode: 'mongoose',
            productViews: {
                value : 1
            }
        }
    }
}

Business.Adobe.com resources