建立自訂事件

Last update: Mon Sep 15 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
個人化
事件

建立對象：

管理員
開發人員

您可以建立自己的店面活動來收集產業獨有的資料，以擴充事件平台。當您建立和設定自訂事件時，會傳送到Adobe Commerce事件收集器。

處理自訂事件

僅支援Adobe Experience Platform的自訂事件。自訂資料不會轉送到Adobe Commerce儀表板和量度追蹤器。

對於任何custom事件，收集器：

將具有identityMap的ECID新增為主要身分
在email中包含identityMap以作為次要身分如果 personalEmail.address已設定在事件中
在轉送至Edge之前，先包裝xdm物件內的完整事件

範例：

透過Adobe Commerce Events SDK發佈的自訂事件：

mse.publish.custom({
    commerce: {
        saveForLaters: {
            value: 1,
        },
    },
});

在Experience Platform Edge中：

{
  xdm: {
    identityMap: {
      ECID: [
        {
          id: 'ecid1234',
          primary: true
        }
      ],
      email: [
        {
          id: "runs@safari.ke",
          primary: false
        }
      ]
    },
    commerce: {
        saveForLaters: {
            value: 1
        }
    }
  }
}

NOTE

使用自訂事件可能會影響預設的Adobe Analytics報表。

處理事件覆寫（自訂屬性）

對於使用customContext設定的任何事件，收集器會覆寫或延伸custom context中欄位之事件裝載中的欄位。覆寫的使用案例是當開發人員想要重複使用和擴充由頁面其他部分在已支援的事件中設定的內容時。

事件覆寫僅適用於轉送至Experience Platform時。它們不會套用至Adobe Commerce和Sensei分析事件。 Adobe Commerce事件收集器README提供其他資訊。

NOTE

使用Experience Platform事件裝載中的自訂屬性增加productListItems時，請使用SKU比對產品。此要求不適用於product-page-view個事件。

使用情況

const mse = window.magentoStorefrontEvents;

mse.publish.productPageView(customCtx);

範例1

此範例會在發佈事件時新增自訂內容。

magentoStorefrontEvents.publish.productPageView({
    productListItems: [
        {
            productCategories: [
                {
                    categoryID: "cat_15",
                    categoryName: "summer pants",
                    categoryPath: "pants/mens/summer",
                },
            ],
        },
    ],
});

範例2

此範例會在發佈事件之前新增自訂內容。

const mse = window.magentoStorefrontEvents;

mse.context.setCustom({
  productListItems: [
    {
      productCategories: [
        {
          categoryID: "cat_15",
          categoryName: "summer pants",
          categoryPath: "pants/mens/summer",
        },
      ],
    },
  ],
});

mse.publish.productPageView();

範例3

此範例會在發佈程式中設定自訂內容，並覆寫先前在Adobe使用者端資料層中設定的自訂內容。

在此範例中，pageView事件在 欄位中會有 自訂頁面名稱2web.webPageDetails.name。

const mse = window.magentoStorefrontEvents;

mse.context.setCustom({
  web: {
    webPageDetails: {
      name: 'Custom Page Name 1'
    },
  },
});

mse.publish.pageView({
  web: {
    webPageDetails: {
      name: 'Custom Page Name 2'
    },
  },
});

範例4

此範例將自訂內容新增至具有多個產品的productListItems事件。

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();

Luma商店：

Luma型存放區以原生方式實作發佈事件，因此您可以延伸customContext來設定自訂資料。

例如：

mse.context.setCustom({
  web: {
    webPageDetails: {
      name: 'Custom Page Name'
    },
  },
});

NOTE

使用自訂屬性覆寫事件可能會影響預設的Adobe Analytics報表。

recommendation-more-help

1dd1eb92-da61-46c0-8ff9-3831f21eb23e