logoDocumentación
Buscar

Configuración básica

Información de la app

Ir a la página [App Settings] - [App Info] para ver información detallada de la aplicación, como el nombre del paquete de la aplicación y el AppKey.

  • El nombre del paquete de la aplicación y el AppKey se pueden utilizar para la integración del SDK, y el AppKey y el Master Secret se pueden utilizar para llamadas a la API.
  • Hacer clic en "Edit" para cambiar el nombre de la aplicación o eliminar la aplicación; hacer clic en "Show" para ver el Master Secret.
  • Hacer clic en "Reset" para regenerar el Master Secret. Después de restablecerlo, es necesario actualizar cuanto antes los parámetros de autenticación de la Rest API. De lo contrario, la llamada fallará. Utilizar la función "Reset" con precaución.

image.png

Ajustes de integración

Introducir el dominio del sitio web

Web push solo admite el protocolo HTTPS. No introducir ninguna dirección distinta de la página de inicio. Se admite la adición masiva, con un máximo de 100 dominios.

alt text

Ajustes avanzados de push

  1. Control del comportamiento al hacer clic en la notificación: Mejorar la experiencia del usuario garantizando que, al hacer clic en una notificación, se ejecuten acciones adecuadas y se minimicen las interrupciones.
  • Navigate to a new tab: Al hacer clic en la notificación, el contenido se abrirá siempre en una nueva pestaña.
  • Focus on an existing tab: Si ya hay una pestaña coincidente abierta, se cambiará a esa pestaña sin actualizarla. En caso contrario, se abrirá una nueva pestaña.
  • Nota: Las notificaciones en Safari siempre se abrirán en una nueva pestaña, independientemente de la estrategia configurada.
  1. Service Workers personalizados (Custom Service Workers): Mejorar la estabilidad de las notificaciones del sitio web, evitando la pérdida de suscriptores o problemas de visualización causados por una configuración incorrecta.

⚠️ Advertencia: Se recomienda no cambiar este ajuste después de que el sitio web esté en producción para evitar la pérdida de suscriptores y problemas de visualización de notificaciones. De forma predeterminada, el Service Worker debe almacenarse en el directorio raíz del sitio. Salvo que sea necesario, se recomienda encarecidamente mantener la configuración predeterminada.

  1. Compatibilidad con certificados de Safari Push: Proporcionar flexibilidad a los desarrolladores que se dirigen a usuarios de Safari 15 o versiones anteriores, con certificados compartidos disponibles para simplificar el proceso.
  • Este certificado solo es necesario si se tiene previsto enviar notificaciones a usuarios de Safari 15 o versiones anteriores. Si no se carga un certificado propio, se proporcionará un certificado compartido de forma predeterminada.

Configuración de autorización de notificaciones

Los usuarios deben conceder permisos para las notificaciones web antes de que se puedan mostrar. Actualmente, se admiten tres métodos: solicitud directa, solicitud guiada y personalizada. Al solicitar permisos de web push, si el usuario deniega la autorización, no se podrá iniciar otra solicitud. Se recomienda encarecidamente utilizar el aviso suave (soft prompt) de "solicitud guiada" para explicar a los usuarios el valor de las notificaciones antes de solicitar permisos de web push.

EngageLab proporciona una "Guided Prompt Configuration" que se muestra antes del aviso de autorización nativo y guía a los usuarios a seleccionar los tipos de mensajes que les interesan. Este aviso no sustituye al aviso nativo ni suscribe a los usuarios a las notificaciones web push. Es beneficioso porque aumenta la probabilidad de que los usuarios mantengan la suscripción a sus mensajes y es altamente recomendado por los navegadores. El aviso de autorización cumple tres objetivos:

  • Presentar a los usuarios el valor de suscribirse a notificaciones push.
  • Evitar que los usuarios queden bloqueados para suscribirse.
  • Activar el aviso nativo cuando el usuario indica su disposición a permitir notificaciones.

Configuración del aviso guiado

Ir a [WebPush] -> [Basic Settings] -> [Notification Authorization Configuration] y seleccionar el método de configuración de solicitud guiada. La configuración de parámetros se explica a continuación:

Compatibilidad con texto multilingüe

