Visitas desde el servidor

Cuándo usarlo

Cuando no puedes poner la etiqueta en una página, o quieres que tu servidor decida qué cuenta como visita. Tu servidor informa de la visita y recibe la visita firmada para guardarla.

La llamada

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: el ID de la página de destino (el linkId del enlace); source: el ID de socio (el sourceId del enlace); subIds: los sub IDs s1–s5 (los affS1–affS5 del enlace).
• ip y userAgent: los del visitante, para que los bots y los límites se comprueben igual que con la etiqueta.
• Opcional country, region y city cuando tu servidor ya los conoce; si no, salen de la dirección IP.

link, ip y userAgent son obligatorios. Omite source para los enlaces propios de tu equipo: cuentan para el espacio de trabajo, sin socio.

La respuesta contiene el hit firmado (y expiresAt, cuándo deja de contar) para enviarlo después con la conversión. Si faltan campos se responde missing_params; una dirección IP errónea, invalid_ip_address.

Bueno saber

• Se aplican las mismas comprobaciones que con la etiqueta: socio, página de destino, oferta, acceso, bots y límites.
• Usa una clave API de Ajustes › Desarrolladores. Si la clave tiene una lista de IP permitidas, solo esas direcciones pueden llamar.