Criar eventos personalizados

Você pode estender a plataforma de eventos criando seus próprios eventos de vitrine eletrônica para coletar dados exclusivos de seu setor. Quando você cria e configura um evento personalizado, ele é enviado para o Coletor de Eventos da Adobe Commerce.

Lidar com eventos personalizados

Eventos personalizados são compatíveis somente com o Adobe Experience Platform. Os dados personalizados não são encaminhados para painéis e rastreadores de métricas do Adobe Commerce.

Para qualquer evento custom, o coletor:

  • Adiciona identityMap com ECID como identidade primária
  • Inclui email em identityMap como uma identidade secundária se personalEmail.address estiver definido no evento
  • Envolve o evento completo dentro de um objeto xdm antes de encaminhar para a Edge

Exemplo:

Evento personalizado publicado pelo SDK de eventos da Adobe Commerce:

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

No Experience Platform Edge:

{
  xdm: {
    identityMap: {
      ECID: [
        {
          id: 'ecid1234',
          primary: true
        }
      ],
      email: [
        {
          id: "runs@safari.ke",
          primary: false
        }
      ]
    },
    commerce: {
        saveForLaters: {
            value: 1
        }
    }
  }
}
NOTE
O uso de eventos personalizados pode afetar os relatórios padrão do Adobe Analytics.

Lidar com substituições de eventos (atributos personalizados)

As substituições de atributo para eventos padrão são compatíveis somente com o Experience Platform. Os dados personalizados não são encaminhados para painéis e rastreadores de métricas do Commerce.

Para qualquer evento com customContext, o coletor substitui campos de junções definidos em contextos relevantes por campos em customContext. O caso de uso para substituições é quando um desenvolvedor deseja reutilizar e estender contextos definidos por outras partes da página em eventos já compatíveis.

NOTE
Ao substituir eventos personalizados, o encaminhamento de eventos para o Experience Platform deve ser desativado para esse tipo de evento para evitar contagem dupla.

Exemplos:

Exibição de produto com substituições publicadas pelo SDK de eventos do Adobe Commerce:

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

No Experience Platform Edge:

{
  xdm: {
    eventType: 'commerce.productViews',
    identityMap: {
      ECID: [
        {
          id: 'ecid1234',
          primary: true,
        }
      ]
    },
    commerce: {
      productViews: {
        value : 1,
      }
    },
    productListItems: [{
        SKU: "1234",
        name: "leora summer pants",
        productCategories: [{
            categoryID: "cat_15",
            categoryName: "summer pants",
            categoryPath: "pants/mens/summer",
        }],
    }],
  }
}
NOTE
Substituir eventos por atributos personalizados pode afetar os relatórios padrão do Adobe Analytics.
recommendation-more-help
6bf243c8-c8c6-4074-826f-546af445e840