Acesso Comercial / Docs / Storefront / API
Ctrl K
MUTATION

track

Registra um evento de tracking (page views, cliques, conversões) para analytics e métricas da loja.

Input

TrackMutationInput!

CampoTipoDescrição
hostnameString!Hostname da loja.
eventString!Tipo do evento (ex: "pageView", "productView", "addToCart").
dataJSONDados adicionais do evento.

Retorno

CampoTipoDescrição
successBooleanSe o evento foi registrado.

Mutation

GraphQL
mutation TrackEvent($input: TrackMutationInput!) {
  track(input: $input) {
    success
  }
}

Variables

JSON
{
  "input": {
    "hostname": "minha-loja",
    "event": "productView",
    "data": {
      "productId": "UHJvZHVjdDphYmMx",
      "url": "/produto/camiseta-premium"
    }
  }
}

Resposta

JSON
{
  "data": {
    "track": {
      "success": true
    }
  }
}

Fetch

JavaScript
const response = await fetch('/graphql', {
  method: 'POST',
  credentials: 'include',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    query: `mutation($input: TrackInput!) {
      track(input: $input) { success }
    }`,
    variables: { input: { hostname: "minha-loja", event: "pageView", data: { page: "/produto/camiseta" } } }
  })
});

cURL

Bash
curl -X POST https://minha-loja.com/graphql \
  -H "Content-Type: application/json" \
  -d '{"query":"mutation { track(input: { hostname: \"minha-loja\", event: \"pageView\", data: \"{}\" }) { success } }"}'