연동
Google Analytics 4
서버 측 Measurement Protocol: 기록된 모든 클릭이 link_click 이벤트가 됩니다.
Solo, Growth, Ultimate에서는 Letlink가 Measurement Protocol을 사용해 기록된 모든 클릭에 대해 GA4 이벤트를 보낼 수 있습니다. 방문자의 브라우저에서 실행되는 것이 없으므로, 방문자가 사이트 픽셀을 불러오지 않아도(QR 스캔, 인앱 웹뷰, 즉시 리디렉션 포함) 이벤트가 도착합니다.
자격 증명 준비
- Google Analytics에서 관리 → 데이터 스트림 → 내 웹 스트림을 여세요.
- 측정 ID(
G-뒤에 영문자와 숫자)를 복사하세요. - Measurement Protocol API 시크릿을 열고 새 시크릿을 만드세요. 한 번만 복사할 수 있으며 GA4는 다시 보여 주지 않습니다.
Letlink에 붙여 넣기
- 연동 → Google Analytics 4로 이동하세요. 소유자와 관리자만 가능합니다.
- 측정 ID와 API 시크릿을 붙여 넣고 저장하세요.
- 연결을 해제하려면 측정 ID를 지우고 저장하세요(비밀 키는 비워 두세요).
이벤트
기록된 클릭마다 engagement_time_msec=1과 함께 이벤트 이름 link_click을 전송합니다. GA4 client_id는 기기 핑거프린트가 있으면 그 값을, 없으면 click.{visit_id}를 사용합니다. 매개변수:
| 매개변수 | 의미 |
|---|---|
| short_code | 단축 URL의 뒷부분 |
| link_type | direct, utm, appstore, instagram, mobile 또는 device |
| variation | 분할 테스트 이름, 스캔은 qr, 또는 빈 값 |
| device_type | 예: desktop, smartphone |
| browser | 브라우저 종류 |
| session_id | 숫자 방문 ID로, GA4가 각 클릭을 별도 세션으로 처리할 수 있게 합니다 |
GA4에서 확인하기
이벤트가 표준 보고서에 표시되기까지 최대 24시간이 걸릴 수 있습니다. 더 빨리 확인하려면 트래픽을 보낸 뒤 관리 → DebugView를 사용하거나, 속성에 Measurement Protocol 이벤트가 포함되어 있다면 실시간 보고서를 확인하세요. 탐색 분석에서 사용하려면 short_code와 variation을 맞춤 측정기준으로 등록하세요.
이 기능이 하지 않는 것
- 리디렉션 시 gtag.js를 불러오지 않습니다.
- 클릭을 대상 사이트의 이후 세션과 연결하지 않습니다. 클라이언트 ID는 사이트의
_ga쿠키가 아니라 Letlink의 핑거프린트입니다. - 월 클릭 한도에 도달했거나 기기 방문 제한으로 리디렉션이 차단된 경우에는 실행되지 않습니다.