1. Centre d'aide
  2. Intègre ton application mobile avec Connectif
  3. Ressources pour le développeur
  4. Intégration de l'application mobile via le SDK mobile
  5. Android SDK
  6. Tracking

Android Mobile SDK : Notifier l'événement personnalisé

Création
Mise à jour
S’abonner

L'événement  personnalisé permet de créer des notifications adaptées entre l'eCommerce et Connectif. Pour cela, il notifie via le Mobile SDK, des événements d’ Intégration personnalisée pour recevoir des données dans Connectif, en utilisant les fonctions Connectif.sendCustomEventById() et Connectif.sendCustomEventByAlias(), selon que nous souhaitons identifier les événements par alias ou id.

 

Comment l'utiliser

La notification d’ événements d'intégration personnalisée est effectuée en définissant le champ type à la valeur littérale "custom" et en identifiant l'événement par le paramètre eventAlias (unique dans votre boutique). Le paramètre CustomEvent contiendra, le cas échéant, les champs de l'événement de l'intégration.

Pour construire le paramètre CustomEvent, nous pouvons utiliser les classes héritées de CustomEventValue, qui correspondent aux types de champs que nous pouvons créer dans les Événements personnalisés depuis le Dashboard de Connectif.

CustomEventValue.Text
CustomEventValue.Phone
CustomEventValue.Email
CustomEventValue.Integer
CustomEventValue.Decimal
CustomEventValue.DateTime
CustomEventValue.Boolean
CustomEventValue.MultipleChoice
CustomEventValue.SingleOption

Ce type d'événement collecte automatiquement les informations suivantes :

  • Système d’exploitation : Android ou iOS.
  • Version de l'application.
  • Version du système d’exploitation.
  • Version du Connectif SDK.

Exemple d'utilisation avec un alias d'événement

Étant donné une intégration personnalisée pour recevoir des données, qui est envoyée lorsqu’un contact donne un  Like à un produit, incluant les champs  email ,  productId .

Notifier un événement personnalisé 2023 - 01-min.png

La notification ressemblera à ceci en utilisant CustomEventValue :

Connectif.sendCustomEventByAlias("product-like",
    CustomEvent(
        mapOf(
            "email" to CustomEventValue.Email("test@example.org"),
            "product-id" to CustomEventValue.Text("1234")
        )
    )
)

Nous pouvons également envoyer les champs de l'événement sous forme d'objet anonyme de la manière suivante :

Connectif.sendCustomEventByAlias("product-like",
    object {
       val `email` = "test@example.org"
       val `product-id` = "1234"
    }
)

 

Exemple utilisant l’identifiant de l'événement

En alternative à l'utilisation d'un alias, il est possible d'identifier l'événement à l'aide de son  eventId. L'exemple ci-dessous montre comment procéder (également compatible avec l'envoi de champs sous forme d'objet anonyme) : 

Connectif.sendCustomEventById("635feb9a4168beeaf0ae6a46",
    CustomEvent(
        mapOf(
            "email" to CustomEventValue.Email("test@example.org"),
            "product-id" to CustomEventValue.Text("1234")
        )
    )
)

 

Callbacks (Optionnel)

Si vous souhaitez obtenir un retour sur d'éventuelles erreurs lors de l'envoi d'événements, nous pouvons ajouter un EventCallbacks lorsque nous utilisons notre méthode.  

 object : EventCallbacks {
    override fun onSuccess() {
        //Gestion en cas de succès
    }
    override fun onError(message: String?) {
         //Gestion en cas d'erreur
    }
}

 

 

 

Félicitations !
Vous êtes arrivé à la fin de la leçon.

  

Des questions restées sans réponse ?
Rappelez-vous que nos spécialistes Connectif sont à votre disposition. 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 :