O presente documento constitui a referência técnica para a SDK SMB Wake Tag, detalhando os dados de rastreamento (tracking) coletados e as plataformas de e-commerce com as quais a SDK demonstra compatibilidade.
- PLATAFORMAS DE E-COMMERCE SUPORTADAS
A SDK SMB Wake Tag é compatível com as seguintes plataformas de e-commerce, conforme listado:
Tabela 1 — Plataformas Suportadas
| Plataforma | Identificador Interno | Descrição | URL de Exemplo |
| Wake Commerce | WakeCommerce | Plataforma Proprietária Wake | - |
Em todas as plataformas homologadas, a SDK executa as seguintes funcionalidades:
- Inicialização: Configuração baseada no clientId específico da loja.
- Envio de Eventos: Transmissão de eventos para o Apache Unomi (Customer Data Platform - CDP) com o propósito de rastreamento e personalização.
Observação: A designação “None” no código sinaliza a ausência de uma plataforma identificada e não representa uma loja suportada.
- DADOS DE RASTREAMENTO (EVENTOS)
Os dados são categorizados por tipo de evento. Em todos os eventos, os seguintes dados de contexto são transmitidos, quando aplicável:
- Contexto de Página: pageName (título da página), pagePath (caminho da URL), pageUrl (URL completa).
- Plataforma: platformName (nome da plataforma de e-commerce, conforme especificado na Tabela 1).
2.1 EVENTO HOME (VISUALIZAÇÃO DA PÁGINA INICIAL)
Tabela 2 — Campos do Evento Home
| Dado | Descrição |
| pageName | Título da página (document.title) |
| pagePath | Caminho da URL (pathname) |
| pageUrl | URL completa da página |
| platformName | Nome da plataforma (Ex: Tray, Bagy, etc.) |
2.2 EVENTO PRODUCT (VISUALIZAÇÃO DE PRODUTO)
Tabela 3 — Campos do Evento Product
| Dado | Descrição |
| productId | Identificador do produto |
| productName | Denominação do produto |
| productSku | SKU (Stock Keeping Unit) do produto |
| productPrice | Valor monetário do produto (numérico) |
| pageName | Título da página |
| pagePath | Caminho da URL |
| pageUrl | URL completa |
| platformName | Nome da plataforma |
2.3 EVENTO CART (VISUALIZAÇÃO OU MANIPULAÇÃO DO CARRINHO)
Este evento elenca os produtos presentes no carrinho, em adição ao contexto de página e plataforma.
2.3.1 Dados de cada produto no carrinho
Tabela 4 — Campos por Item no Carrinho
| Dado | Descrição |
| id | Identificador do produto |
| name | Denominação do produto |
| sku | SKU do produto |
| price | Preço (valor numérico) |
| unit | Quantidade |
2.3.2 Dados principais do Evento Cart
Tabela 5 — Campos Principais do Evento Cart
| Dado | Descrição |
| products | Relação de objetos de produto (incluindo id, name, sku, price, unit) |
| pageName | Título da página |
| pagePath | Caminho da URL |
| pageUrl | URL completa |
| platformName | Nome da plataforma |
2.4 EVENTO PURCHASE (COMPRA FINALIZADA)
Este evento registra uma transação concluída.
Tabela 6 — Campos do Evento Purchase
| Dado | Descrição |
| products | Relação de produtos da aquisição (incluindo id, name, sku, price, unit por item) |
| total | Valor total da aquisição (se disponível) |
| pageName | Título da página |
| pagePath | Caminho da URL |
| pageUrl | URL completa |
| platformName | Nome da plataforma |
2.5 EVENTO IDENTIFY (IDENTIFICAÇÃO DO USUÁRIO)
Empregado para vincular a sessão a um perfil de usuário já conhecido.
Tabela 7 — Campos do Evento Identify
| Dado | Descrição | Requisito |
| firstName | Nome do usuário | Opcional |
| lastName | Sobrenome | Opcional |
| Correio eletrônico do usuário | Obrigatório (para o envio do evento) | |
| phoneNumber | Número de telefone | Opcional |
| uniqueIdentifier | Identificador único (gerado a partir de escopo + e-mail) | Opcional |
| birthDate | Data de nascimento (em formato padronizado) | Opcional |
| scope | Escopo Unomi (contexto da loja) | Opcional |
| platformName | Nome da plataforma | Opcional |
2.6 EVENTO REGISTER (CADASTRO DE USUÁRIO)
O evento de cadastro emprega os mesmos campos de dados do evento Identify. Sua transmissão é desencadeada em duas circunstâncias:
- No formulário de registro da loja.
- No lightbox de captura de leads (opt-in), quando o usuário se registra por meio do plugin.
- RESUMO DE DADOS POR CATEGORIA
Tabela 9 — Sumário de Dados
| Categoria | Dados Capturados | Eventos Correlacionados |
| Navegação | URL, path, título da página, plataforma | Todos os eventos |
| Produto | ID, nome, SKU, preço, quantidade | Product, Cart, Purchase |
| Usuário | Nome, sobrenome, e-mail, telefone, data de nascimento | Identify, Register |
| Conversão | Relação de produtos e valor total da aquisição | Purchase |
Implementação da TAG Wake por meio do GTM - Wake commerce
Com o objetivo de coletar o comportamento dos usuários em toda a plataforma, é imprescindível estabelecer uma tag no Google Tag Manager (GTM), a qual deve ser configurada com um acionador que dispare em todas as páginas.
O código a ser inserido na tag é apresentado a seguir:
<script src="https://smb-data-exp.wake.tech/smb.wakecommerce.min.js"></script>
<script>
window.smbClientId = "{ClientId}";
</script>
- DESTINO E UTILIZAÇÃO DOS DADOS
Destino: Os eventos são encaminhados ao Apache Unomi (CDP), utilizando-se a URL de API configurada na variável de ambiente (UNOMI_API_URL).
Utilização: O Unomi processa os dados para os seguintes fins:
- Segmentação de audiência.
- Personalização da experiência (ex: exibição de lightboxes).
- Análise (Analytics).
Resiliência: Em caso de falha na conexão de rede, os eventos podem ser armazenados localmente (localStorage) e retransmitidos automaticamente após o restabelecimento da conectividade.
VERSÃO DO DOCUMENTO: 1.0
Comentários
0 comentário
Por favor, entre para comentar.