> For the complete documentation index, see [llms.txt](https://help.sixshop.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.sixshop.com/learn-sixshop/store-manager/add-ons/google_tagmanager/ga4.md).

# 구글 태그 매니저 구글 애널리틱스 연동하기  - GA4 버전

## 1. 구글 태그 매니저에 구글 애널리틱스 연동하기

[\[애드온 > 구글 태그 매니저\]](https://www.sixshop.com/dashboard/add-ons-googleTagManager)와 [\[애드온 > 구글 애널리틱스\]](https://www.sixshop.com/dashboard/add-ons-googleAnalytics)는 함께 사용할 수 없습니다. \
구글 태그 매니저와 구글 애널리틱스를 동시에 사용하시려면 [\[애드온 > 구글 태그 매니저\]](https://www.sixshop.com/dashboard/add-ons-googleTagManager)만 설치하신 후 구글 태그 매니저에 구글 애널리틱스를 연동해야 합니다.

## 2. 변수 만들기 

구글 태그 매니저에 구글 애널리틱스 GA4 버전을 연동하기 위해서는 총 5개의 변수를 만들어야 합니다.

5개 변수 중 하나인 ecommerce.items 등록 방법 예시를 참고하여 5개 변수를 모두 만들어 주세요.   \
등록 방법 예시 중 변수명만 변경하여 만들어 주시면 됩니다.

| **변수명**                            | **내용**   |
| ---------------------------------- | -------- |
| ecommerce.items                    | 상품 정보    |
| ecommerce.purchase.currency        | 결제 통화    |
| ecommerce.purchase.items           | 주문 상품 정보 |
| ecommerce.purchase.transaction\_id | 주문 번호    |
| ecommerce.purchase.value           | 결제 금액    |

**Step 1**. [구글 태그 관리자](https://tagmanager.google.com/) 접속 후 \[변수 > 새로 만들기] 버튼을 눌러주세요.  

<figure><img src="/files/WKYBZlMPvfAs5VLnw9TP" alt=""><figcaption></figcaption></figure>

**Step 2**. 변수명 ecommerce.items를 입력하고 변수 유형 아이콘을 선택해 주세요.

<figure><img src="/files/KZh0FBhApPaklgdSzGZP" alt=""><figcaption></figcaption></figure>

**Step 3**. 변수 유형에서 \[데이터 영역 변수]를 선택해 주세요.

<figure><img src="/files/olxecEJSDY8LLk0UDAWm" alt=""><figcaption></figcaption></figure>

**Step 4**. 데이터 영역 변수 이름에  ecommerce.items(변수명)를 입력 후 \[저장] 버튼을 누르면 변수가 만들어집니다.&#x20;

<figure><img src="/files/h2u24ZLCk1xoVnUWKr3d" alt=""><figcaption></figcaption></figure>

**\[ ecommerce.items 변수가 만들어진 화면 ]**

<figure><img src="/files/LiGJrfpEsWS9FMbIjshN" alt=""><figcaption></figcaption></figure>

**Step 5**. Step1 \~ Stetp4 과정을 반복하여 변수 4개를 모두 만들어주세요. &#x20;

<figure><img src="/files/NHMtVh0loZ5S4bjuOpQZ" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/T06ubxx7yzwxItqP4Myx" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/533O9XlwEQpyX7UcIer0" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/pRRQKdk4q0VqPB1Brvtb" alt=""><figcaption></figcaption></figure>

**\[ 5개 변수를 모두 만들었을 때 화면 ]**

<figure><img src="/files/boIeuS6vYmFFVGPp2MkC" alt=""><figcaption></figcaption></figure>

## 3. 트리거 만들기&#x20;

구글 태그 매니저에 구글 애널리틱스 GA4 버전을 연동하기 위해서는 총 3개의 트리거를 만들어야 합니다.

3개 트리거 중 하나인 add\_to\_cart 등록 방법 예시를 참고하여 3개 트리거를 모두 만들어 주세요. \
등록 방법 예시 중 트리거명만 변경하며 만들어 주시면 됩니다.

| **태그 이름**     | **실행 트리거**  |
| ------------- | ----------- |
| add\_to\_cart | 장바구니 담기 이벤트 |
| purchase      | 결제 이벤트      |
| view\_item    | 상품 페이지 조회   |

**Step 1**. [구글 태그 관리자](https://tagmanager.google.com/)에서 \[트리거 > 새로 만들기] 버튼을 눌러주세요.

<figure><img src="/files/0VaVUbY6751SRBcT0PEu" alt=""><figcaption></figcaption></figure>

**Step 2**. 트리거명 add\_to\_cart를 입력하고 트리거 유형 아이콘을 선택해 주세요.

<figure><img src="/files/9PVyZfqmAIGZEVcoMvR1" alt=""><figcaption></figcaption></figure>

**Step 3**. 트리거 유형에서 \[맞춤 이벤트]를 선택해 주세요.

<figure><img src="/files/44DFNtJAoVLxqpMOfUwv" alt=""><figcaption></figcaption></figure>

**Step 4**. 이벤트 이름에 add\_to\_cart(트리거명)를 입력하고 \[일부 맞춤 이벤트] 선택 후 트리거 실행 방법으로 \[Event / 같음 / add\_to\_cart(트리거명)]을 입력한 뒤 \[저장] 버튼을 눌러주세요.&#x20;

<figure><img src="/files/wNCXlT6evEPun8PjicBJ" alt=""><figcaption></figcaption></figure>

**\[ add\_to\_cart 트리거가 만들어진 화면 ]**

<figure><img src="/files/0S2Jtu6gVdz0q828NdcG" alt=""><figcaption></figcaption></figure>

* purchase, view\_item 트리거 구성 등록 화면

<figure><img src="/files/3B1aM7I7w8K71MxiycSe" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/tJxoui15LYmza6ZWxkrC" alt=""><figcaption></figcaption></figure>

**Step 5**. Step 1 \~ Stetp 4 과정을 반복하여 트리거 3개를 모두 만들어주세요. &#x20;

**\[ 3개 트리거를 모두 만들었을 때 화면 ]**

<figure><img src="/files/ZcGJHXabKNDWOhPjsM0S" alt=""><figcaption></figcaption></figure>

## **4. 태그 만들기** &#x20;

구글 태그 매니저에 구글 애널리틱스 GA4 버전을 연동하기 위해서는 총 **4**개의 태그를 만들어야 합니다.

| **태그 이름**               | **실행 트리거**    |
| ----------------------- | ------------- |
| GA4 구성                  | All pages     |
| GA4 이벤트 - add\_to\_cart | add\_to\_cart |
| GA4 이벤트 - view\_item    | view\_item    |
| GA4 이벤트 - purchase      | purchase      |

### 4-1. GA4 구성 태그 만들기&#x20;

**Step 1**. [구글 태그 관리자](https://tagmanager.google.com/)에서 \[태그 > 새로 만들기] 버튼을 눌러주세요. &#x20;

<figure><img src="/files/0d4SVpDi4f3cqMidPAcB" alt=""><figcaption></figcaption></figure>

**Step 2**. 태그명 GA4 구성을 입력하고 태그 유형 아이콘을 선택해 주세요.

<figure><img src="/files/WpFYFU1dY85xkoSs6N4q" alt=""><figcaption></figcaption></figure>

**Step 3**. 태그 유형에서 \[Google 태그]를 선택해 주세요.

<figure><img src="/files/BidLgR64SrtoECTazK5z" alt=""><figcaption></figcaption></figure>

**Step 4**. 변수명을 입력하고 추적 ID를 입력해 주세요.\
&#x20;             추적 ID는 G-\*\*\*\*\*\*\*\*\*\* 형태로 구성된 구글 애널리틱스 추적 ID입니다.\
&#x20;             \[구글 애널리틱스 > 관리 > 데이터 스트림  > 생성한 웹 스트림]에서 확인 가능합니다.

<figure><img src="/files/kFMdrHOXcRjChch5leQr" alt=""><figcaption></figcaption></figure>

**Step 5**. 트리거 선택 아이콘을 선택해 주세요.

<figure><img src="/files/dp86X575MvBd5AgmzFMC" alt=""><figcaption></figcaption></figure>

**Step 6**. 트리거 All pages를 선택해 주세요.&#x20;

<figure><img src="/files/ZpdC2BMKhVHUZP8BALsX" alt=""><figcaption></figcaption></figure>

**Step 7**. 태그 설정을 마친 후 \[저장] 버튼을 눌러주세요.&#x20;

<figure><img src="/files/dgpt0UuZvhKB5g6WO4xz" alt=""><figcaption></figcaption></figure>

**\[ GA4 구성 태그가 만들어진 화면 ]**

<figure><img src="/files/z9UnkqC2tLjWEiqOMS9c" alt=""><figcaption></figcaption></figure>

### **4-2. GA4 이벤트 - add\_to\_cart 태그 만들기** &#x20;

**Step 1**. [구글 태그 관리자](https://tagmanager.google.com/)에서 \[태그 > 새로 만들기] 버튼을 눌러주세요. &#x20;

<figure><img src="/files/QwLGymFQC0e1sqGAy4Wi" alt=""><figcaption></figcaption></figure>

**Step 2**. 태그명 GA4 이벤트 - add\_to\_cart를 입력하고 태그 유형 아이콘을 선택해 주세요.

<figure><img src="/files/lAoKGgGNYyx9Mc6oXb04" alt=""><figcaption></figcaption></figure>

**Step 3**. 태그 유형에서 \[Google 애널리틱스: GA4 이벤트]를 선택해 주세요.

<figure><img src="/files/REDdVsWhUc5W1ivQ8i6o" alt=""><figcaption></figcaption></figure>

**Step 4.** 구성 태그 항목에 \[GA4 구성] 선택, 이벤트 이름에 add\_to\_cart를 입력한 뒤 행 추가 버튼을 눌러주세요.

<figure><img src="/files/hnqG2Tjcm8BM7P9mqMiE" alt=""><figcaption></figcaption></figure>

**Step 5**. 매개변수 이름 items 입력 후 값에 추가 아이콘을 눌러주세요.

<figure><img src="/files/RkSpgohWA6GJjukfP8zU" alt=""><figcaption></figcaption></figure>

**Step 6**. 변수 ecommerce.items를 선택해 주세요.

<figure><img src="/files/YNmGnOHHXBgx79ogsUX8" alt=""><figcaption></figcaption></figure>

**Step 7**. 트리거 선택 아이콘을 선택해 주세요.&#x20;

<figure><img src="/files/EF5GK9BmqDQDO0VNnQo9" alt=""><figcaption></figcaption></figure>

**Step 8**. 트리거 add\_to\_cart를 선택해 주세요.&#x20;

<figure><img src="/files/tBVUvcHwkSOzeignJlrz" alt=""><figcaption></figcaption></figure>

**Step 9.** 태그 설정을 마친 후 \[저장] 버튼을 눌러주세요. &#x20;

<figure><img src="/files/37T37JtoqXmqcd3m0N1A" alt=""><figcaption></figcaption></figure>

**\[ GA4 이벤트 - add\_to\_cart 태그가 만들어진 화면 ]**

<figure><img src="/files/ouiXzlqgBepTn2lkJ5rC" alt=""><figcaption></figcaption></figure>

### **4-3. GA4 이벤트 - view\_item 태그 만들기** &#x20;

&#x20;**Step 1**. [구글 태그 관리자](https://tagmanager.google.com/)에서 \[태그 > 새로 만들기] 버튼을 눌러주세요. &#x20;

<figure><img src="/files/pARVNm4zM7sqzDueno4r" alt=""><figcaption></figcaption></figure>

**Step 2**. 4-2 Step 2 \~ Step 5 과정과 아래 내용 그리고 이미지를 참고하여 항목을 설정하고 값에 추가 아이콘을 눌러주세요.

* 태그명: GA4 이벤트 - view\_item
* 태그 유형: \[Google 애널리틱스: GA4 이벤트]
* 구성 태그: GA4 구성
* 이벤트 이름: view\_item
* 매개변수 이름: items

<figure><img src="/files/1KQOy6ec119g0fgGxxVZ" alt=""><figcaption></figcaption></figure>

**Step 3**. 변수 ecommerce.items를 선택해 주세요.

<figure><img src="/files/a8vtHNL9wC79TxTEBdNL" alt=""><figcaption></figcaption></figure>

**Step 4**. 트리거 선택 아이콘을 선택해 주세요.&#x20;

<figure><img src="/files/csyHHAzXJlwLrx8YA9X4" alt=""><figcaption></figcaption></figure>

**Step 5**. 트리거 view\_item를 선택해 주세요.&#x20;

<figure><img src="/files/q3TaOzBzERkNQNpUL8to" alt=""><figcaption></figcaption></figure>

**Step 6.** 태그 설정을 마친 후 \[저장] 버튼을 눌러주세요. &#x20;

<figure><img src="/files/BCW0pjlYiccc9vkvvyoO" alt=""><figcaption></figcaption></figure>

### **4-4. GA4 이벤트 - purchase 태그 만들기** &#x20;

&#x20;**Step 1**. [구글 태그 관리자](https://tagmanager.google.com/)에서 \[태그 > 새로 만들기] 버튼을 눌러주세요. &#x20;

<figure><img src="/files/9wO0p5WGBwGjYUQbEvl5" alt=""><figcaption></figcaption></figure>

**Step 2**. 4-2 Step 2 \~ Step 5 과정과 아래 내용 그리고 이미지를 참고하여 항목을 설정하고 값에 추가 아이콘을 눌러주세요.

* 태그명: GA4 이벤트 - purchase
* 태그 유형: \[Google 애널리틱스: GA4 이벤트]
* 구성 태그: GA4 구성&#x20;
* 이벤트 이름: purchase
* 매개변수 이름: currency / items / transaction\_id / value 총 4개 입력

<figure><img src="/files/njfMzG8rPMUwzpAxg3PJ" alt=""><figcaption></figcaption></figure>

**Step 3**. 매개변수 이름에 맞춰 변수를 선택해 주세요.

<figure><img src="/files/j0f49ok4svfuhQYwlonH" alt=""><figcaption></figcaption></figure>

* 매개변수 이름, 값 정상 등록 화면

<figure><img src="/files/LGGqXT8VAraS7OFedMXi" alt=""><figcaption></figcaption></figure>

**Step 4**. 트리거 선택 아이콘을 선택해 주세요.

<figure><img src="/files/xlqTwkd2LPn9JziwkuqE" alt=""><figcaption></figcaption></figure>

**Step 5**. 트리거 purchase를 선택해 주세요.&#x20;

<figure><img src="/files/Z3MTBxUhHp13R9QaJNLh" alt=""><figcaption></figcaption></figure>

**Step 6.** 태그 설정을 마친 후 \[저장] 버튼을 눌러주세요. &#x20;

<figure><img src="/files/El1gsE8olFntsGMPlPsx" alt=""><figcaption></figcaption></figure>

**Step 7.** 태그 4개를 모두 생성 후 \[제출] 버튼을 눌러주세요.&#x20;

<figure><img src="/files/rDEgXlxBLEDwJbcMHvit" alt=""><figcaption></figcaption></figure>

**Step 8**. 버전 이름, 버전 설명을 입력하고 \[게시] 버튼을 눌러주시면 됩니다.

<figure><img src="/files/C8GIchQQQ4wjHdqpntKW" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.sixshop.com/learn-sixshop/store-manager/add-ons/google_tagmanager/ga4.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.