# 트리거 및 태그 설정하기

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

## 구글 태그 매니저 트리거란?

구글 태그 매니저 트리거는 로워드 브릿지 강의 호스팅 플랫폼 내에서 특정한 이벤트가 발생하면 트리거 형식으로 태그 매니저 쪽으로 전달하게 됩니다.

예를 들어 결제하기 버튼을 통해 사용자가 결제를 완료했을 경우 결제완료 트리거가 동작하여, 이를 GA 및 채널톡으로 전달합니다.

채널톡이나 구글 애널리틱스는 해당 이벤트로 발생된 정보를 저장하여 마케팅 용도 혹은 통계 집계 용도로 확인이 가능합니다.

### 구글 태그 매니저 트리거 추가하는 방법

구글 태그 매니저의 트리거를 추가하기 위해서는 구글 태그 매니저 관리자 내 좌측 > 트리거 메뉴를 클릭하여 페이지를 접근해 주세요.

이후 아래 사진과 같이 '**새로 만들기**' 버튼을 클릭하여 트리거를 초기 구성할 수 있습니다.

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

트리거는 아래와 같이 4가지 요소를 설정할 수 있습니다.

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

<table><thead><tr><th width="234.22265625">트리거 설정 값</th><th>설명</th></tr></thead><tbody><tr><td>트리거 제목</td><td>(1번)</td></tr><tr><td>트리거 유형</td><td>(2번)</td></tr><tr><td>이벤트 이름</td><td>(3번) 해당 값은 가이드 대로 설정해야 합니다.</td></tr><tr><td>어디서 실행하는 이벤트인지</td><td>(4번)</td></tr></tbody></table>

입력 후 저장 버튼을 클릭하면 트리거가 생성됩니다.

### 구글 태그 매니저 사전 정의된 트리거 설정하기

대부분의 트리거 설정 값을 가이드대로 설정해야 로워드 팀의 설계 기준대로 사이트 셋업을 진행하실 수 있습니다.

<table><thead><tr><th width="211.9609375">(1번) 트리거 제목</th><th width="131.7578125">(2번) 트리거 유형</th><th>(3번) 이벤트 이름</th><th>(4번) 실행 위치</th></tr></thead><tbody><tr><td>write_review</td><td>맞춤 이벤트</td><td>write_review</td><td>모든 맞춤 이벤트</td></tr><tr><td>view_item_trigger</td><td>페이지뷰</td><td></td><td>page_url 포함 /class?lectureId=</td></tr><tr><td>sign_up_trigger</td><td>맞춤 이벤트</td><td>signup</td><td>모든 맞춤 이벤트</td></tr><tr><td>scroll_depth_100percent</td><td>스크롤 깊이</td><td>세로 스크롤 깊이<br>비율 100퍼센트</td><td>모든 페이지</td></tr><tr><td>scroll_depth_75percent</td><td>스크롤 깊이</td><td>세로 스크롤 깊이<br>비율 75퍼센트</td><td>모든 페이지</td></tr><tr><td>scroll_depth_50percent</td><td>스크롤 깊이</td><td>세로 스크롤 깊이<br>비율 50퍼센트</td><td>모든 페이지</td></tr><tr><td>scroll_depth_25percent</td><td>스크롤 깊이</td><td>세로 스크롤 깊이<br>비율 25퍼센트</td><td>모든 페이지</td></tr><tr><td>scroll_depth_10percent</td><td>스크롤 깊이</td><td>세로 스크롤 깊이<br>비율 10퍼센트</td><td>모든 페이지</td></tr><tr><td>purchase_trigger</td><td>맞춤 이벤트</td><td>purchase</td><td>모든 맞춤 이벤트</td></tr><tr><td>page_view_trigger</td><td>페이지뷰</td><td></td><td>page_url 포함 /myClass/vod<br>/myClass</td></tr><tr><td>page_view</td><td>맞춤 이벤트</td><td>page_view</td><td>모든 맞춤 이벤트</td></tr><tr><td>login_trigger</td><td>맞춤 이벤트</td><td>login</td><td>모든 맞춤 이벤트</td></tr><tr><td>lecture_id</td><td>맞춤 이벤트</td><td>lecture_id</td><td>모든 맞춤 이벤트</td></tr><tr><td>coupon_apply_trigger</td><td>맞춤 이벤트</td><td>listup_coupon</td><td>모든 맞춤 이벤트</td></tr><tr><td>begin_checkout_trigger</td><td>맞춤 이벤트</td><td>begin_checkout</td><td>모든 맞춤 이벤트</td></tr></tbody></table>

