Skip to main content

​
Resumen

Si tienes un sitio web optimizado para móviles y quieres convertirlo en una app móvil descargable para el Apple App Store o Google Play Store, Median.co es una solución poderosa. También ofrece una integración perfecta con OneSignal para habilitar notificaciones push.

​
Configuración

​
1. Crear tu app con Median.co

  1. Sigue la Guía de inicio de Median.co.
  2. Crea una app en <https://median.co/app>.

​
2. Configurar OneSignal

  1. Ve a onesignal.com y crea una cuenta.
  2. Configura tu app y plataforma de OneSignal.

​
Configure your OneSignal app and platform

Configure your OneSignal app with the platforms you support — Apple (APNs), Google (FCM), Huawei (HMS), and/or Amazon (ADM).
If your organization already has a OneSignal account, ask to be invited to the Organization. Otherwise, sign up for a free account to get started.
1

Create or select your app

Create a new app by clicking New App/Website, or add a platform to an existing app in Settings > Push & In-App. Select the platform(s) you want to configure and click Next: Configure Your Platform.
OneSignal dashboard showing the new app setup flow with Organization name, app name, and channel selection
2

Configure platform credentials

Enter the credentials for your platform:Click Save & Continue after entering your credentials.
3

Save your App ID and install the SDK

Your App ID is displayed on the final screen. Copy and save it — you need it when initializing the SDK. Select your SDK platform, then follow the setup guide.
OneSignal dashboard showing the App ID and team invite option after setup

​
3. Vincular OneSignal a tu app de Median

Pega el ID de app de OneSignal en la configuración de tu app de Median.co (GoNative).

​
Probar la integración del SDK de OneSignal

Esta guía te ayuda a verificar que tu integración del SDK de OneSignal funciona correctamente probando notificaciones push, registro de suscripción y mensajería en la app.

​
Verificar suscripciones móviles

1

Iniciar tu app en un dispositivo de prueba.

El prompt de permiso push nativo debería aparecer automáticamente si agregaste el método requestPermission durante la inicialización.
2

Verificar tu panel de OneSignal

Antes de aceptar el prompt, verifica el panel de OneSignal:
  • Ve a Audience > Subscriptions.
  • Deberías ver una nueva entrada con el estado “Never Subscribed”.
3

Regresar a la app y tocar Allow en el prompt.

4

Refrescar la página de Suscripciones del panel de OneSignal.

El estado de la suscripción ahora debería mostrar Subscribed.
Has creado exitosamente una suscripción móvil. Las suscripciones móviles se crean cuando los usuarios abren tu app por primera vez en un dispositivo o si desinstalan y reinstalan tu app en el mismo dispositivo.

​
Configurar suscripciones de prueba

Las suscripciones de prueba son útiles para probar una notificación push antes de enviar un mensaje.
1

Agregar a Test Subscriptions.

En el panel, junto a la suscripción, haz clic en el botón Options (tres puntos) y selecciona Add to Test Subscriptions.
2

Nombrar tu suscripción.

Nombra la suscripción para que puedas identificar fácilmente tu dispositivo más tarde en la pestaña Test Subscriptions.
3

Crear un segmento de usuarios de prueba.

Ve a Audience > Segments > New Segment.
4

Nombrar el segmento.

Nombra el segmento Test Users (el nombre es importante porque se usará más adelante).
5

Agregar el filtro Test Users y hacer clic en Create Segment.

Has creado exitosamente un segmento de usuarios de prueba. Ahora podemos probar el envío de mensajes a este dispositivo individual y grupos de usuarios de prueba.

​
Enviar push de prueba vía API

1

Obtener tu clave API de app y tu ID de app.

En tu panel de OneSignal, ve a Settings > Keys & IDs.
2

Actualizar el código proporcionado.

Reemplaza YOUR_APP_API_KEY y YOUR_APP_ID en el código a continuación con tus claves reales. Este código usa el segmento Test Users que creamos anteriormente.
curl -X \
POST --url 'https://api.onesignal.com/notifications' \
 --header 'content-type: application/json; charset=utf-8' \
 --header 'authorization: Key YOUR_APP_API_KEY' \
 --data \
 '{
  "app_id": "YOUR_APP_ID",
  "target_channel": "push",
  "name": "Testing basic setup",
  "headings": {
  	"en": "👋"
  },
  "contents": {
    "en": "Hello world!"
  },
  "included_segments": [
    "Test Users"
  ],
  "ios_attachments": {
    "onesignal_logo": "https://avatars.githubusercontent.com/u/11823027?s=200&v=4"
  },
  "big_picture": "https://avatars.githubusercontent.com/u/11823027?s=200&v=4"
}'
3

Ejecutar el código.

Ejecuta el código en tu terminal.
4

Verificar imágenes y entrega confirmada.

