쇼핑몰 연동

쓰시는 솔루션에 따라 붙이는 방법이 다릅니다. 눌러서 해당 안내로 이동하세요.

솔루션 고르기

자체몰 — 서버 SDK

서버에서 Set-Cookie로 클릭 쿠키를 구울 수 있어 Safari 제약을 받지 않습니다. 가장 정확합니다.

붙이는 순서는 시작하기에 그대로 있습니다 — 쿠키 저장 → order.paid 전송 → 야간 대사.

카페24 — 앱 설치 (준비 중)

카페24 몰에서는 브랜드가 서버 코드를 돌릴 수 없고, 몰 스킨에 스크립트를 직접 넣는 것도 카페24가 금지합니다. 그래서 연동은 링크팜 카페24 앱이 담당합니다. 설치 한 번으로 클릭 추적과 주문 연동이 자동 설정됩니다.

앱 출시 전까지는 크리에이터 할인코드로 귀속합니다 — 스마트스토어와 같은 방식입니다. 코드 발급만 해주시면 됩니다.

앱이 나오면 기존 코드 귀속은 그대로 두고 클릭 추적이 추가됩니다. 붙여둔 것을 걷어낼 필요는 없습니다.

아임웹 · 고도몰 · 메이크샵 · 식스샵

외부 스크립트를 넣을 수 있는 솔루션입니다. 공통 헤더에 아래를 넣어 클릭 식별자를 저장하세요.

Safari에서는 이 쿠키가 24시간으로 잘립니다. 트래킹 도메인을 거쳐 들어온 페이지에 쿼리스트링이 있으면 브라우저가 만든 쿠키를 캡합니다. 그래서 스크립트만 쓰는 경우 크리에이터 할인코드를 함께 운영하시길 권합니다. 코드는 브라우저 제약을 받지 않고, 둘 다 있으면 코드가 우선합니다.

HTML
<!-- 공통 헤더에 삽입. 랜딩의 lf_click 을 쿠키로 저장합니다. -->
<script>
(function () {
  var m = location.search.match(/[?&]lf_click=([^&]+)/);
  if (!m) return;
  // ⚠️ Safari 에서는 이렇게 만든 쿠키가 24시간으로 잘립니다.
  //    가능하면 서버에서 Set-Cookie 로 구우세요.
  document.cookie =
    'lf_click=' + m[1] + '; path=/; max-age=' + 60 * 60 * 24 * 400 +
    '; samesite=lax; secure';
})();
</script>

쿠키의 400일은 저장 수명일 뿐입니다. 귀속 인정은 제품별 어트리뷰션 윈도우(기본 30일, 브랜드가 7·30·60일 중 설정)로 서버가 다시 판정합니다 — 윈도우를 넘긴 클릭은 쿠키가 남아 있어도 귀속되지 않습니다. 할인코드 귀속은 이 제한을 받지 않습니다.

주문 전송은 솔루션의 주문 API 권한을 승인해 주시면 저희가 주기적으로 가져옵니다. 식스샵은 취소·환불 경로가 제한적이라 CSV 대사를 병행합니다.

스마트스토어 — 코드 전용

외부 스크립트 삽입이 막혀 있어 클릭 추적이 불가능합니다. 크리에이터별 할인코드를 발급해 코드로만 귀속합니다.

주문 전송은 커머스 API 권한을 승인해 주시면 저희가 주기적으로 가져오거나, 정산 주기에 맞춰 CSV로 올려주시는 방식 중 고르시면 됩니다.

대사는 어느 방식이든 같습니다

누락 복구는 하나입니다 — 어제 주문 전량을 다시 보내세요. 이미 반영된 주문은 그대로 두고 빠진 것만 채워집니다.

GET/v1/orders
https://openapi.linkfarm.ai/v1/orderssk_

저희가 인식한 주문 목록. 조회 API를 따로 만드실 필요는 없습니다.

어떤 걸 쓰시는지 알려주세요

위에 없는 솔루션이거나 어떤 방식이 맞을지 판단하기 어려우시면 알려주시면 맞는 방법을 안내드립니다 — support@linkfarm.ai