> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Live Activities
> Aprende a usar iOS Live Activities con OneSignal para entregar actualizaciones en tiempo real directamente a la pantalla de bloqueo y Dynamic Island. Habilita el seguimiento sin interrupciones para eventos como marcadores deportivos, entregas y más.
Live Activities permiten que tus apps de iOS e iPadOS entreguen actualizaciones en tiempo real a la pantalla de bloqueo y Dynamic Island, manteniendo a los usuarios informados sin necesidad de abrir la app. Introducidas en iOS 16.1 y expandidas a iOS 17, Live Activities son perfectas para información sensible al tiempo como seguimiento de entregas, marcadores de juegos o actualizaciones de tránsito.
Live Activities son una característica de iOS, pero puedes lograr capacidades similares con [Android Live Notifications](./android-live-notifications).
***
## ¿Por qué usar Live Activities?
Live Activities son excelentes para actualizaciones en tiempo real, transaccionales o limitadas en el tiempo.
* Visibles hasta por 8 horas
* Provisionales — no se requiere permiso para mostrar la primera Live Activity
* Altamente atractivas y visibles en superficies premium del dispositivo como la pantalla de bloqueo y Dynamic Island
[Aprende más sobre casos de uso en nuestro blog →](https://onesignal.com/blog/new-live-activities-support-to-help-you-drive-loyalty-faster)
***
## ¿Por qué usar OneSignal?
OneSignal simplifica Live Activities al manejar:
* Gestión de tokens push temporales
* Escalamiento a millones de dispositivos con una sola llamada de API
* Análisis y estadísticas de rendimiento en tiempo real
* Orquestación multicanal con Push, Email, SMS y Mensajes In-App
Live Activities están disponibles en todos los planes excepto planes Gratuitos con más de 10,000 suscriptores con opt-in. [Ver precios](https://onesignal.com/pricing) o contacta a `support@onesignal.com` para asistencia.
***
## Comenzar con Live Activities
### Requisitos
* iOS 16.1+ o iPadOS 17+
* OneSignal [Mobile SDK integrado](./mobile-sdk-setup)
* Configuración completada según nuestra [Guía de desarrollador de Live Activities](./live-activities-developer-setup)
* El seguimiento de clics y la Entrega confirmada requieren iOS SDK versión **5.2.15 o superior**
### Cómo funcionan Live Activities
* **Duración visible**: Activas hasta por 8 horas (se pueden eliminar usando el parámetro `dismissal_date` en la [Update Live Activity API](/reference/update-live-activity-api)).
* **No se necesita permiso**: La primera actividad es provisional; las futuras dependen de la configuración del usuario.
* **Límite**: Máximo 5 Live Activities por app simultáneamente.
* **Inicio remoto**: Compatible desde iOS 17.2+ a través de push.
* **Uso no promocional**: Debe proporcionar valor al usuario—no diseñado para anuncios.
### Crear y actualizar una Live Activity
Las Live Activities pueden iniciarse de 2 maneras:
1. Usando nuestra [Start Live Activity API](/reference/start-live-activity) también conocida como "push-to-start".
2. Activándola en la app ([Configuración de desarrollador de Live Activities](./live-activities-developer-setup)).
Usa la [Update Live Activity API](/reference/update-live-activity-api) y pasa el `activity_id` para actualizar todos los dispositivos asociados.
Las Live Activities pueden finalizar de las siguientes maneras:
* Envía una solicitud al servidor de OneSignal para dejar de enviar actualizaciones para el `activityId` dado.
* **No** elimina la Live Activity de la pantalla. Se eliminará automáticamente después de 4 horas o mediante acción del usuario.
Usa el campo `event: end` para detener actualizaciones adicionales e incluye un `dismissal_date` para eliminar la Live Activity de la pantalla:
* La Live Activity se eliminará de la pantalla automáticamente después de 4 horas o mediante acción del usuario.
* Establece un tiempo de `dismissal_date` **futuro** dentro de las próximas 4 horas para eliminarla antes.
* Establece un tiempo de `dismissal_date` **pasado** para eliminarla inmediatamente de la pantalla del usuario. El usuario debe haber hecho clic en "Permitir" para que la Live Activity se elimine programáticamente.
* El usuario descarta manualmente la Live Activity, como deslizándola.
* El usuario revoca el permiso de Live Activity en Configuración de iOS.
El método del SDK *no* descarta la Live Activity visualmente.
* Los desarrolladores deben usar la API con `dismissal_date` o métodos nativos de iOS (por ejemplo, `activity.end(dismissalPolicy: .immediate)`).
* El usuario debe haber hecho clic en "Permitir" para que la Live Activity se elimine programáticamente.
***
## Análisis e informes
OneSignal proporciona análisis integrales para ayudarte a medir y optimizar el rendimiento de tus Live Activities. Realiza un seguimiento de métricas clave como tasas de entrega, clics, fallos y cambios de suscripción.
**Métricas clave disponibles:**
* **Enviado**: Live Activities enviadas desde OneSignal al servicio de notificaciones push de Apple (APNs)
* **Entrega confirmada**: Live Activities confirmadas como entregadas a dispositivos (requiere iOS SDK 5.2.15+)
* **Fallido**: Live Activities que no se pudieron entregar
* **Cancelado**: Suscripciones marcadas como canceladas cuando los usuarios descartan o desactivan Live Activities
* **Clicado**: Total de clics en todas las Live Activities
Para información detallada sobre informes de mensajes, actividad de audiencia, exportación de datos y análisis de rendimiento, consulta nuestra [guía de análisis de Live Activities](./live-activities-analytics).
***
## Mejores prácticas y pautas
### Funcionalidad
* Usa Live Activities para actualizaciones transaccionales o contextuales (por ejemplo, ETA, marcador, temporizador).
* En lugar de que los usuarios entren constantemente a tu app para verificar estados o cambios, pueden obtener actualizaciones de un vistazo en su teléfono.
* Eventos o tareas con un comienzo y un final definidos. No uses una Live Activity para mostrar anuncios o servir propósitos puramente promocionales. ¿Qué valor estás proporcionando?
* Evita actualizaciones excesivas para preservar la batería del dispositivo.
* Asegúrate de que una Live Activity sea para un evento o tarea que no dure más de 8 horas, y que solo se muestre mientras sea útil para el usuario.
### UI/UX
* Soporta todas las presentaciones de Live Activity: Compacta, Minimal, Expandida, Pantalla de bloqueo.
* Usa branding, espaciado y temas oscuros/claros correctamente.
* Prioriza la claridad y los objetivos táctiles. No intentes llamar la atención hacia el Dynamic Island.
* Evita mostrar información sensible en una Live Activity.
Consulta las [Pautas de interfaz humana de Live Activities](https://developer.apple.com/design/human-interface-guidelines/live-activities) de Apple para más información sobre mejores prácticas para Live Activities.
### Orientación y envío a escala
Asegúrate de que una Live Activity aparezca cuando se espera, usualmente cuando un usuario toma una acción (por ejemplo, para seguir un evento) o abre la app para verificar actualizaciones (por ejemplo, tiempo de entrega actualizado).
* Orienta segmentos de usuarios para eventos como juegos deportivos, conciertos u otros eventos en vivo.
* Orienta usuarios individuales para eventos personales o transaccionales.
Los detalles sobre cómo orientar usuarios se pueden encontrar en nuestra [documentación de API de OneSignal para enviar mensajes](reference/create-message).
Al actualizar Live Activities, tienes la opción de establecer una "prioridad" que Apple usa para determinar qué tan urgente es la actualización. Apple tiene umbrales internos en los que limitará solicitudes que usan la bandera de alta prioridad con demasiada frecuencia. Debido a este umbral interno, Apple recomienda elegir una mezcla de prioridad normal y alta para prevenir la limitación. Los detalles sobre cómo establecer la prioridad se pueden encontrar en nuestra [referencia de API de Update Live Activity](/reference/update-live-activity-api).
Si tu caso de uso depende de actualizaciones de alta prioridad más frecuentes, puedes agregar la clave `NSSupportsLiveActivitiesFrequentUpdates` a tu Info.plist como un tipo Boolean establecido en YES según lo indicado en la [Documentación de desarrollador de Apple](https://developer.apple.com/documentation/activitykit/starting-and-updating-live-activities-with-activitykit-push-notifications#Determine-the-update-frequency). Se presentará un diálogo a los usuarios cuando la Live Activity exceda su presupuesto push, y si permiten que la Live Activity continúe, el presupuesto se incrementará automáticamente para una experiencia de usuario sin interrupciones.
***
## Preguntas frecuentes
### ¿Tengo acceso a Live Activities en mi plan?
Live Activities están disponibles en todos los planes excepto para planes Gratuitos con más de 10,000 suscriptores con opt-in. Si tienes más de 10,000 suscriptores con opt-in en un Plan Gratuito, puedes actualizar para usar Live Activities. [Ver precios](https://onesignal.com/pricing) o contacta a `support@onesignal.com` para asistencia.
### ¿Cuál es el presupuesto para actualizaciones de alta prioridad?
Apple no proporciona un límite fijo para actualizaciones de alta prioridad (`priority: 10`), pero sí aplican un presupuesto dinámico a nivel de sistema. Enviar demasiadas actualizaciones de alta prioridad en un período corto puede resultar en limitación, donde las actualizaciones se retrasan o se descartan.
Para reducir el riesgo de limitación:
* Usa una mezcla de niveles de prioridad: Apple recomienda usar tanto `priority: 5` (estándar) como `priority: 10` (alta) para equilibrio.
* Reserva `priority: 10` solo para actualizaciones sensibles al tiempo o críticas (por ejemplo, cambios de estado de pedido, marcadores de juegos).
Si tu caso de uso requiere actualizaciones frecuentes:
* Agrega la clave `NSSupportsLiveActivitiesFrequentUpdates` al archivo `Info.plist` de tu app, establecida como Boolean `YES`.
* Cuando este presupuesto se excede, iOS puede solicitar al usuario que permita actualizaciones adicionales. Si el usuario acepta, Apple expandirá automáticamente el límite de actualización permitido para mantener una experiencia sin interrupciones.
Para más detalles, consulta la [Documentación de desarrollador de Apple](https://developer.apple.com/documentation/activitykit/starting-and-updating-live-activities-with-activitykit-push-notifications#Determine-the-update-frequency).
### ¿Dónde puedo ver Live Activities en el Panel de OneSignal?
Las Live Activities solo pueden enviarse a través de nuestras APIs de Live Activities. Sin embargo, puedes ver Live Activities enviadas históricamente (hasta 30 días) en el panel en Mensajes enviados, después de filtrar por Live Activities. Aquí podrás ver qué Live Activities se enviaron, qué información actualizada se envió y el tamaño de audiencia que recibió la actualización.
### ¿Qué dispositivos funcionan con Live Activities?
Apple mantiene una guía de compatibilidad actualizada con todos los dispositivos que funcionan con [iOS 16+](https://support.apple.com/guide/iphone/supported-models-iphe3fa5df43/16.0/ios/16.0) e [iPadOS 17+](https://support.apple.com/guide/ipad/ipad-models-compatible-with-ipados-17-ipad213a25b2/ipados).
***
Ahora deberías estar equipado con todo lo que necesitas saber sobre Live Activities.
Comienza a configurar tus Live Activities siguiendo nuestra [Documentación de desarrollador de Live Activities](./live-activities-developer-setup).
***