위 트리거를 모두 테이블 내용대로 설정한다면 트리거 설정은 완료 되었습니다.

## 구글 태그 매니저 태그란?

구글 태그 매니저 내의 태그란 특정한 행동이나 이벤트가 발생했을 때 태그를 실행시키는 신호입니다.\
로워드 브릿지 강의 호스팅 플랫폼에서는 사용자의 행동(이벤트)이 발생하면 이를 트리거 형태로 구글 태그 매니저에 전달하게 됩니다.

예를 들어 사용자가 로워드 브릿지 강의 호스팅 플랫폼에서 결제를 완료했을 경우

1. 로워드 브릿지 강의 호스팅에서 결제 완료 이벤트 발생
2. 이 이벤트가 구글 태그 매니저의 결제완료 트리거로 전달
3. 해당 트리거가 동작하면서 연결된 GA(구글 애널리틱스)와 채널톡 태그 실행
4. 구글 애널리틱스에는 전환 데이터가 저장되고 채널톡에는 사용자 행동 정보가 기록됩니다.

### 구글 태그 매니저 태그 추가하는 방법

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

구글 태그 매니저 관리자 콘솔에서 좌측 태그 메뉴를 클릭해서 태그 설정 화면으로 접속하신 뒤, '새로 만들기' 버튼을 클릭하여 태그를 생성할 수 있습니다.

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

위 사진과 같이 블록 형식의 빨간 영역을 클릭하게 되면 태그 구성 설정과 트리거 설정들을 할 수 있습니다.\
트리거 설정과 마찬가지로 태그별 이름은 좌 상단에 설정할 수 있습니다.

태그를 생성할때 태그 구성에서 로워드 브릿지 강의 호스팅에서 사용되는 주요 태그 유형은 주로 2가지를 사용합니다.

<table><thead><tr><th width="170.1875">태그 유형</th><th>설명</th></tr></thead><tbody><tr><td>Google 애널리틱스</td><td>태그 발생 시 구글 애널리틱스 매체로 데이터를 전송합니다.</td></tr><tr><td>Channel.io</td><td>태그 발생 시 채널톡으로 데이터를 전송합니다.</td></tr><tr><td>Google Ads(선택)</td><td>구글 광고로 직접 태그 전환을 넘길 경우에만 사용합니다.</td></tr></tbody></table>

{% hint style="info" %}
사전에 채널톡 연동이 되어 있지 않으면, 채널톡 태그 유형은 선택하실 수 없습니다.
{% endhint %}

구글 애널리틱스와 채널톡 둘 다 이벤트를 동시에 발생시키기에, 하나의 태그를 채널톡, Google 애널리틱스 용도로 2개씩 생성해야합니다.

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

구글 애널리틱스 태그 유형의 경우, 꼭 Google 애널리틱스: GA4 이벤트를 클릭해 주세요.

#### Google 애널리틱스: GA4 이벤트 태그 설정 방법

<figure><img src="/files/2i3pxmAwX13vubw69N6e" alt=""><figcaption></figcaption></figure>

구글 애널리틱스 이벤트로 태그 유형을 설정할 경우 측정 ID에 사전에 정의하였던 GA4\_ID 변수를 넣어줍니다.\
여기서 변수 값은 중괄호가 겹쳐진 형태로 변수를 감싸야합니다. \*사진 참고

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

### 설정해야할 태그 (구글 애널리틱스 태그 유형)

구글 애널리틱스에 설정할 태그에 대한 정리입니다. 각 요소에 맞게 꼭 설정해야 값이 정상적으로 전달됩니다.

