@edgelinkapp/sdk-web

Edgelink 전환 추적을 위한 브라우저 SDK. 단축 링크 클릭으로 발생한 el_cid(click ID)를 1st-party 쿠키로 보존하고, 사용자 행동(회원가입, 장바구니 추가 등)이 발생하면 POST /api/v1/track으로 전환 이벤트를 전송합니다.

설치 (스크립트 태그)

<script>
  ;(function () {
    var w = window
    if (w.edgelink) return
    var queue = (w.edgelink = function () {
      queue.q.push(arguments)
    })
    queue.q = []
  })()
</script>
<script async src="https://cdn.edgelink.me/sdk/v1/edgelink.iife.js" data-publishable-key="pk_live_xxxxx"></script>

설치 (npm)

React/Next.js 등 번들러 파이프라인에 포함시키려면 npm으로 설치합니다.

npm install @edgelinkapp/sdk-web

ESM(import)과 CJS(require)를 모두 지원하며 TypeScript 타입이 포함되어 있습니다.

사용법

import { Edgelink } from '@edgelinkapp/sdk-web'

const edgelink = new Edgelink({ publishableKey: 'pk_live_xxxxx' })
edgelink.init()

// 회원가입 완료 시
edgelink.track('signup', {
  externalUserId: 'user_12345',
  email: '[email protected]',
  externalEventId: 'signup_user_12345', // 미지정 시 SDK가 자동 생성
})

// 사용자 식별 (선택)
edgelink.identify('user_12345', { email: '[email protected]' })

보안 / 개인정보

• sale 이벤트는 클라이언트에서 금액 위변조 위험으로 거부됩니다. 결제는 서버에서 @edgelinkapp/sdk-node로 전송하세요.
• 이메일은 SDK가 자동으로 lowercase + SHA-256 해시하여 customerEmailHash로 전송합니다.
• GPC(Sec-GPC: 1) 또는 DNT(Do Not Track: 1) 신호 감지 시 track() 호출이 no-op 처리됩니다 (옵션 respectPrivacySignals: false로 비활성 가능).

번들 크기

gzip 8KB 미만 (size-limit CI 가드).