# 🔧 Instalación de Estrategias

🚀 Introducción

En este manual se detallan las instrucciones para que el cliente pueda instalar el componente de estrategias online mediante Google Tag Manager (GTM) y publicarlo correctamente en su tienda VTEX.

✅ Requisitos Previos

• Acceso de administrador al VTEX Admin
• Cuenta de Google con acceso a Google Tag Manager
• Contenedor GTM creado y Container ID disponible (ej: GTM-XXXXXX)

📦 Instalación de la App GTM en VTEX

Nota: Si ya tiene la app instalada, ignore este paso.

1. Ingrese a VTEX Admin → Apps / Extensions Hub → App Store
2. Busque la app Google Tag Manager e instálela
3. Ingrese el Container ID de GTM en la configuración
4. Opcional: habilite el envío de eventos GA4
5. Guarde y confirme la instalación

⚙️ Configuración del Activador

Configuraciones del Activador

• Nombre sugerido: pageViewOrderPlaced
• Tipo: Vista de una página
• Condición: Page Path → contiene → /checkout/orderPlaced

Detalles de la Configuración

✅ pageViewOrderPlaced
├── Tipo de activador: Vista de una página
├── Condición: Page Path contiene /checkout/orderPlaced
└── Referencias: iframeStrategiesKoinPageView, redirectStrategiesKoinPageView

🏷️ Creación del Tag en GTM y Asociación con Activador

Configuraciones del Tag

• Nombre sugerido: redirectStrategiesKoinPageView
• Tipo: HTML personalizado
• Código: Pegue el script entregado (Ver anexo 8.1)

Recordar: El tag debe estar configurado como HTML personalizado

Asociación

• El activador pageViewOrderPlaced debe asociarse al nuevo tag

Ejemplo de Configuración

Tipo de etiqueta: HTML personalizado
Código HTML: [Ver script en los anexos]
Activador: pageViewOrderPlaced

🚀 Publicación Final

1. Pruebe en modo Preview de GTM
2. Si todo funciona correctamente, publique el contenedor en GTM

✅ Checklist de Validación

• El tag se dispara SOLO en /checkout/orderPlaced
• El modal aparece y redirige correctamente
• El flujo de compra continúa sin bloqueos si el usuario completa la validación

📎 Anexos

8.1. Código Script

🧪 Ambiente de Sandbox

<script src="https://portal-dev.koin.com.br/argus-static/scripts/vtex/v1/gtm_script.js"></script>

🌐 Ambiente de Producción

<script src="https://antifraud.koin.com.br/argus-static/scripts/vtex/v1/gtm_script.js"></script>

Koin - Antifraude Inteligente 🌐 www.koin.com.br