<table data-full-width="false"><thead><tr><th width="188.57421875">태그명</th><th width="159.95703125">이벤트 이름</th><th width="296.91015625">이벤트 매개변수 : 값</th><th width="172.94140625">사용자 속성</th><th width="251.328125">트리거</th></tr></thead><tbody><tr><td>GA4_Begin_checkout</td><td>begin_checkout</td><td>lecture: {{item_id}}<br>lecture_name: {{item_name}}<br>quantity: {{quantity}}<br>price: {{price}}<br>currency: {{currency}}</td><td></td><td>begin_checkout_trigger</td></tr><tr><td>GA4_Coupon_listup</td><td>listup_coupon</td><td>code: {{coupon_code}}<br>type: {{type}}<br>status: {{status}}<br>value: {{value}}</td><td>user: {{user_id}}</td><td>coupon_apply_trigger</td></tr><tr><td>GA4_Login</td><td>login</td><td>method: {{method}}<br>status: {{status}}<br>class_ids: {{class_ids}}<br>grade: {{grade}}</td><td>user: {{user_id}}</td><td>login_trigger</td></tr><tr><td>GA4_PageView</td><td>pageview</td><td>refferer: {{Referrer}}<br>URL: {{Page URL}}<br>Path: {{Page Path}}<br>Title: {{page_title}}</td><td>user: {{user_id}}</td><td>All Pages</td></tr><tr><td>GA4_Purchase</td><td>purchase</td><td>transaction_id: {{transaction_id}}<br>value: {{value}}<br>currency: {{currency}}<br>coupon: {{coupon}}<br>coupon_name: {{coupon_name}}<br>mileage: {{mileage}}<br>items: {{items}}</td><td>user: {{user_id}}<br>email: {{email}}<br>phone: {{phone}}<br><br><strong>전자상거래 데이터 전송</strong><br><strong>Data Layer</strong></td><td>purchase_trigger</td></tr><tr><td>GA4_Review_write</td><td>write_review</td><td>lecture: {{item_id}}<br>rating: {{rating}}<br>review_contents: {{review_content}}</td><td>user: {{user_id}}</td><td>write_review</td></tr><tr><td>GA4_scroll_depth_100percent</td><td>scroll100</td><td></td><td><strong>태그 실행 옵션</strong><br>페이지 당 한 번</td><td>scroll_depth_100percent</td></tr><tr><td>GA4_scroll_depth_75percent</td><td>scroll75</td><td></td><td><strong>태그 실행 옵션</strong><br>페이지 당 한 번</td><td>scroll_depth_75percent</td></tr><tr><td>GA4_scroll_depth_50percent</td><td>scroll50</td><td></td><td><strong>태그 실행 옵션</strong><br>페이지 당 한 번</td><td>scroll_depth_50percent</td></tr><tr><td>GA4_scroll_depth_25percent</td><td>scroll25</td><td></td><td><strong>태그 실행 옵션</strong><br>페이지 당 한 번</td><td>scroll_depth_25percent</td></tr><tr><td>GA4_scroll_depth_10percent</td><td>scroll10</td><td></td><td><strong>태그 실행 옵션</strong><br>페이지 당 한 번</td><td>scroll_depth_10percent</td></tr><tr><td>GA4_Signup</td><td>signup</td><td>method: {{method}}<br>status: {{status}}<br>refferer: {{Referrer}}</td><td>user: {{user_id}}</td><td>sign_up_trigger</td></tr><tr><td>GA4_View_item</td><td>view_item</td><td>lecture: {{item_id}}<br>lecture_name: {{item_name}}<br>category: {{category}}<br>teacher: {{teacher}}<br>price: {{price}}<br>currency: {{currency}}</td><td></td><td>view_item_trigger</td></tr><tr><td>Google TAG</td><td>Google 태그<br>(Google 애널리틱스 이벤트 아님)</td><td>{{GA4_ID}}</td><td></td><td>Initialization - All Pages</td></tr><tr><td>GTAG Install</td><td>Google 태그<br>(Google 애널리틱스 이벤트 아님)</td><td>{{GTAG}}</td><td></td><td>Initialization - All Pages</td></tr></tbody></table>

### 설정해야할 태그 (Channel.io 태그 유형)

채널톡에 설정할 태그에 대한 정리입니다. 각 요소에 맞게 꼭 설정해야 값이 정상적으로 전달됩니다.\
Action(액션) 값은 무조건 Track (Send Event)로 설정해야합니다.

