L'evento personalizzato serve a creare notifiche personalizzate tra l'eCommerce e Connectif. A tal fine, notifica tramite il Mobile SDK eventi di Integrazione personalizzata per ricevere dati in Connectif, utilizzando le funzioni Connectif.sendCustomEventById() e Connectif.sendCustomEventByAlias(), a seconda che si desideri identificare gli eventi tramite alias o id.
Come si usa
La notifica degli eventi di integrazione personalizzata viene eseguita impostando il campo type con il valore letterale " custom " e identificando l'evento tramite il parametro eventAlias (unico nel tuo negozio). Nel parametro CustomEvent si troveranno, se presenti, i campi dell'evento dell'integrazione.
Per costruire il parametro CustomEvent possiamo utilizzare le classi che ereditano da CustomEventValue, che corrispondono ai tipi di campi che possiamo creare negli Eventi personalizzati dalla Dashboard di Connectif.
CustomEventValue.Text
CustomEventValue.Phone
CustomEventValue.Email
CustomEventValue.Integer
CustomEventValue.Decimal
CustomEventValue.DateTime
CustomEventValue.Boolean
CustomEventValue.MultipleChoice
CustomEventValue.SingleOption
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 usando l'alias dell'evento
Dati un'integrazione personalizzata per ricevere dati, che viene inviata quando un contatto mette un Like a un prodotto, includendo i campi email, productId.
La notifica avrà questo aspetto utilizzando CustomEventValue:
Connectif.sendCustomEventByAlias("product-like",
CustomEvent(
mapOf(
"email" to CustomEventValue.Email("test@example.org"),
"product-id" to CustomEventValue.Text("1234")
)
)
)
È possibile anche inviare i campi dell'evento come oggetto anonimo nel seguente modo:
Connectif.sendCustomEventByAlias("product-like",
object {
val `email` = "test@example.org"
val `product-id` = "1234"
}
)
Esempio utilizzando l'identificatore dell'evento
In alternativa all'uso dell'alias, è possibile identificare l'evento tramite il suo eventId. L'esempio seguente mostra come utilizzarlo (compatibile anche con l'invio dei campi come oggetto anonimo):
Connectif.sendCustomEventById("635feb9a4168beeaf0ae6a46",
CustomEvent(
mapOf(
"email" to CustomEventValue.Email("test@example.org"),
"product-id" to CustomEventValue.Text("1234")
)
)
)
Callbacks (Opzionale)
Se vuoi ricevere feedback su eventuali 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!
Hai completato la lezione.
Hai ancora dubbi irrisolti?
Ricorda che hai a disposizione i nostri specialisti di Connectif. Per contattarli, ti basterà aprire un ticket all'Assistenza cliccando sul pulsante blu "Aiuto" nella tua dashboard.
Continua a imparare!
Per sfruttare tutto il potenziale del tuo account Connectif, ti consigliamo di proseguire con i seguenti articoli:
- Android SDK Get Started, per aggiungere Connectif Mobile SDK al tuo progetto Android.
- Configurazione Firebase Cloud Messaging, per attivare l'invio e la ricezione di push tramite il Mobile SDK di Android.
- iOS SDK Get Started, per aggiungere Connectif Mobile SDK al tuo progetto iOS.
- Configurazione Apple Push Notifications Service, per attivare l'invio e la ricezione di push tramite il Mobile SDK di iOS.