Gestión de aplicaciones

Mis aplicaciones (panel de control)

Mis aplicaciones (/ o /apps) es la página de inicio tras iniciar sesión y el punto central de todas las aplicaciones que gestiona tu equipo.

La tabla de aplicaciones. Cada fila muestra: un índice numérico, el icono de la aplicación (o un avatar con una letra si no se ha subido ningún icono) junto con su nombre e ID de paquete/bundle, la marca asignada, la tienda (un icono de plataforma para iOS/Android/Amazon), la versión actual del SDK (ordenable), un indicador de estado de la configuración predeterminada (verde, "Añadida", si se ha generado una configuración predeterminada para la aplicación; gris, "No añadida", en caso contrario), la fecha de creación (ordenable) y una columna de acciones.

Búsqueda y filtros. Un cuadro de búsqueda filtra por nombre/paquete mientras escribes. Los filtros desplegables independientes de marca, tienda y versión del SDK (en la barra de filtros) se pueden combinar con la búsqueda. La paginación utiliza un pie personalizado con el texto "Mostrando X–Y de Z", un selector de filas por página y botones de navegación ⟨ ‹ › ⟩, en lugar del paginador integrado de la tabla.

Menú de acciones. El menú de tres puntos de cada fila ofrece las opciones Editar, Duplicar y Eliminar, según tus permisos (consulta más abajo los límites del plan y los permisos de la vista compartida).

Límites del plan y aplicaciones bloqueadas. Tu plan de suscripción limita el número de aplicaciones que puedes tener (maxApps). Si tu número actual de aplicaciones supera ese límite —por ejemplo, tras cambiar a un plan inferior—, aparece un aviso de color ámbar en la parte superior de la página: "Has superado el límite de aplicaciones — X/Y aplicaciones utilizadas", con una pequeña barra de progreso y un botón Mejorar plan que enlaza a Suscripción.

Cuando superas el límite, el portal no elige arbitrariamente qué aplicaciones bloquear: mantiene disponibles las más antiguas (por fecha de creación), hasta el límite de tu plan, y bloquea todas las creadas después. El menú de acciones de una aplicación bloqueada se reduce a una versión restringida: al hacer clic en el botón de tres puntos, solo se muestra el encabezado "BLOQUEADA" con la explicación "Esta aplicación supera el límite de tu plan. Elimínala para liberar una plaza" y, si tienes permiso para eliminar, una opción roja "Eliminar aplicación". Editar y Duplicar no están disponibles en las filas bloqueadas; la única forma de recuperar el acceso a una aplicación bloqueada es eliminar otras aplicaciones para liberar una plaza o mejorar tu plan.

Botón de creación. El botón + Crear aplicación solo está habilitado si tu plan aún tiene capacidad (canCreateApp()). Si has alcanzado el límite, se sustituye por un pequeño indicador de uso ("X/Y aplicaciones utilizadas") y un enlace "🔒 Mejorar plan" a Suscripción.

Vista compartida/de colaborador. Si estás viendo esta página en el contexto de otra cuenta o de una cuenta compartida (consulta el menú de cuenta más arriba), la tabla también consulta tus permisos específicos para esa cuenta (mediante /rights/user-permissions) y los utiliza para habilitar o restringir Editar/Eliminar/Duplicar en cada fila. Por ejemplo, podrías ver y editar aplicaciones, pero no eliminarlas, según los permisos que te haya concedido el propietario del recurso.

Añadir una nueva aplicación

Al hacer clic en + Crear aplicación, se abre el formulario de aplicación en modo de creación, en un modal vertical centrado.

Campos:

