[PaaS uniquement]{class="badge informative" title="S’applique uniquement aux projets Adobe Commerce on Cloud (infrastructure PaaS gérée par Adobe) et aux projets On-premise."}

Créer des événements personnalisés

Vous pouvez étendre la plateforme d’événements en créant vos propres événements de storefront pour 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.

Gérer les événements personnalisés

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

Pour tout événement custom, le collecteur :

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

Exemple :

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

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.

Gérer les remplacements d’événement (attributs personnalisés)

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

Pour tout événement avec customContext, le collecteur remplace les champs de jointure définis dans les contextes appropriés par des champs dans customContext. Le cas d’utilisation des remplacements se présente 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 Experience Platform doit être désactivé pour ce type d’événement afin d’éviter un double comptage.

Exemples :

Vue de produit avec remplacements publiée via Adobe Commerce Events SDK :

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 des événements par des attributs personnalisés peut affecter les rapports Adobe Analytics par défaut.
recommendation-more-help
1dd1eb92-da61-46c0-8ff9-3831f21eb23e