Android Get started

Connectif Support

Creación 27 de agosto de 2024 15:13

Actualización 24 de febrero de 2025 14:30

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.

Para realizar esta integración, necesitarás de un experto con conocimientos de programación.

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.

¡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:

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.