Instalação das Tags BTG

📌 O que é o BTG?

O BTG é uma ferramenta que coleta dados de comportamento dos usuários em sites e aplicativos. Esses dados são usados para:

• Direcionar anúncios e produtos de forma personalizada;

• Automatizar e-mails com base em eventos, como carrinho abandonado;

• Integrar dados com campanhas da plataforma.

Passo a Passo para Instalação

1️⃣ Verificar Dados no dataLayer

Antes de implementar as tags, é fundamental verificar se os dados necessários estão sendo enviados corretamente para o dataLayer. Isso garante que as variáveis captadas pelas tags terão valores válidos.

Veja aqui a documentação sobre DataLayer.

2️⃣Criar Tags no GTM

As tags devem ser configuradas no Google Tag Manager (GTM) utilizando Custom HTML. A seguir, os principais tipos de tags que devem ser implementadas:

👤 Tag Cliente – Allin_Client

Trigger: Window Loaded
Finalidade: Captar o e-mail do visitante

<script type="text/javascript" src="//i.btg360.com.br/btg360-2.0.1.min.js"></script>
<script type="text/javascript">
var mail;
if ({{visitorContactInfoAllin}}) {
mail = {{visitorContactInfoAllin}}[0] ? {{visitorContactInfoAllin}}[0] : "";
} else {
mail = '';
}

Btg360.add({
account: "{{AllinAccount}}",
domain: "{{AllinDomain}}",
event: "client",
items: [{ email: mail }]
});

//Btg360.debug(); // Remova o comentário para debug
</script>

🛍️ Tag Produto – Allin_Product

Trigger: Window Loaded (quando pageCategoryAllin = Product)
Alternativa: Evento productView ou productDetail

<script type="text/javascript" src="//i.btg360.com.br/btg360-2.0.1.min.js"></script>
<script type="text/javascript">
Btg360.add({
account: "{{AllinAccount}}",
domain: "{{AllinDomain}}",
event: "product",
items: [{
id: "{{productIdAllin}}",
name: "{{productNameAllin}}",
price: "{{productPriceToAllin}}",
department: "{{productDepartmentNameAllin}}",
category: "{{productCategoryNameAllin}}",
subcategory: "{{productSubCategoryNameAllin}}",
brand: "{{productBrandNameAllin}}"
}]
});

//Btg360.debug();
</script>

🛒 Tag Carrinho – Allin_Cart

Trigger: Evento cartLoaded ou cart

<script type="text/javascript" src="//i.btg360.com.br/btg360-2.0.1.min.js"></script>
<script type="text/javascript">
var products = {{orderFormProductsAllin}}, total = products.length, items = [];

for (var i = 0; i < total; i++) {
items.push({
id: products[i].id,
name: products[i].name,
price: products[i].price,
department: (products[i].categoryTree[0]) ? products[i].categoryTree[0] : '',
category: (products[i].categoryTree[1]) ? products[i].categoryTree[1] : '',
subcategory: '',
brand: products[i].brand
});
}

Btg360.add({
account: "{{AllinAccount}}",
domain: "{{AllinDomain}}",
event: "cart",
items: items
});

//Btg360.debug();
</script>

💳 Tag Checkout – Allin_Checkout

Trigger: Evento orderPlaced

<script type="text/javascript" src="//i.btg360.com.br/btg360-2.0.1.min.js"></script>
<script type="text/javascript">
var products = {{transactionProductsAllin}}, total = products.length, items = [];

for (var i = 0; i < total; i++) {
items.push({
transactionId: "{{transactionIdAllin}}",
id: products[i].id,
name: products[i].name,
price: products[i].price,
department: (products[i].categoryTree[0]) ? products[i].categoryTree[0] : '',
category: (products[i].categoryTree[1]) ? products[i].categoryTree[1] : '',
subcategory: (products[i].categoryTree[2]) ? products[i].categoryTree[2] : '',
brand: products[i].brand
});
}

Btg360.add({
account: "{{AllinAccount}}",
domain: "{{AllinDomain}}",
event: "transaction",
items: items
});

//Btg360.debug();
</script>

3️⃣ Configuração de Variáveis no GTM

Para cada tipo de evento, crie uma nova tag com o tipo Custom HTML e configure o gatilho (trigger) correspondente. Abaixo estão os exemplos:

🏷️ Exemplo: Criar Tag de Produto

1. Vá em Tags > Nova > Tag de HTML Personalizado.

2. Nomeie como Allin_Product.

3. Cole o seguinte código (exemplo já mostrado anteriormente):

🔄 Repetir para outras Tags

• Tag Cliente – Allin_Client

  • Trigger: Window Loaded

• Tag Carrinho – Allin_Cart

  • Trigger: Evento personalizado cartLoaded ou cart

• Tag Checkout – Allin_Checkout

  • Trigger: Evento orderPlaced

⚠️ Certifique-se de que os eventos estão realmente sendo disparados no dataLayer. Use o preview do GTM para confirmar.

4️⃣ Integração de XML

Para enriquecer a base de dados, é possível integrar um XML com os dados dos produtos. Siga os passos:

🔗 Acessar o XML

• Verifique a estrutura do XML (ex: tag pai como item ou entry)

• Identifique o separador de categoria (ex: hífen em product_type)

⚙️ Integração via Plataforma

Acesse o menu Integrações na plataforma e:

1. Informe a URL do XML (sem espaços);

2. Selecione “Não” em Ignorar parâmetros do link;

3. Escolha o separador de categorias;

4. Indique o nome da tag pai.

Se houver campos em vermelho após o carregamento, revise o XML ou indique que o campo não existe, quando aplicável.