Median.co (anteriormente GoNative.io)

​

Resumen

​

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

Step-by-step instructions for configuring your OneSignal app.

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.

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.

3

Configure platform credentials

Follow the prompts based on your platforms:

• Android: Set up Firebase Credentials
• iOS: p8 Token (Recommended) or p12 Certificate
• Amazon: Generate API Key
• Huawei: Authorize OneSignal

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.

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.

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

​

3. Vincular OneSignal a tu app de Median

​

Probar la integración del SDK de OneSignal

​

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

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.

Copy

Ask AI

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.

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

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 [email protected].

​

Enviar un mensaje en la 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 [email protected] y te ayudaremos a investigar qué está ocurriendo.

​

Solicitar permisos push

​

Preguntas frecuentes

​

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

  var osSubscriptionId = "the OneSignal Subscription ID string";
  var isSubscribedToPushNotifications;

  median.onesignal.onesignalInfo().then(function (oneSignalInfo) {
    console.log(oneSignalInfo);
    osSubscriptionId = oneSignalInfo.oneSignalUserId;
    isSubscribedToPushNotifications = oneSignalInfo.oneSignalSubscribed;
  });

​

¿Cómo envío notificaciones push de deep link a mi app de Median?

​

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:

{
  "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?