Configuración Navegación Web en VTEX FastStore

Esta guía explica cómo activar el registro de navegación de WoowUp en una tienda FastStore. Al terminar, la tienda enviará a WoowUp los productos y las categorías que visita cada cliente identificado.

Toda la instalación se realiza desde Google Tag Manager. No es necesario modificar el código de la tienda.

---

Requisitos

Antes de comenzar, confirma que tienes:

• La Public Key de la cuenta de WoowUp del cliente

• Acceso de edición al contenedor de Google Tag Manager de la tienda

• Un contacto de prueba en la cuenta de WoowUp, para verificar al final

El acceso al Tag Manager es del cliente o de su agencia. Si no lo tienes, solicítalo antes de continuar: sin ese acceso no es posible avanzar.

Antes de comenzar, escríbenos con la URL de la tienda. Nosotros confirmamos que la tienda es FastStore y cuál es su contenedor de Tag Manager, y te indicamos si puedes ir directo al Paso 1 o si primero hay que agregar Tag Manager. No necesitas revisar nada por tu cuenta.

---

Si la tienda todavía no tiene Tag Manager

Omite esta sección si ya te confirmamos el identificador del contenedor.

Agregar Tag Manager se hace una sola vez y es la única parte que requiere una intervención de la agencia en el proyecto de la tienda:

1. Crear un contenedor de Google Tag Manager para la tienda.

2. En el archivo discovery.config.js del proyecto, cargar su identificador:

   analytics: {
     gtmContainerId: 'GTM-XXXXXXX',
   }

3. Publicar el cambio.

Una vez hecho, la agencia no vuelve a intervenir: el resto de la instalación y cualquier cambio futuro se realizan desde el Tag Manager.

---

Paso 1 · Crear el tag en Google Tag Manager

1. En el contenedor de la tienda, crea un nuevo tag de tipo HTML personalizado.

2. Pega esta única línea, reemplazando PUBLIC_KEY por la Public Key de la cuenta:

   <script src="https://assets-cdn.woowup.com/js/webtracking-faststore.min.js?k=PUBLIC_KEY"></script>

3. Asígnale el activador Initialization o All Pages.

4. Nómbralo de forma reconocible, por ejemplo WoowUp — Webtracking.

5. Publica el contenedor.

No es necesario ningún activador adicional. El conector detecta por sí mismo cada cambio de página.

Publicarlo es seguro: el conector no registra nada de los visitantes que WoowUp no reconoce, de modo que para el resto de la tienda no cambia nada.

---

Paso 2 · Verificar

El registro de navegación solo aplica a visitantes que WoowUp ya reconoce, así que para probarlo hay que ingresar a la tienda como uno de ellos:

1. Envía una campaña de prueba a tu contacto de prueba.

2. Ingresa a la tienda haciendo clic en un enlace de ese correo. Con eso el visitante queda identificado.

3. Navega haciendo clic en: una categoría, un producto, otra categoría.

Después, en el panel de WoowUp, busca tu contacto de prueba. En unos minutos deberían aparecer:

• Los productos vistos que visitaste

• La categoría visitada

Si eso aparece, la instalación es correcta y no hay nada más que hacer.

Si no aparece nada, revisa la tabla de problemas frecuentes antes de escribirnos.

---

Problemas frecuentes

Revisa estos casos en orden: cada uno supone que el anterior ya quedó descartado.

Síntoma	Causa probable	Qué hacer
El perfil del contacto de prueba no registra ninguna visita	No ingresaste a la tienda desde un enlace de campaña	El registro solo aplica a visitantes que WoowUp ya reconoce. Repite el Paso 2 entrando desde un enlace del correo.
Sigue sin registrar nada, aunque ingresaste desde un enlace de campaña	La línea del tag quedó sin la Public Key	En el tag de Tag Manager, verifica que hayas reemplazado PUBLIC_KEY por la Public Key de la cuenta.
El perfil registra la visita pero no aparecen los productos	El código de producto no coincide con el catálogo	Escríbenos: hay que revisar con qué código está cargado el catálogo de esa cuenta.
Nada de lo anterior aplica y el perfil sigue vacío	El correo no es contacto de esa cuenta, o la tienda no es FastStore	Los contactos son por cuenta: verifica que el correo exista en esa cuenta de WoowUp. Si existe, escríbenos con la URL de la tienda.

---

Alcance

Esta guía cubre la instalación del registro de navegación: productos y categorías visitadas. De esos datos dependen el abandono de navegación, la fila de "más vendidos de la categoría visitada" y los segmentos por comportamiento de navegación.

No cubre las notificaciones push, que en FastStore se evalúan por separado.

---

Soporte

Si algo no coincide con lo descrito en esta guía, escríbenos con estos dos datos:

• La URL de la tienda

• El identificador del contenedor de Google Tag Manager (GTM-XXXXXXX)

Con eso reproducimos el diagnóstico de nuestro lado. No necesitas ejecutar nada ni enviarnos ningún dato técnico adicional.