Creare eventi personalizzati

Puoi estendere la piattaforma di gestione eventi creando i tuoi eventi storefront per raccogliere dati specifici per il tuo settore. Quando crei e configuri un evento personalizzato, questo viene inviato all'Agente di raccolta eventi di Adobe Commerce.

Gestire eventi personalizzati

Gli eventi personalizzati sono supportati solo per Adobe Experience Platform. I dati personalizzati non vengono inoltrati alle dashboard di Adobe Commerce e ai tracker di metriche.

Per qualsiasi evento custom, l'agente di raccolta:

  • Aggiunge identityMap con ECID come identità primaria
  • Include email in identityMap come identità secondaria se personalEmail.address è impostato nell'evento
  • Racchiude l'evento completo all'interno di un oggetto xdm prima di inoltrarlo ad Edge

Esempio:

Evento personalizzato pubblicato tramite SDK eventi di Adobe Commerce:

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

Nell’Experience Platform Edge:

{
  xdm: {
    identityMap: {
      ECID: [
        {
          id: 'ecid1234',
          primary: true
        }
      ],
      email: [
        {
          id: "runs@safari.ke",
          primary: false
        }
      ]
    },
    commerce: {
        saveForLaters: {
            value: 1
        }
    }
  }
}
NOTE
L’utilizzo di eventi personalizzati può influire sui rapporti predefiniti di Adobe Analytics.

Gestire le sostituzioni di eventi (attributi personalizzati)

Le sostituzioni di attributo per gli eventi standard sono supportate solo per l’Experience Platform. I dati personalizzati non vengono inoltrati alle dashboard e ai tracciatori delle metriche di Commerce.

Per qualsiasi evento con customContext, l'agente di raccolta sostituisce i campi di join impostati nei contesti rilevanti con i campi in customContext. Il caso d’uso per le sostituzioni si verifica quando uno sviluppatore desidera riutilizzare ed estendere i contesti impostati da altre parti della pagina in eventi già supportati.

NOTE
Quando si esegue l’override di eventi personalizzati, l’inoltro di eventi ad Experience Platform deve essere disattivato per quel tipo di evento per evitare un doppio conteggio.

Esempi:

Visualizzazione prodotto con sostituzioni pubblicate tramite SDK per eventi di Adobe Commerce:

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

Nell’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
La sostituzione di eventi con attributi personalizzati può influire sui rapporti predefiniti di Adobe Analytics.
recommendation-more-help
6bf243c8-c8c6-4074-826f-546af445e840