• Icono — opcional. En la parte superior, un área cuadrada grande para subir archivos muestra "Subir imagen" hasta que se selecciona un archivo; los formatos admitidos son JPEG, PNG y GIF.
• Tienda — selección obligatoria mediante botones de opción: Apple App Store, Google Play o Amazon App Store (las opciones se cargan dinámicamente desde el backend; si la llamada falla, se utilizan estas tres como alternativa).
• Nombre — obligatorio, entre 4 y 70 caracteres.
• ID de paquete / bundle — obligatorio, debe comenzar por com. (se valida con el patrón com.*).
• URL — obligatoria al crear. Si seleccionas Google Play como tienda, se rellena automáticamente con https://play.google.com/store/apps/details?id={package}; si seleccionas Apple App Store, se rellena con la URL base https://apps.apple.com/. Puedes editar la URL manualmente después del autocompletado. Además, si cambias el paquete mientras Google Play está seleccionado, la URL autocompletada se mantiene sincronizada.
• Marca — un desplegable con tus marcas existentes.

Al enviar el formulario, se llama al endpoint de creación de aplicaciones y la aplicación se crea sin ninguna red de mediación ni unidades de anuncios configuradas. Estas se configuran después, en Detalles de la aplicación. Al hacer clic en Cancelar, el modal se cierra sin guardar.

Editar o duplicar una aplicación (modal rápido)

Al elegir Editar en el menú de acciones de una fila, se abre el mismo componente de formulario en modo de edición, pero dispuesto en una única fila horizontal compacta en lugar del diseño vertical de creación: icono (con un pequeño botón de lápiz superpuesto para sustituirlo), Nombre, un campo Paquete de solo lectura, un campo URL de solo lectura, el desplegable Marca y un botón Guardar. Paquete y URL pasan a ser permanentemente de solo lectura una vez creada la aplicación (no puedes cambiar el ID de paquete ni la URL de la tienda después de crearla; solo su nombre, icono y marca). Esta fila está sujeta a una comprobación del permiso canUpdate, que en un contexto compartido/de colaborador depende de los permisos de Información de la aplicación que se te hayan concedido.

Al elegir Duplicar, se abre una segunda copia del formulario en modo de creación, rellenada con los datos de la aplicación de origen y con .copy añadido al nombre del paquete para evitar conflictos con el original. Puedes ajustar lo que quieras (nombre, icono, marca) antes de guardarla como una aplicación completamente nueva. La mediación, las unidades de anuncios y el resto de los ajustes de Detalles de la aplicación no se copian; la copia parte de cero, igual que una aplicación recién creada.

Detalles de la aplicación

Al abrir una aplicación (desde Mis aplicaciones → Editar o haciendo clic en la propia fila), accedes a Detalles de la aplicación: la página más compleja del portal, donde se configura el comportamiento real del SDK para esa aplicación.

Modo Live frente a Dev. Un selector en la parte superior permite alternar toda la página entre las configuraciones de Live (producción) y Dev (desarrollo). Cada sección que aparece a continuación —Mediación, Unidades de anuncios, Emplazamientos, Opciones de visualización, MMP, Promoción de funcionalidades y Ajustes— se configura por separado para cada modo, de modo que puedes preparar y probar cambios en Dev sin afectar a la configuración en producción de tu aplicación publicada. Dos botones, Aplicar Live a Dev y Aplicar Dev a Live, permiten copiar toda la configuración de un modo al otro en una sola acción (útil para pasar a Live una configuración de Dev ya probada o restablecer Dev para que coincida con Live antes de probar algo nuevo).

El encabezado de la página también muestra el número actual de Versión de configuración de la aplicación, un enlace a Historial de cambios (consulta más abajo) y un botón Obtener configuración (consulta más abajo). Algunos elementos de la interfaz de configuración (y el selector de grupos de regiones mencionado más abajo) solo aparecen cuando la versión del SDK notificada por la aplicación cumple determinados requisitos mínimos. El portal restringe algunas funciones nuevas a versiones mínimas del SDK para no mostrar a las compilaciones antiguas de la aplicación opciones que no pueden utilizar.

El resto de la página se organiza en secciones desplegables, en este orden:

Información de la aplicación

