Configuración de Assurance

Además de la instalación general de SDK, iOS también requiere el siguiente código adicional para iniciar la sesión de Assurance en la 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.

Además de la instalación general de SDK, Android también requiere el siguiente código adicional para iniciar la sesión de Assurance en la aplicación.

1. En Android Studio, en la vista de Android, vaya a aplicación > kotlin+java > com.adobe.luma.tutorial.android > LumaApplication.

2. Añada el siguiente código a fun handleDeeplink(deeplink: String?):

   code language-kotlin
   // Called when the app in background is opened with a deep link. if (deeplink.isNullOrEmpty()) { Log.w("Luma", "Deeplink is null or empty") return } Log.i("Luma", "Handling deeplink: $deeplink") Assurance.startSession(deeplink)

   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.

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.

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.

{modal="regular"}

1. Abra el proyecto en Android Studio.
2. Seleccione build.gradle.kts (Módulo :app) en el navegador.
3. Asegúrese de usar un identificador de paquete unique y reemplace el valor com.adobe.luma.tutorial.android para namespace en android
4. Asegúrese de usar el mismo identificador de paquete unique y reemplace com.adobe.luma.tutorial.android para applicationId en defaultConfig en android

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

{modal="regular"}

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

   {modal="regular"}

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 a través de un 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. En la aplicación de ejemplo, el vínculo profundo es lumatutorialswiftui://.

1. Vaya a la vista de Android de su proyecto en Android Studio.

2. Seleccione aplicación > manifiestos > AndroidManifest.xml en el navegador.

3. Asegúrese de que el elemento XML manifest > application > activity tenga el siguiente aspecto:

   code language-xml

   <activity android:name=".MainActivity" android:exported="true" android:theme="@style/Theme.LumaAndroid"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> <intent-filter android:label="@string/app_name"> <action android:name="android.intent.action.VIEW" /> <category android:name="android.intent.category.DEFAULT" /> <category android:name="android.intent.category.BROWSABLE" /> <data android:scheme="lumatutorialandroid" android:host="default" /> </intent-filter> </activity>

Asegúrese de especificar un android:scheme (por ejemplo. lumatutorialandroid) y android:host (por ejemplo default) para definir la dirección URL base.

Para obtener más información sobre los vínculos profundos en Android, consulte Crear vínculos profundos al contenido de la aplicación.

Assurance funciona abriendo una dirección URL a través de un 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. En la aplicación de ejemplo, el vínculo profundo es lumatutorialandroid://default.

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 .

   Opcionalmente, es posible que quiera limpiar su compilación, especialmente cuando vea resultados inesperados. 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"}

6. Seleccione Continuar.

En su explorador:

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

2. Seleccione Assurance en el carril izquierdo.

3. Seleccione Crear nueva sesión y la opción Conexión de vínculo profundo.

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.
   {modal="regular"}

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.

     {modal="regular"}

   Si utiliza un simulador:

   1. Seleccione Copiar vínculo.

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

      {modal="regular"}

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 de Experience Cloud que llegan a través de la interfaz de usuario de Assurance y muestran lo siguiente:

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

     2. Detalles de un evento seleccionado.

     3. El dispositivo y la cronología.

        {modal="regular"}

10. Seleccione Continuar para ir a la pantalla Inicio.

En Android Studio:

1. Cree o reconstruya y ejecute la aplicación en el simulador o en un dispositivo físico desde Android Studio con .

   Opcionalmente, es posible que quiera limpiar su compilación, especialmente cuando vea resultados inesperados. Seleccione Limpiar proyecto del menú Generar de Android Studio.

2. En el cuadro de diálogo Permitir que Luma Android le envíe notificaciones, seleccione Permitir.

   {width="300"}

3. Seleccione Mostrar cuadro de diálogo de permisos.

   {width="300"}

4. En el Permitir que Luma Android acceda a la ubicación de este dispositivo?…

   {width="300"}

   • Seleccione Preciso.
   • Seleccione mientras usa la aplicación.

5. En la pantalla de introducción de la aplicación, selecciona Abrir configuración del dispositivo.

6. En la pantalla Permiso de ubicación, seleccione Permitir todo el tiempo. A continuación, seleccione ← para volver a la pantalla de introducción de la aplicación.

   {width="300"}

7. Seleccione Continuar para ir a la pantalla Inicio.

En su explorador:

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

2. Seleccione Assurance en el carril izquierdo.

3. Seleccione Crear nueva sesión y la opción Conexión de vínculo profundo.

4. Seleccione Iniciar.

5. Proporcione un Nombre de sesión como Luma Mobile App Session y la URL base, que son las android:scheme y android:host que definió en AndroidManifest.xml en Android Studio, separadas por ://. Por ejemplo: lumatutorialandroid://default

6. Seleccione Siguiente.
   {modal="regular"}

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.

     {modal="regular"}

   Si utiliza un simulador:

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

   {modal="regular"}

   Cuando se le pida en Chrome que Continúe con Luma Android, seleccione Continuar.

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 de Experience Cloud que llegan a través de la interfaz de usuario de Assurance y muestran lo siguiente:

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

     2. Detalles de un evento seleccionado.

     3. El dispositivo y la cronología.

        {modal="regular"}

{modal="regular"}

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 actualiza las dependencias del paquete.

{modal="regular"}

Si ve extensiones obsoletas, consulte la documentación de Android Studio sobre cómo actualizar los módulos de dependencia para su proyecto.