Guía de integración de App Clips de Apple

Para obtener instrucciones completas sobre cómo los desarrolladores crean un App Clip para tu aplicación, consulta la guía de App Clips de Apple para desarrolladores.

Para obtener una aplicación de muestra simplificada que demuestra el uso de los App Clips y su integración con una aplicación completa, consulta la guía de App Clips de AppsFlyer.

• El SDK es necesario para la atribución de AppsFlyer de clics, instalaciones, eventos in-app e instalaciones completas de aplicaciones desde App Clips.
• OneLink redirige a los usuarios independientemente de la integración del SDK.

Para instalar el SDK y configurar el SDK de la aplicación completa: 

Envía los siguientes enlaces a tu desarrollador de iOS y dile que siga las instrucciones para:

• Integración del SDK en el App Clip
• Configuración de la atribución de la instalación completa de la aplicación desde el App Clip
• [Opcional] Configuración de eventos in-app, si aún no tiene eventos in-app que se midan para tu aplicación completa, o si deseas usar diferentes eventos in-app para el App Clip.

Requisitos previos:

• Plantilla de OneLink para tu aplicación completa con enlaces universales de iOS configurados.
• Enlace de OneLink.
• Recomendación: La plantilla y la invocación del enlace que utilizas para el App Clip envían a todos los usuarios sin tu aplicación completa al App Clip. Por lo tanto, considera tener una plantilla y un enlace personalizado independientes para los casos en los que desees enviar a esos usuarios al App Store, en lugar del App Clip.

Para configurar la plantilla de OneLink para tu App Clip:

1. En el panel de control de AppsFlyer, ve a Captación > Administración de OneLink.
2. Selecciona la plantilla de OneLink que utilizas para dirigir a los usuarios a tu aplicación completa. 
3. Asegúrate de que la plantilla de OneLink tenga enlaces universales configurados. (Consulta las instrucciones para agregar enlaces universales).
4. Haz clic en Guardar.
   El archivo AASA se actualiza para admitir el App Clip.
5. En el panel de control de AppsFlyer, ve a Captación > Administración de OneLink.
6. Selecciona elenlace personalizado de OneLink basado en la plantilla que configuraste en los pasos 1 a 4, que utilizas para dirigir a los usuarios a tu App Clip.
7. Asegúrate de tener una fuente de medios (pid) especificada.
   La fuente de medios debe especificarse en la URL (por ejemplo: pid=chartboost_int) o estar incluida dentro del enlace.

Para verificar que los App Clips estén habilitados en OneLink de AppsFlyer:

1. Crea una URL para obtener tu archivo de asociación. La URL se crea tomando el dominio de tu plantilla de OneLink y agregando /.well-known/apple-app-site-association. 
   Por ejemplo: coffee.onelink.me/.well-known/apple-app-site-association.
2. Ve a la URL de tu archivo de asociación.
   El archivo apple-app-site-association se descarga automáticamente.
3. Abre el archivo apple-app-site-association con un editor de texto (por ejemplo, el Bloc de notas).
4. Asegúrate de que el archivo contenga la palabra "appclips" y que el ID del paquete termine con ".Clip". Por ejemplo:
   

   "appclips": {
       "apps": [
         "ABCD1234.id.your.app.Clip",
         ...
       ]
   ...
   }

   Si es así, habrás configurado correctamente los App Clips en AppsFlyer y el App Clip estará implementado en cualquier plantilla de OneLink con el mismo subdominio.

Requisitos previos: Finalización de la configuración de la plantilla de OneLink para App Clips

Para configurar tu App Clip para que funcione con OneLink: 

1. En la página de tu aplicación en App Store Connect, ve a Build (Compilar) > Domain Status (Estado de dominio).
2. Asegúrate de que tu dominio de OneLink aparezca en Build domains (Compilar dominios) y que Cache status (Estado de caché) y Debug status (Estado de depuración) estén "validados".
3. En el panel de control de AppsFlyer, ve a Captación > Administración de OneLink.
4. Coloca el cursor sobre el ícono Acciones del enlace que deseas utilizar y haz clic enObtener URL. 
5. Registre la URL corta (o el prefijo de la URL larga). 
6. En la página de tu aplicación en App Store Connect, ve a App Clip > Edit Advanced Experiences (Editar experiencias avanzadas) > +Add (Agregar) > Next (Siguiente).
7. En App Clip Experience URL (URL de experiencia de App Clip), pega la URL personalizada de OneLink que registraste en el paso 5.
   Nota: Puedes agregar parámetros de consulta después de la URL personalizada principal, pero no puedes cambiar la ruta.
8. Haz clic en Next (Siguiente).
   Tu App Clip ahora está configurado para funcionar con OneLink. Puedes encontrar más instrucciones sobre la configuración de App Store Connect en la guía para desarrolladores de Apple.

Requisitos previos: Un dispositivo de prueba registrado con iOS 14 sin la aplicación completa instalada.

Para probar la integración de OneLink/App Clip:

1. En el panel de control de AppsFlyer, ve aCaptación > Administración de OneLink.
2. Desplaza el puntero sobre el icono Acciones del enlace que quieres probar y haz clic en Obtener URL. 
3. Escanea el código QR con tu dispositivo.
   La tarjeta del App Clip se muestra en tu dispositivo, lo que indica que tu integración de OneLink/App Clip está configurada correctamente.