Visitas do lado do servidor

Quando usar

Quando não pode colocar a etiqueta numa página, ou quer que o seu servidor decida o que conta como visita. O seu servidor comunica a visita e recebe de volta a visita assinada para guardar.

A chamada

POST https://go.hitctrl.com/hits
x-api-key: your API key

{
  "link": "lp_7Kq2",
  "source": "jane-doe",
  "subIds": { "s1": "summer", "s2": "banner-a" },
  "ip": "203.0.113.7",
  "userAgent": "Mozilla/5.0 …",
  "referrer": "https://news.example/"
}

• link: o ID da página de destino (o linkId do link); source: o ID de parceiro (o sourceId do link); subIds: os sub IDs s1–s5 (os affS1–affS5 do link).
• ip e userAgent: os do visitante, para que bots e limites sejam verificados como na etiqueta.
• Opcionalmente country, region e city quando o seu servidor já os conhece; senão vêm do endereço IP.

link, ip e userAgent são obrigatórios. Omita source para os links da sua própria equipa: contam para o workspace, sem parceiro.

A resposta traz o hit assinado (e expiresAt, quando deixa de contar) para enviar depois com a conversão. Campos em falta respondem missing_params; um endereço IP errado invalid_ip_address.

Bom saber

• Aplicam-se as mesmas verificações da etiqueta: parceiro, página de destino, oferta, acesso, bots e limites.
• Use uma chave API de Configurações › Programadores. Quando a chave tem uma lista de IP permitidos, só esses endereços podem chamar.