API de notificaciones push (OneSignal, Firebase, Pushwoosh)

Envíe notificaciones push a los usuarios de su app iOS con OneSignal, Firebase o Pushwoosh: configuración, deep links y segmentación por usuario explicados.

Las notificaciones push son notificaciones que aparecen en su smartphone sin necesidad de abrir la aplicación. Este tipo de mensajes permite una interacción excelente con los clientes y usuarios de la aplicación. Su aplicación no tiene que estar abierta para recibir este tipo de notificaciones. De este modo, sus clientes no se perderán ninguna noticia ni mensaje importante. Las notificaciones push son adecuadas para muchos casos, por ejemplo, para actualizaciones de pedidos, live tickers o comunidades de redes sociales. Debe haber conexión a Internet para que los usuarios de la aplicación puedan recibir mensajes push. WebViewGold admite varias formas de llegar a sus usuarios mediante notificaciones push. Si NO desea utilizar notificaciones push en absoluto, abra Config.swift y establezca askforpushpermissionatfirstrun en false para evitar que se solicite al usuario de la aplicación el permiso de notificaciones.

Opción 1: Utilizar la API JavaScript de notificaciones push locales

Puede insertar un fragmento de código (JavaScript) en su sitio web para definir una notificación push que podrá mostrarse después de que su aplicación se haya cerrado (la programación se realiza mientras la aplicación está abierta). Esto funciona sin necesidad de configurar OneSignal.

  <script>
  var title = "Your cart is waiting!"; //notification title
  var message = "You have left a cart full of dreams and deals behind. Dont leave it feeling abandoned"; //notification message
  var seconds = 120; //seconds from now on
  var url = "https://myshop.org/cart.php"; //deep-linking URL

  window.location.href = "sendlocalpushmsg://push.send?s="+ seconds +"=msg!"+ message +"&!#"+ title +"&!#"+ url +"";
  </script>
            

  <script>
  window.location.href = "sendlocalpushmsg://push.send.cancel";
  </script>
            

Comprobar el estado del permiso de notificaciones nativo

Llame a checkNativePushPermissions:// para comprobar si el usuario ha concedido el permiso de notificaciones nativo de iOS. El resultado se inyecta en su aplicación web como la variable de JavaScript nativePushEnabled (true o false), útil, por ejemplo, para mostrar su propio aviso con un enlace a los ajustes de la aplicación si las notificaciones están desactivadas:

<script>
window.location.href = "checkNativePushPermissions://";
setTimeout(function() {
  if (typeof nativePushEnabled !== "undefined" && !nativePushEnabled) {
    // p. ej., mostrar un aviso con enlace a settingsapp://
  }
}, 500);
</script>

Opción 2: Utilizar notificaciones push remotas de Pushwoosh

¡Los usuarios de WebViewGold pueden disfrutar de dos meses gratis de Pushwoosh!
Para acceder a esta oferta, envíe su licencia de WebViewGold por correo electrónico a [email protected] y recibirá una respuesta personal en breve.

Si desea utilizar Pushwoosh (¡una gran elección!) para las notificaciones push en su aplicación, simplemente active las opciones en Config.swift estableciendo kPushwooshEnable en true y asegúrese también de actualizar el valor Pushwoosh_APPID en el archivo Info.plist con su propio Application ID de Pushwoosh.



Asegúrese también de completar la configuración de Pushwoosh en su sitio web, incluyendo la importación del certificado.
¡Enhorabuena! Su configuración ya está completa. Ahora está listo para enviar notificaciones push:



¿Desea obtener el ID del dispositivo de cada usuario para notificaciones push personalizadas o para su posterior procesamiento? Simplemente establezca kPushwooshEnhanceUrl en true en Config.swift para añadir ?pushwoosh_id=XYZ a la URL de su WebView:



Por ejemplo, si la URL de su WebView es https://www.example.org, WebViewGold llamará en su lugar a https://www.example.org?pushwoosh_id=XYZ. Recuerde que solo la primera solicitud de URL recibirá esta variable GET, por lo que le rogamos que la guarde en una sesión o en una cookie para poder utilizarla más adelante en las páginas enlazadas. Alternativamente o de forma adicional, puede recuperar y procesar esta información en cualquier página utilizando JavaScript:

<script>
window.location.href = "getpushwooshid://";
alert(pushwooshplayerid);
</script>

Opción 3: Utilizar notificaciones push remotas de OneSignal

Si desea utilizar OneSignal en su aplicación, active estas opciones en Config.swift (cambiando los valores de false a true) y asegúrese también de sustituir el marcador de posición oneSignalID por el suyo propio.




Ahora genere un certificado de push para iOS e impórtelo:



¡Bien, ya ha terminado! Ahora puede enviar notificaciones push:



Si desea utilizar el deep linking de URL de OneSignal (abre una URL específica al pulsar su notificación), añada la URL deseada mediante un campo personalizado llamado url:

<script>
window.location.href = "getonesignalplayerid://";
alert(onesignalplayerid);
</script>

Opción 4: Utilizar notificaciones push remotas de Firebase

Paso 1: Crear un proyecto de Firebase
Comience creando un proyecto de Firebase en su Firebase Console. Este es un requisito previo para integrar Firebase con su aplicación WebViewGold.

Paso 2: Registrar su aplicación en Firebase
Una vez que su proyecto de Firebase esté listo, puede añadir su aplicación WebViewGold siguiendo estos pasos:

a. Vaya a la página general del proyecto en su consola de Firebase y seleccione el icono de iOS para iniciar el proceso de registro de la aplicación.

b. Para añadir una nueva aplicación a su proyecto, haga clic en Añadir aplicación y seleccione las opciones de plataforma. Cuando se le solicite, introduzca el bundle ID de su aplicación en el campo iOS bundle ID. Este ID es crucial y puede encontrarlo así:
- Abriendo el proyecto de su aplicación en Xcode.
- Seleccionando el nombre del proyecto en la parte superior del navegador para acceder a la pestaña General.
- El bundle ID de su aplicación aparece en el campo Bundle Identifier (por ejemplo, com.onlineappcreator.webviewgold).
Asegúrese de introducir el bundle ID exacto que utiliza su aplicación. Este valor es permanente una vez que la aplicación se ha registrado en Firebase.

c. Complete la configuración proporcionando la información requerida de la aplicación, incluyendo:
- Alias de la aplicación: Un identificador de conveniencia para su referencia en la consola de Firebase.
- App Store ID: Necesario para la integración con Firebase Dynamic Links y Google Analytics. Puede añadirlo más adelante si su aplicación aún no lo tiene.

Paso 3: Registrar su aplicación
Haga clic en Registrar aplicación para completar el proceso de registro.

Paso 4: Descargar GoogleService-Info.plist
Descargue este archivo de configuración y sustituya el marcador de posición en su proyecto WebViewGold por el archivo GoogleService-Info.plist descargado.

Paso 5: Activar Firebase en WebViewGold
En el archivo Config.swift, establezca la variable kFirebasePushEnabled en true para habilitar las funcionalidades de Firebase.

Paso 6: Configurar APN y firmar su aplicación
Genere una clave APN para Firebase, súbala y, a continuación, firme su aplicación utilizando el perfil de aprovisionamiento de Firebase. Para una guía detallada, consulte la documentación de Firebase sobre certificados de iOS.

Paso 7: Implementar el deep linking de URL (opcional)
Para dar soporte al deep linking de URL de Firebase, añada la URL de destino en un campo Custom Data dentro de Additional options (optional), con Key = «url» y Value = {URL deseada}.

<script>
window.location.href = "getfirebaseplayerid://";
alert(firebaseplayerid);
</script>

Opción 5: Utilizar notificaciones push de bubble.io

1. Cree una aplicación bubble.io
2. Instale el plugin WebViewGold OneSignal Push:

3. Siga las instrucciones de OneSignal (véase arriba) y las instrucciones del plugin (véase aquí y aquí).