Se admite la adición de texto en varios idiomas: se detectará automáticamente el idioma del navegador del usuario final. Si no se establece ningún otro idioma, el contenido se enviará a todos los usuarios objetivo con la configuración de idioma [default]. alt text

Lógica del intervalo de visualización del pop-up de autorización

Después de que el usuario cierre por primera vez el pop-up del aviso suave sin completar la suscripción, el sistema volverá a mostrar el pop-up tras el intervalo inicial (3 días de forma predeterminada). Si el usuario sigue sin completar la suscripción cuando el pop-up se muestre de nuevo, se continuará mostrando según la configuración del intervalo posterior (7 días de forma predeterminada) hasta que el estado del usuario cambie a suscrito.

  • Pop-up de intervalo inicial: el valor predeterminado es 3 días; se puede configurar entre 0 y 7 días.
  • Pop-up de intervalo posterior: el valor predeterminado es 7 días; se puede configurar entre 0 y 15 días.

alt text

Avisos de categorías

Al etiquetar automáticamente a los usuarios que deciden suscribirse a notificaciones push, se pueden segmentar y personalizar los mensajes según sus intereses. Esto significa que se pueden personalizar los mensajes push en función de los intereses y preferencias de los usuarios, mejorando la interacción y la satisfacción. La función de etiquetado ayuda a comprender mejor a los usuarios para enviar contenido relevante a distintos grupos, mejorando así la experiencia y la interacción.

Los desarrolladores pueden ofrecer a cada usuario hasta 10 categorías de mensajes para que elija e indique su interés en determinados temas.

Estas categorías deben estar relacionadas con funciones, productos o temas específicos. Por ejemplo, los usuarios pueden optar por suscribirse a boletines, recibir notificaciones sobre nuevas promociones y productos o sobre temas específicos como noticias de última hora, finanzas, política, entretenimiento, etc.

  • Etiqueta: el texto que se muestra para la categoría en el pop-up.
  • Clave de etiqueta correspondiente: ¿cuál es la etiqueta en EngageLab?

Actualización de las selecciones de categorías del usuario

Después de que los usuarios se suscriban a las notificaciones push, los desarrolladores pueden mostrar los avisos de categorías varias veces según sea necesario, por ejemplo, mediante una llamada tras la inicialización:

MTpushInterface.promptPushCategories();
              
              MTpushInterface.promptPushCategories();

            
Este bloque de código se muestra en una ventana flotante

Cuando el pop-up de autorización se muestra de nuevo y el mismo usuario actualiza las categorías de mensajes seleccionadas (p. ej., "deseleccionar información de noticias" y "seleccionar información de descuentos"), el sistema desvinculará la etiqueta del usuario correspondiente a la información de noticias y vinculará la etiqueta correspondiente a la información de descuentos.

  • Explicación de actualización: si se decide mostrar de nuevo los avisos de categorías después de que los usuarios se suscriban a las notificaciones push, se mostrará una explicación de actualización en lugar de un mensaje operativo. Esto permite informar a los usuarios de que pueden actualizar sus categorías.

alt text

Solicitud directa

La solicitud directa consiste en invocar directamente la interfaz de autorización informada del navegador. Si el usuario acepta, se mostrará la notificación. Si el usuario rechaza la autorización, ya no será posible volver a solicitarla.

  • Delay * seconds: Significa que, después de que el visitante abra el sitio web, la solicitud de suscripción se mostrará según el tiempo de retraso configurado.
    • Por ejemplo, si se configura 0, significa que la solicitud de suscripción se muestra de inmediato; si se configura 5, significa que la suscripción se retrasará 5 segundos.
  • visits: Indica que se puede solicitar a los usuarios que se suscriban a las notificaciones web push cuando visiten repetidamente el sitio web.
    • Por ejemplo, si la configuración es 1, significa que la solicitud de suscripción se mostrará en la primera visita; si se configura 3, significa que la solicitud de suscripción se mostrará en la tercera visita.

image.png

Personalizada

Si se selecciona el modo personalizado, es necesario personalizar el estilo del pop-up de la página en el sitio web y comunicar al sistema que corresponde a ese estilo personalizado mediante los siguientes métodos:image.png

Icon Solid Transparent White Qiyu
Contacto