Los datos básicos de identificación de la aplicación: nombre, ID de paquete/bundle, tienda, icono y marca asignada. Son, en esencia, los mismos campos del formulario de creación/edición, disponibles aquí para mayor comodidad.

Selección de mediación

Elige la red de mediación utilizada para esta aplicación y este modo (por ejemplo, una red de tipo cascada o AppLovin MAX). Esta selección es un requisito previo: hasta que elijas una red de mediación, las secciones Unidades de anuncios, Emplazamientos de anuncios y Unidades de anuncios para emplazamientos permanecerán bloqueadas, porque dependen del SDK y del formato de unidad de anuncios de la red que vayas a configurar.

Añadir unidades de anuncios

Introduce los IDs de unidades de anuncios proporcionados por tu red de mediación, organizados en pestañas por formato: Apertura de aplicación, Intersticial, Banner, Nativo y Bonificado. Solo aparecen pestañas para los formatos compatibles con la red de mediación seleccionada anteriormente.

Emplazamientos de anuncios

Define emplazamientos con nombre: los espacios lógicos de tu aplicación o juego donde puede aparecer un anuncio (por ejemplo, "Nivel completado" o "Banner del menú principal"). Se muestran en una cuadrícula numerada en la que puedes añadir o renombrar emplazamientos. Como los nombres de los emplazamientos suelen tener que coincidir con constantes del código fuente de tu aplicación, el portal permite importar y exportar toda la lista como un archivo de enumeración de Kotlin (.kt). Así puedes mantener sincronizados el código y la configuración del portal sin tener que volver a introducir los nombres manualmente.

Unidades de anuncios para emplazamientos de anuncios

Una cuadrícula de asignación: los emplazamientos aparecen en un eje y los formatos de anuncios (Intersticial / Banner / Nativo / Bonificado) en el otro. Para cada combinación, eliges qué unidad de anuncios específica (de las añadidas anteriormente) debe servir anuncios en ese emplazamiento.

Cabe destacar que Promoción cruzada también aparece como opción seleccionable en esta cuadrícula, junto a las unidades de tus redes publicitarias. Si la eliges para un emplazamiento, ese espacio no mostrará ningún anuncio de pago de una red; en su lugar, mostrará una creatividad de promoción cruzada de una de tus otras aplicaciones, según lo configurado en Campañas. Este es el mecanismo que conecta la función Campañas con las ubicaciones reales de anuncios dentro de tus aplicaciones.

Opciones de visualización de anuncios

Controla la experiencia de carga de cada formato: si se muestra un diálogo de carga o un efecto shimmer mientras se obtiene el anuncio y el tiempo máximo de espera antes de cancelar el intento. Los anuncios intersticiales ofrecen opciones adicionales para la lógica de activación, más allá de los tiempos de visualización: puedes activarlos al hacer clic, después de un intervalo de tiempo, con una combinación de ambos o según las transiciones de escena dentro de la aplicación. Cada modo de activación incluye sus propios parámetros ajustables (por ejemplo, el intervalo de tiempo o el número de clics).

Selección de MMP

Conecta un socio de medición móvil (MMP) —entre las opciones se incluyen Adjust, AppsFlyer, Firebase, Cost Center y Solar Engine— y activa o desactiva los informes de ingresos publicitarios por formato de anuncio. Así, los eventos de ingresos publicitarios se envían a tus herramientas de atribución y analítica junto con el resto de los datos de instalaciones e interacción.

Promoción de funcionalidades

Configura banners o tarjetas promocionales dentro de la aplicación que no estén relacionados con redes publicitarias; por ejemplo, para anunciar una nueva funcionalidad o promocionar un plan prémium en la interfaz de tu propia aplicación. Cada entrada de esta tabla editable tiene un título, un tipo, una clave, una imagen y una acción (como un enlace profundo o un destino de navegación dentro de la aplicación) que se ejecuta cuando el usuario la toca.

