유입 추적 (UTM · GA 연동)

위젯이 만드는 유입과 행동을 상점의 분석 도구(GA4, GTM 등)에서 보는 방법은 두 가지입니다.

	무엇을 알 수 있나	설정 위치
UTM 태그	위젯에서 상품 페이지로 넘어간 유입이 어디서 왔는지	위젯 스튜디오 → 프리셋 상세 → 트래킹 (UTM)
분석 이벤트 브리지	위젯 안에서의 행동 (열림 · 재생 · 상품 클릭 등)	같은 섹션의 분석 이벤트 브리지 토글

둘 다 위젯 스튜디오 프리셋 단위로 설정하므로, 위젯마다 다르게 걸 수 있습니다.

UTM 태그

방문자가 위젯의 상품 태그를 눌러 상품 페이지로 이동할 때, 그 링크 뒤에 UTM 파라미터가 붙습니다. GA 는 이 파라미터로 "이 방문이 쇼츠 위젯에서 왔다"는 것을 구분합니다.

세 가지 모드 중 하나를 고릅니다.

계정 기본값 (기본)

별도 설정이 없으면 아래 기본 UTM 이 붙습니다.

utm_source=shortsworks&utm_medium=social&utm_campaign=shortsworks_product_clicked&utm_content=쇼츠아이디

[위젯 설정] 페이지에서 계정 전체 UTM 을 지정해 두었다면 그 값이 대신 붙습니다.

이 위젯 전용

이 프리셋에서만 쓸 UTM 값을 직접 넣습니다. 캠페인·지면별로 위젯을 나눠 운영할 때 유용합니다.

• 소스(utm_source) 와 미디엄(utm_medium) 은 둘 다 필수입니다. 하나라도 비면 기본 UTM 이 붙습니다.
• 콘텐츠(utm_content) 를 비워두면 클릭된 쇼츠(포스팅) 아이디가 자동으로 들어갑니다. 어떤 쇼츠가 유입을 만들었는지 GA 에서 바로 구분됩니다.

붙이지 않음

이 위젯의 상품 링크에 UTM 을 아예 붙이지 않습니다.

언제 끄나요?

GA 는 UTM 이 붙은 링크를 만나면 방문의 유입 소스를 그 값으로 다시 잡습니다. 예를 들어 광고로 들어온 방문자가 위젯의 상품을 누르면, 이후 전환이 광고가 아니라 shortsworks / social 로 집계될 수 있습니다. 광고 어트리뷰션을 엄격하게 관리한다면 이 모드를 쓰고, 위젯 행동은 아래 분석 이벤트 브리지로 측정하세요.

분석 이벤트 브리지

UTM 은 "위젯을 떠나 상품으로 간" 순간만 알 수 있습니다. 위젯을 열었는지, 얼마나 재생했는지 같은 행동까지 보려면 브리지를 켜세요.

프리셋 상세의 트래킹 (UTM) 섹션에서 분석 이벤트 브리지를 켜면, 그 위젯이 설치된 페이지에서 아래 이벤트가 상점 사이트로 전달됩니다.

• GTM 을 쓰는 경우 — dataLayer 에 shortsworks_ 로 시작하는 이벤트가 push 됩니다.
• 그 외 도구 — shortsworks: 로 시작하는 브라우저 CustomEvent 가 발생합니다.

전달되는 이벤트

이벤트	언제 발생하나
widget_opened	방문자가 위젯을 눌러 쇼츠 재생 화면이 열렸을 때
content_view_started	쇼츠 재생이 시작됐을 때
content_skipped	쇼츠를 끝까지 보지 않고 넘겼을 때
contents_viewed	쇼츠를 끝까지 봤을 때
product_clicked	상품 태그를 눌러 상품 페이지로 이동할 때
feed_like_pressed	좋아요를 눌렀을 때

이벤트에는 쇼츠 아이디(storyId/feedId), 위젯 형태(widget_shape), 상품 아이디(product_id, 상품 클릭 시), 이동 URL(destination_url) 등이 함께 실립니다. 방문자를 식별할 수 있는 값은 포함되지 않습니다.

GTM 이 없는 사이트라면

브리지는 사이트에 이미 있는 dataLayer 만 사용하고, 없으면 만들지 않습니다. GTM 을 쓰지 않는 사이트에서는 아래 CustomEvent 방식으로 받으세요.

GTM → GA4 연동하기

1. GTM 에서 트리거 → 새로 만들기 → 맞춤 이벤트를 선택하고, 이벤트 이름에 shortsworks_.* 를 넣은 뒤 정규식 일치를 켭니다. (특정 이벤트만 원하면 shortsworks_product_clicked 처럼 정확히 적습니다.)
2. 변수 → 새로 만들기 → 데이터 영역 변수로 쓰고 싶은 필드를 등록합니다. 예: storyId, product_id, destination_url
3. 태그 → 새로 만들기 → Google 애널리틱스: GA4 이벤트를 만들고, 위 트리거를 연결합니다. 이벤트 이름은 를 그대로 쓰면 shortsworks_... 이름 그대로 GA4 에 쌓입니다. 매개변수에 2번에서 만든 변수를 연결합니다.
4. GTM 미리보기 모드로 상점에 들어가 위젯을 눌러보면, 이벤트가 들어오는 것을 바로 확인할 수 있습니다.

CustomEvent 로 직접 받기

GTM 없이 직접 스크립트로 받을 수도 있습니다.

<script>
  window.addEventListener("shortsworks:product_clicked", function (event) {
    // event.detail 에 storyId, product_id, destination_url 등이 들어 있습니다
    console.log("쇼츠 상품 클릭:", event.detail);
  });
</script>

이벤트 이름은 shortsworks: + 위 표의 이벤트명입니다. Meta Pixel 등 다른 도구로 보내는 것도 이 리스너 안에서 자유롭게 연결하면 됩니다.

구매 전환까지 보려면

• Cafe24 — 카페24 구매전환 측정하기의 전환 코드를 함께 쓰면 카페24 통계에서 위젯발 구매를 볼 수 있습니다.
• FLEXG — 플렉스지 구매전환 측정하기를 참고하세요.
• GA4 — UTM 이 붙은 세션에서 발생한 구매는 GA4 의 트래픽 소스 보고서에서 utm_source / utm_medium 기준으로 확인합니다.