L'evento personalizzato serve per creare notifiche adattate 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 vogliano identificare gli eventi tramite alias o id.
Come si usa
La notifica di eventi di integrazione personalizzata si effettua impostando il campo type al 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, le quali 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
Esempio usando alias dell'evento
Data un'integrazione personalizzata per ricevere dati, che viene inviata quando un contatto mette un Like a un prodotto, che include i campi email, productId.
La notifica avrà questo aspetto utilizzando CustomEventValue:
Connectif.sendCustomEventByAlias("product-like", CustomEvent(values: [
"email": .email("test@example.org"),
"product-id": .text("+123456789")
])
Esempio usando identificatore dell'evento
In alternativa all'uso dell'alias, è possibile identificare l'evento tramite il suo eventId. L'esempio seguente mostra come farne uso (anche compatibile con l'invio di campi come oggetto anonimo):
Connectif.sendCustomEventById("635feb9a4168beeaf0ae6a46", CustomEvent(values: [
"email": .email("test@example.org"),
"product-id": .text("+123456789")
])
Callbacks (Opzionale)
Se vogliamo ricevere un feedback su eventuali errori nell'invio degli eventi, possiamo aggiungere un EventCallbacks quando utilizziamo il nostro metodo.
EventCallbacks(
onSuccess: {
//Gestione in caso di successo
},
onError: { error in
//Gestione in caso di errore
})
Congratulazioni!
Hai raggiunto la fine della lezione.
Hai ancora domande senza risposta?
Ricorda che hai a disposizione i nostri specialisti in Connectif. Per contattarli, ti basterà aprire un ticket a Supporto cliccando sul pulsante blu “Aiuto” nella tua dashboard.
Continua a imparare!
Per sfruttare appieno il potenziale del tuo account Connectif, ti consigliamo di continuare con i seguenti articoli:
- Android SDK Get Started, per aggiungere Connectif Mobile SDK al tuo progetto Android.
- Configurazione Firebase Cloud Messaging, per abilitare l'invio e la ricezione di notifiche push tramite il Mobile SDK per Android.
- iOS SDK Get Started, per aggiungere Connectif Mobile SDK al tuo progetto iOS.
- Configurazione Apple Push Notifications Service, per abilitare l'invio e la ricezione di notifiche push tramite il Mobile SDK per iOS.