연동
Google Tag Manager (server-side)
클릭과 전환을 GA4 Measurement Protocol 히트로 서버 측 GTM 컨테이너에 보냅니다.
Google Tag Manager 연동은 기록된 모든 Letlink 클릭과 승인된 모든 전환을 GA4 Measurement Protocol 히트로 사용자의 서버 측 GTM 컨테이너에 보냅니다. 이벤트가 태깅 서버에 도착하면 컨테이너의 모든 태그(GA4, Google Ads, Meta, 데이터 웨어하우스 등)가 처리할 수 있으므로, 도구마다 따로 설정하지 않고 GTM에서 한 번만 대상을 설정하면 됩니다. Growth 및 Ultimate에서 제공됩니다.
필요한 것
- 자체 HTTPS 주소를 가진 실행 중인 서버 측 컨테이너(예:
https://gtm.example.com). - 해당 컨테이너의 Measurement Protocol 클라이언트. GTM은 기본적으로 추가하지 않습니다.
- 컨테이너가 전달하는 GA4 웹 스트림의 측정 ID(
G-…).
컨테이너 준비
- 서버 컨테이너에서 Clients → New를 열고 클라이언트 유형으로 Measurement Protocol을 선택하세요.
- Activation Path를
/mp/collect(또는 원하는 경로 — Letlink에도 같은 경로를 입력합니다)로 설정하고 저장하세요. - 해당 클라이언트로 트리거되는 Google Analytics: GA4 태그와 이벤트를 전달할 기타 태그를 추가하거나 재사용한 다음 컨테이너를 제출합니다.
Letlink에 연결하기
- 연동 → Google Tag Manager(서버 측)를 엽니다. 소유자와 관리자만 가능합니다.
- 태깅 서버 URL(경로 없이), 측정 ID, 변경한 경우 클라이언트 경로를 입력하세요.
- API 시크릿은 선택 사항입니다. GA4 태그가 GA4 Measurement Protocol 시크릿으로 Google에 히트를 전달한다면 붙여 넣으세요.
- 저장하고 테스트 이벤트 보내기를 누른 다음, 컨테이너의 미리보기 모드에서 요청이 도착하는지 확인하세요.
전송하는 내용
표준 GA4 Measurement Protocol 본문을 담은 <tagging server><path>?measurement_id=G-…에 대한 POST. client_id는 대시보드와 같은 기기 지문이며, 알 수 있는 경우 방문자의 국가가 user_location에 들어갑니다.
| Letlink 이벤트 | GA4 이벤트 | 추가 매개변수 |
|---|---|---|
| 클릭 | link_click |
short_code, link_type, variation, destination_url, UTM 값, click_id |
| 판매 | purchase |
transaction_id(주문 ID), value, currency |
| 리드 | generate_lead |
전송된 경우 value, currency |
| 가입 | sign_up |
method = short_link |
| 맞춤 | GA4 규칙에 맞게 정리된 이벤트 이름 | 전송된 경우 value, currency |
모든 전환에는 conversion_id(conv-<id>)와 원래 클릭의 click_id도 포함되므로, BigQuery에서 조인하거나 태그에서 중복을 제거할 수 있습니다.
아무것도 도착하지 않습니다 — 무엇을 확인해야 하나요?
- 태깅 서버 URL은 HTTPS여야 하며 인터넷에서 접근할 수 있어야 합니다.
404는 대개 해당 경로를 처리하는 클라이언트가 없다는 뜻입니다. Measurement Protocol 클라이언트의 활성화 경로를 확인하세요. - 미리보기 모드는 열려 있는 동안의 요청만 표시합니다. 연 다음에 테스트 이벤트를 보내세요.
- 워크스페이스가 광고 플랫폼으로 전환을 전달하지 않더라도 이 연동에는 항상 전환이 전송됩니다.