전환과 매출

전환 추적은 클릭과 그 클릭이 만들어 낸 돈 사이의 고리를 닫습니다. 리디렉터는 리디렉션마다 서명된 식별자를 발급하고, 여러분의 서버나 감사 페이지가 그것을 주문과 함께 되돌려 보냅니다. 그러면 이미 보고 있던 모든 내역에 매출 열이 하나 더 생깁니다.

전환은 유료 기능입니다. 요금제에 포함되어 있지 않으면 리디렉터는 식별자 발급 자체를 중단하고, 두 수신 경로 모두 요금제 제한을 이유로 전환을 거부합니다.

클릭 식별자

리디렉션마다 워커는 토큰을 하나 발급하고 다음을 수행합니다.

• 여러분이 고른 이름의 파라미터(기본값은 lp_cid)로 도착 주소에 덧붙입니다.
• 여러분의 리디렉션 도메인에 속한 퍼스트파티 쿠키에 유효 기간 90일로 기록합니다.

서드파티라면 무엇이든 더 이상 받아들이지 않는 브라우저에서도 귀속이 살아남는 것은 이 쿠키 덕분입니다. 이 쿠키를 심는 것이 저희 도메인이 아니라 여러분 자신의 도메인이기 때문입니다.

토큰에는 서명이 있고 테넌트에 묶여 있습니다. 워크스페이스와 파트너 식별자가 서명 대상에 포함되므로, 어느 고객사의 링크에서 발급된 토큰은 다른 고객사의 워크스페이스에서 위조물과 똑같이 거부됩니다. 개인 정보는 담기지 않습니다. 담기는 것은 클릭 시각과 링크, 분할 변형, 국가, 기기 종류, 트래픽 유입원, 그리고 의심 트래픽 표시뿐입니다.

파라미터 이름과 발급 스위치는 모두 전환 → 설정에 있습니다. 둘 중 무엇을 바꾸든 모든 링크의 캐시된 설정이 즉시 다시 쓰입니다.

기여 기간

기간이 지나 도착한 전환은 attribution_expired로 거부됩니다. 이는 invalid_click_id와 다른 코드이므로, 연동하는 쪽은 “너무 늦었다”와 “식별자가 잘못됐다”를 추측 없이 구분할 수 있습니다. 기간은 워크스페이스별 설정입니다.

목표

목표는 이름을 붙인 결과입니다. purchase, signup, trial 같은 것들입니다. 목표에는 기본 금액과 통화를 지정할 수 있으며, 금액 없이 전환이 도착했을 때 사용됩니다. 아직 없는 목표를 전환이 참조하면 처음 쓰일 때 만들어지므로, 연동을 두 곳에서 따로 설정할 필요가 없습니다.

전환 보내기

서버에서 보내기

curl -X POST https://api.linkprofit.com/v1/conversions \
  -H "Authorization: Bearer lp_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-10241" \
  -d '{
    "click_id": "1.eyJ1aWQiOiJ...",
    "goal": "purchase",
    "order_id": "10241",
    "amount_cents": 4999,
    "currency": "usd"
  }'

키에는 conversions:write 범위가 필요합니다. 금액은 최소 단위 정수이며 센트, 펜스, 코페이카입니다. 49.99 같은 금액은 조용히 반올림되지 않고 어느 항목인지와 함께 거부됩니다. 결제 경로 한복판에서 즉석으로 만들어 낸 반올림 규칙이야말로 매출 보고서와 청구서가 소리 없이 어긋나기 시작하는 원인이기 때문입니다.

브라우저에서 보내기

워커는 여러분 자신의 리디렉션 도메인에서 작은 스크립트를 제공합니다.

<script src="https://go.example.com/cv.js" defer></script>
<script>
  window.lpConversion({ goal: 'purchase', orderId: '10241', amountCents: 4999, currency: 'usd' });
</script>

스크립트는 URL이나 퍼스트파티 쿠키에서 식별자를 읽습니다. 이 경로 어디에도 서드파티 호스트는 없습니다. 이는 프라이버시 측면의 성질인 동시에 화이트 라벨 측면의 성질이기도 합니다. 고객사의 페이지는 플랫폼을 언급하는 어떤 것도 불러오지 않습니다.

중복

중복 제거는 읽은 다음 쓰는 방식이 아니라 한 번의 원자적 삽입으로 이루어집니다. 같은 order_id가 반복해서 전달되어도 전환은 하나만 생기고, 중복으로 표시된 채 반환됩니다. 실패한 웹훅을 다시 시도하는 일이 위험하지 않고 안전한 이유가 바로 이것입니다.

의심 전환

분류기의 판정은 토큰 안에 함께 실려 오므로, 데이터센터나 프록시에 귀속된 전환은 기록되는 시점에 의심으로 표시됩니다. 삭제되거나 조용히 뒤섞이지 않고 보고서에 별도의 구간으로 나타납니다. “전환 200건”과 “전환 200건, 그중 40건은 한 시간 안에 같은 호스팅 대역에서”는 서로 다른 사실입니다.

전환은 그다음 어디로 가는가

• 서명된 conversion.created 웹훅 이벤트가 평소의 웹훅 장치를 통해 발송됩니다. 큐와 서명, 재시도 일정, 누락분을 채우는 cron이 그대로 쓰입니다.
• 설정해 둔 광고 연동에는 전달 큐를 통해 전환이 도착합니다. 이 큐에서는 시도 횟수 카운터가 외부 호출 전에 증가하고, 대기 시간을 늘리는 방식이 문서로 정해져 있으며, 무한히 재시도하는 대신 포기 표시를 남깁니다.

월별 허용량

요금제는 UTC 기준으로 달력 한 달에 받아들이는 전환 수를 제한할 수 있습니다. 한도를 넘으면 수신 경로는 quota_exceeded로 응답합니다. 이는 요금제 제한과는 다른 코드이므로, “요금제에 없다”와 “이번 달 분을 다 썼다”의 차이를 문의 없이도 알 수 있습니다.