> For the complete documentation index, see [llms.txt](https://woowup-docs.gitbook.io/woowup-developer-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://woowup-docs.gitbook.io/woowup-developer-docs/web-tracking/faststore.md).

# 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:

   ```js
   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:

   ```html
   <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.