Eventos e Gatilhos de Disparo

Este documento detalha os eventos de conversão, suas condições de disparo e a estrutura de dados (payload) esperada para cada etapa do funil.

1. Mapeamento de Eventos

Evento	Ação Necessária para Disparo
ViewContent	Acessar página de produto (PDP).
AddToCart	Adicionar produto ao carrinho (via PDP ou Spot/Vitrine).
Search	Realizar uma busca ou acessar a página de resultados de busca.
InitiateCheckout	Acessar a página de início de finalização do pedido (`/checkout/complete`).
AddPaymentInfo	Selecionar ou inserir uma forma de pagamento.
Purchase	Acessar a página de confirmação/sucesso do pedido (`/checkout/confirmation`).

2. Estrutura de Dados (Payloads JSON)

Abaixo estão os exemplos técnicos de como as informações devem ser enviadas em cada evento.

ViewContent

Disparado quando o usuário visualiza os detalhes de um item.

{
    "categories": "Masculino",
    "value": 109.99,
    "name": "Camiseta Preta",
    "variant_id": null,
    "id": 150131,
    "currency": "BRL"
}

AddToCart

Disparado no clique do botão de compra.

{
    "categories": "Masculino",
    "value": 109.99,
    "name": "Camiseta Preta",
    "variant_id": 336646,
    "id": 150131,
    "currency": "BRL"
}

Search

Disparado ao processar uma consulta de pesquisa.

{
    "search_string": "camiseta"
}

InitiateCheckout

Disparado na primeira etapa do checkout, consolidando os itens do carrinho.

{
    "content_ids": [150131, 150139],
    "num_items": 3,
    "value": 359.98,
    "contents": [
        {
            "id": 150131,
            "quantity": 2,
            "variant_id": 336646
        },
        {
            "id": 150139,
            "quantity": 1,
            "variant_id": 336654
        }
    ],
    "currency": "BRL"
}

AddPaymentInfo

Disparado quando o método de pagamento é definido.

{
    "types": ["Boleto"]
}

Purchase

Evento final de conversão com os dados transacionais completos.

{
    "content_ids": [336646, 336654],
    "num_items": 3,
    "content_type": "product",
    "orders_ids": [3132],
    "contents": [
        {
            "variant_id": 336646,
            "quantity": 2,
            "name": "Camisa NIKE Preto",
            "value": 219.98
        },
        {
            "variant_id": 336654,
            "quantity": 1,
            "name": "Camiseta preta1",
            "value": 140
        }
    ],
    "value": 374.98,
    "currency": "BRL"
}