El evento personalizado sirve para crear notificaciones adaptadas entre el eCommerce y Connectif. Para ello, notifica vía el Mobile Sdk, eventos de Integración personalizada para recibir datos en Connectif, mediante las funciones Connectif.sendCustomEventById() y Connectif.sendCustomEventByAlias(), según queramos identificar los eventos por alias o id.
Cómo se usa
La notificación de eventos de integración personalizada se realiza estableciendo el campo type a valor literal "custom" e identificando el evento mediante el parámetro eventAlias (único en tu Tienda). En el parámetro CustomEvent se encontrarán, en caso de haber, los campos del evento de la integración.
Para construir el parámetro CustomEvent podremos usar las clases que heredan de CustomEventValue, los cuales corresponden con los tipos de campos que podremos crear en los Eventos personalizados desde el Dashboard de Connectif.
CustomEventValue.Text
CustomEventValue.Phone
CustomEventValue.Email
CustomEventValue.Integer
CustomEventValue.Decimal
CustomEventValue.DateTime
CustomEventValue.Boolean
CustomEventValue.MultipleChoice
CustomEventValue.SingleOption
Este tipo de evento recoge de forma automática la siguiente información:
- Sistema operativo: Android o iOS.
- Versión de app.
- Versión de sistema operativo.
- Versión de Connectif SDK.
Ejemplo usando alias del evento
Dada una integración personalizada para recibir datos, que se envía cuando un contacto da un Like a un producto, que incluye los campos email, productId.
La notificación tendrá este aspecto usando CustomEventValue:
Connectif.sendCustomEventByAlias("product-like",
CustomEvent(
mapOf(
"email" to CustomEventValue.Email("test@example.org"),
"product-id" to CustomEventValue.Text("1234")
)
)
)
Podremos optar por la opción de enviar los campos del evento como un objeto anónimo de la siguiente manera:
Connectif.sendCustomEventByAlias("product-like",
object {
val `email` = "test@example.org"
val `product-id` = "1234"
}
)
Ejemplo usando identificador del evento
De forma alternativa al uso del alias, es posible identificar el evento mediante su eventId. El ejemplo a continuación muestra cómo hacer uso de ello (también compatible con el envío de campos como objeto anónimo):
Connectif.sendCustomEventById("635feb9a4168beeaf0ae6a46",
CustomEvent(
mapOf(
"email" to CustomEventValue.Email("test@example.org"),
"product-id" to CustomEventValue.Text("1234")
)
)
)
Callbacks (Opcional)
Si quieres tener feedback de posibles errores al enviar eventos, podremos añadir un EventCallbacks cuando usemos nuestro método.
object : EventCallbacks {
override fun onSuccess() {
//Manejo en caso de éxito
}
override fun onError(message: String?) {
//Manejo en caso de error
}
}
¡Enhorabuena!
Has llegado al final de la lección.
¿Te han quedado dudas sin resolver?
Recuerda que tienes a tu disposición a nuestros especialistas en Connectif. Para contactar con ellos, tan solo tendrás que abrir ticket a Soporte haciendo clic en el botón azul de “Ayuda” de tu dashboard.
¡Sigue aprendiendo!
Para aprovechar todo el potencial de tu cuenta en Connectif, te recomendamos continuar con los siguientes artículos:
- Android SDK Get Started, para añadir Connectif Mobile SDK a tu proyecto Android.
- Configuración Firebase Cloud Messaging, para activar el envío y recepción de push mediante el Mobile SDK de Android.
- iOS SDK Get Started, para añadir Connectif Mobile SDK a tu proyecto iOS.
- Configuración Apple Push Notifications Service, para activar el envío y recepción de push mediante el Mobile SDK de iOS.