구글 태그 관리자(서버)

이것은 Amplitude 애널리틱스를 위한 서버 측 Google 태그 매니저 템플릿입니다. 이 태그는 데이터 수집을 위해 Amplitude HTTP V2 API를 사용합니다.

향상된 기능 세트, 중요한 버그 수정, 향상된 사용자 경험을 위해 Amplitude GTM 템플릿을 지속적으로 최신 버전으로 업데이트하십시오.

컨테이너 설정

0부터 시작하는 경우 먼저 컨테이너를 설정하십시오. 이 Amplitude 애널리틱스 태그 템플릿은 서버 대상 플랫폼에서 찾을 수 있으며, 데스크톱 및 모바일 웹 페이지에서 사용하기 위한 것입니다.

템플릿 추가

갤러리를 검색하여 새 태그 템플릿을 만듭니다. Amplitude 애널리틱스를 선택하고 add버튼을 클릭합니다.

클라이언트 생성

클라이언트는 GTM 서버측 컨테이너가 수신한 데이터를 가져오고 처리하거나 조정합니다. 그런 다음 클라이언트는 해당 컨테이너의 태그, 트리거 및 변수에 데이터를 사용할 수 있도록 합니다. 새 서버 컨테이너를 생성하면 Universal 분석와 GA4라는 두 개의 클라이언트가 자동으로 생성됩니다. 또한 서버측 템플릿을 웹 컨테이너의 프록시로 사용하거나 Template섹션에서 사용자 지정 클라이언트 템플릿을 만들 수도 있습니다.

태그 생성

Amplitude 브라우저 SDK 추적을 위한 태그를 생성하세요. New버튼을 클릭하여 새 태그를 생성합니다.

API 키

API 키 필드에 Amplitude 프로젝트 API 키를 복사하세요. EU 거주자의 경우 프로젝트 API 키는 analytics.eu.amplitude.com에 있습니다. 각 프로젝트마다 다른 API 키가 있으므로 올바른 프로젝트에서 API 키를 복사해야 합니다. 설정 > 프로젝트 > 목록에서 올바른 프로젝트 이름을 클릭하여 프로젝트 API 키를 찾습니다. 자세한 내용은 API 키 및 토큰 설명서를 참조하십시오.

사용자 IP 주소 숨기기

Amplitude가 사용자의 IP 주소를 수신하지 않도록 하려면 이 확인란을 선택합니다.

확인 Hide User IP Address: Amplitude는 HTTP 요청 헤더에서 수집된 IP를 사용하며, 이는 귀하의 서버에서 받은 IP입니다.
체크 취소 Hide User IP Address: Amplitude는 getRemoteAddress 메소드를 사용하여 요청이 시작된 IP 주소를 가져옵니다.

EU 데이터 상주

EU 데이터 거주를 위해서는 Amplitude EU 내에서 프로젝트를 설정하고 Amplitude EU의 API 키를 사용하세요. 태그 구성 아래의 EU 데이터 상주권 사용 확인란을 선택하여 서버 영역을 구성할 수 있습니다.

이벤트 구성

이벤트 페이로드와 관련된 구성입니다.

맵 이벤트 유형

테이블에서 Amplitude 이벤트 유형에 매핑할 각 이벤트 이름에 대한 행을 추가합니다. Block events that are not mapped을 선택하면 Amplitude는 이 테이블에 포함된 이벤트 데이터 키만 요청과 함께 전송하고 테이블에 없는 이벤트를 제외합니다.

이름	설명
`Event Name`	필수입니다. `string`. 이 태그가 수신한 `event_name`.
`Send As Event Type`	필수입니다. `string`. 이벤트 이름을 매핑하려는 이벤트 유형입니다. 이 이름은 Amplitude 대시보드에 표시되는 이름입니다.

이벤트 속성을 매핑하세요.

이벤트 데이터 객체의 키를 Amplitude로 전송할 이벤트 속성에 매핑합니다. 이벤트 속성 이름을 지정하지 않으면 Amplitude는 대신 이벤트 데이터 키를 사용합니다.

이름	설명
`Event Data Key`	필수입니다. `string`. Amplitude 이벤트 페이로드에 이벤트 속성으로 포함하려는 이벤트 데이터 객체의 키/값 쌍입니다.
`Send As Event Property`	선택 사항입니다. `string`. 이 이벤트의 속성 이름으로, Amplitude 대시보드에 표시됩니다. 비어 있으면 Amplitude는 대신 이벤트 유형으로 `Event Data Key`를 사용합니다.

이벤트 속성 추가

이 표를 사용하여 Amplitude 서버로 전송된 히트에 새 이벤트 속성을 추가하십시오. 각 속성에는 키와 값이 필요합니다.

이름	설명
`Event Property Key`	필수입니다. `string`. 이벤트 데이터 객체에 있는 `event_name`.
`Event Property Value`	선택 사항입니다. `string`. 이벤트 속성 키의 값입니다.

