L’événement « Notifier un achat réalisé » est utilisé pour décrire un achat effectué par le client. Pour cela, il envoie une notification via le SDK Mobile lorsqu’un utilisateur finalise un achat en utilisant la méthode sendPurchase.
Comment l’utiliser
La notification des informations d’achat utilise la méthode Connectif.sendPurchase(purchase: Purchase), dans laquelle nous ajouterons la propriété purchase contenant toutes les informations relatives à l’achat.
Notifier l’achat effectué
Cet objet représente le modèle du Panier d’achat, qui inclut les propriétés suivantes :
| Nom | Obligatoire | Type | Description |
|---|---|---|---|
| purchaseId | Oui | String | Identifiant unique de l’achat. |
| cartId | Oui | String | Identifiant unique du panier à l’origine de cet achat. |
| totalQuantity | Oui | Int | Quantité totale de produits dans l’achat (y compris les doublons). |
| totalPrice | Oui | Decimal | Montant total de l’achat. |
| purchaseDate | Non | Date | Date de l’achat. |
| paymentMethod | Non | String | Moyen de paiement. |
| products | Oui | Product Basket Item | Produits inclus dans l’achat, avec leurs quantités et montants. |
| source_name | Non | String | Nom de la source pour donner un contexte sur le type d’origine de l’achat. |
| source_type | Non | String | Nom de la source où l’achat a eu lieu. Valeurs possibles : « marketplace », « digital-store », « point-of-sale », « third-party » et « other ». |
Organisation des valeurs de source (source_type)
Ci-dessous l’explication de chacune des valeurs possibles du champ source_type :
| Valeur | Description | Exemple |
|---|---|---|
| marketplace | Plateformes e-commerce tierces sur lesquelles vous publiez vos produits. | Amazon Marketplace, eBay, Zalando… |
| digital-store | Ventes depuis le site web ou l’app e-commerce du commerçant. | Direct, recherche organique, recherche payante, email marketing… |
| pont-of-sale | Ventes en boutique physique via système de caisse (POS). | Caisse en magasin, borne interactive, pop-up store… |
| third-party | Ventes par des distributeurs, revendeurs ou partenaires (hors marketplaces). | Vente en gros, distributeurs, affiliés… |
| other | Cas particuliers ou canaux ne correspondant pas aux catégories précédentes. | Télévente, salons, commerce social… |
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 SDK Connectif.
Exemple
La notification aura l’aspect suivant :
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",
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",
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",
quantity: 1,
price: Decimal(51.88)
)
let purchase = Purchase(
purchaseId: "purchase-e3418b5a-8709-4593-a7c8-d8a7f12df737",
products: [productBasketItem],
totalQuantity: 1,
totalPrice: Decimal(51.88),
cartId: "cart-0098caf9-42f4-44e9-afdd-45eafe892293",
paymentMethod: "Credit Card",
purchaseDate: Date()
)
Connectif.sendPurchase(purchase)
Callbacks (optionnel)
Pour obtenir un retour en cas d’erreur lors de l’envoi des événements, vous pouvez ajouter EventCallbacks à l’utilisation de la méthode.
EventCallbacks(
onSuccess: {
// Succès
},
onError: { error in
// Erreur
})Félicitations !
Vous êtes arrivé(e) au bout de cette leçon.
Des doutes ?
N’oubliez pas que nos spécialistes Connectif sont à votre disposition. Pour les contacter, il vous suffit d’ouvrir un ticket via le bouton bleu « Aide » de votre tableau de bord.
Continuez à apprendre !
Pour tirer le meilleur parti de votre compte Connectif, nous vous recommandons les articles suivants :
- Commencer avec le SDK Android, pour intégrer le SDK Mobile Connectif dans votre projet Android.
- Configurer Firebase Cloud Messaging, pour activer l’envoi et la réception de push via le SDK Android.
- Commencer avec le SDK iOS, pour intégrer le SDK Mobile Connectif dans votre projet iOS.
- Configurer Apple Push Notification Service, pour activer les pushs via le SDK iOS.