서버 측 방문

언제 쓰나요

페이지에 태그를 넣을 수 없거나, 무엇을 방문으로 볼지 서버에서 정하고 싶을 때입니다. 서버가 방문을 보고하고, 보관해야 할 서명된 방문을 받습니다.

호출

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: 랜딩 페이지 ID(링크의 linkId). source: 파트너 ID(링크의 sourceId). subIds: 서브 ID s1–s5(링크의 affS1–affS5).
• ip와 userAgent: 방문자 정보로, 태그와 똑같이 봇과 한도를 확인하기 위한 것입니다.
• 서버가 이미 알고 있다면 선택 항목 country, region, city. 없으면 IP 주소에서 구합니다.

link, ip, userAgent는 필수입니다. 팀 자체 링크에서는 source를 빼세요. 파트너 없이 워크스페이스에 집계됩니다.

응답에는 서명된 hit(와 더 이상 집계되지 않는 시점인 expiresAt)이 담기며, 나중에 전환과 함께 보내야 합니다. 항목이 빠지면 missing_params, 잘못된 IP 주소는 invalid_ip_address가 됩니다.

알아 두면 좋은 점

• 태그와 같은 확인을 거칩니다. 파트너, 랜딩 페이지, 오퍼, 접근 권한, 봇, 한도입니다.
• 설정 › 개발자의 API 키를 쓰세요. 키에 IP 허용 목록이 있으면 그 주소에서만 호출할 수 있습니다.