<table data-full-width="false"><thead><tr><th width="188.57421875">태그명</th><th width="159.18359375">이벤트 이름</th><th width="296.91015625">이벤트 매개변수 : 값</th><th width="251.328125">트리거</th></tr></thead><tbody><tr><td>CH_begin_checkout</td><td>begin_checkout</td><td>lecture: {{item_id}}<br>lecture_name: {{item_name}}<br>quantity: {{quantity}}<br>price: {{price}}<br>currency: {{currency}}</td><td>begin_checkout_trigger</td></tr><tr><td>CH_class_ids</td><td>class_ids</td><td>class_ids: {{class_ids}}</td><td>lecture_id</td></tr><tr><td>CH_coupon_listup</td><td>listup_coupon</td><td>code: {{coupon_code}}<br>type: {{type}}<br>status: {{status}}<br>value: {{value}}<br>user: {{user_id}}</td><td>coupon_apply_trigger</td></tr><tr><td>CH_login</td><td>login</td><td>method: {{method}}<br>status: {{status}}<br>user: {{user_id}}<br>class_ids: {{class_ids}}<br>grade: {{grade}}</td><td>login_trigger</td></tr><tr><td>CH_lecture_id</td><td>lectureId</td><td>class_ids: {{class_ids}}</td><td>lecture_id</td></tr><tr><td>CH_page_view</td><td>page_view</td><td>page_path: {{page_path}}<br>page_url: {{page_url}}</td><td>page_view<br>page_view_trigger</td></tr><tr><td>CH_Purchase</td><td>purchase</td><td>value: {{value}}<br>currency: {{currency}}<br>coupon: {{coupon}}<br>coupon_name: {{coupon_name}}<br>mileage: {{mileage}}<br>items: {{items}}</td><td>purchase_trigger</td></tr><tr><td>CH_review_write</td><td>write_review</td><td>lecture: {{item_id}}<br>rating: {{rating}}<br>review_contents: {{review_content}}<br>user: {{user_id}}</td><td>write_review</td></tr><tr><td>CH_scroll100</td><td>scroll100</td><td></td><td>scroll_depth_100percent</td></tr><tr><td>CH_scroll75</td><td>scroll75</td><td></td><td>scroll_depth_75percent</td></tr><tr><td>CH_scroll50</td><td>scroll50</td><td></td><td>scroll_depth_50percent</td></tr><tr><td>CH_scroll25</td><td>scroll25</td><td></td><td>scroll_depth_25percent</td></tr><tr><td>CH_scroll10</td><td>scroll10</td><td></td><td>scroll_depth_10percent</td></tr><tr><td>CH_signup</td><td>signup</td><td>method: {{method}}<br>status: {{status}}<br>refferer: {{Referrer}}<br>user: {{user_id}}</td><td>sign_up_trigger</td></tr><tr><td>CH_view_item</td><td>view_item</td><td>lecture: {{item_id}}<br>lecture_name: {{item_name}}<br>category: {{category}}<br>teacher: {{teacher}}<br>price: {{price}}<br>currency: {{currency}}</td><td>view_item_trigger</td></tr></tbody></table>

구글 애널리틱스 태그 설정과 크게 다른 부분은 없으나, 채널톡 유형은 사용자 정보를 이벤트 매개 변수에 포함시켜 보낸다는 특징이 있어, 사용자 특정이 필요할 경우 user: {{user\_id}}를 추가합니다.

## 변경사항 배포하기

템플릿, 변수, 트리거, 태그 설정이 완료 되었다면, 이제 실제 내 사이트에 배포할 시간입니다.\
배포는 우측 상단 제출하기를 클릭하면 아래와 같은 사진처럼 나타나게 됩니다.

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

버전 이름을 간단하게 1.0이라고 기재한 뒤,\
버전 설명에 어떤 항목을 추가했는지 기록용으로 작성하여 게시해 주세요.

{% hint style="info" %}
버전은 이후 추가, 수정이 잘못되었을때 기존에 제출한 배포로 되돌릴 수 있습니다.\
업데이트 기록을 촘촘히 하시는 것을 권장 드립니다.
{% endhint %}


---

# Agent Instructions: 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://docs.ledu.kr/gtm/trigger.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.