전환과 판매 귀속

전환이란 LinkHarbor가 내 페이지의 클릭에 귀속할 수 있는 판매나 후원 결제를 말합니다. 링크가 몇 번 클릭되었는지뿐 아니라 그 클릭으로 무엇이 이어졌는지도 볼 수 있습니다. 이 글은 자체 쇼핑몰을 운영하는 크리에이터와 쇼핑몰을 연결하는 개발자를 위한 것입니다. 전환 분석과 콜백 시크릿 생성은 Creator Pro부터 가능합니다.

#전환이 들어오는 경로

• 쇼핑몰이나 서버가 판매 콜백으로 보고한 판매
• Stripe를 통한 후원 결제. 환불되면 전환도 다시 제거됨(Stripe를 통한 후원 결제 참고)

각 전환은 해당 클릭의 데이터(페이지, 링크, 국가, 기기, 유입 경로, UTM 파라미터)를 그대로 물려받습니다. 그래서 통계에서도 클릭이 발생한 바로 그 위치에 표시됩니다.

#귀속 방식

1. 방문자가 내 페이지의 링크를 클릭합니다
2. LinkHarbor가 클릭을 집계하고, 리디렉션할 때 고유한 클릭 ID가 담긴 lt_click_id 파라미터를 대상 URL에 붙입니다
3. 대상 페이지(예: 쇼핑몰)가 주소에서 lt_click_id를 읽어 구매 시점까지 보관합니다
4. 구매가 끝나면 서버가 이 클릭 ID와 함께 판매 콜백을 LinkHarbor로 보냅니다
5. 전환이 대시보드와 페이지 통계에 표시됩니다

클릭 ID는 http:// 또는 https://로 시작하는 대상에만 붙습니다. mailto:나 tel: 링크에는 붙지 않습니다. 파라미터가 제목이나 전화번호를 망가뜨리기 때문입니다. 봇의 클릭에도 클릭 ID가 붙지 않습니다.

#콜백 시크릿 만들기

판매 콜백은 콜백 시크릿으로 자신을 인증해야 합니다. 소유자와 관리자는 Creator Pro부터 메뉴의 계정 영역에 있는 “콜백 및 API”에서 시크릿을 관리합니다.

1. “콜백 및 API”를 엽니다
2. “콜백 시크릿” 카드에서 “+ 새 시크릿 만들기”를 클릭합니다
3. 필요하면 이름을 입력합니다. 예: “쇼핑몰 콜백”
4. “시크릿 만들기”를 클릭합니다
5. 시크릿은 한 번만 표시되므로 바로 복사합니다

“편집”

이름과 상태(활성 또는 비활성)를 변경합니다. 비활성 시크릿은 거부됩니다.

“↺ 교체”

새 시크릿을 만듭니다. 이전 시크릿은 즉시 작동을 멈추므로 새 시크릿을 바로 쇼핑몰에 입력하세요.

“삭제”

확인 후 시크릿을 제거합니다.

“마지막 콜백:”

시크릿이 마지막으로 사용된 시점을 보여 주며, 사용된 적이 없으면 “아직 사용 안 함”이 표시됩니다.

워크스페이스마다 콜백 시크릿을 최대 5개까지 만들 수 있습니다.

#판매 콜백 보내기

서버가 LinkHarbor API로 POST 요청을 보냅니다. 시크릿은 X-Callback-Secret 헤더에 넣습니다.

curl -X POST https://dock.at-harbor.com/v1/callbacks/sale \
  -H "Content-Type: application/json" \
  -H "X-Callback-Secret: YOUR_CALLBACK_SECRET" \
  -d '{
    "click_id": "3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a23",
    "order_id": "B-10042",
    "amount": "49.90",
    "currency": "EUR"
  }'

click_id

필수. lt_click_id의 클릭 ID(10~36자)입니다.

order_id

필수. 주문 번호(1~128자)입니다. 주문 번호마다 전환은 하나만 집계되므로 콜백을 다시 보내도 두 번째 전환은 생기지 않습니다.

amount

필수. 소수로 나타낸 금액입니다.

currency

필수. 3자리 통화 코드입니다. 예: EUR.

occurred_at, meta

선택. 구매 시각과 추가 정보를 담는 사용자 지정 키 최대 50개(각 1~64자)입니다. 값은 최대 500자의 텍스트, 숫자, true/false 또는 null이며, 중첩된 객체는 API가 거부합니다.

응답

개발자를 위한 모든 필드와 오류 코드는 판매와 사용자 지정 데이터 보내기에 있습니다.

#전환 분석

• 대시보드: “전환”과 “CVR” 타일, UTM 소스와 매체별 “전환” 카드
• 페이지 통계: “전체 CVR”, “고유 CVR”, “세부 분석”이 있는 “전환” 카드
• 전체 CVR = 전환 수 ÷ 클릭수, 고유 CVR = 전환 수 ÷ 고유 클릭수