Android Mobile SDK : Notifier les informations du panier

L’événement « Notifier les informations du panier »  sert à décrire le panier d'achat qu'un contact possède à un moment donné. Pour cela, il envoie une notification via le Mobile SDK des produits et de l’état du panier d’un contact en utilisant la méthode Connectif.sendCart.

Comment l'utiliser

Cette notification décrit l'intégralité du panier. Connectif détecte automatiquement les modifications et génère les événements appropriés lorsqu’un produit est ajouté ou retiré du panier.

Notifier le panier d’achat

Cet objet représente un panier d’achat complet à un instant donné. Il inclut les propriétés suivantes :

Notifier les produits via Product Basket Item

Cet objet représente les produits, leur quantité et le prix total présents dans un panier d’achat ou une commande.

Il inclut toutes les propriétés du type d’objet Produit (plus d’infos dans Notifier l’événement de produit visité), en plus des suivantes :

Ce type d’événement recueille 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.

Autres considérations

Il est très important d’établir un identifiant de panier ("cartId") et de notifier Connectif également lorsque le panier est vidé, afin d'éviter la génération d'événements de paniers abandonnés.

Exemple

La notification aura cet aspect :

val cart =

    Cart(

        products = listOf(

            ProductBasketItem(

            productDetailUrl = "https://example.com/product/12345",

            productId = "59a31949a1a562d4979fbca2",

            name = "Example Product",

            unitPrice = BigDecimal("96.80"),

            description = "Ceci est un produit exemple",

            imageUrl = "https://example.com/product/images/12345.jpg",

            categories = listOf("Électronique", "Gadgets"),

            tags = listOf("Tendance", "Nouveauté"),

            brand = "ExampleBrand",

            reviewCount = 150,

            rating = BigDecimal("4.5"),

            ratingCount = 124,

            thumbnailUrl = "https://example.com/product/thumbnails/12345.jpg",

            unitPriceOriginal = BigDecimal("120.00"),

            unitPriceWithoutVAT = BigDecimal("80.00"),

            discountedAmount = BigDecimal("23.20"),

            discountedPercentage = BigDecimal("19.33"),

            publishedAt = Date(),

            customField1 = "Édition spéciale",

            customField2 = "Stock limité",

            customField3 = "En ligne uniquement",

            price = BigDecimal("51.88"),

            quantity = 2

            )

        ),

        totalQuantity = 2,

        totalPrice = BigDecimal("193.60"),

        cartId = "cart-0098caf9-42f4-44e9-afdd-45eafe892293",

    )

Connectif.sendCart(cart)

Callbacks (Optionnel)

Si vous souhaitez obtenir un retour d’information 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
    }
}

Poursuivez votre apprentissage !

Pour tirer pleinement parti de votre compte Connectif, nous vous recommandons de continuer avec les articles suivants :

• Android SDK Get Started, pour ajouter Connectif Mobile SDK à votre projet Android.
• Configuration Firebase Cloud Messaging, pour activer l’envoi et la réception de notifications push via le Mobile SDK Android.