전환 추적은 유료 요금제에서 사용할 수 있어요. 워크스페이스 요금제에 포함되어 있지 않으면 추적 스니펫은 아무것도 기록하지 않습니다.
AI 에이전트에 설정 요청하기
이 작업을 직접 손으로 연결할 필요는 없어요. AI 코딩 어시스턴트(Claude Code, Cursor, 또는 에디터의 유사한 에이전트)를 사용한다면, 아래와 같은 프롬프트에 이벤트 추적 ID와 원하는 전환 항목을 넣어 붙여넣으세요:작동 방식
- 수신자가 이메일 서명에 있는 링크를 클릭합니다.
- Scribe가 수신자를 사이트로 리디렉션하면서 대상 URL에
scribe_click_id파라미터를 추가합니다. - 랜딩 페이지의 Scribe SDK가 해당
scribe_click_id를 읽어 퍼스트파티로 저장하고, 기록되는 모든 이벤트에 이를 첨부합니다. - 방문자가 전환하면
scribe.track('signup')를 호출합니다. Scribe가 해당 이벤트를 원래의 클릭과 연결합니다.
scribe_click_id이고, 다른 하나는 이미 식별된 방문자입니다(이전 scribe.identify 또는 어트리뷰션된 이벤트가 해당 방문자를 원래 클릭과 연결합니다). 둘 다 없는 이벤트(즉, 순수 다이렉트 트래픽, 만료된 링크, 파라미터가 제거된 경우)는 기록되지 않아요. 이 방식 덕분에 전환 분석은 실제로 서명이 만들어낸 트래픽으로만 한정됩니다.
시작하기 전에
세 가지가 필요해요:- 전환 추적이 포함된 유료 요금제.
- 워크스페이스에 추적 활성화. 서명 조회수·클릭 분석과 동일한 설정이에요. 필요한 동의를 확보한 뒤에만 켜세요(개인정보와 동의 참고).
- 이벤트 추적 ID. 워크스페이스의 공개 식별자이며 비밀 값이 아니에요. 웹사이트 HTML에 안전하게 삽입할 수 있어요.
1
이벤트 추적 ID 복사
Scribe에서 설정을 열고 워크스페이스 탭으로 이동해 이벤트 추적 ID 아래의 값을 복사하세요. 이 화면에서 추적이 활성화되어 있는지도 확인하세요.
2
사이트에 SDK 추가
일반 웹사이트에는 스크립트 스니펫을, 앱이나 SPA에는 npm 패키지를 사용하세요. 두 방식 모두 동일한 옵션 B. npm 또는 yarn. 패키지를 설치한 뒤 앱 시작 시점에 한 번 초기화하세요.모듈을 임포트해도 부작용이 없어요(서버 사이드 렌더링에서도 안전).
scribe.track(...) API를 제공해요.옵션 A. 스크립트 스니펫. 추적하려는 모든 페이지의 닫는 </head> 태그 바로 앞에 추가하세요. 스니펫은 data-workspace에서 자동으로 초기화되므로 별도의 init() 호출이 필요 없어요.init()를 호출하기 전까지는 아무것도 전송되지 않아요.3
첫 전환 기록
전환이 발생하는 지점(예: 가입 성공 핸들러)에서 SDK가 랜딩 URL에서 Scribe 클릭 어트리뷰션을 자동으로 수집하고, 이벤트를 배치로 묶어 방문자가 페이지를 떠날 때에도 안정적으로 전송해요.
scribe.track를 호출하세요.4
동작 확인
실제 방문자와 동일한 경로로 테스트하세요. 본인의 서명 이메일 안 링크를 클릭해 Scribe가 사이트로 리디렉션하도록 하고(도착 URL에
scribe_click_id가 포함돼요), 해당 페이지에서 전환을 발생시키세요. Scribe에서 분석을 열면 조회수·클릭수와 함께 서명, 팀원, 캠페인, 국가별로 분석된 결과가 표시돼요.SDK 레퍼런스
scribe.track(name, metadata)
이벤트를 기록해요. name 값은 필수예요(예: signup, demo_booked, purchase).
value,currency,event_id필드는 최상위 필드로 인식돼요.- 그 밖의 모든 키는 이벤트의
properties값에 포함돼요. 속성은 평면 스칼라 값(문자열, 숫자, 불리언)으로만 구성하세요. 이메일이나 전화번호 같은 개인 정보는 속성에 넣지 마세요. 개인 정보로 보이는 키는 Scribe가 자동으로 삭제해요. - 전송을 안전하게 재시도하려면
event_id값을 직접 지정하세요. 24시간 이내에 같은event_id값이 두 번 수신되면 한 번만 기록돼요. - Scribe는 같은 이벤트를 방문자별로 하루에 한 번만 집계해요.
value값이 없거나value값이 0인 이벤트가 같은 날(UTC) 해당 방문자에 대해 이미 기록된 이벤트와name값 및properties값이 같으면 다시 기록되지 않아요. 예를 들어 하루에 가입 양식을 다섯 번 제출한 사람도 그날은signup1건으로 집계돼요.value값이 있는 이벤트는 항상 기록되므로, 하루에 두 번 구매하면 구매 2건으로 집계돼요. 이 동작은 최대한 처리하는 방식이며 정확히 보장되지는 않아요. 동일한 이벤트가 같은 순간에 도착하면 드물게 둘 다 기록될 수 있어요.
scribe.identify(userId, traits)
방문자를 자체 사용자 중 한 명과 연결해 어떤 서명이 어떤 고객을 확보하는지 확인할 수 있어요. B2B 및 계정 기반 업무에 유용해요.
identify를 호출하면 이후의 track 호출이 해당 사용자와 연결돼요. 로그아웃 시 scribe.reset()를 호출해 사용자 식별 정보를 지우세요.
scribe.flush()
이벤트는 일괄 처리되어 자동으로 전송되며, 페이지가 숨겨질 때는 항상 전송돼요. 현재 배치를 즉시 강제로 전송해야 할 때만 flush()를 호출하세요.
스니펫 속성
스크립트 스니펫을 사용할 때는data-* 속성으로 설정하세요.
콘텐츠 보안 정책(CSP)
사이트에 콘텐츠 보안 정책을 설정했다면 Scribe 호스트를 허용 목록에 추가하세요.활용 사례: 전환을 성장으로
전환 추적을 사용하면 이메일 서명이 측정 가능한 고객 확보 채널이 돼요. 유료 리마케팅에 데이터를 활용하는 방법을 포함해 팀들이 데이터를 어떻게 활용하는지 소개할게요.Google Ads와 Meta Ads에서 리마케팅 캠페인 운영하기
scribe.track를 호출하는 곳에서 광고 플랫폼 전환 픽셀도 함께 실행하면 하나의 전환이 Scribe, Google Ads, Meta에 동시에 기록돼요. Scribe는 전환이 이메일 서명에서 발생했음을 알려 주고, Google과 Meta는 같은 신호를 입찰과 잠재고객 타겟팅에 활용해요.
구매 의도가 높은 리타기팅 오디언스 구축
서명을 클릭해 사이트에 방문했지만 전환하지 않은 사람은 이미 관심을 보인 잠재 고객이에요. Scribe로 서명에서 유입된 트래픽을 확인한 다음, Google과 Meta에서 맞춤 혜택으로 이 방문자를 리타기팅하세요. 자체 이메일에서 발생한 트래픽이므로 이 오디언스는 콜드 프로스펙팅보다 전환율이 높은 경향이 있어요.전환한 사용자로 유사 오디언스 만들기
가장 좋은 시드 오디언스는 신뢰할 수 있는 채널을 통해 이미 전환한 사람들이에요. 서명으로 유입된 방문자를 가져와(서명, 팀원, 캠페인별로 필터링) Meta의 맞춤 타겟(Custom Audience) 또는 Google Ads의 고객 일치(Customer Match) 목록으로 업로드한 다음, 이 고품질 시드를 바탕으로 유사 타겟(Lookalike) 또는 유사 오디언스(Similar audiences)를 만드세요.신규 고객 확보 비용에서 기존 고객 제외
이미 가입했거나 구매한 사람을 확보하는 데 비용을 쓰지 마세요. 전환한 사용자를 내보내 잠재 고객 발굴 캠페인의 제외 목록으로 추가하면 예산이 새로운 잠재 고객에게만 쓰여요.클릭이 아닌 매출 기준으로 최적화
각 전환마다 실제value 및 currency 값을 함께 전달하세요. 매출 데이터가 연결되면 Google과 Meta에서 가치 기반 입찰로 전환할 수 있고, Scribe에서는 클릭 수만이 아니라 창출한 매출을 기준으로 서명, 팀원, 캠페인의 순위를 매길 수 있어요.
채널 성과 입증과 예산 재배분
전환 추적을 사용하면 이메일 서명으로 발생한 매출을 유료 채널과 같은 기준으로 비교할 수 있어요. 서명 캠페인이 유료 캠페인보다 성과가 좋다면, 효과적인 곳으로 예산을 옮길 근거가 되는 수치를 확보할 수 있어요.개인정보 보호 및 동의
전환 추적은 방문자를 존중하고 준수해야 할 의무를 지키도록 설계되었어요:- IP 주소는 익명화돼요. Scribe는 IP를 저장하기 전에 해시 처리해요. 원본 IP는 저장하지 않아요.
- 속성에 개인 정보를 담지 않아요. 개인 정보로 보이는 키(이메일, 전화번호, 비밀번호, 토큰, 카드 번호 등)는 이벤트 속성에서 자동으로 제거돼요. 사용자를 의도적으로 연결하려면
identify를 사용하세요. - 동의 기반 저장. 방문자가 동의하기 전까지 SDK가 클릭 식별자를 저장하지 않도록
data-consent="denied"(스니펫) 또는consent: false(npminit)를 설정하세요. - 추적을 켜기 전에 동의를 받으세요. 워크스페이스 추적 설정에는 다른 분석 픽셀과 같은 책임이 따라요. 설정을 켜기 전에 해당 지역에서 요구하는 동의를 받았는지 확인하세요.
관련 문서
- 분석 개요: 워크스페이스 전체의 조회수, 클릭수, 도달 범위, CTR을 확인하세요.
- 분석 대시보드: 모든 탭에서 조회수, 클릭수와 함께 전환을 확인하세요.
- 서명 분석: 개별 서명의 성과를 확인하세요.
- 마케팅 캠페인: 서명 안에서 배너 캠페인을 운영하고 성과를 측정하세요.
- Smartfields로 링크 개인화하기: UTM 매개변수와 팀원 정보를 자체 도구로 보내요. Scribe 추적과는 별개의 데이터 세트예요.
- AI 에이전트를 위한 Scribe: 어시스턴트가 추적을 설정하고 전환을 보고하도록 맡기세요.