Saltar al contenido principal

Apps y seguimiento multiplataforma

Las apps te permiten registrar usuarios en distintas plataformas (web, iOS y Android) con claves de SDK independientes, mientras lo gestionas todo desde un mismo lugar.

¿Qué son las apps?​

Las apps representan las diferentes plataformas o propiedades en las que registras usuarios:

  • App web: tu sitio web o aplicación web.
  • App para iOS: tu aplicación móvil para iOS.
  • App para Android: tu aplicación móvil para Android.

Cada app recibe una clave de SDK única para el seguimiento, mientras todos los datos fluyen a tu organización de Joryio.

¿Por qué usar varias apps?​

Registrar actividad en todas las plataformas​

Descubre qué usuarios interactúan con tu app web frente a tus apps móviles:

Recorrido del usuario:
1. Visita el sitio web (app web)
2. Se registra en la web
3. Descarga la app para iOS
4. Compra desde iOS

Segmentar por plataforma​

Dirígete a usuarios según el uso de la plataforma:

Objetivo: usuarios que han usado la app para iOS pero NO la app para Android
Campaña: "Prueba nuestra app para Android"

Analizar el rendimiento por plataforma​

Compara métricas entre plataformas:

App web:
  - 10.000 usuarios activos
  - 50.000 eventos/día
  - Función más usada: exportar

App para iOS:
  - 5.000 usuarios activos
  - 25.000 eventos/día
  - Función más usada: cámara

Crear una app​

Paso 1: ir a Apps​

  1. Ve a Configuración → Apps.
  2. Haz clic en Crear app.

Paso 2: configurar la app​

  • Nombre: un nombre descriptivo (por ejemplo, "Mi sitio web", "App para iOS").
  • Plataforma: elige web, iOS o Android.

Paso 3: obtener la clave de SDK​

Después de crearla, recibirás una clave de SDK única:

jry_sdk_web_abc123...     (Web)
jry_sdk_ios_def456...     (iOS)
jry_sdk_android_ghi789... (Android)
Formato de la clave de SDK

Las claves de SDK incluyen la plataforma en la propia clave para identificarlas fácilmente.

Usar claves de SDK​

import JoryioSDK from '@joryio/web-sdk';

const joryio = new JoryioSDK({
  sdkKey: 'jry_sdk_web_abc123...' // La clave de SDK de tu app web
});

Metadatos automáticos de la app​

Todos los eventos registrados mediante un SDK incluyen automáticamente metadatos de la app:

{
  "eventName": "Page Viewed",
  "properties": {
    "page": "/pricing",
    // Se añade automáticamente:
    "$app_id": "app_123",
    "$app_name": "My Website",
    "$platform": "web",
    "$session_id": "session_456"
  }
}

Esto permite una segmentación avanzada por app o plataforma.

Analítica de apps​

Consulta la analítica de cada app:

  1. Ve a Configuración → Apps.
  2. Haz clic en Ver analítica para una app.

Métricas disponibles​

Estadísticas generales:

  • Total de eventos registrados.
  • Usuarios activos (últimos 30 días).
  • Marca de tiempo del último evento.

Eventos a lo largo del tiempo:

  • Volumen de eventos diario.
  • Análisis de tendencias.

Eventos principales:

  • Eventos registrados con más frecuencia.
  • Recuentos y porcentajes de eventos.

Segmentar por uso de la app​

Crea segmentos con el filtro Uso de app / sitio (operadores: ha usado la app / no ha usado la app). Como una app ya implica su plataforma, puedes dirigirte a plataformas eligiendo las apps correspondientes:

Ejemplo 1: usuarios exclusivamente móviles​

Ha usado la app "App para iOS"
AND
NO ha usado la app "Mi sitio web"

Ejemplo 2: usuarios multiplataforma​

Ha usado la app "Mi sitio web"
AND
Ha usado la app "App para iOS"

Ejemplo 3: comportamiento específico de una app​

Ha usado la app "App para iOS"
AND
Ha realizado "Pedido completado" en los últimos 30 días

Úsalo para: fomentar la adopción de la app móvil y enviar mensajes específicos por plataforma.

Gestionar apps​

Ver todas las apps​

Configuración → Apps muestra todas tus apps con:

  • Nombre y plataforma de la app.
  • Clave de SDK (con botón para copiar).
  • Fecha de creación.
  • Acciones rápidas.

Editar una app​

  1. Haz clic en el nombre de la app o en el icono de edición.
  2. Actualiza el nombre.
  3. Haz clic en Guardar.
No se puede cambiar la plataforma

El tipo de plataforma no puede cambiarse después de crear la app. Crea una app nueva si la necesitas.

Regenerar la clave de SDK​

Si una clave de SDK se ve comprometida:

  1. Haz clic en Regenerar clave para la app.
  2. Confirma la acción.
  3. Actualiza tu aplicación con la clave nueva.