Ajustes

Opciones diversas a nivel de aplicación que no encajan en otras secciones: activar los registros de consola para depuración, activar el registro de eventos publicitarios, establecer una tolerancia de diferencia horaria permitida para las notificaciones locales y definir las URL de la Política de privacidad y los Términos del servicio de la aplicación (que algunas redes publicitarias y tiendas de aplicaciones exigen mostrar).

Obtener configuración

Al hacer clic en Obtener configuración, se genera una cadena de configuración cifrada que representa todo lo configurado anteriormente para el modo (Live o Dev) que esté activo. Si has seleccionado un grupo de regiones en el selector de regiones del encabezado de Detalles de la aplicación, el enlace o la cadena generados incluyen el ID de ese grupo como parámetro de consulta, de modo que la configuración obtenida en tiempo de ejecución puede variar según el grupo de regiones. El portal también te guía para publicar esa cadena mediante Firebase Remote Config con la clave de parámetro AKS_AND_LIVE. Así es como tu aplicación en producción obtiene la configuración en tiempo de ejecución, ya que el portal no envía la configuración directamente a los dispositivos de los usuarios finales.

Historial de cambios

Cada vez que se guarda la configuración de una aplicación, se registra una nueva Versión de configuración. Historial de cambios (una página independiente a la que se accede desde el enlace en Detalles de la aplicación) muestra todas las versiones de esa aplicación en una tabla: un número de secuencia, la versión de configuración, una descripción de los cambios (las descripciones largas se delimitan internamente con barras verticales y se muestran en líneas separadas; a partir de los primeros 20 caracteres, se truncan con un control "Mostrar más / Mostrar menos"), la fecha de actualización y quién la actualizó. Un filtro de intervalo de fechas en la parte superior limita la lista a un periodo concreto. Esto proporciona un registro de auditoría básico de quién cambió la configuración de una aplicación y cuándo.

Compartido conmigo

Si otro equipo te ha invitado a colaborar en sus aplicaciones y has aceptado, esos recursos compartidos aparecen en Compartido conmigo (/SharedWithMe): una tabla de las invitaciones recibidas, separada de las aplicaciones que pertenecen a tu propio equipo. Cada fila muestra quién envió la invitación y su estado actual.

Desde aquí puedes Aceptar o Rechazar una invitación pendiente. Ambas acciones llaman al mismo endpoint de gestión de invitaciones con la decisión correspondiente. Una vez aceptada, la cuenta que te invitó aparece en el desplegable del selector de cuentas (descrito más arriba), para que puedas acceder a ella y trabajar con los permisos que te hayan concedido.

Si llegas a esta página mediante un enlace de notificación que contiene el parámetro de consulta ?invitationId=, el Diálogo de invitación se abre automáticamente al cargar, sin que tengas que buscar la fila.

El diálogo de invitación. Este modal muestra el correo electrónico de la cuenta que invita en una etiqueta con forma de píldora en la parte superior, junto con un encabezado y un icono que dependen del estado: un regalo para una invitación pendiente, una marca de verificación para una ya aceptada, una X para una rechazada y un reloj para una caducada. Debajo aparece una lista desplazable titulada "Acceso a N recurso(s)". Cada fila muestra un icono de aplicación genérico, el nombre del recurso (por ejemplo, "Aplicaciones" o "Información de la aplicación", formateado a partir de la clave de permiso subyacente) e insignias alineadas a la derecha con los permisos que tendrías sobre él (Lectura / Creación / Actualización / Eliminación). Si la invitación tiene fecha de caducidad, se muestra en una línea de advertencia.

Los botones del pie dependen del estado: una invitación pendiente muestra "Ahora no" y "✓ Aceptar invitación"; una invitación ya resuelta o caducada solo muestra "Cerrar", junto con un texto explicativo (para una invitación caducada, algo como "Pide a {correo de quien te invitó} que envíe una nueva invitación").

---