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 general del SDK, que ha completado en la lección anterior, iOS también requiere la siguiente adición para iniciar la sesión de Assurance para su aplicación.

  1. Vaya a Luma > Luma > SceneDelegate en el navegador de proyectos de Xcode.

  2. 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.

Encontrará más información aquí.

Definir identificador de paquete

Debe proporcionar un identificador de paquete único para la aplicación.

  1. Abra el proyecto en Xcode.

  2. Seleccione Luma en el navegador de proyectos.

  3. Seleccione el destino Luma.

  4. Seleccione la pestaña Firma y capacidades.

  5. Defina un Identificador de paquete.

    note important
    IMPORTANT
    Asegúrese de utilizar un identificador de paquete unique y reemplace el identificador de paquete com.adobe.luma.tutorial.swiftui, ya que cada identificador de paquete debe ser único. Normalmente, utiliza un formato DNS inverso para cadenas de ID de paquete, como com.organization.brand.uniqueidentifier. La versión final de este tutorial, por ejemplo, utiliza com.adobe.luma.tutorial.swiftui.

    Funciones de firma de Xcode {modal="regular"}

Configuración de una dirección URL base

  1. Vaya al proyecto en Xcode.

  2. Seleccione Luma en el navegador de proyectos.

  3. Seleccione el destino Luma.

  4. Seleccione la ficha Información.

  5. Para agregar una URL base, desplácese hacia abajo hasta Tipos de URL y seleccione el botón +.

  6. Establezca Identificador en el identificador de paquete que elija y establezca Esquemas de URL de su elección

    url de garantía

    note important
    IMPORTANT
    Asegúrese de utilizar un identificador de paquete unique y reemplace el identificador de paquete com.adobe.luma.tutorial.swiftui, ya que cada identificador de paquete debe ser único. Normalmente, utiliza un formato DNS inverso para cadenas de ID de paquete, como com.organization.brand.uniqueidentifier. Puede usar el mismo identificador de paquete que usó en Definir identificador de paquete.
    Del mismo modo, use un esquema de URL único y reemplace el esquema de URL ya proporcionado lumatutorialswiftui por el único.

Para obtener más información acerca de 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:

  1. Compile o vuelva a compilar y ejecute la aplicación en el simulador o en un dispositivo físico desde Xcode con Play .

    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… en el menú Xcode Producto.
  2. En el cuadro de diálogo Permitir que la "aplicación de Luma" use su ubicación, seleccione Permitir al usar la aplicación.

    {width="300"}

  3. En el cuadro de diálogo "Aplicación de Luma" desea enviarle notificaciones, seleccione Permitir.

    {width="300"}

  4. Seleccione Continuar… para permitir que la aplicación rastree su actividad.

    {width="300"}

  5. En el cuadro de diálogo Permitir que "Aplicación de Luma" rastree su actividad en las aplicaciones y sitios web de otras compañías, seleccione Permitir.

    {width="300"}

En su explorador:

  1. Vaya a la IU de recopilación de datos.

  2. Seleccione Assurance en el carril izquierdo.

  3. Seleccione Crear sesión.

  4. Seleccione Iniciar.

  5. Proporcione un Nombre de sesión como Luma Mobile App Session y la URL base, que son los esquemas de URL que introdujo en Xcode, seguidos de ://. Por ejemplo: lumatutorialswiftui://

  6. Seleccione Siguiente.
    garantía al crear sesión

  7. En el diálogo modal Crear nueva sesión:

    Si utiliza un dispositivo físico:

    • Seleccione 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.

      código de control de calidad de seguridad

    Si utiliza un simulador:

    1. Seleccione Copiar vínculo.

    2. Copie el vínculo profundo mediante Copiar y utilice el vínculo profundo para abrir la aplicación con Safari en el simulador.

      Vínculo de copia de seguridad

  8. 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.

    {width="300"}

    Escriba el PIN y seleccione Conectar.

  9. Si la conexión se ha realizado correctamente, verá lo siguiente:

    • Un icono de Assurance flotando en la parte superior de la aplicación.

      {width="300"}

    • Actualizaciones del Experience Cloud que llegan a través de la interfaz de usuario de Assurance, y muestran:

      1. Eventos de experiencia procedentes de la aplicación.

      2. Detalles de un evento seleccionado.

      3. El dispositivo y la cronología.

        eventos de garantía

Si encuentra algún desafío, revise la documentación técnica y la documentación general.

Verificar extensiones

Para comprobar si su aplicación utiliza las extensiones más actualizadas:

  1. Seleccione Configurar.

  2. Seleccione Agregar para 123 versiones de extensión.

  3. Seleccione Guardar.

    Configurar versiones de extensión

  4. Seleccione 123 Versiones de extensión para ver una descripción general de las extensiones más recientes disponibles y de las extensiones usadas en su versión de la aplicación.

    Versiones de extensión

  5. Para actualizar las versiones de la extensión (por ejemplo, Messaging y Optimize), 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.

NOTE
Una vez que haya actualizado las extensiones (paquetes) en Xcode, cierre y elimine la sesión actual y repita todos los pasos de Conexión a una sesión y Verificación de las extensiones para garantizar que Assurance notifique correctamente las extensiones correctas en una nueva sesión de Assurance.
SUCCESS
Ahora ha configurado la aplicación para que utilice Assurance durante el resto del tutorial.
Gracias por dedicar su tiempo a conocer el SDK móvil de Adobe Experience Platform. Si tiene preguntas, desea compartir comentarios generales o tiene sugerencias sobre contenido futuro, compártalas en esta publicación de debate de la comunidad de Experience League

Siguiente: Implementar consentimiento

recommendation-more-help
9fed61f5-c338-47ad-8005-0b89a5f4af8b