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 Evento di Prodotto Visitato

Creato
Aggiornato
Segui

L' evento "Notificare evento di prodotto visitato" serve a comunicare che il contatto ha visitato un determinato prodotto durante la sua navigazione nell'app. A tale scopo, notifica, tramite Mobile SDK, quando un utente accede a una pagina di dettaglio del prodotto utilizzando il metodo Connectif.sendProductVisit().

 

Come si usa

La notifica di prodotto visitato utilizza l'oggetto Product, del metodo sendProductVisit, per arricchire le informazioni degli eventi inviati. 

 

Notificare le informazioni del prodotto visitato

Queste sono le proprietà che possiamo inviare nel nostro oggetto Product:

Nome Obbligatorio Tipo Descrizione
productDetailUrl Sì String URL della pagina del prodotto (l'URL deve essere non codificato).
productId Sì String Identificatore univoco del prodotto (nell'eCommerce).
name Sì String Nome del prodotto.
description No String Descrizione del prodotto. Può contenere codice HTML.
imageUrl No String URL dell'immagine del prodotto.
unitPrice Sì BigDecimal Prezzo unitario del prodotto.
availability No Availability Può avere uno dei seguenti valori: IN_STOCK o OUT_OF_STOCK.
categories No List<String> La categoria a cui appartiene il prodotto. Se l'eCommerce permette sottocategorie, puoi indicarle con il percorso completo della categoria separando ogni livello con il carattere '/'.
Ad esempio: "/Computer/Tastiere/Logitech".
tags No List<String> Etichette associate al prodotto.
brand No String Marca del prodotto.
reviewCount No Int Numero di recensioni del prodotto.
rating No Int Valutazione del prodotto normalizzata nell'intervallo da 0 a 5.
ratingCount No Int Numero di valutazioni del prodotto.
thumbnailUrl No String URL dell'immagine in miniatura del prodotto.
relatedExternalProductIds No List<String> ID dei prodotti correlati.
priority No Int Priorità di un prodotto.
unitPriceOriginal No BigDecimal Prezzo unitario del prodotto senza lo sconto applicato.
unitPriceWithoutVAT No BigDecimal Prezzo unitario originale del prodotto.
discountedPercentage No Int Percentuale di sconto, intervallo da 0 a 100 senza simbolo di percentuale.
publishedAt No Date Data di pubblicazione del prodotto nel catalogo del negozio.
customField1 No String Campo personalizzato del prodotto.
customField2 No String Campo personalizzato del prodotto.
customField3 No String Campo personalizzato del prodotto.

Questo tipo di evento raccoglie automaticamente le seguenti informazioni:

  • Sistema operativo: Android o iOS.
  • Versione dell'app.
  • Versione del sistema operativo.
  • Versione di Connectif SDK.

Esempio

La notifica avrà questo aspetto:

Connectif.sendProductVisit(
    Product(
        productDetailUrl = "https://example.com/product/12345",
        productId = "12345",
        name = "Example Product",
        unitPrice = BigDecimal("99.99"),
        description = "Questo è un prodotto di esempio",
        imageUrl = "https://example.com/product/images/12345.jpg",
        availability = Product.Availability.IN_STOCK,
        categories = listOf("Elettronica", "Gadget"),
        tags = listOf("Tendenza", "Nuovo arrivo"),
        brand = "ExampleBrand",
        reviewCount = 150,
        rating = BigDecimal("4.5"),
        ratingCount = 124,
        thumbnailUrl = "https://example.com/product/thumbnails/12345.jpg",
        relatedExternalProductIds = listOf("54321", "67890"),
        priority = 1,
        unitPriceOriginal = BigDecimal("120.00"),
        unitPriceWithoutVAT = BigDecimal("80.00"),
        discountedAmount = BigDecimal("20.00"),
        discountedPercentage = BigDecimal("16.67"),
        publishedAt = Date(),
        customField1 = "Edizione Speciale",
        customField2 = "Stock Limitato",
        customField3 = "Solo Online"
    )
)

 

Callbacks (Opzionale)

Se desideri ricevere feedback su possibili errori durante l'invio di eventi, possiamo aggiungere un EventCallbacks quando utilizziamo il nostro metodo.  

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

 

 

Congratulazioni!
Hai completato la lezione.

  

Hai ancora dubbi?
Ricorda che hai a disposizione i nostri specialisti di Connectif. Per contattarli, ti basterà aprire un ticket di supporto cliccando sul pulsante blu “Aiuto” della tua dashboard.

Continua a imparare!

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