[Alleen PaaS]{class="badge informative" title="Is alleen van toepassing op Adobe Commerce op Cloud-projecten (door Adobe beheerde PaaS-infrastructuur) en op projecten in het veld."}

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 met ECID toe als primaire identiteit
  • Omvat email in identityMap als secundaire identiteit als personalEmail.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
        }
    }
  }
}
NOTE
Het gebruik van aangepaste gebeurtenissen kan invloed hebben op standaard Adobe Analytics-rapporten.

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.

NOTE
Wanneer u 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'
    },
  },
});
NOTE
Het overschrijven van gebeurtenissen met aangepaste kenmerken kan van invloed zijn op standaard Adobe Analytics-rapporten.
recommendation-more-help
1dd1eb92-da61-46c0-8ff9-3831f21eb23e