이 도움말에서는 서버 측 컨테이너에 이벤트를 전송하는 다양한 방법에 대해 설명합니다. 배경 정보가 더 필요한 경우 서버 측 태그 지정 작동 방식을 참고하세요.
이 도움말에서는 다음 작업을 실행하는 방법을 설명합니다.
- 웹사이트에서 서버 측 컨테이너로 데이터 전송
- 서버 컨테이너에 추가 데이터 전송
- 서버 측 컨테이너에서 데이터 수신
- 웹사이트 이외의 소스에서 데이터 전송
시작하기 전에
이 가이드에서는 다음 작업을 이미 완료했다고 가정합니다.
1. 웹사이트에서 서버 측 컨테이너로 데이터 전송
태그 관리자 또는 Google 태그(gtag.js)를 통해 서버 측 구현을 사용하여 데이터를 라우팅할 수 있습니다. 구현 옵션을 선택합니다.
선택사항: 각 이벤트와 함께 추가 매개변수 전송
두 유형의 추가 매개변수, 즉 구성 수준 매개변수와 이벤트 수준 매개변수를 전송할 수 있습니다. 구성 매개변수는 Google 태그의 동작에 영향을 미치며 Google 태그 수준에서만 설정할 수 있습니다.
이벤트 매개변수는 이벤트에 대한 추가 정보를 지정하며 모든 이벤트, 일부 이벤트 또는 page_view 이벤트에 대해서만 설정할 수 있습니다.
2. 서버 측 컨테이너에서 데이터 수신
서버 컨테이너에 HTTP 요청을 보내면 클라이언트에서 해당 요청의 소유권을 주장해야 합니다.
사용 가능한 클라이언트 목록을 보려면 다음 안내를 따르세요.
Google 태그 관리자를 엽니다.
서버 컨테이너를 엽니다.
왼쪽의 탐색 메뉴에서 클라이언트를 클릭합니다. GA4 클라이언트는 기본적으로 서버 측 컨테이너에 사전 설치되어 있습니다. 유니버설 애널리틱스를 사용해야 하는 경우 Google 애널리틱스: 유니버설 애널리틱스 클라이언트를 설정하세요.
세부정보를 보거나 수정할 클라이언트의 이름을 클릭합니다.
클라이언트 설정(선택사항)
대부분의 경우 클라이언트는 수정할 필요가 없습니다. 하지만 사용 사례는 다를 수 있으며 다음 설정 중 하나를 수정하는 것이 좋습니다.
우선순위: 클라이언트의 실행 순서를 결정합니다. 숫자가 클수록 먼저 실행되며, 수신된 요청과 일치하는 첫 클라이언트가 해당 요청에 대한 활성 클라이언트가 됩니다.
활성화 기준: 활성화 기준은 클라이언트가 요청에 응답할 시점을 정의합니다.
UA 클라이언트의 경우: 기본 유니버설 애널리틱스 경로: 요청 경로에
/collect,/r/collect, Google 애널리틱스에 데이터를 전송하는 JavaScript 파일에서 사용되는 기타 유사한 경로가 포함된 경우 클라이언트가 활성화됩니다. 이 설정은 기본적으로 활성화되어 있습니다.특정 ID의 기본 gtag.js 경로: 서버 컨테이너 URL을 통해 제공되는 gtag.js JavaScript를 사용 설정하려면 이 설정을 사용합니다. 사용 설정하면 클라이언트가 기본 gtag.js 요청 경로(예:
/gtag/js?id=TAG_ID)에 전송되는 요청에 반응하여 활성화됩니다. 측정 ID 추가를 클릭하여 하나 이상의 도착 페이지 ID를 추가합니다.
선택사항: 서버 측 태그 관리자에서 추가 데이터 받기
추가 매개변수를 전송하는 경우 추가 매개변수를 파싱하고 추가 매개변수로부터 이벤트 데이터를 만들도록 서버 컨테이너의 Google 애널리틱스 4 클라이언트를 설정해야 합니다.
서버 태그에서 추가 매개변수를 사용하는 방법은 다음과 같습니다.
- 서버 컨테이너에서 왼쪽 탐색 메뉴에 있는 변수를 클릭합니다.
- 새로운 사용자 정의 변수를 만듭니다.
- 변수 구성에서 이벤트 데이터 변수 유형을 선택합니다.
- 키 경로에 매개변수의 이름을 입력합니다.
- 변수 이름을 지정하고 저장합니다.
이제 서버 컨테이너 내 다른 태그에서 이벤트 매개변수를 사용할 수 있습니다.
3. 선택사항: 웹사이트 이외의 소스에서 데이터 전송
Google 애널리틱스 측정 프로토콜은 모바일 앱 및 서버 간 애플리케이션과 같은 소스에서 서버 측 태그 지정을 사용 설정하는 데 사용할 수 있습니다.
모바일 앱
Android 또는 iOS 앱에서 서버 컨테이너로 데이터를 전송하도록 하려면 맞춤 이미지 태그를 만들고 측정 프로토콜을 사용하도록 구성합니다.
- 모바일 컨테이너(Android 또는 iOS)에서 태그 > 새로 만들기를 클릭합니다.
- 태그 구성에서 맞춤 이미지 태그 유형을 선택합니다.
- 이미지 URL 값을 앞에서 지정한 측정 프로토콜 클라이언트 경로의 서버 컨테이너에 있는 픽셀 이미지로 설정합니다.
원하는 측정 프로토콜 매개변수를 픽셀 URL 끝에 추가합니다.
https://custom.example.com/app?v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home - 캐시 무효화 사용을 선택 해제합니다.
- 태그를 저장하고 컨테이너를 게시합니다.
- 서버 측 컨테이너에서 클라이언트 > 새로 만들기를 클릭합니다.
- 클라이언트 구성에서 측정 프로토콜 클라이언트 유형을 선택합니다.
- 활성화 경로를 앱의 컬렉션 엔드포인트 경로로 설정합니다.
- 클라이언트 구성을 저장하고 서버 측 컨테이너를 게시합니다.
서버 간 앱
측정 프로토콜 데이터를 서버 컨테이너에 전송하려면 www.google-analytics.com 호스트 이름을 서버 컨테이너의 도메인 이름으로 바꿉니다. 예:
POST /batch HTTP/1.1
Host: collection.example.com
v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home
측정 프로토콜 조회를 수신하려면 다음 단계에 따라 서버 측 태그 관리자 설치에 측정 프로토콜 클라이언트를 구성합니다.
- 서버 측 컨테이너에서 클라이언트 > 새로 만들기를 클릭합니다.
- 클라이언트 구성에서 측정 프로토콜 클라이언트 유형을 선택합니다.
- 활성화 경로를 서버의 엔드포인트 경로로 설정합니다.
- 클라이언트 구성을 저장하고 컨테이너를 게시합니다.
다음 단계
실제 퍼스트 파티 맥락에서 데이터를 전송하려면 자체 서버에서 Google 애널리틱스 라이브러리와 같은 Google 스크립트를 제공해야 합니다.