Si todos los pasos de configuración se completaron exitosamente, las suscripciones de prueba deberían recibir una notificación con una imagen incluida:
Las imágenes aparecerán pequeñas en la vista de notificación contraída. Expande la notificación para ver la imagen completa.
5

Verificar entrega confirmada.

En tu panel, ve a Delivery > Sent Messages, luego haz clic en el mensaje para ver las estadísticas.Deberías ver la estadística confirmed, lo que significa que el dispositivo recibió el push.
Has enviado exitosamente una notificación vía nuestra API a un segmento.
  • ¿No recibiste la imagen? Puede que falte tu Notification Service Extension.
  • ¿Sin entrega confirmada? Revisa tu configuración de App Groups.
  • ¿Tienes problemas? Copia y pega la solicitud de API y un registro desde el inicio hasta el fin del lanzamiento de la app en un archivo .txt. Luego comparte ambos con support@onesignal.com.

​
Enviar un mensaje en la app

Los mensajes en la app te permiten comunicarte con usuarios mientras están usando tu app.
1

Cerrar o poner en segundo plano tu app en el dispositivo.

Esto se debe a que los usuarios deben cumplir con los criterios de audiencia en la app antes de que comience una nueva sesión. En OneSignal, una nueva sesión comienza cuando el usuario abre tu app después de que ha estado en segundo plano o cerrada durante al menos 30 segundos. Para más detalles, consulta nuestra guía sobre cómo se muestran los mensajes en la app.
2

Crear un mensaje en la app.

  • En tu panel de OneSignal, navega a Messages > In-App > New In-App.
  • Encuentra y selecciona el mensaje Welcome.
  • Establece tu Audiencia como el segmento Test Users que usamos anteriormente.
3

Personalizar el contenido del mensaje si lo deseas.

4

Establecer Trigger a 'On app open'.

5

Programar frecuencia.

En Schedule > How often do you want to show this message? selecciona Every time trigger conditions are satisfied.
6

Activar mensaje.

Haz clic en Make Message Live para que esté disponible para tus Test Users cada vez que abran la app.
7

Abrir la app y ver el mensaje.

Después de que el mensaje en la app esté activo, abre tu app. Deberías verlo mostrarse:
¿No ves el mensaje?
  • Inicia una nueva sesión
    • Debes cerrar o poner en segundo plano la app durante al menos 30 segundos antes de reabrirla. Esto asegura que se inicie una nueva sesión.
    • Para más información, consulta cómo se muestran los mensajes en la app.
  • ¿Aún en el segmento Test Users?
    • Si reinstalaste o cambiaste de dispositivo, vuelve a agregar el dispositivo a Test Subscriptions y confirma que es parte del segmento Test Users.
  • ¿Tienes problemas?
    • Sigue Obtener un registro de depuración mientras reproduces los pasos anteriores. Esto generará registros adicionales que puedes compartir con support@onesignal.com y te ayudaremos a investigar qué está ocurriendo.
Has configurado exitosamente el SDK de OneSignal y aprendido conceptos importantes como:

​
Solicitar permisos push

En lugar de llamar a requestPermission() inmediatamente al abrir la app, toma un enfoque más estratégico. Usa un mensaje en la app para explicar el valor de las notificaciones push antes de solicitar permiso. Para mejores prácticas y detalles de implementación, consulta nuestra guía Solicitar permisos push.

​
Preguntas frecuentes

​
¿Cómo puedo acceder a datos de OneSignal en el lado del cliente?

Usa el método de puente de JavaScript nativo de Median median_onesignal_info para recuperar el ID de suscripción de OneSignal (oneSignalUserId) y el estado de suscripción.
javascript
  var osSubscriptionId = "the OneSignal Subscription ID string";
  var isSubscribedToPushNotifications;

  median.onesignal.onesignalInfo().then(function (oneSignalInfo) {
    console.log(oneSignalInfo);
    osSubscriptionId = oneSignalInfo.oneSignalUserId;
    isSubscribedToPushNotifications = oneSignalInfo.oneSignalSubscribed;
  });
Más detalles en Documentos de Median.co
Las apps de Median usan deep linking para una experiencia nativa en lugar de abrir un navegador emergente.

​
Al usar el panel de OneSignal:

  • No uses el campo Launch URL.
  • En su lugar, usa el campo Additional Data.
    • Agrega una clave: targetUrl (“U” mayúscula)
    • Agrega un valor: la URL que quieres que los usuarios abran.

​
Al usar la API REST:

Incluye targetUrl en el objeto data de tu payload de push. Ejemplo: 
{
  "app_id": "YOUR-APP-ID",
  "include_player_ids": ["USER-ID"],
  "data": { "targetUrl": "https://example.com/page" },
  "contents": { "en": "Check out this page!" }
}

​
¿Enviando a web y móvil simultáneamente?

Si envías a web y móvil simultáneamente: En la sección Launch URL, selecciona “Different URL for web/app”. Deja el campo APP URL en blanco para evitar sobrescritura.