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. iOS SDK
  6. Tracking

iOS Mobile SDK : Notifier les informations du panier

Création
Mise à jour
S’abonner

L' événement "Notifier les informations du panier" sert à décrire le panier d'achat du contact à un moment donné. Pour cela, il notifie via le Mobile SDK les produits et 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 se charge de détecter les modifications et de générer les événements appropriés lorsque l’on ajoute ou retire un produit 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 :

Nom Obligatoire Type Description
cartId Oui String Identifiant unique du panier.
totalQuantity Oui Int Quantité totale de produits dans le panier.
totalPrice Oui Int Prix total du panier.
products Oui Product Basket Item Articles contenus dans le panier, avec leur quantité et leur montant.
cartRecoveryUrl Non Cart recovery url URL associée au panier à partir de laquelle son contenu peut être récupéré. Elle doit être une URL valide et ne peut pas dépasser 1 000 caractères.


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 de l’objet Produit (plus d’informations sur Notifier un événement de produit visité), en plus des suivantes :

Nom Obligatoire Type Description
quantity Oui Int Quantité d’unités de ce produit.
price Oui Int Prix total des produits représentés par cet objet Product Basket Item. Il est généralement égal à quantity * unitPrice.


Autres considérations

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

L' événement "Notifier les informations du panier" sert à décrire le panier d'achat du contact à un moment donné. Pour cela, il notifie via le Mobile SDK les produits et l’état du panier d’un contact en utilisant la méthode Connectif.sendCart.

 

Exemple

La notification aura cet aspect :

let productBasketItem = ProductBasketItem(
    productDetailUrl: "https://example.com/product/12345",
    productId: "59a31949a1a562d4979fbca2",
    name: "Example Product",
    unitPrice: Decimal(51.88),
    description: "This is an example product",
    imageUrl: "https://example.com/product/images/12345.jpg",
    availability: "instock",
    categories: ["Electronics", "Gadgets"],
    tags: ["Trending", "New Arrival"],
    brand: "ExampleBrand",
    reviewCount: 150,
    rating: Decimal(4.5),
    ratingCount: 124,
    thumbnailUrl: "https://example.com/product/thumbnails/12345.jpg",
    relatedExternalProductIds: ["54321", "67890"],
    priority: 10,
    unitPriceOriginal: Decimal(120.00), 
    unitPriceWithoutVAT: Decimal(80.00), 
    discountedAmount: Decimal(20.00), 
    discountedPercentage: Decimal(16.67),
    publishedAt: Date(),
    customField1: "Special Edition",
    customField2: "Limited Stock",
    customField3: "Online Only",
    price: Decimal(51.88),
    quantity: 1
)

let cart = Cart(
    products: [productBasketItem],
    totalQuantity: 1,
    totalPrice: Decimal(51.88),
    cartId: "cart-0098caf9-42f4-44e9-afdd-45eafe892293"
)

Connectif.sendCart(cart)

 

Callbacks (Optionnel)

Si nous souhaitons recevoir un retour sur d'éventuelles erreurs lors de l'envoi des événements, nous pouvons ajouter un EventCallbacks lorsque nous utilisons 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.

  

Des questions non résolues ?
Rappelez-vous que nos spécialistes Connectif sont disponibles pour vous aider. Pour les contacter, ouvrez simplement 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 :