Referência de Eventos

O Converlay rastreia automaticamente 10 eventos da vitrine por meio da Web Pixels API da Shopify. Nenhuma configuração manual de eventos é necessária — todos os eventos disparam automaticamente quando um visitante interage com sua loja.

Eventos rastreados automaticamente

Evento	Gatilho	Dados principais
`page_view`	Cada carregamento de página	URL, referrer, UTMs
`view_item`	Página de produto visualizada	ID do produto, nome, preço, variante
`view_item_list`	Coleção / resultados de busca visualizados	ID da lista de itens, itens
`add_to_cart`	Item adicionado ao carrinho	ID do produto, quantidade, preço
`remove_from_cart`	Item removido do carrinho	ID do produto, quantidade
`search`	Busca realizada	Termo de busca
`begin_checkout`	Checkout iniciado	Valor do carrinho, itens
`add_payment_info`	Informações de pagamento inseridas	Método de pagamento
`add_shipping_info`	Informações de envio inseridas	Método de envio
`purchase`	Pedido finalizado	ID da transação, valor, itens, dados do usuário

Estrutura do payload de eventos

Cada evento enviado para o endpoint de coleta do Converlay segue esta estrutura. Aqui está um exemplo de evento purchase:

purchase event payload

{
  "event_id": "evt_abc123",
  "event_name": "purchase",
  "shop_domain": "my-store.myshopify.com",
  "page_url": "https://my-store.com/thank-you",
  "client_id": "clid_...",
  "session_id": "sid_...",
  "fbp": "fb.1.1700000000000.1234567890",
  "gclid": "CjwKCAiA...",
  "consent_data": {
    "analytics": true,
    "marketing": true,
    "ad_user_data": true,
    "ad_personalization": true
  },
  "ecommerce": {
    "transaction_id": "5678",
    "value": 129.99,
    "currency": "USD",
    "items": [
      {
        "item_id": "gid://shopify/ProductVariant/123",
        "item_name": "Classic Tee",
        "price": 29.99,
        "quantity": 2
      }
    ]
  },
  "user_data": {
    "email": "sha256:abc...",
    "phone": "sha256:def..."
  }
}

Tratamento de PII

Os dados do usuário (e-mail, telefone, endereço) são hasheados com SHA-256 no servidor antes do encaminhamento para plataformas de anúncios. PII bruto nunca é armazenado ou compartilhado. Normalização específica por país é aplicada antes do hashing.

Enriquecimento de eventos

Antes do encaminhamento, cada evento é enriquecido com:

Vinculação de Click ID — gclid, fbclid, ttclid são persistidos entre sessões
Parâmetros do Facebook — _fbp e _fbc são gerados para correspondência com a Meta CAPI
Contexto de sessão — sessão rotativa de 30 minutos com client ID persistente
Sinais de consentimento — sinais do Google Consent Mode v2 mapeados da Customer Privacy API da Shopify
Deduplicação de eventos — event_id único previne contagem dupla entre fontes de pixel e webhook

Anterior← Conectar destinos PróximoConsentimento e privacidade →