Aangepaste gebeurtenissen maken
U kunt het gebeurtenisplatformuitbreiden door uw eigen storefront gebeurtenissen te creëren om gegevens te verzamelen uniek aan uw industrie. Wanneer u creeert en een douanegebeurtenis vormt, wordt het verzonden naar de Collector van de Gebeurtenissen van Adobe Commerce.
Aangepaste gebeurtenissen afhandelen
Aangepaste gebeurtenissen worden alleen ondersteund voor de Adobe Experience Platform. Aangepaste gegevens worden niet doorgestuurd naar Adobe Commerce-dashboards en metrieke trackers.
Voor elke custom
-gebeurtenis:
- Voegt
identityMap
metECID
toe als primaire identiteit - Omvat
email
inidentityMap
als secundaire identiteit alspersonalEmail.address
in de gebeurtenis wordt geplaatst - Hiermee wordt de volledige gebeurtenis binnen een
xdm
-object geprononceerd voordat deze naar de Edge wordt doorgestuurd
Voorbeeld:
Aangepaste gebeurtenis gepubliceerd via Adobe Commerce Events SDK:
mse.publish.custom({
commerce: {
saveForLaters: {
value: 1,
},
},
});
In Experience Platform Edge:
{
xdm: {
identityMap: {
ECID: [
{
id: 'ecid1234',
primary: true
}
],
email: [
{
id: "runs@safari.ke",
primary: false
}
]
},
commerce: {
saveForLaters: {
value: 1
}
}
}
}
Overschrijvingen van gebeurtenissen afhandelen (aangepaste kenmerken)
Voor elke gebeurtenis die met een customContext
is ingesteld, overschrijft of breidt de verzamelaar de velden in de gebeurtenislading van de velden in de custom context
. Het gebruik van overschrijvingen is mogelijk wanneer een ontwikkelaar contexten die door andere delen van de pagina zijn ingesteld, opnieuw wil gebruiken en uitbreiden in gebeurtenissen die al worden ondersteund.
Overschrijvingen van gebeurtenissen zijn alleen van toepassing wanneer u deze naar Experience Platform doorstuurt. Ze worden niet toegepast op analytische gebeurtenissen van Adobe Commerce en Sensei. De Collector van de Gebeurtenissen van Adobe Commerce READMEverstrekt extra info.
productListItems
uitbreidt met aangepaste kenmerken in Experience Platform-gebeurtenisladingen, dient u producten overeen te laten komen met gebruik van SKU. Deze vereiste geldt niet voor product-page-view
-gebeurtenissen.Gebruik
const mse = window.magentoStorefrontEvents;
mse.publish.productPageView(customCtx);
Voorbeeld 1
In dit voorbeeld wordt aangepaste context toegevoegd bij het publiceren van de gebeurtenis.
magentoStorefrontEvents.publish.productPageView({
productListItems: [
{
productCategories: [
{
categoryID: "cat_15",
categoryName: "summer pants",
categoryPath: "pants/mens/summer",
},
],
},
],
});
Voorbeeld 2
In dit voorbeeld wordt aangepaste context toegevoegd voordat de gebeurtenis wordt gepubliceerd.
const mse = window.magentoStorefrontEvents;
mse.context.setCustom({
productListItems: [
{
productCategories: [
{
categoryID: "cat_15",
categoryName: "summer pants",
categoryPath: "pants/mens/summer",
},
],
},
],
});
mse.publish.productPageView();
Voorbeeld 3
In dit voorbeeld wordt de aangepaste context in de uitgever ingesteld en wordt de aangepaste context overschreven die eerder is ingesteld in de Adobe Client Data Layer.
In dit voorbeeld, zal de pageView
gebeurtenis Naam van de Pagina van de Douane 2 op het web.webPageDetails.name
gebied hebben.
const mse = window.magentoStorefrontEvents;
mse.context.setCustom({
web: {
webPageDetails: {
name: 'Custom Page Name 1'
},
},
});
mse.publish.pageView({
web: {
webPageDetails: {
name: 'Custom Page Name 2'
},
},
});
Voorbeeld 4
In dit voorbeeld wordt aangepaste context toegevoegd aan productListItems
-gebeurtenissen met meerdere producten.
const mse = window.magentoStorefrontEvents;
mse.context.setCustom({
productListItems: [
{
SKU: "24-WB01", //Match SKU to override correct product in event payload
productCategory: "Hand Bag", //Custom attribute added to event payload
name: "Strive Handbag (CustomName)" //Override existing attribute with custom value in event payload
},
{
SKU: "24-MB04",
productCategory: "Backpack Bag",
name: "Strive Backpack (CustomName)"
},
],
});
mse.publish.shoppingCartView();
Opslag op basis van luminantie:
In op een luminantie gebaseerde opslagruimten worden publicatiegebeurtenissen native geïmplementeerd, zodat u aangepaste gegevens kunt instellen door customContext
uit te breiden.
Bijvoorbeeld:
mse.context.setCustom({
web: {
webPageDetails: {
name: 'Custom Page Name'
},
},
});