> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 서드파티 분석

> Google Analytics 4, Google Tag Manager 및 Meta Pixel로 Dodo Payments 호스팅 페이지에서 페이지 조회수 및 전자상거래 이벤트를 추적하세요.

<Frame>
  <img src="https://mintcdn.com/dodopayments/OJISfHo1pPGtWHk9/images/analytics-cover.png?fit=max&auto=format&n=OJISfHo1pPGtWHk9&q=85&s=6f9b234fb9bb78755cd79b315e594826" alt="Analytics Integration" width="2866" height="1436" data-path="images/analytics-cover.png" />
</Frame>

스토어프런트에서 체크아웃을 거쳐 구매 완료까지 고객 여정을 추적하세요. Dodo Payments는 Google Analytics 4, Google Tag Manager, Meta Pixel과 통합되어 모든 호스팅 페이지에서 광범위한 분석을 제공합니다.

<Info>
  Analytics 추적은 대시보드에서 추적 ID를 추가하면 스토어프런트, 체크아웃 페이지 및 고객 포털에서 자동으로 활성화됩니다.
</Info>

<Warning>
  고객 브라우저의 광고 차단기가 일부 방문자에 대해 분석 추적이 작동하지 못하게 할 수 있습니다.
</Warning>

## 지원 플랫폼

<CardGroup cols={3}>
  <Card title="Google Analytics 4" icon="chart-simple">
    GA4로 페이지 조회수 및 전자상거래 추적
  </Card>

  <Card title="Google Tag Manager" icon="tags">
    마케팅 태그 추가 및 관리
  </Card>

  <Card title="Meta Pixel" icon="meta">
    Facebook 및 Instagram 광고 전환 추적
  </Card>
</CardGroup>

## 시작하기

<Steps>
  <Step title="Open Business Settings">
    Dodo Payments 대시보드에서 **설정**으로 이동한 다음 **Analytics** 섹션으로 스크롤하세요.
  </Step>

  <Step title="Enable Your Tracking Platform">
    사용하려는 분석 플랫폼을 켜고 추적 ID를 입력하세요:

    * **Google Analytics**: 측정 ID 입력 (형식: `G-XXXXXXXXXX`)
    * **Google Tag Manager**: 컨테이너 ID 입력 (형식: `GTM-XXXXXXX`)
    * **Meta Pixel**: 픽셀 ID 입력 (숫자, 10-20자리)
  </Step>

  <Step title="Save Your Settings">
    **저장**을 클릭하여 추적 구성 내용을 적용하세요.
  </Step>

  <Step title="Verify Tracking">
    스토어프런트를 방문하거나 테스트 체크아웃을 만들어 이벤트가 분석 대시보드에 기록되는지 확인하세요.
  </Step>
</Steps>

## Google Analytics 4