Cambio incompatible

Regenerar una clave de SDK invalida inmediatamente la clave anterior. Actualiza tu app antes de regenerarla.

Eliminar una app​

  1. Haz clic en Eliminar para la app.
  2. Confirma la eliminación.
Impacto en los datos

Al eliminar una app:

  • Se invalida la clave de SDK (el seguimiento se detiene).
  • Los eventos ya ingeridos permanecen en tu almacén analítico.
  • La acción no se puede deshacer.

Prácticas recomendadas​

1. Una app por plataforma​

Crea apps independientes para cada plataforma:

Correcto

  • "My Website" (web)
  • "App para iOS" (iOS)
  • "App para Android" (Android)

Incorrecto

  • "Todas las plataformas" (web): mezcla de plataformas

2. Nombres descriptivos​

Usa nombres claros y fáciles de reconocer:

Correcto: "App web de producción", "iOS - App Store" Incorrecto: "App 1", "Prueba"

3. Protege las claves de SDK​

  • No incluyas nunca claves de SDK en repositorios públicos.
  • Usa variables de entorno.
  • Regénéralas si quedan expuestas.
// Correcto: usa variables de entorno
const joryio = new JoryioSDK({
  sdkKey: process.env.JORYIO_SDK_KEY
});

// Incorrecto: clave codificada directamente
const joryio = new JoryioSDK({
  sdkKey: 'jry_sdk_web_abc123...'
});

Casos de uso habituales​

1. Campañas específicas por plataforma​

Envía mensajes segmentados según la plataforma:

Segment: iOS users who haven't updated in 30 days
Campaign: "New features in latest iOS app update"

2. Analítica multiplataforma​

Compara la interacción de los usuarios entre plataformas:

Query: How many users are active on both web and mobile?
Segment: Has used platform "web" AND has used platform "ios"

3. Migración entre plataformas​

Anima a los usuarios a probar otras plataformas:

Segment: Active web users who haven't downloaded mobile app
Campaign: "Take us on the go - download our mobile app"

4. Funciones específicas por plataforma​

Registra el uso de funciones por plataforma:

Event: Feature Used
Properties: { feature: "camera", platform: "ios" }

Analysis: Camera feature only available on mobile

Recorrido del usuario entre varias apps​

Registra a los usuarios a lo largo de todo su recorrido:

Cronología de user_123:

Día 1 (app web):
  - Registro completado
  - Perfil creado
  - Precios consultados

Día 3 (app para iOS):
  - App instalada
  - Inicio de sesión
  - Primera compra

Día 7 (app web):
  - Inicio de sesión
  - Configuración actualizada

Día 14 (app para Android):
  - App instalada
  - Inicio de sesión
  - Función utilizada

Todo se registra automáticamente con los metadatos de la app.

Seguridad y control de acceso​

Permisos de las claves de SDK​

Las claves de SDK (lado cliente) solo pueden:

  • Registrar eventos.
  • Identificar usuarios.
  • Enviar atributos de usuario.
  • No pueden acceder a otros datos de la organización.
  • No pueden enviar campañas.
  • No pueden eliminar usuarios.

Permisos de las claves de API​

Las claves de API (lado servidor) se gestionan en Configuración → Claves de API e incluyen los permisos que les otorgues, como:

  • Todas las operaciones de SDK.
  • Gestión de campañas.
  • Consultas de usuarios.
  • Acceso a la analítica.
No uses nunca claves de API en código cliente

Las claves de API solo deben usarse del lado servidor. Usa claves de SDK para el seguimiento del lado cliente.

Solución de problemas​

Los eventos no aparecen​

Comprueba que la clave de SDK sea correcta:

// Activa el modo de depuración
const joryio = new JoryioSDK({
  sdkKey: 'jry_sdk_web_...',
  enableDebug: true // Consulta los registros en la consola
});

Comprueba que la app esté activa:

  • Ve a Configuración → Apps.
  • Comprueba el estado de la app.
  • Confirma que la clave de SDK coincida.

La analítica no se actualiza​

La analítica se actualiza en tiempo real, pero puede tener unos segundos de retraso:

  • Comprueba la marca de tiempo de «Último evento».
  • Verifica que se estén registrando eventos.
  • Prueba a actualizar la página.

Coincidencia de usuarios entre plataformas​

Los usuarios se vinculan mediante:

  1. ID de usuario (si se han identificado).
  2. ID anónimo (antes de identificarse).

Asegúrate de identificar a los usuarios de forma coherente en todas las plataformas:

// Web
joryio.identify('user_123');
joryio.setAttributes({
  email: 'user@example.com',
  name: 'John Doe'
});

// iOS (same user ID)
Joryio.shared.identify("user_123")
Joryio.shared.setAttributes([
  "email": "user@example.com",
  "name": "John Doe"
])

Próximos pasos​