1. Centro assistenza
  2. Integra la tua App Mobile con Connectif
  3. Risorse per lo sviluppatore
  4. Integrazione dell'app mobile tramite Mobile SDK
  5. Android SDK
  6. Tracking

Android Mobile SDK: Notificare informazioni sul carrello

Creato
Aggiornato
Segui

Android Mobile SDK: Notificare informazioni sul carrello

L’evento “Notificare informazioni sul carrello” serve a descrivere il carrello della spesa che il contatto possiede in un determinato momento. A tale scopo, notifica tramite Mobile SDK i prodotti e lo stato del carrello di un contatto utilizzando il metodo Connectif.sendCart.

 

Come si usa

Questa notifica descrive il carrello completo; Connectif rileva le modifiche e genera gli eventi appropriati quando un prodotto viene aggiunto o rimosso dal carrello.

 

Notificare il carrello della spesa

Questo oggetto rappresenta un carrello della spesa completo in un determinato istante. Include le seguenti proprietà:

Nome Obbligatoria Tipo Descrizione
cartId Sì String Identificatore univoco del carrello.
totalQuantity Sì Int Quantità totale di prodotti presenti nel carrello.
totalPrice Sì Int Prezzo totale del carrello.
products Sì Product Basket Item Articoli contenuti nel carrello, insieme alla relativa quantità e all’importo.
cartRecoveryUrl No Cart recovery url URL associato al carrello dal quale è possibile recuperarne il contenuto. Deve essere un URL valido e non può superare i 1000 caratteri.

 

Notificare i prodotti tramite Product Basket Item

Questo oggetto rappresenta i prodotti, la relativa quantità e il prezzo totale presenti in un carrello della spesa o in un acquisto.

Include tutte le proprietà del tipo di oggetto Prodotto (maggiori informazioni in Notificare l’evento di prodotto visitato), oltre alle seguenti:

Nome Obbligatoria Tipo Descrizione
quantity Sì Int Quantità di unità di questo prodotto.
price Sì Int Prezzo cumulativo dei prodotti rappresentati da questo Product Basket Item. Di solito corrisponde a quantity * unitPrice.

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.

 

Altre considerazioni

È molto importante impostare un identificatore del carrello ("cartId") e notificare Connectif anche quando il carrello viene svuotato, per evitare che vengano generati eventi di carrelli abbandonati.

 

Esempio

La notifica sarà simile a questa:

val cart =
    Cart(
        products = listOf(
            ProductBasketItem(
            productDetailUrl = "https://example.com/product/12345",
            productId = "59a31949a1a562d4979fbca2",
            name = "Example Product",
            unitPrice = BigDecimal("96.80"),
            description = "This is an example product",
            imageUrl = "https://example.com/product/images/12345.jpg",
            categories = listOf("Electronics", "Gadgets"),
            tags = listOf("Trending", "New Arrival"),
            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 = "Special Edition",
            customField2 = "Limited Stock",
            customField3 = "Online Only",
            price = BigDecimal("51.88"),
            quantity = 2
            )
        ),
        totalQuantity = 2,
        totalPrice = BigDecimal("193.60"),
        cartId = "cart-0098caf9-42f4-44e9-afdd-45eafe892293",
    )
Connectif.sendCart(cart)

 

Callback (facoltativo)

Se vuoi ricevere feedback su possibili errori durante l’invio degli eventi, puoi aggiungere un EventCallbacks quando utilizzi il nostro metodo.  

 object : EventCallbacks {
    override fun onSuccess() {
        //Gestione in caso di successo
    }
    override fun onError(message: String?) {
         //Gestione in caso di errore
    }
}

 

 

Congratulazioni!
Sei arrivato alla fine della lezione.

  

Hai ancora dubbi irrisolti?
Ricorda che puoi contare sui nostri specialisti Connectif. Per contattarli, ti basterà aprire un ticket al Supporto facendo clic sul pulsante blu “Aiuto” nella tua dashboard.

Continua a imparare!

Per sfruttare tutto il potenziale del tuo account Connectif, ti consigliamo di continuare con i seguenti articoli: