제휴 프로그램을 운영하는 일이 두 번째 기술 프로젝트가 되어서는 안 됩니다. 요구사항은 대개 짧습니다: 주문이 어디서 왔는지 알고, 설명할 수 있는 수수료율을 지급하며, 제휴사가 보는 페이지에 우리 브랜드를 넣고, 스프린트 없이 모두 운영하는 것입니다. 이 글은 각 부분을 살펴본 다음 실제로 보내야 하는 요청을 보여드립니다.

그냥 있는 게 아니라 제대로 된 추적

두 가지 이벤트가 중요합니다. 클릭은 방문자가 제휴 링크를 통해 들어왔다는 것을 알려주며, 제휴 통계의 기초가 됩니다. 전환은 주문이 완료되었다는 것을 알려주며, 커미션 계산의 기초가 됩니다. Afflixo는 IP, 사용자 에이전트, 리퍼러와 함께 클릭을 기록하고, URL의 판매자 정보를 검증한 후에만 전환을 수락합니다.

조용히 중요하게 작용하는 부분은 중복 제거입니다. 결제 웹훅은 재시도되며, 재시도가 두 번째 전환을 만들면 한 번의 판매에 대해 두 번 지급하게 됩니다. Afflixo는 프로그램 내부의 주문 ID를 기준으로 중복을 제거하므로, 동일한 주문 ID를 다시 보내면 새 전환을 만들지 않고 기존 전환을 반환합니다. 이 동작을 위해 추가로 보낼 것은 없으며, 자체 시스템에서 고유한 주문 ID만 있으면 됩니다.

제휴사에게 설명할 수 있는 커미션 규칙

세 가지 설정으로 거의 모든 프로그램을 처리할 수 있습니다:

  • 주문의 일정 비율.
  • 판매당 고정 금액.
  • 별도로 협상한 파트너를 위한 특정 제휴사에 대한 요율.

프로그램의 기본값을 설정하고 필요한 곳에서 덮어씁니다. 둘 다 존재하는 경우 제휴사별 요율이 우선합니다. 적용 범위는 요율과 별개입니다: 첫 주문만, 처음 N개 주문, 또는 기간 설정입니다.

개발자 없이 변경할 수 있는 모집 페이지

제휴사가 처음 접하는 페이지는 대개 그들이 당신에 대해 보는 첫인상이며, 빨리 낡습니다: 제안이 바뀌고, 요율이 바뀌고, 스크린샷이 낡습니다. 헤드라인을 바꾸는 것이 개발자 티켓을 의미한다면, 페이지는 업데이트를 멈추게 됩니다.

그래서 프로모션 페이지는 비주얼 에디터에서 편집합니다. 텍스트, 이미지, 제목, 버튼, FAQ 항목, 색상, 그리고 팀원이 원한다면 선택적으로 커스텀 CSS도 가능합니다. 에디터에서 보는 것이 실제 페이지에 표시되는 것이며, 그 사이에 배포 단계는 없습니다.

제휴사와 지급을 한곳에서

프로그램에 누가 참여하고 있는지, 그들이 어떻게 하고 있는지 확인하고, 신청자를 승인하거나 거절하며, 지급할 금액을 알아야 합니다. Afflixo는 제휴사, 전환, 커미션, 지급 요청을 판매자 대시보드에 모두 표시하며, 모두 자체 프로그램 범위로 한정됩니다.

돈을 이동시키는 데까지는 가지 않습니다. 제휴사가 출금을 요청하면 승인하고, 이미 지급하는 방식대로 지급합니다. 그러면 커미션은 정산 처리되어 두 번 승인될 수 없습니다. 이것은 의도적인 한계이지 빠진 기능이 아닙니다: 자금이 나가는 시점을 직접 통제할 수 있게 해줍니다.

통합

판매자 슬러그가 추적 엔드포인트에서 당신을 식별하므로 관리할 API 키가 없습니다. 대시보드에서 가져오면 됩니다.

주문이 완료되고 제휴사에서 왔다는 것을 알게 되면, 백엔드에서 한 번 호출하세요:

POST /api/<merchantSlug>/track/conversion
Content-Type: application/json

{
  "orderId": "ORD-12345",
  "amount": 99.00,
  "currency": "USD",
  "affiliateCode": "ABC123"
}
  • orderId는 자체 주문 ID입니다. 중복 제거의 기준이 되므로 당신 쪽에서 고유해야 합니다.
  • amount는 커미션이 계산되는 기준 금액으로, 소계 기준으로 지급한다면 주문 총액일 필요는 없습니다.
  • affiliateCode는 방문자가 이미 리퍼럴 링크가 설정하는 affiliate_ref 쿠키를 가지고 있다면 선택 사항입니다. x-affiliate-code 헤더로 보낼 수도 있습니다. 세 가지 중 어느 것도 없으면 요청은 거부됩니다. 크레딧을 줄 대상이 없기 때문입니다.

응답에는 계산된 커미션과 그 상태가 포함됩니다. 이것이 필요한 전체 통합입니다.

클릭 보고는 선택 사항이며 다음과 같습니다:

POST /api/<merchantSlug>/track/click
Content-Type: application/json

{ "affiliateCode": "ABC123" }

이것을 건너뛰면 클릭 통계만 잃게 되며, 커미션은 계속 작동합니다.

이것이 맞는 경우와 아닌 경우

다단계 커미션, 판매자별 커스텀 도메인, PayPal이나 Stripe를 통한 자동 지급, 또는 USD 외의 통화가 필요하다면 Afflixo는 현재 이러한 기능을 제공하지 않습니다. 위 목록이 필요하다면, 통합은 엔드포인트 하나이며 개발자 문서에서 정확한 사양을 확인할 수 있습니다.