L'événement personnalisé sert à créer des notifications adaptées entre l’eCommerce et Connectif. Pour cela, il notifie via le Mobile SDK les événements d’ Intégration personnalisée pour recevoir des données dans Connectif, au moyen des fonctions Connectif.sendCustomEventById() et Connectif.sendCustomEventByAlias(), selon que l’on souhaite identifier les événements par alias ou id.
Comment l'utiliser
La notification d’ événements d’intégration personnalisée se fait en définissant le champ type avec la valeur littérale "custom" et en identifiant l’événement par le paramètre eventAlias (unique dans votre boutique). Dans le paramètre CustomEvent se trouveront, s’il y en a, les champs de l’événement d’intégration.
Pour construire le paramètre CustomEvent, nous pouvons utiliser les classes qui héritent de CustomEventValue, qui correspondent aux types de champs pouvant être créés dans les événements personnalisés depuis le tableau de bord Connectif.
CustomEventValue.Text
CustomEventValue.Phone
CustomEventValue.Email
CustomEventValue.Integer
CustomEventValue.Decimal
CustomEventValue.DateTime
CustomEventValue.Boolean
CustomEventValue.MultipleChoice
CustomEventValue.SingleOption
Exemple utilisant l’alias de l’événement
Étant donné une intégration personnalisée pour recevoir des données, envoyée lorsqu’un contact met un Like à un produit, incluant les champs email, productId.
La notification aura cet aspect en utilisant CustomEventValue:
Connectif.sendCustomEventByAlias("product-like", CustomEvent(values: [
"email": .email("test@example.org"),
"product-id": .text("+123456789")
])
Exemple utilisant l'identifiant de l'événement
En alternative à l’utilisation de l’alias, il est possible d’identifier l’événement par son eventId. L’exemple suivant montre comment l’utiliser (également compatible avec l’envoi de champs en tant qu’objet anonyme) :
Connectif.sendCustomEventById("635feb9a4168beeaf0ae6a46", CustomEvent(values: [
"email": .email("test@example.org"),
"product-id": .text("+123456789")
])
Callbacks (Optionnel)
Si nous souhaitons recevoir un retour d’information sur d’éventuelles erreurs lors de l’envoi d’événements, nous pouvons ajouter un EventCallbacks lors de l’utilisation de notre méthode.
EventCallbacks(
onSuccess: {
// Gestion en cas de succès
},
onError: { error in
// Gestion en cas d'erreur
})
Félicitations !
Vous êtes arrivé à la fin de la leçon.
Avez-vous encore des questions non résolues ?
Rappelez-vous que nos spécialistes Connectif sont disponibles pour vous aider. Pour les contacter, il vous suffit d’ouvrir un ticket de support en cliquant sur le bouton bleu "Aide" de votre tableau de bord.
Continuez à apprendre !
Pour exploiter pleinement le potentiel de votre compte Connectif, nous vous recommandons de poursuivre avec les articles suivants :
- Android SDK Get Started, pour ajouter le Connectif Mobile SDK à votre projet Android.
- Configuration de Firebase Cloud Messaging, pour activer l’envoi et la réception des notifications push via le Mobile SDK Android.
- iOS SDK Get Started, pour ajouter le Connectif Mobile SDK à votre projet iOS.
- Configuration d’Apple Push Notifications Service, pour activer l’envoi et la réception des notifications push via le Mobile SDK iOS.