[Google Analytics 4](https://marketingplatform.google.com/about/analytics/)는 전자상거래 추적 기능을 갖춘 포괄적인 웹 분석을 제공합니다. Dodo Payments 통합을 통해 스토어 탐색부터 구매 완료까지 전체 고객 여정을 추적할 수 있습니다.

### Google Analytics 측정 ID 추가하기

1. Google Analytics에서 **관리자** → **데이터 스트림**으로 이동하여 웹 스트림 선택
2. **측정 ID** 복사 (`G-`로 시작)
3. Dodo Payments 대시보드에서 **설정** → **Analytics**로 이동
4. **Google Analytics**를 켜고 측정 ID 붙여넣기
5. **저장** 클릭

<Tip>
  Google Analytics 속성이 아직 없다면 [Google의 설정 안내](https://support.google.com/analytics/answer/9304153)를 따라 만드세요.
</Tip>

### Google Analytics에서 추적되는 이벤트

호스팅된 스토어프런트와 체크아웃 페이지에서 다음 이벤트를 추적합니다. 제품 정보, 거래 합계, 통화를 포함한 이벤트 데이터가 각 이벤트에 전송됩니다.

#### 스토어프런트 이벤트

| Event            | Description                 |
| ---------------- | --------------------------- |
| `view_item_list` | 제품과 함께 스토어프런트 페이지가 로드될 때 발생 |
| `select_item`    | 고객이 제품을 클릭하여 체크아웃을 시작할 때 발생 |

#### 체크아웃 이벤트

| Event               | Description                |
| ------------------- | -------------------------- |
| `view_item`         | 체크아웃 페이지가 로드될 때 발생         |
| `view_cart`         | 체크아웃이 로드될 때 및 옵션이 선택될 때 발생 |
| `apply_discount`\*  | 유효한 할인 코드가 성공적으로 적용될 때 발생  |
| `remove_discount`\* | 할인 코드가 제거될 때 발생            |
| `add_payment_info`  | 고객이 결제 양식을 제출할 때 발생        |
| `purchase`          | 결제가 성공적일 때 발생              |

<Note>
  `apply_discount` 및 `remove_discount`는 [표준 Google Analytics 전자상거래 이벤트](https://support.google.com/analytics/answer/9267735)에 포함되지 않은 맞춤 이벤트입니다.
</Note>

### 오버레이/인라인 체크아웃에서 GA4 사용하기

자사 웹사이트에 임베드된 오버레이 또는 인라인 체크아웃에서 Google Analytics 이벤트를 추적하려면 체크아웃이 임베드된 웹사이트에 Google Analytics 추적 코드를 설치해야 합니다.

설치하면 위에 나열된 모든 추적 이벤트가 별도 구성 없이 자동으로 Google Analytics 계정으로 전송됩니다.

## Google Tag Manager

[Google Tag Manager](https://marketingplatform.google.com/about/tag-manager/)는 코드를 수정하지 않고도 마케팅 및 분석 태그를 관리할 수 있게 해줍니다. GTM을 통해 배포된 태그는 모든 Dodo Payments 호스팅 페이지에서 실행됩니다.

### GTM 컨테이너 ID 추가하기

1. Google Tag Manager에서 **컨테이너 ID** 복사 (`GTM-`로 시작)
2. Dodo Payments 대시보드에서 **설정** → **Analytics**로 이동
3. **Google Tag Manager**를 켜고 컨테이너 ID 붙여넣기
4. **저장** 클릭

<Info>
  GTM을 사용할 때 Google Ads 전환과 같은 추가 추적은 GTM 컨테이너 내에서 직접 구성할 수 있습니다. Dodo Payments 통합은 최대 호환성을 위해 GTM 스크립트와 noscript 폴백을 모두 삽입합니다.
</Info>

### 오버레이/인라인 체크아웃에서 GTM 사용하기

웹사이트에 임베드된 오버레이 또는 인라인 체크아웃의 경우 자체 사이트에 GTM을 설치하세요. 체크아웃은 귀하의 GTM 구성을 상속받아 임베드된 프레임 내에서 이벤트를 실행합니다.

## Meta Pixel

[Meta Pixel](https://www.facebook.com/business/tools/meta-pixel/)은 고객 행동을 추적하여 Facebook 및 Instagram 광고 캠페인의 효과를 측정합니다. 광고 클릭부터 구매 완료까지 전환을 추적하세요.

### Meta Pixel ID 추가하기

1. [Meta 이벤트 관리자](https://www.facebook.com/events_manager2/)에서 픽셀을 생성하거나 선택
2. **픽셀 ID** 복사 (숫자, 일반적으로 15-16자리)
3. Dodo Payments 대시보드에서 **설정** → **Analytics**로 이동
4. **Meta Pixel**을 켜고 픽셀 ID 붙여넣기
5. **저장** 클릭

<Tip>
  아직 픽셀이 없다면 Meta의 [픽셀 설정 안내](https://www.facebook.com/business/help/952192354843755)를 따라 생성하세요.
</Tip>

### Meta Pixel에서 추적되는 이벤트

다음 이벤트는 [Meta 이벤트 관리자](https://www.facebook.com/events_manager2/)에 표시됩니다. 콘텐츠 ID, 값, 통화를 포함한 이벤트 데이터가 각 이벤트와 함께 전송됩니다.

<Note>
  Meta 이벤트 관리자에 이벤트가 즉시 나타나지 않을 수 있으며 몇 분 지연이 있을 수 있습니다.
</Note>

#### 스토어프런트 이벤트

| Event              | Description                 |
| ------------------ | --------------------------- |
| `PageView`         | 스토어프런트 페이지가 로드될 때 발생        |
| `ViewContent`      | 제품과 함께 스토어프런트가 로드될 때 발생     |
| `InitiateCheckout` | 고객이 제품을 클릭하여 체크아웃을 시작할 때 발생 |

#### 체크아웃 이벤트

| Event              | Description                |
| ------------------ | -------------------------- |
| `PageView`         | 체크아웃 페이지가 로드될 때 발생         |
| `AddToCart`        | 체크아웃이 로드될 때 및 옵션이 선택될 때 발생 |
| `ApplyDiscount`\*  | 유효한 할인 코드가 성공적으로 적용될 때 발생  |
| `RemoveDiscount`\* | 할인 코드가 제거될 때 발생            |
| `AddPaymentInfo`   | 고객이 결제 양식을 제출할 때 발생        |
| `Purchase`         | 결제가 성공적일 때 발생              |

<Note>
  `ApplyDiscount` 및 `RemoveDiscount`는 [Meta의 표준 이벤트](https://developers.facebook.com/docs/meta-pixel/reference#standard-events)에 포함되지 않은 맞춤 이벤트입니다.
</Note>

## 전체 이벤트 참조

이 테이블은 Google Analytics 4와 Meta Pixel 전반에서 추적되는 모든 이벤트를 보여줍니다:

| Trigger                      | GA4 Event          | Meta Pixel Event   | Location   |
| ---------------------------- | ------------------ | ------------------ | ---------- |
| Storefront page loads        | `view_item_list`   | `ViewContent`      | Storefront |
| Customer clicks product      | `select_item`      | `InitiateCheckout` | Storefront |
| Checkout page loads          | `view_item`        | `AddToCart`        | Checkout   |
| Cart viewed/variant selected | `view_cart`        | -                  | Checkout   |
| Discount code applied        | `apply_discount`   | `ApplyDiscount`    | Checkout   |
| Discount code removed        | `remove_discount`  | `RemoveDiscount`   | Checkout   |
| Payment form submitted       | `add_payment_info` | `AddPaymentInfo`   | Checkout   |
| Payment successful           | `purchase`         | `Purchase`         | Checkout   |

## 플랫폼 적용 범위

다양한 Dodo Payments 환경에서 분석 추적이 제공됩니다:

| Surface                     | Google Analytics 4 | Google Tag Manager | Meta Pixel |
| --------------------------- | ------------------ | ------------------ | ---------- |
| Storefront                  | 예                  | 예                  | 예          |
| Checkout (Hosted)           | 예                  | 예                  | 예          |
| Checkout (Overlay/Inline)\* | 예                  | 예                  | 예          |
| Customer Portal             | 예                  | 예                  | 아니요        |

<Info>
  \*오버레이 및 인라인 체크아웃의 경우 전체 어트리뷰션을 위해 자체 웹사이트에 추적 코드를 설치하세요. 임베드된 체크아웃에서 발생한 이벤트는 자동으로 추적됩니다.
</Info>

## 포함된 이벤트 데이터

각 추적 이벤트에는 고객 행동을 분석하는 데 도움이 되는 관련 전자상거래 데이터가 포함됩니다:

### 제품 데이터

* 제품 ID
* 제품명
* 가격
* 통화
* 수량

### 거래 데이터 (구매 이벤트)

* 거래/결제 ID
* 총 금액
* 세금 금액
* 통화
* 적용된 할인

### 고객 데이터

* 고객 ID (재방문 고객의 경우)
* 이메일 (적용 가능한 경우 개인정보 보호를 위해 해시 처리된 형태)

## 권장 사항

<AccordionGroup>
  <Accordion title="Test Your Integration">
    추적 ID를 추가한 후 스토어프런트를 방문하고 테스트 체크아웃을 완료하여 이벤트가 분석 대시보드에 나타나는지 확인하세요. Google Analytics 실시간 보고서 또는 Meta 이벤트 관리자의 테스트 이벤트 기능을 사용하세요.
  </Accordion>

  <Accordion title="Use UTM Parameters">
    마케팅 링크에 UTM 매개변수를 추가하여 어떤 캠페인이 전환을 유도하는지 추적하세요. Dodo Payments는 체크아웃 흐름 전반에 걸쳐 UTM 매개변수를 보존합니다.
  </Accordion>

  <Accordion title="Set Up Conversion Goals">
    Google Analytics에서 `purchase` 이벤트로 전환 이벤트를 생성하여 전환율을 추적하세요. Meta Ads Manager에서는 캠페인 최적화 목표로 `Purchase` 이벤트를 사용하세요.
  </Accordion>

  <Accordion title="Enable Enhanced E-commerce">
    Google Tag Manager를 사용하는 경우 세부적인 퍼널 분석과 제품 성과 지표를 위해 향상된 전자상거래 리포트를 설정하는 것을 고려하세요.
  </Accordion>
</AccordionGroup>

## 문제 해결

<AccordionGroup>
  <Accordion title="Events not appearing in Google Analytics">
    * 측정 ID가 정확한지 확인하세요 (형식: `G-XXXXXXXXXX`)
    * Google Analytics 실시간 보고서를 확인하세요 - 이벤트가 먼저 거기에 나타납니다
    * Dodo Payments 설정에서 토글이 활성화되어 있는지 확인하세요
    * 처리 지연이 있을 수 있으니 잠시 기다리세요
    * 광고 차단기를 배제하기 위해 시크릿 창에서 테스트하세요
  </Accordion>

  <Accordion title="Events not appearing in Meta Events Manager">
    * 픽셀 ID가 정확한지 확인하세요 (숫자, 10-20자리)
    * Meta Pixel Helper 브라우저 확장 프로그램으로 디버그하세요
    * 이벤트 관리자에서 테스트 이벤트 탭을 확인하세요
    * 이벤트가 나타나기까지 몇 분이 걸릴 수 있습니다
    * 테스트 중에 광고 차단기를 꺼두세요
  </Accordion>

  <Accordion title="GTM tags not firing">
    * 컨테이너 ID가 정확한지 확인하세요 (형식: `GTM-XXXXXXX`)
    * GTM 미리보기 모드를 사용하여 태그 실행을 디버그하세요
    * 트리거가 GTM 컨테이너에서 올바르게 구성되어 있는지 확인하세요
    * 컨테이너가 게시되었는지(초안이 아닌지) 확인하세요
  </Accordion>

  <Accordion title="Overlay/Inline checkout not tracking">
    * 먼저 자체 웹사이트에 추적 코드를 설치하세요
    * 체크아웃 오버레이가 열리기 전에 추적이 로드되는지 확인하세요
    * 브라우저 콘솔에서 JavaScript 오류를 확인하세요
    * GA4를 사용하는 경우 교차 도메인 추적이 구성되었는지 확인하세요
  </Accordion>

  <Accordion title="Purchase events showing wrong amounts">
    * 금액은 가장 작은 통화 단위(센트)로 전송됩니다
    * 분석 도구가 올바른 통화를 표시하도록 구성되었는지 확인하세요
    * 세금 포함/제외 여부를 확인하세요
  </Accordion>
</AccordionGroup>

## 관련 리소스

<CardGroup cols={2}>
  <Card title="Segment Integration" icon="chart-line" href="/integrations/segment">
    자세한 분석 및 CDP 통합을 위해 Segment로 결제 이벤트 전송
  </Card>

  <Card title="Dub Integration" icon="https://mintcdn.com/dodopayments/LYWHtNbGSpS1P01t/images/logos/dub.svg?fit=max&auto=format&n=LYWHtNbGSpS1P01t&q=85&s=c36ca87c0811f65b3d8a4a79e4a34242" href="/integrations/dub" width="64" height="64" data-path="images/logos/dub.svg">
    Dub으로 판매 전환 및 제휴사 귀속 추적
  </Card>

  <Card title="Customer.io Integration" icon="envelope" href="/integrations/customer-io">
    결제 이벤트를 기반으로 자동 이메일 캠페인 트리거
  </Card>

  <Card title="Webhooks" icon="webhook" href="/developer-resources/webhooks">
    웹훅 이벤트로 사용자 정의 분석 통합 구축
  </Card>
</CardGroup>