Configurar Assurance
Obtenga información sobre cómo configurar Adobe Experience Platform Assurance en una aplicación móvil.
Assurance, anteriormente conocido como Project Griffon, está diseñado para ayudarle a inspeccionar, probar, simular y validar la forma en que recopila datos o sirve experiencias en su aplicación móvil.
Assurance le ayuda a inspeccionar los eventos de SDK sin procesar generados por el SDK para móviles de Adobe Experience Platform. Todos los eventos recopilados por el SDK están disponibles para su inspección. Los eventos del SDK se cargan en una vista de lista, ordenados por tiempo. Cada evento tiene una vista detallada que proporciona más detalles. También se proporcionan vistas adicionales para examinar la configuración del SDK, los elementos de datos, los estados compartidos y las versiones de extensión del SDK. Obtenga más información acerca de Assurance en la documentación del producto.
Requisitos previos
- La aplicación se ha configurado y instalado correctamente con los SDK.
Objetivos de aprendizaje
En esta lección, deberá hacer lo siguiente:
- Confirme que su organización tiene acceso a (y solicítelo si no lo tiene).
- Configure la dirección URL base.
- Añada el código específico de iOS requerido.
- Conéctese a una sesión.
Confirmar acceso
Confirme que su organización tiene acceso a Assurance. Usted, como usuario, debe añadirse al perfil de Adobe Experience Platform. Consulte Acceso de usuario en la Guía de Assurance para obtener más información.
Implementación
Además de la Instalación del SDKSin embargo, como ha completado la lección anterior, iOS también requiere la siguiente adición para iniciar la sesión de Assurance para su aplicación.
-
Vaya a Luma > Luma > SceneDelegate en el navegador de proyectos de Xcode.
-
Añada el siguiente código a
func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>
:code language-swift // Called when the app in background is opened with a deep link. if let deepLinkURL = URLContexts.first?.url { // Start the Assurance session Assurance.startSession(url: deepLinkURL) }
Este código inicia una sesión de garantía cuando la aplicación se encuentra en segundo plano y se abre mediante un vínculo profundo.
Puede encontrar más información aquí.
Definir identificador de paquete
Debe proporcionar un identificador de paquete único para la aplicación.
-
Abra el proyecto en Xcode.
-
Seleccionar Luma en el navegador del proyecto.
-
Seleccione el Luma objetivo.
-
Seleccione el Firma y capacidades pestaña.
-
Defina un Identificador de paquete.
note important IMPORTANT Asegúrese de utilizar un único identificador de paquete y reemplace el com.adobe.luma.tutorial.swiftui
identificador de paquete, ya que cada identificador de paquete debe ser único. Normalmente, se utiliza un formato DNS inverso para cadenas de ID de paquete, comocom.organization.brand.uniqueidentifier
. La versión final de este tutorial, por ejemplo, utilizacom.adobe.luma.tutorial.swiftui
.{zoomable="yes"}
Configuración de una dirección URL base
-
Vaya al proyecto en Xcode.
-
Seleccionar Luma en el navegador del proyecto.
-
Seleccione el Luma objetivo.
-
Seleccione el Información pestaña.
-
Para añadir una URL base, desplácese hacia abajo hasta Tipos de URL y seleccione la + botón.
-
Establecer Identificador Vaya al Identificador de paquete de su elección y defina una Esquemas de URL de su elección.
note important IMPORTANT Asegúrese de utilizar un único identificador de paquete y reemplace el com.adobe.luma.tutorial.swiftui
identificador de paquete, ya que cada identificador de paquete debe ser único. Normalmente, se utiliza un formato DNS inverso para cadenas de ID de paquete, comocom.organization.brand.uniqueidentifier
. Puede utilizar el mismo identificador de paquete que utilizó en Definir identificador de paquete.
Del mismo modo, utilice un esquema de URL único y reemplace el ya proporcionadolumatutorialswiftui
con su esquema de URL único.
Para obtener más información sobre los esquemas de URL en iOS, consulte Documentación de Apple.
Assurance funciona abriendo una dirección URL, ya sea mediante explorador o código QR. Esa URL comienza con la URL base que abre la aplicación y contiene parámetros adicionales. Estos parámetros únicos se utilizan para conectar la sesión.
Conexión a una sesión
En Xcode:
-
Cree o reconstruya y ejecute la aplicación en el simulador o en un dispositivo físico desde Xcode, utilizando .
note tip TIP De forma opcional, es posible que desee "limpiar" la compilación, especialmente cuando vea resultados inesperados. Para ello, seleccione Limpiar carpeta de compilación… desde el Xcode Product menú. -
En el Permitir que "Aplicación de Luma" use su ubicación diálogo, seleccione Permitir mientras se utiliza la aplicación.
img-md w-300 -
En el "Aplicación de Luma" desea enviarle notificaciones diálogo, seleccione Permitir.
img-md w-300 -
Seleccionar Continuar… para permitir que la aplicación rastree su actividad.
img-md w-300 -
En el Permitir que "Aplicación de Luma" rastree su actividad en las aplicaciones y sitios web de otras empresas diálogo, seleccione Permitir.
img-md w-300
En su explorador:
-
Vaya a la IU de recopilación de datos.
-
Seleccionar Assurance desde el carril izquierdo.
-
Seleccionar Crear sesión.
-
Seleccionar Inicio.
-
Proporcione un Nombre de sesión como
Luma Mobile App Session
y el URL básica, que son los esquemas de URL introducidos en Xcode, seguidos de://
Por ejemplo:lumatutorialswiftui://
-
Seleccione Siguiente.
-
En el Crear nueva sesión diálogo modal:
Si utiliza un dispositivo físico:
-
Seleccionar Escanear código QR. Para abrir la aplicación, utilice la cámara del dispositivo físico para escanear el código QR y pulse el vínculo.
Si utiliza un simulador:
-
Seleccionar Copiar vínculo.
-
Copie el vínculo profundo mediante y utilice el vínculo profundo para abrir la aplicación con Safari en el simulador.
-
-
Cuando se carga la aplicación, aparece un cuadro de diálogo modal en el que se le solicita que introduzca el PIN que se muestra en el paso 7.
img-md w-300 Introduzca el PIN y seleccione Connect.
-
Si la conexión se ha realizado correctamente, verá lo siguiente:
-
Un icono de Assurance flotando en la parte superior de la aplicación.
img-md w-300 -
Actualizaciones del Experience Cloud que llegan a través de la interfaz de usuario de Assurance, y muestran:
-
Eventos de experiencia procedentes de la aplicación.
-
Detalles de un evento seleccionado.
-
El dispositivo y la cronología.
-
-
Si tiene algún problema, consulte la técnico and general documentation.
Verificar extensiones
Para comprobar si su aplicación utiliza las extensiones más actualizadas:
-
Seleccionar Configurar.
-
Seleccionar para Versiones de extensión.
-
Seleccione Guardar.
-
Seleccionar Versiones de extensión para ver una descripción general de las últimas extensiones disponibles y de las extensiones utilizadas en su versión de la aplicación.
-
Para actualizar las versiones de la extensión (por ejemplo, Mensajes y Optimización) seleccione el paquete (extensión) de Dependencias del paquete (por ejemplo, AEPMessaging) y en el menú contextual, seleccione Actualizar paquete. Xcode actualizará las dependencias del paquete.
Siguiente: Implementación del consentimiento