Edgelink
Docs전환 추적전환 추적 개요

전환 추적 개요

Edgelink 전환 추적을 활용해 단축 링크 클릭이 회원가입·매출로 이어진 비율을 측정합니다.

전환 추적 개요

Edgelink 전환 추적은 링크 클릭이 회원가입·매출로 얼마나 이어졌는지를 정량적으로 측정하는 기능입니다. 마케팅 채널 효율을 비교하고, 광고비 ROI를 검증할 수 있습니다.

동작 방식

1. 사용자가 단축 링크 클릭
   ↓
2. Edgelink가 클릭 ID(el_cid) 발급 + destination URL에 자동 부착
   ↓
3. 고객사 사이트 진입 시 sdk-web이 el_cid를 _el_cid 쿠키(90일)에 저장
   ↓
4. 회원가입·결제 같은 전환 발생 시 SDK가 /api/v1/track으로 이벤트 전송
   ↓
5. 대시보드에서 클릭 → 리드 → 매출 퍼널 분석

이벤트 타입

이벤트키용도
클릭자동단축 링크가 열린 시점. Edgelink가 자동 기록
리드lead회원가입·뉴스레터 구독·문의 등 가치 발생 시점
매출sale결제 완료. secret 키 + 서버(sdk-node) 전송 필수 (위변조 방지)
커스텀임의 문자열영상 끝까지 시청, 카트 담기 등 임의 정의

두 가지 SDK

SDK용도키가이드
@edgelink/sdk-web브라우저에서 lead·커스텀 이벤트 전송publishable (pk_)sdk-web 가이드
@edgelink/sdk-node서버에서 sale 등 위변조 우려 이벤트secret (sk_)sdk-node 가이드

sale 이벤트는 매출 위변조를 막기 위해 publishable 키로는 전송할 수 없습니다. 반드시 결제 webhook이 도착하는 서버에서 secret 키로 전송하세요.

5분 시작 가이드

1단계 — Pro 플랜 활성화 후 통합 페이지 진입

워크스페이스 설정의 통합(Integrations) → 전환 추적 탭에서 publishable 키를 발급합니다.

2단계 — 스니펫 복사 후 사이트에 삽입

발급 직후 표시되는 <script> 스니펫을 고객사 사이트 <head> 영역에 삽입합니다.

<script
  async
  src="https://cdn.edgelink.me/sdk/v1/edgelink.iife.js"
  data-publishable-key="pk_live_xxxxxxxxxxxx"
></script>

3단계 — 전환 이벤트 호출

<script>
  edgelink('track', 'signup', { externalUserId: 'user-1234' })
</script>

4단계 — 매출 이벤트는 서버에서

import { Edgelink } from '@edgelink/sdk-node'

const edgelink = new Edgelink({ secretKey: process.env.EDGELINK_SECRET_KEY! })

await edgelink.conversions.create({
  clickId: req.cookies._el_cid,
  eventType: 'sale',
  eventName: 'purchase',
  externalEventId: order.id,
  valueMinor: order.totalAmountKrw,
  currency: 'KRW',
})

5단계 — 대시보드에서 퍼널 확인

통합 페이지의 최근 전환 이벤트 섹션에서 실시간 수신 여부를 확인할 수 있습니다. 자세한 퍼널 분석은 워크스페이스 분석 대시보드에서 제공됩니다.

다음 단계