> For the complete documentation index, see [llms.txt](https://businessdaangn.gitbook.io/business.daangn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://businessdaangn.gitbook.io/business.daangn/ads-pro/tools/tracking/event.md).

# 이벤트 스크립트 설치 가이드

### 이벤트 스크립트 한눈에 보기

| 이벤트 이름    | 이벤트 라벨                 | 설명                            |
| --------- | ---------------------- | ----------------------------- |
| 로그인       | `Login`                | 사용자가 서비스 내 로그인을 완료한 경우        |
| 회원가입      | `CompleteRegistration` | 사용자가 서비스 내 회원가입을 완료한 경우       |
| 상세 페이지 조회 | `ViewContent`          | 사용자가 서비스 내 상세 페이지를 접속한 경우     |
| 장바구니 담기   | `AddToCart`            | 사용자가 서비스 내 제품을 장바구니에 담은 경우    |
| 구매        | `Purchase`             | 사용자가 제품을 구매한 경우               |
| 설치        | `Install`              | 사용자가 앱을 설치한 경우                |
| 잠재고객 수집   | `Lead`                 | 사용자가 특정 서비스를 신청하기 전에 발생하는 이벤트 |
| 서비스 신청    | `SubmitApplication`    | 사용자가 특정 서비스를 신청 완료한 경우        |

***

### 로그인

사용자가 로그인을 완료한 경우 발생하는 이벤트예요. 로그인 완료 페이지에 삽입하는 것을 권장해요.

```html
<!-- Danggeun Market Code -->
<script>
  window.karrotPixel.track('Login');
</script>
<!-- End Danggeun Market Code -->
```

***

### 회원가입

사용자가 회원가입을 완료한 경우 발생하는 이벤트예요. 회원가입 완료 페이지에 삽입하는 것을 권장해요.

```html
<!-- Danggeun Market Code -->
<script>
  window.karrotPixel.track('CompleteRegistration');
</script>
<!-- End Danggeun Market Code -->
```

***

### 상세 페이지 조회

사용자가 상세 페이지를 조회한 경우 발생하는 이벤트예요. 상세 페이지에 삽입하는 것을 권장해요.

**기본 스크립트**

```html
<!-- Danggeun Market Code -->
<script>
  window.karrotPixel.track('ViewContent');
</script>
<!-- End Danggeun Market Code -->
```

**파라미터 포함 스크립트 (상품 판매 늘리기 캠페인 권장)**

상품 판매 늘리기 캠페인을 집행하는 경우, 상품 ID 파라미터를 함께 전달하는 것을 권장해요.

| 파라미터 | 필수/선택   | 데이터 타입 | 설명              |
| ---- | ------- | ------ | --------------- |
| id   | 선택 (권장) | 문자     | 상품 또는 콘텐츠의 ID 값 |

```html
<!-- Danggeun Market Code -->
<script>
  window.karrotPixel.track(
    'ViewContent',
    {
      'id': '{상품ID}'
    }
  )
</script>
<!-- End Danggeun Market Code -->
```

> 중괄호(`{}`)에 포함된 내용을 서비스 내 실제 데이터 값으로 변경해 사용해 주세요.

***

### 장바구니 담기

사용자가 상품을 장바구니에 담은 경우 발생하는 이벤트예요. 장바구니 담기 버튼 클릭 시 동적으로 스크립트가 작동하는 형태로 삽입하는 것을 권장해요.

**기본 스크립트**

```html
<!-- Danggeun Market Code -->
<script>
  window.karrotPixel.track('AddToCart');
</script>
<!-- End Danggeun Market Code -->
```

**파라미터 포함 스크립트 (상품 판매 늘리기 캠페인 권장)**

| 파라미터                | 필수/선택 | 데이터 타입 | 단일/복수 | 설명       |
| ------------------- | ----- | ------ | ----- | -------- |
| (products) id       | 선택    | 문자     | 단일/복수 | 상품의 ID 값 |
| (products) name     | 선택    | 문자     | 단일/복수 | 상품명      |
| (products) quantity | 선택    | 문자     | 단일/복수 | 상품 수량    |
| (products) price    | 선택    | 숫자     | 단일/복수 | 상품 가격    |

```html
<!-- Danggeun Market Code -->
<script>
  window.karrotPixel.track(
    'AddToCart',
    {
      'products': [{
        'id': '{상품ID}',
        'name': '{상품명}',
        'quantity': '{상품수}',
        'price': '{상품가격}',
      }]
    }
  )
</script>
<!-- End Danggeun Market Code -->
```

> 중괄호(`{}`)에 포함된 내용을 서비스 내 실제 데이터 값으로 변경해 사용해 주세요.

***

### 구매

사용자가 상품을 구매한 경우 발생하는 이벤트예요. 구매 완료 페이지에 삽입하는 것을 권장해요.

**기본 스크립트**

```html
<!-- Danggeun Market Code -->
<script>
  window.karrotPixel.track('Purchase');
</script>
<!-- End Danggeun Market Code -->
```

**파라미터 포함 스크립트 (상품 판매 늘리기 캠페인 권장)**

구매 금액·수량 등을 함께 전달하면 당근 대시보드에서 ROAS 성과를 확인할 수 있어요.

| 파라미터                | 필수/선택   | 데이터 타입 | 단일/복수 | 설명           |
| ------------------- | ------- | ------ | ----- | ------------ |
| total\_price        | 선택 (권장) | 문자     | 단일    | 구매한 총 가격     |
| total\_quantity     | 선택      | 문자     | 단일    | 구매한 총 수량     |
| (products) id       | 선택      | 문자     | 단일/복수 | 구매한 상품의 ID 값 |
| (products) name     | 선택      | 문자     | 단일/복수 | 구매한 상품명      |
| (products) quantity | 선택      | 문자     | 단일/복수 | 구매한 상품 수량    |
| (products) price    | 선택      | 문자     | 단일/복수 | 구매한 상품 가격    |

```html
<!-- Danggeun Market Code -->
<script>
  window.karrotPixel.track(
    'Purchase',
    {
      'total_price': '{구매금액}',
      'total_quantity': '{구매수량}',
      'products': [{
        'id': '{상품ID}',
        'name': '{상품명}',
        'quantity': '{상품수}',
        'price': '{상품가격}',
      }]
    }
  )
</script>
<!-- End Danggeun Market Code -->
```

> 중괄호(`{}`)에 포함된 내용을 서비스 내 실제 데이터 값으로 변경해 사용해 주세요.

***

### 설치

사용자가 앱 설치를 완료한 경우 발생하는 이벤트예요. 설치 이벤트는 웹서비스에서 발생하기 어려운 이벤트예요. 앱 서비스를 운영하는 경우에 사용하는 것을 권장해요.

```html
<!-- Danggeun Market Code -->
<script>
  window.karrotPixel.track('Install');
</script>
<!-- End Danggeun Market Code -->
```

***

### 잠재고객 수집

사용자가 특정 서비스를 신청하기 전 발생하는 이벤트예요. 잠재고객으로 정의된 이벤트에 동적 스크립트가 작동하는 형태로 삽입하는 것을 권장해요.

이벤트 예시: 상담 신청, 체험 신청, 이벤트 신청

```html
<!-- Danggeun Market Code -->
<script>
  window.karrotPixel.track('Lead');
</script>
<!-- End Danggeun Market Code -->
```

***

### 서비스 신청

사용자가 특정 서비스를 신청 완료한 경우 발생하는 이벤트예요. 서비스 신청 이벤트에 동적 스크립트가 작동하는 형태로 삽입하는 것을 권장해요.

이벤트 예시: 구독 신청 완료, 대출 신청 완료, 계좌 개설 완료

```html
<!-- Danggeun Market Code -->
<script>
  window.karrotPixel.track('SubmitApplication');
</script>
<!-- End Danggeun Market Code -->
```