Su informe de atribución de canales de GA4 tiene un vacío. Los envíos de notificaciones push del mes pasado aparecen sin medio ni fuente, por lo que en teoría parecen tráfico directo en lugar de ingresos recuperados. Lo rastrea hasta un parámetro UTM que nunca se completó más allá del marcador de posición que su equipo estableció en la instalación. Esta guía de configuración de los ajustes del sitio de pushengage existe porque arreglar ese único campo hoy significa iniciar sesión en el panel, encontrar la pestaña correcta y volver a introducir todos los demás campos predeterminados a la vez, ya que el formulario no le permite editar solo uno.
Ese es el costo real de la configuración del sitio PushEngage: no que sea difícil entender una configuración individual, sino que los detalles del sitio, los valores predeterminados de la campaña y la configuración del service worker viven en lugares separados, se tocan con poca frecuencia como para que nadie recuerde dónde, y requieren una reintroducción completa del formulario para arreglar un campo. Esta guía cubre los tres grupos de configuración que realmente revisará —detalles del sitio, valores predeterminados de la campaña y configuración del service worker— y cómo cambiar cualquiera de ellos con una solicitud en lenguaje natural a un asistente de IA conectado al servidor MCP de PushEngage, en lugar de una búsqueda de pestañas en el panel.
Por qué la configuración del sitio PushEngage se convierte en un ticket de soporte en lugar de una solución de cinco minutos
La configuración del sitio no se configura una vez y se olvida. Se revisa cada vez que el negocio cambia de forma: un nuevo mercado significa un cambio de zona horaria, un nuevo requisito de atribución significa una actualización del parámetro UTM, un cambio de marca significa que el interruptor "Impulsado por PushEngage" necesita una segunda revisión, una migración de plataforma significa verificar si el archivo del service worker todavía vive donde PushEngage espera. Dado que cada uno de estos se encuentra en un rincón diferente del panel, la fricción real no es la edición en sí. Es volver a encontrar la pestaña, luego volver a introducir campos que no pretendía tocar, en una tarea que volverá a hacer en tres meses cuando algo más cambie.
Tres modos de fallo aparecen con suficiente frecuencia como para importar, y ninguno de ellos genera un error cuando ocurren:
- Un hueco en los UTM predeterminados. Los valores predeterminados de la campaña se envían con parámetros UTM en blanco o de marcador de posición, por lo que cada envío de notificaciones push en esa ventana aparece en GA4 sin medio ni fuente, invisible en un informe de atribución de canales.
- Una notificación de respaldo faltante. Los suscriptores no segmentados, aquellos que no coinciden con ninguna regla de audiencia, no reciben nada, o una copia genérica, en lugar de un valor predeterminado deliberado que su equipo eligió.
- Una ruta de service worker obsoleta después de una migración del sitio. Esto detiene la entrega de notificaciones por completo, sin producir un mensaje de error obvio que apunte a la configuración que lo causó.
Los tres simplemente le cuestan silenciosamente datos, alcance o entrega hasta que alguien se da cuenta, generalmente mientras mira un informe que no cuadra.
Ese es el caso para tratar la configuración del sitio como una verificación recurrente en lugar de un paso de instalación único, y ese es el caso para cambiar la forma en que las verifica.
Primeros pasos: conecte el servidor PushEngage MCP a su asistente
@pushengage/mcp es el servidor oficial del Protocolo de Contexto de Modelo (MCP) de PushEngage, y cada herramienta en esta guía se ejecuta a través de él. Agréguelo a la configuración MCP de su cliente —claude_desktop_config.json de Claude Desktop, ~/.cursor/mcp.json de Cursor, o la propia configuración MCP de Claude Code— con el comando npx -y @pushengage/mcp. No se requiere instalación global.
La primera vez que le pida a su asistente que inicie sesión, se abrirá una pestaña del navegador para autorizar la conexión, por lo que su contraseña de PushEngage nunca toca al asistente en sí, y el token resultante se almacena localmente en su máquina. A partir de ahí, pida ver sus sitios de PushEngage y seleccione el que desea utilizar; cada herramienta de configuración a continuación se utiliza por defecto con el sitio que tenga seleccionado actualmente. Para obtener el recorrido completo, incluida la solución de problemas de conexión, consulte la guía completa de configuración de PushEngage MCP.
Detalles del sitio: nombre, URL, zona horaria, geolocalización y el interruptor de marca
pushengage_get_site_details lee su configuración actual; pushengage_update_site_details la cambia. Entre ambas, cubren los campos que la documentación de incorporación de PushEngage llama "Agregar detalles del sitio":
- Nombre del sitio
- URL del sitio
- Zona horaria
- Seguimiento de geolocalización
- El interruptor de marca "Powered By PushEngage" en el widget de su panel
Si alguna vez necesitó corregir alguno de esos detalles del sitio de Pushengage después de la instalación inicial, este es el par de herramientas que accede a los cinco campos, y es el mismo par de herramientas para leerlos antes de asumir que algo está mal configurado.
La zona horaria importa más de lo que parece. Es el punto de referencia para cada envío programado y cada pieza de programación basada en la zona horaria del suscriptor que ejecute. Si se equivoca, un envío a las 9 a. m. aterrizará a las 2 a. m. para una parte de su lista, lo que se interpreta como un fallo de segmentación cuando la causa real es un campo mal configurado.
La geolocalización está desactivada por defecto y debe activarse explícitamente antes de que PushEngage pueda adjuntar datos de ciudad, estado y país a un registro de suscriptor, que es la base sobre la que depende la segmentación por geolocalización. Si sus segmentos hacen referencia a la ubicación y los números parecen escasos, vale la pena comprobarlo antes de asumir que su base de suscriptores no tiene la distribución geográfica que esperaba.
El interruptor de marca es más simple: controla si "Powered By PushEngage" se muestra o no en su widget de panel, lo que es más importante para los equipos que ejecutan una experiencia de soporte o chat con marca blanca donde se examina cada marca de proveedor visible.
Ninguno de estos requiere un ticket de soporte o una búsqueda en menús de configuración anidados. El propio ejemplo del README es el patrón a seguir: pregúntale a tu asistente, “Cambia la zona horaria de mi sitio a Asia/Kolkata y activa la geolocalización”, y ambos campos se actualizan en una sola solicitud. Corregir la URL de tu sitio después de un cambio de dominio, o el nombre de tu sitio después de un cambio de marca, sigue el patrón idéntico.
Valores predeterminados de la campaña: la configuración que controla silenciosamente la atribución y el alcance de cada envío
pushengage_get_campaign_defaults y pushengage_update_campaign_defaults cubren cuatro campos. Estos valores predeterminados de campaña de pushengage no son cosméticos. Son la configuración que se encuentra debajo de cada envío que realizas, ya sea que alguien del equipo recuerde o no que existen, y equivocarse en cualquiera de ellos no falla de manera lo suficientemente evidente como para que alguien se dé cuenta de inmediato.
- Parámetros UTM: tu base para rastrear notificaciones push con parámetros UTM en GA4 o cualquier pila de análisis posterior. Omite esta configuración y cada envío hereda una atribución en blanco: envíos sin fuente ni medio, ingresos no atribuibles, un vacío que nadie nota hasta que un informe mensual no cuadra. Ese es el informe de atribución de canal que abrió este artículo.
- Notificación de reserva: lo que se activa para un suscriptor que no coincide con ninguna regla de audiencia. Si la dejas sin configurar, esos suscriptores no recibirán nada.
- Atributos de reserva: tokens de personalización para ese mismo grupo no segmentado, de modo que su copia se lea como intencional en lugar de rota o genérica. Un suscriptor sin un atributo coincidente no debería ver un espacio en blanco donde se suponía que iría su nombre.
- Expiración predeterminada de la notificación: cuánto tiempo permanece en cola un envío no entregado antes de que PushEngage lo descarte. Un envío de oferta flash con una expiración de 7 días aún puede llegar días después de que termine la oferta, engañando a un suscriptor en lugar de simplemente fallar silenciosamente, lo cual es peor para la relación que si el envío nunca llegara.
Establecer una expiración predeterminada de 7 días es una sola solicitud: “Establecer mi expiración de notificación predeterminada en 7 días”, directamente del propio ejemplo del README. El mismo patrón cubre una notificación de reserva para suscriptores no coincidentes, atributos de reserva para la personalización de ese grupo, o un pase completo por los parámetros UTM para que cada envío se atribuya correctamente a GA4 en el futuro. Revisar tus valores predeterminados de campaña de pushengage actuales antes de una ventana de envío grande, en lugar de después de que aparezca una brecha en los informes, es la versión de este hábito que vale la pena cultivar.
Configuración del service worker: registro, compatibilidad con subcarpetas y la ruta del archivo del worker
pushengage_get_service_worker_settings y pushengage_update_service_worker_settings cubren el registro, el soporte de subcarpetas y la ruta del archivo del trabajador: la mecánica que permite que las notificaciones push lleguen a un navegador en primer lugar. Si alguna de las tres es incorrecta, el modo de fallo es el mismo. Las notificaciones dejan de entregarse silenciosamente, sin ningún error obvio que apunte a la configuración que lo causó, y el primer síntoma que cualquiera nota es una caída en los números de envío sin una causa clara.
El soporte de subcarpetas es lo que afecta a los sitios con restricciones de plataforma que no permiten un archivo de trabajador a nivel de raíz: un CMS, una instalación en un subdirectorio, una configuración de múltiples sitios que comparten un dominio. Si su archivo de trabajador vive en otro lugar que no sea la raíz, la configuración de la ruta debe coincidir con esa ubicación exacta, tanto el directorio como el nombre del archivo, o el registro falla silenciosamente.
Esta es la primera cosa que vale la pena revisar después de una migración de sitio o un cambio de plataforma: pida a su asistente que obtenga su configuración actual del service worker de pushengage y confirme que la ruta registrada todavía coincide con el lugar donde realmente vive el archivo, el mismo tipo de verificación que la configuración del service worker de PushEngage para configuraciones con restricciones de plataforma existe para resolver.
El registro en sí mismo también merece una mirada periódica, particularmente después de cualquier cambio en cómo su sitio carga los scripts. Una actualización de la política de seguridad de contenido, un nuevo contenedor de administrador de etiquetas o una capa de caché que elimina encabezados pueden interferir con el registro de maneras que no aparecen en ningún otro lugar excepto en una disminución silenciosa en las notificaciones entregadas. Obtener su configuración del service worker de pushengage junto con una verificación de la tasa de entrega es un hábito de cinco minutos que detecta el problema antes de que le cueste un ciclo de informes completo.
Ediciones parciales sin volver a introducir todo: por qué el comportamiento de fusión importa
Aquí está el detalle que hace que pedirle a un asistente de IA sea más rápido que el panel de control, no solo diferente: pushengage_update_campaign_defaults fusiona su cambio sobre los valores actuales en lugar de reemplazar todo el registro. Pida cambiar solo la caducidad predeterminada de la notificación, y sus parámetros UTM, la notificación de respaldo y los atributos de respaldo permanecerán exactamente como estaban. No tiene que volver a especificar campos que no tiene intención de tocar.
Compare eso con un formulario de configuración típico, donde cambiar un campo en un bloque guardado a menudo significa que todo el formulario se recarga con cada campo editable, y un deslizamiento en un campo no relacionado sobrescribe silenciosamente algo que estaba funcionando correctamente. "Establecer mi caducidad de notificación predeterminada en 7 días" cambia exactamente una cosa y deja el resto de los valores predeterminados de su campaña sin tocar. Esa es la diferencia entre una edición dirigida y un guardado completo cada vez que se necesita ajustar una sola configuración, y es la diferencia que convierte una revisión mensual de configuración de una tarea de quince minutos de nuevo en la solicitud de una sola oración que debería haber sido todo el tiempo.
Lo que las configuraciones precisas realmente protegen: la entregabilidad y la atribución, no solo la pulcritud
Nada de esto tiene que ver realmente con el orden. Una zona horaria incorrecta interrumpe la programación de envíos para una parte de tu lista. Un valor predeterminado de UTM que falta interrumpe la atribución de cada envío hasta que alguien lo detecta. Un trabajador de servicio mal registrado interrumpe la entrega por completo, y lo hace de forma silenciosa. Cada una de estas configuraciones se encuentra debajo de cada campaña que ejecuta tu equipo. La campaña no falla ruidosamente; la información sobre ella simplemente deja de coincidir silenciosamente con la realidad.
Ese es el caso real para tratar los detalles del sitio, los valores predeterminados de la campaña y la configuración del trabajador de servicio como configuraciones de notificación push del asistente de IA que revisas rutinariamente, de la misma manera que revisarías un panel de control de tasa de entrega, en lugar de un paso de configuración único que configuras una vez y nunca vuelves a visitar. Enmarcar estas como configuraciones de notificación push del asistente de IA en lugar de una pestaña de panel de control oculta significa que la verificación en sí misma lleva tanto tiempo como escribir la solicitud. Detectar un valor predeterminado de UTM roto o una ruta de trabajador obsoleta en una solicitud protege los mismos números de ingresos recuperados de los que dependen tus informes de retención, sin esperar un ticket de TI o una llamada de reincorporación para solucionar algo que lleva una frase decir en voz alta.
Una vez que tu servidor MCP de PushEngage esté conectado, repasa los tres grupos de configuraciones cubiertos en esta guía de configuración de ajustes del sitio de PushEngage de la misma manera que repasarías cualquier otra auditoría de retención: rápidamente y en tu propio horario, en lugar de solo cuando un informe no cuadra. Funciona en todos los planes de PushEngage, incluido el nivel gratuito, por lo que no hay ninguna barrera entre tener el servidor MCP conectado y usarlo realmente para verificar los detalles de tu sitio de PushEngage, los valores predeterminados de la campaña y la configuración del trabajador de servicio antes de que te cuesten atribución o alcance.
