En este artículo tienes las instrucciones paso a paso para añadir Connectif Mobile SDK a tu proyecto iOS. 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 iOS
- 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 iOS en Swift
- iOS 13 como versión mínima de soportada.
- Implementado en la app Apple Push Notification Service para la recepción de notificaciones push.
2. Cómo añadir Connectif Mobile SDK a tu proyecto iOS
1. Añadir el SDK
Actualmente Connectif iOS SDK puede ser instalado mediante Swift Package Manager (SPM), si necesita de un repositorio distinto no dude en comunicarse con nosotros para estudiar su caso.
Para añadir la dependencia de iOS SDK a través de Swift Package Manager:
- Dirígete a File> Add Package Depenencies.
- Asegúrate de que tienes una cuenta de GitHub asociada a Xcode (debería de aparecer en la columna de la izquierda como Source Control Account. En caso negativo, puedes añadirla haciendo en el símbolo "+" que encontrarás en esa misma columna.
- Introduce la URLde nuestro repositorio en el buscador de la derecha, por ejemplo:
https://github.com/connectif/Connectif-iOS-SDK
- En la vista central, selecciona el SDK cuando aparezca.
- Haz clic en la opción Add Package.
- En el diálogo de selección de targets, selecciona tu app como target del Connectif iOS SDK y haz clic en Add Package.
2. Iniciar el SDK
Un buen lugar para iniciar el SDK es el AppDelegate application(_:didFinishLaunchingWithOptions:), aunque esto de penderá de la naturaleza de tu aplicación.
De forma opcional, puedes obtener el email de usuarios que se registraron o iniciaron sesión antes de implementar el Mobile SDK de Connectif, añadiendo el email del usuario al iniciar el SDK.
El email deberá de 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 AppDelegate: NSObject, UIApplicationDelegate {
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil) -> Bool {
Connectif.initialize(apiKey: "YOUR_API_KEY",email: "useremail@example.com")
return true
}
}
3. (Opcional). Configuración Log
Al iniciar el SDK, podrás indicar el nivel de Logs que quieres 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 Apple Push Notifications Service, para activar el envío y recepción de push mediante el Mobile SDK de iOS.
- 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.