Prerequisites. A verified domain in Rankly and
your ingest token from Settings.
Send an event
Field names
Field names are forgiving. Any of the aliases below work:| Meaning | Accepted field names |
|---|---|
| Timestamp | ts, timestamp (epoch ms or ISO 8601) |
| HTTP method | method |
| URL | url, or host + path |
| User-agent | userAgent, user_agent, ua |
| Client IP | ip, client_ip, clientIp |
| Referer | referer, referrer |
| Status | status, statusCode, sc-status |
| Bytes | bytes, responseSize |
| Country | country |
What to send
For full coverage, send a record whenever your server handles a request from:- A known AI bot user-agent (see Bot coverage).
- A request to
/favicon.icoor/apple-touch-iconfrom any user-agent (the humanity signal). - A human visit whose referer is an LLM domain such as
chatgpt.com,perplexity.ai, orclaude.ai(an LLM referral).