광고주(머천트) 연동 가이드

제휴팜과 함께 상품을 판매하실 업체 담당자용 안내입니다.

제휴팜이 하는 일: 파트너(홍보자)를 모집하고, 파트너별 고유 링크로 발생한 방문·구매를 추적·집계해서 정산 데이터를 만들어 드립니다. 업체는 아래 연동만 완료하면 파트너들이 알아서 상품을 홍보하기 시작합니다.

작동 원리 (1분 이해)

파트너가 자신의 고유 링크를 홍보합니다. 방문자가 클릭하면 제휴팜이 클릭을 기록하고, 업체 상품 페이지로 ?p=파트너코드를 붙여 보냅니다.

업체 페이지에 설치된 스크립트가 이 코드를 30일간 기억(쿠키)합니다.

결제가 완료되면 "어느 파트너의 손님이 얼마를 결제했는지"가 제휴팜에 자동 보고됩니다.

파트너와 제휴팜 운영자가 각자 대시보드에서 실적을 실시간 확인합니다.

연동 방식 A — 웹빌더 사이트 아임웹·카페24 등 / 코딩 불필요

스크립트 두 줄만 복사해 붙여넣으면 끝납니다. (약 10분 소요)

① 사이트 전역(모든 페이지) 스크립트 위치에:
아임웹: 환경설정 → 공통 스크립트 / 카페24: 디자인 편집 → 공통 레이아웃

② 구매(주문) 완료 시점에 실행되는 스크립트 위치에:
아임웹: 광고 캠페인 관리 → 데이터 연결 → 스크립트 직접 삽입(고급 설정) → "구매 완료" 토글 ON

<script src="https://jehyufarm.vercel.app/jf-track.js"
        data-jf-merchant="머천트ID"
        data-jf-amount="결제금액변수"
        data-jf-order="주문번호변수(선택)"></script>

· 머천트ID: 제휴팜에서 발급해 드립니다 (예: imweb)
· 결제금액변수: 사용 중인 빌더가 제공하는 치환 변수 (아임웹은 $total_price)
· 주문번호변수: 있으면 넣어주세요 — 중복 집계 방지가 더 정확해집니다 (없어도 동작)

연동 방식 B — 직접 개발한 사이트 서버 연동 / 권장

서버에서 결제 완료 시 아래 API를 1회 호출합니다. 방식 A보다 안전하고 정확합니다. 랜딩 페이지에는 방식 A의 ①번 스크립트(또는 동일 기능의 자체 코드로 ?p= 값 저장)가 필요합니다.

POST https://rphkhioxoqfowvxrltsz.supabase.co/rest/v1/rpc/record_conversion
Content-Type: application/json
apikey: 공개키(발급값)

{
  "p_secret":   "비밀키 — 별도 전달, 코드·문서에 노출 금지",
  "p_merchant": "머천트ID",
  "p_code":     "저장해둔 파트너 코드",
  "p_order_ref": "주문번호",
  "p_amount":   55000
}

· 성공 응답: {"ok": true}
· 환불/취소 시: 같은 주문번호로 "p_status": "cancelled"를 추가해 재호출하면 실적에서 차감됩니다
· 같은 주문번호 중복 호출은 자동으로 1건 처리되므로 재시도해도 안전합니다
· 파트너 코드가 없는(일반 유입) 주문은 호출하지 않으면 됩니다

🔐 위조 방지 — 방식 A(웹빌더)는 비밀키를 브라우저에 두지 않습니다. 실제 클릭 기록이 있는 코드 + 제휴팜이 허용한 머천트의 보고만 서버에서 인정되므로 가짜 실적을 꽂을 수 없습니다. 방식 B(서버 연동)는 비밀키로 검증하며, 이 키는 연동 확정 시 담당자에게 개별 전달되고 공개 코드·저장소에 포함하시면 안 됩니다.

연동 후 테스트 체크리스트

제휴팜에서 전달받은 테스트 추적 링크를 시크릿 창에서 클릭 → 상품 페이지 주소 끝에 &p=코드가 붙어 도착하는지 확인

그 창에서 테스트 결제 1건 진행 (최소 금액 상품 권장)

제휴팜 담당자에게 확인 요청 → 클릭·전환이 대시보드에 잡혔는지 회신드립니다

취소 테스트(선택): 해당 주문을 취소 처리하고 차감 반영 확인

운영 정책

업체는 파트너 경유 주문을 성실하게 보고할 의무가 있습니다. 제휴팜은 클릭 대비 전환율을 상시 모니터링하며, 보고 누락이 의심되는 경우 테스트 구매 등으로 검증할 수 있습니다.
보고 누락이 확인되면 계약에 따라 누락 수수료 정산 및 제휴 중단이 진행될 수 있습니다.
수수료율·정산 주기는 개별 계약으로 정하며, 파트너 홍보 콘텐츠에는 공정위 지침에 따른 경제적 이해관계 표시가 안내됩니다.

문의

연동 지원·머천트ID 발급: cogur1010@gmail.com
연동은 보통 당일 완료되며, 기술 문의는 언제든 환영합니다.