Plugin de WordPress de OneSignal para push web

​

Descripción general

​

Novedades en la versión 3+

• 🚀 Actualización del SDK: Actualiza el SDK web de OneSignal de la versión 15 a la 16
• 💬 Solicitudes desde el panel: Configure todas las solicitudes de permiso directamente en el panel de OneSignal, sin necesidad de código personalizado
• ⏩ Publicación con un clic: Marque “Enviar notificación cuando se publique la entrada” para enviar automáticamente notificaciones push
• 🧑‍🤝‍🧑 Segmentación de audiencia: Elija qué segmentos reciben notificaciones para cada entrada
• 📲 Integración con aplicaciones móviles: Envíe a suscriptores de aplicaciones móviles con enlaces profundos opcionales

​

Configuración

• Cuenta de OneSignal (gratis para crear)
• Acceso de administrador de WordPress para instalar y configurar plugins
• Sitio web con HTTPS habilitado (requerido para notificaciones push web)

​

1. Configurar WordPress en el panel de OneSignal

​

Configuración del sitio

• Nombre del sitio: El nombre de su sitio y el título predeterminado de las notificaciones.
• URL del sitio: Debe coincidir exactamente con la URL de su sitio de WordPress (siga la política del mismo origen)
• Resuscripción automática: Habilite esto para resuscribir automáticamente a los usuarios que borren los datos de su navegador cuando regresen a su sitio (no se requiere nueva solicitud de permiso)
• URL del icono predeterminado: PNG, JPG o GIF no animado cuadrado de 256×256 para notificaciones y solicitudes. Consulte Iconos de notificación.

​

Solicitudes de permiso

• Configuración básica de solicitud
• Avanzado: Segmentación basada en categorías

1

Haga clic en Push Slide Prompt para personalizar

2

Configure el tiempo y el texto:

• Establezca Auto Prompt en 1 vista de página y 1 segundo para las pruebas iniciales
  • Personalice el texto y la apariencia de la solicitud
  • Ajuste el tiempo según el comportamiento del usuario después del lanzamiento

3

Haga clic en Done cuando haya terminado de configurar la solicitud.

Para mensajes dirigidos basados en los intereses del usuario, configure categorías:

1

Seleccione Categorías en la configuración de su solicitud

2

Configure cada categoría con:

• Etiqueta (Label): Lo que los usuarios ven en la solicitud
• Clave de etiqueta (Tag Key): Clave de etiqueta interna para segmentación

3

Haga clic en Done cuando haya terminado de configurar la solicitud.

Lógica de etiquetas: Las categorías marcadas establecen el valor de la etiqueta en 1, las no marcadas en 0. Estas etiquetas permiten mensajes dirigidos a intereses específicos de los usuarios.

​

Notificación de bienvenida

• Agradece a los usuarios por suscribirse
• Demuestra cómo aparecen las notificaciones
• Aumenta el compromiso y reduce las bajas

​

2. Configurar el plugin de WordPress

​

Configuración avanzada

utm_medium=push&utm_source=onesignal&utm_campaign=wordpress-plugin

utm_medium=ppc&utm_source=adwords&utm_campaign=snow%20boots&utm_content=durable%20snow%20boots

• Tipos de entrada personalizados: Agregue tipos de entrada de plugins para habilitar opciones de notificación
• Enviar automáticamente notificaciones cuando se publique una entrada: Marca automáticamente la casilla de notificación al publicar entradas para que se envíen notificaciones sin tener que marcar la casilla manualmente
• Enviar automáticamente notificaciones cuando se actualice una entrada: Marca automáticamente la casilla de notificación al actualizar entradas para que se envíen notificaciones sin tener que marcar la casilla manualmente
• Enviar automáticamente notificaciones cuando se publique una página: Marca automáticamente la casilla de notificación al publicar páginas para que se envíen notificaciones sin tener que marcar la casilla manualmente
• Enviar automáticamente notificaciones cuando se actualice una página: Marca automáticamente la casilla de notificación al actualizar páginas para que se envíen notificaciones sin tener que marcar la casilla manualmente
• Enviar automáticamente una notificación push cuando publique una entrada desde plugins de terceros: Enviar automáticamente notificaciones desde plugins de publicación externos
• Integración con aplicaciones móviles: Envíe notificaciones a los suscriptores de su aplicación móvil utilizando el mismo App ID de OneSignal

