Instalar con Google Tag Manager, y cuándo no hacerlo

Google Tag Manager puede cargar Provedly con una etiqueta Custom HTML y un activador All Pages, y para los equipos que no pueden tocar las plantillas del sitio es el camino más rápido. Pero GTM es una capa intermedia con su propio orden de carga, su bloqueo por consentimiento y su exposición a los bloqueadores, y para un widget cuyo valor entero consiste en ser visto, cada una de esas cosas tiene un costo. En este artículo mostramos la instalación y luego te decimos cuándo saltarte GTM.

La etiqueta

Crea una etiqueta nueva de tipo Custom HTML y pega la etiqueta script simple o la versión con función. GTM acepta las dos; la versión con función es la que genera el panel para las barras, porque deja explícitos los atributos.

<script>
    (function () {
        var s = document.createElement('script');
        s.src = 'https://provedly.app/w/widget.js';
        s.setAttribute('data-token', 'pp_your_token');
        s.async = true;
        document.body.appendChild(s);
    })();
</script>

Activador: All Pages. Ponle a la etiqueta un nombre que entienda quien venga detrás, publica el contenedor y comprueba en el panel de Provedly que llegan las primeras impresiones en unos minutos. Para una barra CTA, repite el proceso con https://provedly.app/w/cta.js y el token de la barra.

No añadas filtros de URL en GTM para controlar dónde aparece el widget. La segmentación por URL de Provedly (todas las páginas, solo estas, todas excepto) y la segmentación por dispositivo se configuran en el panel y se aplican igual tanto si el script viene de GTM como de la página. Un solo sitio para la regla es mejor que dos.

Aplicaciones de una sola página

Si tu sitio es una SPA, el activador All Pages de GTM se dispara una vez en la carga inicial, que es lo correcto para Provedly. El cargador es idempotente y gestiona por sí mismo los cambios de ruta. No añadas un activador History Change a esta etiqueta; inyectaría un segundo elemento script en cada navegación. El cargador comprueba si ya existe una instancia antes de inicializarse, así que el daño son peticiones desperdiciadas y no notificaciones duplicadas, pero no tiene ninguna ventaja.

Cuándo GTM no es la herramienta adecuada

El consentimiento retrasa o bloquea el widget

Muchas configuraciones de consentimiento retienen todas las etiquetas de GTM hasta que el visitante acepta las cookies. Si Provedly está detrás de esa barrera, los visitantes que rechazan, o que nunca interactúan con el banner, nunca ven una notificación. Si el widget necesita consentimiento o no es algo que debe decidir tu propia revisión de privacidad; asigna un ID de visitante para los límites por sesión y la atribución. Si tu revisión concluye que no necesita consentimiento, cargarlo directamente en la página evita una barrera pensada para analítica y publicidad.

Bloqueadores

Los bloqueadores de contenido suelen bloquear el propio contenedor de GTM. Un visitante que usa uno no ve ninguna etiqueta de ese contenedor, Provedly incluido. Una etiqueta script directa desde provedly.app es una decisión aparte para el bloqueador y no la atrapan las reglas dirigidas a googletagmanager.com. Esto importa más con públicos de perfil técnico.

Shopify

En Shopify, usa la app de Provedly y su app embed del tema en lugar de GTM. La app importa los pedidos de los últimos 60 días al instalarse, recibe cada pedido nuevo por un webhook firmado y, por tanto, marca las compras como "Verified" sin ninguna etiqueta script. Además, en la mayoría de los planes GTM no se ejecuta en el checkout de Shopify, así que la instalación quedaría a medias. Consulta la guía de configuración de Shopify.

Necesitas el ID de visitante en el checkout

Los pedidos asistidos por la prueba social del panel se emparejan por ID de visitante. Tu código de checkout lo lee con window.Provedly?.visitorId() y lo pasa como metadata.provedly_visitor de Stripe o en el campo visitor de la Records API. Si GTM carga Provedly tarde, puede que el ID todavía no exista cuando se ejecuta tu código de checkout. Se resuelve con una breve espera, pero una etiqueta directa async defer en la plantilla elimina la carrera.

Orden de carga y rendimiento

GTM carga el contenedor, luego evalúa los activadores y después inyecta el script. Son dos saltos extra antes de un archivo de 6 KB. En una página rápida son unos cientos de milisegundos; en una lenta puede retrasar la primera notificación hasta después de que el visitante haya hecho scroll y pasado de largo. El widget ya espera 3 segundos por defecto antes de la primera notificación, y a eso le estás sumando más.

Tabla de decisión

Cómo verificar la instalación

Abre tu sitio, espera unos segundos y busca la notificación. Si no aparece nada, revisa en este orden: el contenedor de GTM está publicado (no solo en vista previa); la etiqueta se disparó en el panel de depuración de GTM; el dominio de la página está en la lista de dominios permitidos del sitio en Provedly; el widget tiene al menos un registro que mostrar, porque si no, no tiene nada que decir. Un widget nuevo sin registros es el aviso de "no funciona" más habitual. Publica un registro por la API o importa un CSV y aparecerá con la etiqueta Imported. O conecta Stripe y espera al primer pedido real.

Preguntas frecuentes

¿Puedo cargar el widget solo tras el consentimiento y seguir contando bien las impresiones?

Sí. Las impresiones se cuentan cuando una notificación se muestra de verdad, así que un widget bloqueado que nunca carga nunca consume una impresión. Lo que pierdes es alcance, no precisión.

¿El propio script de GTM cuenta para mi cuota de impresiones?

No. Solo cuentan las notificaciones mostradas. Una impresión es una notificación mostrada a un visitante, unas 3 por visita.

¿Puedo usar GTM para el widget y una etiqueta directa para la barra?

Sí, son cargadores independientes con tokens distintos. Combinarlos no es problema siempre que cada uno aparezca una sola vez por página.

Elijas el camino que elijas, el plan Free basta para probarlo en un sitio real: crea una cuenta.