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
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(values: [
"email": .email("test@example.org"),
"product-id": .text("+123456789")
])
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(values: [
"email": .email("test@example.org"),
"product-id": .text("+123456789")
])
Callbacks (Opcional)
Si queremos tener feedback de posibles errores al enviar eventos, podremos añadir un EventCallbacks cuando usemos nuestro método.
EventCallbacks( onSuccess: { //Manejo en caso de éxito }, onError: { error in //Manejo en caso de error })
¡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.