​

Service worker

importScripts("https://cdn.onesignal.com/sdks/web/v16/OneSignalSDK.sw.js");

​

3. Completar la migración (solo usuarios que actualizan)

​

Prueba de su configuración

• Revise Solicitudes de permiso web para personalización avanzada
• Explore Configuración de canales para integración de email y SMS
• Configure estrategias de segmentación para mensajería dirigida

​

Publicación de notificaciones

​

Notificaciones básicas de entradas

• Marque “Send notification when post is published or updated”
• Desmarque para omitir el envío de una notificación para esa entrada

​

Segmentación de audiencia

​

Enviar a todos los suscriptores (predeterminado)

​

Enviar a segmentos específicos

1. Vaya a Audience > Segments en su panel de OneSignal
2. Cree segmentos usando sus claves de etiqueta, por ejemplo:
   • Segmento de Noticias: Etiqueta news es 1
   • Segmento de Ofertas: Etiqueta deals es 1

3. Después de crear los segmentos, actualice su editor de entradas de WordPress
4. Seleccione su segmento objetivo del menú desplegable

​

Personalización del contenido de notificaciones

​

Comportamiento predeterminado

• Título: Usa el título de su sitio de WordPress (Configuración > General)
• Mensaje: Usa el título de la entrada
• Imagen: Usa la imagen destacada de la entrada (si está configurada)
• URL: Enlaza a la entrada publicada

​

Contenido personalizado

​

Agregar un tipo de entrada personalizado al plugin de WordPress de OneSignal

​

Encontrar el nombre de su tipo de entrada personalizado

https://yoursite.com/wp-admin/post-new.php?post_type=your_custom_type

​

Agregar a la configuración de OneSignal

1. Vaya a OneSignal > Settings en el panel de administración de WordPress
2. En Advanced Settings, agregue los nombres de sus tipos de entrada personalizados al campo Custom Post Types
3. Guarde la configuración

​

Integración con aplicaciones móviles

1. Habilite “Send notification to Mobile app subscribers” en la configuración del plugin
2. En el metabox de la entrada, agregue una Mobile URL para enlaces profundos
3. Los usuarios móviles serán dirigidos a su aplicación en lugar del navegador web

​

Preguntas frecuentes

¿Cómo desactivo las solicitudes en páginas específicas?

Nota: Este método solo funciona con solicitudes deslizantes y solicitudes de permiso nativas, no con solicitudes de campana o de enlace personalizado.

1. En su panel de OneSignal, vaya a Settings > Push & In-App > Web Settings
2. Seleccione su solicitud de la tabla Permission Prompt Setup
3. Desmarque Auto Prompt y haga clic en Done

4. Desplácese hacia abajo, haga clic en Save y luego en Finish
5. Agregue código JavaScript personalizado a páginas específicas donde desee que aparezcan las solicitudes

Esto le da control completo sobre el tiempo y la ubicación de las solicitudes. Consulte Solicitudes de permiso web para detalles de implementación.

¿Por qué mis solicitudes no funcionan después de la migración?

Problemas de caché: El caché de WordPress puede retrasar los cambios de migración.Solución:Paso 1: Haga clic derecho en su sitio web y seleccione InspeccionarPaso 2: Vaya a la pestaña RedPaso 3: Marque “Disable cache”

Paso 4: Actualice su sitio web para ver la configuración actualPaso 5: Borre la configuración de su plugin de caché de WordPress si corresponde

¿Qué significa el error `A bad HTTP response code (404)`?

Este error indica una migración incompleta:

Solución:

1. Asegúrese de haber guardado la configuración de su panel de OneSignal
2. En WordPress, haga clic en “Migration Completed” en la configuración del plugin
3. Haga clic en Save Settings para finalizar la actualización

Este error solo afecta a los usuarios que actualizan desde la versión 2.x.x.

<?php

add_filter('onesignal_send_notification', function ($fields, $post_id) {

  // Add fields supported by the Create notification API:
  // https://documentation.onesignal.com/reference/create-notification

  $fields['web_buttons'] = array(
    array(
      'id' => 'read-more',
      'text' => 'Read More',
      'url' => get_permalink($post_id),
    ),
  );

  return $fields;

}, 10, 2);