WordPress

​

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

Seleccione WordPress de las opciones de Website Builder en su 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: Archivo PNG o JPG cuadrado de 256x256px para notificaciones y solicitudes; MacOS Safari no mostrará una solicitud de notificación sin un icono.

Ingrese su URL exacta del sitio. https://su-sitio.com es diferente de https://www.su-sitio.com; use solo un formato de manera consistente

​

Solicitudes de permiso

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

1

Haga clic en Solicitud deslizante de Push para personalizar

Acceda y personalice la configuración de su solicitud deslizante de push

2

Configure el tiempo y el texto:

• Establezca Solicitud automática 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

Configure el tiempo de solicitud automática y personalice la apariencia de la solicitud

3

Haga clic en Listo 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: Lo que los usuarios ven en la solicitud
• Clave de etiqueta: Clave de etiqueta interna para segmentación

3

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

Ejemplo: Configurar categorías de Noticias y Ofertas crea etiquetas 'news: 1' y 'deals: 1' para usuarios que marcan estas opciones

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

Copie su ID de aplicación y clave de API del panel de OneSignal

Asegúrese de que el ID de aplicación y la clave de API REST de su plugin de WordPress coincidan exactamente con su panel de OneSignal

​

Configuración avanzada

Configuración avanzada para funcionalidad mejorada y seguimiento de analíticas

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 ID de aplicación de OneSignal

​

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

Haga clic en Migración completada para finalizar la actualización de su plugin

​

Prueba de su configuración

• Prueba inicial
• Verificar suscripción
• Enviar mensaje de prueba

1. Visite su sitio web (evite la navegación de incógnito/privada; los usuarios no pueden suscribirse en estos modos) 2. Busque la solicitud deslizante que configuró

Su solicitud deslizante configurada debería aparecer según la configuración de tiempo establecida

3. Haga clic en el botón de suscripción (etiquetado como “Suscribirse” en este ejemplo)
4. Acepte el permiso del navegador cuando se le solicite

La solicitud de permiso del navegador (la apariencia varía según el navegador) es necesaria para las notificaciones push web

5. Busque la notificación de bienvenida (si está configurada)

La notificación de bienvenida aparece inmediatamente después de una suscripción exitosa

1. En su panel de OneSignal, vaya a Audiencia > Suscripciones 2. Debería ver su suscripción de push web marcada como “Suscrita”

Las suscripciones exitosas aparecen en la audiencia de su panel de OneSignal

1. Navegue a Mensajes > Push en su panel de OneSignal 2. Cree un Nuevo mensaje 3. Envíe una notificación de prueba a usted mismo 4. Verifique que la notificación aparezca correctamente Consulte nuestra guía de mensajería Push para instrucciones detalladas.

• 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

Metabox de Notificaciones Push de OneSignal; arrastre para reposicionar si es necesario

• Marque “Enviar notificación cuando se publique o actualice la entrada”
• 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 Audiencia > Segmentos 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

¡Las etiquetas distinguen entre mayúsculas y minúsculas! 'news' y 'News' son etiquetas diferentes

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

Seleccione segmentos específicos para dirigirse a grupos de usuarios relevantes

​

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

Personalice el título, contenido y otros elementos de la notificación

Notificación push personalizada como aparece para los usuarios

​

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

​

Encontrar el nombre de su tipo de entrada personalizado

https://susitio.com/wp-admin/post-new.php?post_type=su_tipo_personalizado

​

Agregar a la configuración de OneSignal

1. Vaya a OneSignal > Configuración en el panel de administración de WordPress
2. En Configuración avanzada, agregue los nombres de sus tipos de entrada personalizados al campo Tipos de entrada personalizados
3. Guarde la configuración

​

Integración con aplicaciones móviles

1. Habilite “Enviar notificación a suscriptores de aplicaciones móviles” en la configuración del plugin
2. En el metabox de la entrada, agregue una URL móvil 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 enlaces personalizados.

1. En su panel de OneSignal, vaya a Configuración > Push e In-App > Configuración web
2. Seleccione su solicitud de la tabla Configuración de solicitud de permiso
3. Desmarque Solicitud automática y haga clic en Listo

Desactive la solicitud automática para controlar manualmente cuándo aparecen las solicitudes

4. Desplácese hacia abajo, haga clic en Guardar y luego en Finalizar
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 “Desactivar caché”

Desactive el caché del navegador para forzar la carga de archivos actualizados después de la migración

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:

Error 404 en la consola del navegador indica un proceso de migración incompleto

Solución:

1. Asegúrese de haber guardado la configuración de su panel de OneSignal
2. En WordPress, haga clic en “Migración completada” en la configuración del plugin
3. Haga clic en Guardar configuración 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) {

  // Incluya cualquier propiedad mencionada en la referencia de la API Create Notification:
  // https://documentation.onesignal.com/reference/push-notification ej:

  // Agregar botones de acción
  $fields['web_buttons'] = array(
    array(
      "id" => "read-more",
      "text" => "Leer más",
      "url" => get_permalink($post->ID)
    )

  // Devolver el array de campos modificado
  return $fields;

}, 10, 2);