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

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# 방문자 추적하기

> whop.site의 사이트에는 페이지 조회와 체크아웃을 자동으로 추적하는 Whop 픽셀이 포함되어 있습니다. 리드, 예약, 사용자 지정 이벤트에는 whop.track 호출을 추가하세요.

Whop은 사이트가 제공하는 모든 HTML 페이지에 앱의 비즈니스로 범위가 지정된 픽셀을 주입하고 페이지 조회를 전송합니다. 붙여 넣을 스니펫도, 구성할 계정 ID도 없습니다.

| 자동으로 추적됨 | `whop.track` 호출을 추가해야 함 |
| - | - |
| 페이지 조회 | 리드 양식, 통화 예약, 신청서 |
| Whop 체크아웃 조회 | 퀴즈, VSL 시청 완료, 자체 페이지의 모든 것 |
| 구매, 구독, 체험 | Whop 결제 데이터로 볼 수 없는 단계 |

## 자체 이벤트 추적하기

`window.whop`은 앱 코드가 실행되기 전에 존재하므로 직접 호출하세요.

```javascript theme={null}
whop.track("lead");
whop.track("schedule", { value: 50, currency: "USD" });
whop.track("watched_vsl");
```

표준 이벤트 이름(`lead`, `schedule`, `submit_application`, `contact`, `complete_registration`, `view_content`, `add_to_cart`, `initiate_checkout`)은 각각 선택적으로 `value`와 `currency`를 받습니다. 다른 이름도 사용할 수 있으며, 보고서에 해당 이름으로 표시됩니다.

작업이 완료되는 곳에서 이벤트를 전송하세요. 페이지가 그대로 유지되면 성공 핸들러에서, 리디렉션되면 확인 페이지에서 전송합니다.

> [!TIP]
>
> 재시도, 새로고침, 또는 서버에서 동일한 전환을 미러링하는 경우처럼 두 번 도착할 수 있는 이벤트에는 `event_id`를 전달하세요. Whop은 각 이름과 ID 쌍을 한 번만 집계합니다. 해당 작업에 대해 시스템에 이미 있는 ID를 사용하고, `"lead"` 같은 상수는 절대 사용하지 마세요.

## 상품 및 장바구니 추적하기

추적 도구는 판매를 방문자가 본 상품과 연결합니다. 각 조회, 장바구니 추가, 체크아웃 시작이 어떤 Whop 상품과 변형에 대한 것인지 픽셀에 알려 주세요. Whop AI가 빌드한 스토어는 상품 및 체크아웃 페이지에서 이미 이 작업을 합니다. 직접 빌드하거나 CLI로 업로드한 사이트는 호출 세 개와 속성 네 개를 추가하면 됩니다.

상품 페이지에 변형이 표시될 때와 구매자가 다른 변형을 선택할 때 `view_content`를, 장바구니에 추가할 때 `add_to_cart`를, 체크아웃이 열릴 때 `initiate_checkout`을 전송하세요.

```javascript theme={null}
whop.track("view_content", {
  variant_id: "plan_xxxxxxxxxxxxx",
  product_id: "prod_xxxxxxxxxxxxx",
  value: 49,
  currency: "USD",
});
```

* `variant_id`는 `plan_` 접두사가 붙은 변형 ID이고, `product_id`는 `prod_` 접두사가 붙은 해당 상품의 ID입니다.
* `value`는 페이지에 표시된 가격으로 통화의 주 단위(49.00달러는 `49`)를 사용하며, `currency`는 ISO 4217 코드입니다. 페이지에 가격이 표시되지 않으면 둘 다 생략하세요.
* 여러 변형에 대한 체크아웃은 합계와 함께 `initiate_checkout`을 보내고, `variant_id`와 `product_id`는 생략합니다.

추적 스크립트가 언제든 읽을 수 있도록, 상품을 표시하는 요소에 화면에 표시된 변형의 같은 네 가지 값을 표시하세요.

```html theme={null}
<section
  data-whop-product-id="prod_xxxxxxxxxxxxx"
  data-whop-variant-id="plan_xxxxxxxxxxxxx"
  data-whop-price="49"
  data-whop-currency="USD"
>
```

구매자가 다른 변형을 선택하거나 표시된 가격이 바뀔 때마다 속성을 업데이트하세요. 구매에는 따로 할 일이 없습니다. Whop이 자체 결제 데이터로 기록합니다.

## 데이터가 표시되는 곳

도메인별 방문자, 페이지 조회, 귀속 수익을 보려면 [대시보드](https://whop.com/dashboard)에서 **Websites**를 열고, 전체 이벤트 내역을 보려면 [픽셀 대시보드](https://whop.com/dashboard)를 여세요. 첫 이벤트는 방문 후 약 1분 뒤에 표시됩니다.

> [!NOTE]
>
> 픽셀 스니펫을 직접 설치하는 것도 계속 지원됩니다. 플랫폼 픽셀은 기존 `window.whop`이 있는지 확인하고 있으면 아무 작업도 하지 않으므로 중복 집계되지 않습니다. 사이트에 자체 비즈니스 외의 범위가 필요할 때 이렇게 하세요.

`whop.site`가 아닌 자체 도메인의 사이트라면 스니펫을 직접 설치하세요. [Whop 픽셀 설치하기](https://docs.whop.com/ko/developer/ads/pixel.md)를 참고하세요.

## 다음 단계

> [card] [픽셀 레퍼런스](https://docs.whop.com/ko/developer/ads/pixel.md)
>
> 모든 이벤트 필드, 고객 매칭, 서버 측 전송.

> [card] [결제 받기](https://docs.whop.com/ko/developer/guides/accept-payments.md)
>
> 픽셀이 귀속할 전환을 만드세요.


## Related topics

- [CLI로 웹사이트 빌드하기](https://docs.whop.com/ko/developer/websites/quickstart.md)
- [블루프린트 비즈니스 배포하기](https://docs.whop.com/ko/developer/websites/blueprints.md)
- [Whop의 웹사이트 호스팅](https://docs.whop.com/ko/developer/websites/hosting.md)
