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

Required setup for push notifications To start sending push notifications with OneSignal, you must first configure your OneSignal app with all the platforms your support—Apple (APNs), Google (FCM), Huawei (HMS), and/or Amazon (ADM).
If your organization already has a OneSignal account, ask to be invited as an admin role to configure the app. Otherwise, sign up for a free account to get started.
You can manage multiple platforms (iOS, Android, Huawei, Amazon, Web) under a single OneSignal app.
1

Create or select your app

  • To add platforms to an existing app, go to Settings > Push & In-App in the OneSignal dashboard.
  • To start fresh, click New App/Website and follow the prompts.

Example shows creating a new app.

2

Set up and activate a platform

  • Choose a clear and recognizable name for your app and organization.
  • Select the platform(s) you want to configure (iOS, Android, etc.).
  • Click Next: Configure Your Platform.

Example setting up your first OneSignal app, org, and channel.

3

Configure platform credentials

Follow the prompts based on your platforms:Click Save & Continue after entering your credentials.
4

Choose target SDK

Select the SDK that matches your development platform (e.g., iOS, Android, React Native, Unity), then click Save & Continue.

Select which SDK you are using to be navigated to the docs.

5

Install SDK and save your App ID

Once your platform is configured, your OneSignal App ID will be displayed. Copy and save this ID—you’ll need it when installing and initializing the SDK.If collaborating with others, use the Invite button to add developers or teammates, then click Done to complete setup.

Save your App ID and invite additional team members.

Once complete, follow the SDK installation guide for your selected platform to finish integrating OneSignal.

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.

Prompts de permiso push de iOS y Android

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”.

Panel mostrando suscripción con 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.

Panel mostrando suscripción con estado '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.

Agregar un dispositivo a 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.

Panel mostrando el campo 'Name your subscription'

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.

Crear un segmento 'Test Users' con el filtro Test Users

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:

Notificación push con imagen en iOS y Android

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.

Estadísticas de entrega mostrando entrega confirmada

Si estás en un plan Professional o superior, desplázate a Audience Activity para ver la confirmación a nivel de suscripción:

Entrega confirmada a nivel de dispositivo en Audience Activity

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.

Orientar el segmento 'Test Users' con un mensaje en la app

3

Personalizar el contenido del mensaje si lo deseas.

Ejemplo de personalización de mensaje Welcome en la app

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.

Opciones de programación de mensaje en la app

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:

Mensaje en la app Welcome mostrado en dispositivos

¿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.

Usar Additional Data con targetUrl

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.

Configurar URLs diferentes para web y móvil