# 🔧 Componente de Estratégias Online em VTEX

✅ Requisitos Prévios

Acesso de administrador ao VTEX Admin
Conta do Google com acesso ao Google Tag Manager
Container GTM criado e Container ID disponível (ex: GTM-XXXXXX)

📦 Instalação da App GTM no VTEX

Nota: Se já possui a app instalada, pule esta etapa.

Acesse VTEX Admin → Apps / Extensions Hub → App Store
Busque pela app Google Tag Manager e instale-a
Insira o Container ID do GTM na configuração
Opcional: habilite o envío de eventos GA4
Salve e confirme a instalação

⚙️ Configuração do Acionador

Configurações do Acionador

Nome sugerido: pageViewOrderPlaced
Tipo: Vista de uma página
Condição: Page Path → contém → /checkout/orderPlaced

Detalhes da Configuração

✅ pageViewOrderPlaced
├── Tipo de acionador: Vista de uma página
├── Condição: Page Path contém /checkout/orderPlaced
└── Referências: iframeStrategiesKoinPageView, redirectStrategiesKoinPageView

🏷️ Criação da Tag no GTM e Associação com Acionador

Configurações da Tag

Nome sugerido: redirectStrategiesKoinPageView
Tipo: HTML personalizado
Código: Cole o script fornecido (Ver anexo 8.1)

Importante: A tag deve estar configurada como HTML personalizado

Associação

O acionador pageViewOrderPlaced deve ser associado à nova tag

Exemplo de Configuração

Tipo de etiqueta: HTML personalizado
Código HTML: [Ver script nos anexos]
Acionador: pageViewOrderPlaced

🚀 Publicação Final

Teste em modo Preview do GTM
Se tudo funcionar corretamente, publique o container no GTM

✅ Checklist de Validação

A tag dispara APENAS em /checkout/orderPlaced
O modal aparece e redireciona corretamente
O fluxo de compra continua sem bloqueios se o usuário completar a validação

📎 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 Produção

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

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