L’evento “Notificare evento di acquisto effettuato” serve a descrivere un acquisto effettuato dal cliente. A tale scopo, invia una notifica tramite il Mobile SDK quando un utente effettua un acquisto utilizzando il metodo sendPurchase.
Come si usa
La notifica delle informazioni di acquisto utilizza il metodo Connectif.sendPurchase(purchase: Purchase), nel quale si aggiunge la proprietà purchase con tutte le informazioni dell’acquisto.
Notificare l’acquisto effettuato
Questo oggetto rappresenta il modello del Carrello, che include le seguenti proprietà:
| Nome | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
| purchaseId | Sì | String | Identificatore univoco dell’acquisto. |
| cartId | Sì | String | Identificatore univoco del carrello da cui è stato generato l’acquisto. |
| totalQuantity | Sì | Int | Quantità totale di prodotti nell’acquisto (inclusi i duplicati). |
| totalPrice | Sì | Decimal | Importo totale dell’acquisto. |
| purchaseDate | No | Date | Data dell’acquisto. |
| paymentMethod | No | String | Metodo di pagamento. |
| products | Sì | Product Basket Item | Prodotti inclusi nell’acquisto con quantità e importo. |
| source_name | No | String | Nome della fonte, per fornire contesto sul tipo di canale d’acquisto. |
| source_type | No | String | Nome del canale d’acquisto. Valori possibili: “marketplace”, “digital-store”, “point-of-sale”, “third-party” e “other”. |
Organizzazione dei valori della fonte (source_type)
Qui sotto sono spiegati i valori possibili del campo source_type:
| Valore | Descrizione | Esempio |
|---|---|---|
| marketplace | Piattaforme e-commerce di terze parti dove pubblichi i tuoi prodotti. | Amazon Marketplace, eBay, Zalando… |
| digital-store | Vendite dal sito o app e-commerce del rivenditore. | Diretto, ricerca organica, ricerca a pagamento, email marketing… |
| pont-of-sale | Vendite in negozi fisici elaborate con sistema POS. | Cassa in negozio, chiosco, pop-up store… |
| third-party | Vendite tramite distributori, rivenditori o reti partner (non marketplace). | Vendita all’ingrosso, distributori, affiliati… |
| other | Casi particolari o canali non inclusi nelle categorie precedenti. | Teleselling, fiere, social commerce… |
Questo tipo di evento raccoglie automaticamente le seguenti informazioni:
- Sistema operativo: Android o iOS.
- Versione dell’app.
- Versione del sistema operativo.
- Versione del Connectif SDK.
Esempio
La notifica sarà simile a questa:
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 (Opzionale)
Per ottenere feedback su possibili errori nell’invio degli eventi, puoi aggiungere EventCallbacks quando utilizzi il metodo.
EventCallbacks(
onSuccess: {
// Successo
},
onError: { error in
// Errore
})Complimenti!
Hai completato la lezione.
Hai ancora dubbi?
Ricorda che i nostri specialisti Connectif sono a tua disposizione. Per contattarli, clicca sul pulsante blu “Aiuto” nella tua dashboard.
Continua a imparare!
Per sfruttare al meglio il tuo account Connectif, ti consigliamo i seguenti articoli:
- Introduzione a SDK Android, per integrare il Mobile SDK di Connectif nel tuo progetto Android.
- Configurazione Firebase Cloud Messaging, per attivare notifiche push nel SDK Android.
- Introduzione a SDK iOS, per integrare il Mobile SDK di Connectif nel tuo progetto iOS.
- Configurazione Apple Push Notification Service, per abilitare notifiche push nel SDK iOS.