Créer des événements personnalisés

Vous pouvez étendre la plateforme d’événement en créant vos propres événements storefront afin de collecter des données propres à votre secteur d’activité. Lorsque vous créez et configurez un événement personnalisé, il est envoyé au Collecteur d’événements Adobe Commerce.

Gestion des événements personnalisés

Les événements personnalisés ne sont pris en charge que pour Adobe Experience Platform. Les données personnalisées ne sont pas transférées vers les tableaux de bord et les dispositifs de suivi des mesures Adobe Commerce.

Pour tout événement custom, le collecteur :

  • Ajoute identityMap avec ECID comme identité principale
  • Inclut email dans identityMap comme identité secondaire si personalEmail.address est défini dans l’événement
  • Envoie l’événement complet dans un objet xdm avant le transfert vers Edge

Exemple :

Événement personnalisé publié via le SDK Adobe Commerce Events :

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

Dans Experience Platform Edge :

{
  xdm: {
    identityMap: {
      ECID: [
        {
          id: 'ecid1234',
          primary: true
        }
      ],
      email: [
        {
          id: "runs@safari.ke",
          primary: false
        }
      ]
    },
    commerce: {
        saveForLaters: {
            value: 1
        }
    }
  }
}
NOTE
L’utilisation d’événements personnalisés peut affecter les rapports Adobe Analytics par défaut.

Gestion des remplacements d’événements (attributs personnalisés)

Les remplacements d’attributs pour les événements standard sont pris en charge pour l’Experience Platform uniquement. Les données personnalisées ne sont pas transférées vers les tableaux de bord et les outils de suivi des mesures Commerce.

Pour tout événement avec customContext, le collecteur remplace les champs définis dans les contextes appropriés avec les champs dans customContext. Le cas d’utilisation des remplacements est lorsqu’un développeur souhaite réutiliser et étendre des contextes définis par d’autres parties de la page dans des événements déjà pris en charge.

NOTE
Lors du remplacement d’événements personnalisés, le transfert d’événement vers l’Experience Platform doit être désactivé pour ce type d’événement afin d’éviter un double comptage.

Exemples :

Consultation produit avec remplacements publiés via le SDK Adobe Commerce Events :

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

Dans 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
Le remplacement d’événements avec des attributs personnalisés peut affecter les rapports Adobe Analytics par défaut.
recommendation-more-help
6bf243c8-c8c6-4074-826f-546af445e840