사용자 속성 구성

사용자 속성 구성에서 다음 필드를 완료하십시오.

UTM 매개변수 자동 추적

Amplitude는 UTM 매개 변수를 추적하기 위해 getEventData('page_location')를 사용하여 해당 값을 분석합니다.search_parameter

utm_source, utm_medium, utm_campaign, utm_term, utm_content를 비롯한 모든 UTM 매개변수를 수집하려면 이 확인란을 선택합니다. Amplitude는 이러한 값과 다른 사용자 속성을 추적된 이벤트와 함께 전송합니다.

사용자 속성 매핑

이벤트 데이터 객체의 키를 Amplitude로 전송하려는 사용자 속성에 매핑합니다. 사용자 속성 이름을 지정하지 않으면 Amplitude는 대신 이벤트 데이터 키를 사용합니다. 이 표에 포함된 이벤트 데이터 키만 Amplitude 요청과 함께 사용됩니다.

이름	설명
`Event Data Key`	필수입니다. `string`. Amplitude로 전송할 사용자 속성으로 포함하려는 이벤트 데이터 객체의 키입니다.
`Send As User Property`	선택 사항입니다. `string`. 사용자 속성 이름입니다. 이 이름은 Amplitude 대시보드에 표시되는 이름입니다. 비어 있으면 Amplitude는 대신 해당 값을 사용자 속성 키로 `Event Data Key`사용합니다.

사용자 속성 추가

이 표를 사용하여 Amplitude 서버로 전송된 히트에 새 이벤트 속성을 추가하십시오. 각 속성에는 키와 값이 필요합니다.

이름	설명
`User Property Key`	필수입니다. `string`. Amplitude로 전송할 사용자 속성으로 포함하려는 이벤트 데이터 객체의 키입니다.
`User Property Value`	필수입니다. `string`. 특정 사용자 속성 키의 값입니다.

추가 속성

이 기능을 사용하여 이벤트 속성을 추가할 수 있습니다. 전체 겹치는 경우에는 새 값이 이전 값을 대체합니다. 각 속성에는 키와 값이 필요합니다.

이름	설명
`Additional Property Key`	필수입니다. `string`. 이벤트 속성의 키입니다.
`Additional Property Value`	필수입니다. `string`. 속성 키의 속성 값입니다.

이벤트 추적과 함께 제공되는 기타 정보

이름	설명	기본값
`user_id`	사용자 ID입니다.	이벤트 객체 또는 `undefined`의 `user_id`또는 `x-ga-mp2-user_properties.user_id` 값입니다.
`device_id`	디바이스 ID입니다.	이벤트 객체에서 `client_id`의 값입니다.
`time`	현재 시간을 밀리초 단위로 나타내는 숫자입니다.	자세한 내용입니다.
`session_id`	세션 ID입니다.	이벤트 객체 + `000`에 있는 `ga_session_id`의 정수 값입니다.
`insert_id`	Amplitude 서버에 데이터 중복 제거 목적으로 삽입되는 ID입니다.	`device_id` + 이벤트 객체 내의 `eventName`+ `time`.
`library`	Amplitude에서 이벤트 소스를 식별하기 위한 라이브러리입니다.	`S-GTM`.

트리거 정의 - 트리거링

모든 태그는 이벤트를 기반으로 실행됩니다. Google 태그 관리자는 이벤트를 등록할 때마다 이벤트 트리거를 평가하고 이에 따라 태그를 실행합니다. 서버 태그의 트리거는 웹 컨테이너와 비교할 때 제한적입니다. GTM은 다음과 같은 트리거를 제공합니다.

사용자 지정 트리거: 서버 컨테이너 클라이언트가 수신 요청을 수락하고 이를 처리하며 해당 데이터를 다른 태그에 사용할 수 있도록 컨테이너에서 사용할 수 있게 하면 사용자 지정 트리거를 사용하여 태그를 실행할 수 있습니다. 태그를 모든 이벤트에 대해 실행할지 아니면 특정 이벤트에 대해 실행할지 선택할 수 있습니다.
페이지 뷰 트리거: 클라이언트가 수신 요청을 처리하고 page_view이벤트를 생성한 경우 트리거가 활성화됩니다. 이 이벤트는 서버 GTM의 미리보기 모드에서 볼 수 있어야 합니다.
사용자 지정 이벤트 트리거: 사용자 지정 이벤트 트리거는 페이지 보기 트리거와 동일한 방식으로 작동합니다. 유일한 차이점은 발생할 이벤트의 이름을 선택할 수 있다는 것입니다.

문제 해결

GTM 갤러리에서 Amplitude 애널리틱스를 찾을 수 없는 이유는 무엇입니까?

서버 컨테이너를 선택했는지 확인하십시오. 서버측 템플릿은 서버 컨테이너 갤러리에만 존재합니다.

이 내용이 도움이 되었나요?