En este artículo tienes las instrucciones paso a paso para añadir Connectif Mobile SDK a tu proyecto Android. Este comienzo de la integración de tu App Móvil con Connectif, una vez hayas revisado que cumples los requisitos previos para poder realizarla.
1. Requisitos para poder añadir Connectif Mobile SDK a tu proyecto Android
- Necesitaremos tener activada nuestra integración App Mobil en Connectif para tener acceso en la configuración de la integración a nuestra key. Puede consultar nuestra guía de implementación.
- Desarrollado como librería de Android.
- Versión mínima soportada Android 5.0 (Level 21).
- Implementado en la app Firebase Cloud Messaging para la recepción de notificaciones push.
2. Cómo añadir Connectif Mobile SDK a tu proyecto Android
2.1. Añadir el SDK
Añade la dependencia del SDK a tu fichero build.gradle (Module: app).
Kotlin
implementation("ai.connectif:sdk:1.0.1")
Groovy
implementation 'ai.connectif:sdk:1.0.1'
Haz clic sobre la opción Sync Now de la toolbar superior, para hacer que se sincronice el fichero de gradle.
2.2. Iniciar el SDK de Connectif
El mejor lugar para iniciar nuestro SDK será en el callback onCreate de la Application Class.
De forma opcional, para obtener el email de usuarios que se registraron o iniciaron sesión antes de implementar el Mobile SDK de Connectif, enviaremos el email del usuario al iniciar el SDK. El email deberá cumplir estos requisitos:
- Un correo válido debe tener un nombre de usuario, seguido por @, un dominio y una extensión, sin espacios ni caracteres especiales.
- Un máximo de 200 caracteres.
Ejemplo del email:
class SampleApp : Application() {
override fun onCreate() {
super.onCreate()
Connectif.init(
context = applicationContext,
apiKey = "YOUR_API_KEY",
"usermail@example.com"
)
}
}
3. Configuraciones adicionales
Recuerda que al iniciar el SDK podrá definir algunos valores usando el parámetro ConnectifConfig en Connectif.initialize().
3. 1. Icono
Por defecto este es icono asignado a nuestras notificaciones push:
ic_default_notification
Si lo deseas, podrás personalizando indicando el recurso en la propiedad pushSmallIcon de ConnectifConfig al iniciar el SDK, recuerda que para que se visualice correctamente debe contener únicamente color blanco y transparencias.
3.2. Canal de notificaciones
Desde Android 8 es obligatorio crear un canal para poder mostrar las notificaciones, por defecto asignaremos a las notificaciones mostradas por Connectif el nombre de canal "Default Channel" y "connectif_channel" como identificador de canal.
Podrás indicarnos tu nombre y canal personalizado usando las propiedades pushChannelName y pushChannelId de ConnectifConfig al iniciar el SDK.
3.3. Log
Puedes definir el logLevel, es decir, el nivel de logs que querremos mostrar (default: LogLevel.NONE). Cada nivel mantiene los logs del nivel anterior, por lo que el nivel INFO mostrará todos los logs.
- NONE: Desactiva todos los registros.
- ERROR: Solo se registran errores.
- WARN: Se registran advertencias y errores.
- INFO: Se registran mensajes de información, advertencias y errores.
4. Implementar el tracking de los usuarios
Una vez tengas configurada la inicialización podrás comenzar con el tracking del usuario, a través de la implementación de las diferentes notificaciones.
- Notificar evento de página visitada
- Notificar evento de producto visitado
- Notificar evento de compra realizada
- Notificar evento de búsqueda
- Notificar información del carrito
- Notificar de información de contacto
- Notificar suscripción a newsletter
- Notificar evento de login
- Notificar evento de registro
- Notificar evento personalizado
¡Sigue aprendiendo!
Para aprovechar todo el potencial de tu cuenta en Connectif, te recomendamos continuar con los siguientes artículos:
- Guía completa para integrar Connectif con tu App Móvil, para conocer en profundidad todos los cambios de esta integración.
- 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.