> ## 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 픽셀 설치하기

> 퍼널의 모든 페이지에 Whop 픽셀을 추가한 다음, 이벤트를 전송하여 광고가 리드와 판매에 대한 기여를 인정받도록 하세요.

Whop 픽셀은 웹사이트에 추가하는 JavaScript 스니펫입니다. 페이지 조회수를 측정하고, 방문자를 구매와 연결하며, 전환 이벤트의 기여도를 광고에 산정합니다. 설치가 완료되면 [Websites 페이지](https://whop.com/dashboard/websites)에서 웹사이트를 확인할 수 있습니다.

## Whop 픽셀 설치하기

## 1. Whop 계정 ID 확인하기

[Whop 대시보드](https://whop.com/dashboard/)에서 확인할 수 있습니다. URL에서 `dashboard/` 뒤에 오는 `biz_`로 시작하는 부분입니다. `biz_xxxxxxxxxxxxx`와 같은 형태입니다.

![브라우저 주소 표시줄의 Whop 대시보드 URL, dashboard 뒤의 계정 ID에 밑줄 표시](https://mintcdn.com/whop/i81Det37UaKELkrh/images/dashboard-url.png?fit=max\&auto=format\&n=i81Det37UaKELkrh\&q=85\&s=f8dce6ea378318d4c89f7bce9239605d)

## 2. 스니펫 설치하기

이 스니펫을 홈페이지뿐만 아니라 퍼널의 **모든 페이지**(랜딩 페이지, 광고형 기사, 결제 페이지, 감사 페이지)의 `<head>` 안에 붙여 넣으세요. `biz_xxxxxxxxxxxxx`를 자신의 계정 ID로 바꾸세요.

```html Pixel snippet theme={null}
<script>
!function(w,d,s,u,n,a,b){if(w[n])return;a=w[n]={q:[],t:+new Date,s:[],o:u,track:function(){a.q.push([+new Date].concat([].slice.call(arguments)))},setScope:function(){a.s=[].slice.call(arguments).filter(function(x){return typeof x==="string"});a.q.push([+new Date,"setScope"].concat(a.s))},scope:function(){var c=[].slice.call(arguments);return{track:function(){a.q.push([+new Date].concat([].slice.call(arguments)).concat([{__scope:c}]))}}}};b=d.createElement(s);b.async=1;b.src=u+"/s.js";d.getElementsByTagName(s)[0].parentNode.insertBefore(b,d.getElementsByTagName(s)[0])}(window,document,"script","https://t.whop.tw","whop");
whop.setScope("biz_xxxxxxxxxxxxx");
whop.track("page");
</script>
```

**둘 이상의 Whop 계정에서 광고를 운영하는 경우**, 모든 계정 ID를 `setScope`에 추가하세요. 픽셀은 나열된 모든 계정에 각 이벤트를 전송하므로, 각 대시보드는 캠페인에 전환 기여도를 산정하는 데 필요한 페이지 조회수를 받게 됩니다.

```javascript Send events to multiple accounts theme={null}
whop.setScope("biz_xxxxxxxxxxxxx", "biz_yyyyyyyyyyyyy", "biz_zzzzzzzzzzzzz");
```

Whop은 계정별로 데이터를 분리하여 보관합니다. `setScope`에 없는 계정은 이 페이지에서 이벤트를 받지 않습니다. [서버에서 이벤트를 전송](https://docs.whop.com/ko/developer/ads/events-api.md)하는 경우에도 각 이벤트를 해당 계정의 ID와 함께 계정마다 한 번씩 전송하세요.

원시 HTML 대신 플랫폼에서 퍼널을 구축하고 있나요? 페이지 빌더의 텍스트 블록에 스니펫을 붙여 넣는 대신 전용 설치 가이드를 따르세요.

| 사용 중인 플랫폼 | 따라야 할 가이드 |
| - | - |
| ClickFunnels | [ClickFunnels에 Whop 픽셀 설치하기](https://docs.whop.com/ko/developer/ads/platforms/clickfunnels.md) |
| GoHighLevel | [GoHighLevel에 Whop 픽셀 설치하기](https://docs.whop.com/ko/developer/ads/platforms/gohighlevel.md) |
| Kajabi | [Kajabi에 Whop 픽셀 설치하기](https://docs.whop.com/ko/developer/ads/platforms/kajabi.md) |
| WordPress | [WordPress에 Whop 픽셀 설치하기](https://docs.whop.com/ko/developer/ads/platforms/wordpress.md) |
| WooCommerce | [WooCommerce에 Whop 픽셀 설치하기](https://docs.whop.com/ko/developer/ads/platforms/woocommerce.md) |
| Shopify | [Shopify에 Whop 픽셀 설치하기](https://docs.whop.com/ko/developer/ads/platforms/shopify.md) |
| WebinarJam | [WebinarJam에 Whop 픽셀 설치하기](https://docs.whop.com/ko/developer/ads/platforms/webinarjam.md) |
| iClosed | [iClosed와 함께 Whop 픽셀 설치하기](https://docs.whop.com/ko/developer/ads/platforms/iclosed.md) |
| Calendly | [Calendly와 함께 Whop 픽셀 설치하기](https://docs.whop.com/ko/developer/ads/platforms/calendly.md) |

## 3. 이벤트 추적하기

리드 양식, 통화 예약, 신청서처럼 퍼널에 Whop 결제 외부의 중요한 단계가 있다면 `whop.track` 호출을 추가하여 해당 이벤트를 추적하세요.

```html Tracking events theme={null}
<script>
  whop.track("lead");                                      // a standard event
  whop.track("schedule", { value: 50, currency: "USD" });  // optionally with a value
  whop.track("quiz_completed");                            // or your own event name
</script>
```

호출을 어디에 넣을지는 동작 이후에 무슨 일이 일어나는지에 따라 다릅니다:

**a. 동작 후 리디렉션되는 경우** (방문자를 감사 페이지로 보내는 양식)

방문자가 도착하는 페이지에서 이벤트를 발생시키세요. 호출은 해당 페이지의 HTML 또는 페이지 빌더의 코드 필드에 들어가므로 `<script>` 태그로 감싸세요. 해당 페이지에도 픽셀 스니펫이 설치되어 있어야 합니다.

```html Track on a thank-you page theme={null}
<script>
  whop.track("lead");
</script>
```

**b. 동작 후 같은 페이지에 머무르는 경우** (인라인 성공 메시지를 표시하는 양식)

동작의 성공 핸들러에서 이벤트를 발생시키세요. 이미 JavaScript 안에 있으므로 `<script>` 태그가 필요 없습니다.

```javascript Track on submit (no redirect) theme={null}
form.addEventListener("submit", async (e) => {
  e.preventDefault();
  await submitForm();
  whop.track("lead");
});
```

**퍼널의 모든 단계에서 고객에 대해 가지고 있는 모든 정보를 포함하는 것이 중요합니다.** 이름, 이메일, 전화번호와 함께 리드를 받는다면 Whop에 전송하는 이벤트에 이를 포함하세요.

```html Lead with customer details theme={null}
<script>
  whop.track("lead", { name: "John Doe", email: "johndoe@example.com", phone: "555-555-1234" });
</script>
```

## 표준 이벤트

Whop 픽셀에는 퍼널의 일반적인 단계를 위한 표준 이벤트 이름 세트가 포함되어 있습니다. 각 이벤트는 선택적으로 `value`(숫자)와 `currency`(ISO 4217 코드)를 받습니다. 예외는 `purchase`로, 양수 `value`가 필수입니다.

| 이벤트 | 발생 시점 |
| - | - |
| `lead` | 방문자가 연락처 정보나 옵트인 양식을 제출할 때 |
| `schedule` | 방문자가 통화나 약속을 예약할 때 |
| `submit_application` | 방문자가 신청서를 제출할 때 |
| `contact` | 방문자가 대화나 연락 요청을 시작할 때 |
| `complete_registration` | 가입이나 등록이 완료될 때 |
| `view_content` | 방문자가 주요 페이지나 콘텐츠를 조회할 때 |
| `add_to_cart` | 방문자가 장바구니에 상품을 추가할 때 |
| `initiate_checkout` | 방문자가 결제 단계에 도달할 때 |
| `purchase` | [자체 결제](#track-sales-on-your-own-checkout)에서 판매가 완료될 때 — Whop 외부에서 발생하는 결제에만 해당합니다. Whop은 자체 결제를 자동으로 추적합니다 |

이벤트가 어떤 Whop 변형과 상품에 관한 것인지 알리려면 `variant_id`(`plan_` 접두사)와 `product_id`(`prod_` 접두사)를 전달하세요. 일반적으로 `view_content`와 `add_to_cart`에서 사용합니다([상품 및 장바구니 추적하기](https://docs.whop.com/ko/developer/websites/tracking.md#track-products-and-carts)에서 두 가지를 모두 수행하는 상품 페이지를 보여줍니다):

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

## 사용자 지정 이벤트

Whop의 표준 이벤트로 퍼널의 요구 사항을 충족할 수 없거나 고객 여정의 특정 단계를 추적하고 싶다면 사용자 지정 이벤트를 발생시킬 수 있습니다.

```html Custom event theme={null}
<script>
  whop.track("watched_vsl");
  whop.track("quiz_completed", { value: 25, currency: "USD" });
</script>
```

이름은 짧고 일관되게 유지하고, 소수의 이름을 재사용하세요. Whop은 최대 250자의 이름을 저장합니다.

사용자 지정 이벤트도 표준 이벤트와 동일한 배치 규칙을 따릅니다. [이벤트 추적하기](#track-events)를 참고하세요.

## 자체 결제에서 판매 추적하기

Whop 결제 대신 자체 결제를 통해 판매하는 경우, 판매가 완료되면 `purchase` 이벤트를 발생시키세요. `value`는 필수입니다. 광고 플랫폼은 금액이 없는 판매를 대상으로 최적화할 수 없기 때문에 Whop은 양수 값이 없는 구매 이벤트를 거부합니다. `currency`는 선택 사항이며 기본값은 USD입니다.

```html Purchase on your own checkout theme={null}
<script>
  whop.track("purchase", {
    value: 149.99,
    currency: "USD",
    event_id: "order_8412",
    email: "visitor@example.com",
  });
</script>
```

Whop은 이를 광고 플랫폼의 표준 Purchase 이벤트로 전달하므로, 구매에 최적화된 캠페인이 이를 학습합니다. Whop 보고서에서는 구매와 별도로 외부 구매로 표시됩니다. 구매 및 ROAS는 Whop이 처리한 결제만 집계합니다.

> [!WARNING]
>
> Whop이 처리한 판매에 대해서는 절대 `purchase`를 발생시키지 마세요. Whop이 이미 해당 판매를 광고 플랫폼에 보고하므로 중복으로 집계됩니다.

## 각 이벤트에 ID 부여하기

Whop에 두 번 이상 도달할 수 있는 이벤트에는 `event_id`를 전달하세요. 예를 들어, 감사 페이지에 도착할 때 이벤트를 발생시킨다면 해당 이벤트가 페이지 조회마다가 아니라 실제 전환마다 한 번씩 발생하도록 하세요. Whop은 각 `event_name`과 `event_id` 쌍을 한 번만 집계하므로, 재시도, 페이지 새로고침, 또는 두 곳에서 전송된 동일한 전환은 하나의 이벤트로 합쳐집니다.

```html Event with an ID theme={null}
<script>
  whop.track("lead", { event_id: "lead_8f21c0" }); // one visitor's form submission
  whop.track("lead", { event_id: "lead_2b94de" }); // a different visitor's
</script>
```

**ID는 이벤트 유형이 아니라 단일 이벤트 하나를 식별합니다.** 모든 리드에는 고유한 ID가 필요합니다. 모든 리드의 ID로 `"lead"`를 전송하면 Whop은 이를 모두 하나의 이벤트로 취급하므로, 수백 개의 리드가 하나로 표시됩니다.

자체 시스템에 이미 있는 해당 동작의 값(리드 ID, 주문 번호, 양식 제출 ID 등)을 사용하세요. 동일한 동작을 다시 전송할 때만 그 값을 재사용하세요. 재시도는 동일한 동작으로 간주됩니다. 서버에서 미러링된 동일한 전환도 마찬가지입니다. 발생 시점에 만든 값은 매번 새로워지므로 중복을 막지 못합니다.

동일한 전환이 웹사이트와 서버 양쪽에서 올 수 있다면, 양쪽에서 동일한 `event_id`를 전송하여 하나의 이벤트로 기록되도록 하세요.

## 고객 정보 첨부하기

가능한 한 많은 고객 정보를 항상 전송하세요. 이는 Whop이 이벤트를 고객과 매칭하고 전환 추적을 개선하는 데 도움이 됩니다.

이 필드들은 모든 이벤트 유형에 첨부할 수 있으며 선택 사항입니다. 가지고 있는 필드만 전송하세요.

```html Lead with customer fields theme={null}
<script>
  whop.track("lead", {
    email: "visitor@example.com",
    first_name: "Jane",
    last_name: "Doe",
    name: "Jane Doe",
    phone: "+15551234567",
    external_id: "customer_123",
    city: "New York",
    state: "NY",
    postal_code: "10001",
    country: "US",
  });
</script>
```

| 필드 | 설명 |
| - | - |
| `email` | 방문자의 이메일 주소 |
| `first_name` | 방문자의 이름 |
| `last_name` | 방문자의 성 |
| `name` | 방문자의 전체 표시 이름 |
| `phone` | 방문자의 전화번호 |
| `external_id` | 자체 사용자/고객 ID |
| `city` | 방문자의 도시 |
| `state` | 방문자의 주 또는 지역 |
| `postal_code` | 방문자의 우편번호 |
| `country` | 방문자의 국가 |

> [!WARNING]
>
> 이 값들은 일반 텍스트로 전송하세요. 해시된 이메일은 유효한 주소가 아니므로 삭제됩니다. 해시된 전화번호는 의미 없는 숫자로 저장되어 아무와도 매칭되지 않습니다.

> [!NOTE]
>
> **Whop 결제, 구독, 체험판은 추적하지 마세요.** Whop은 자체 결제에서 발생하는 모든 결제 페이지 조회, 구매, 구독, 체험판 시작을 별도 설정 없이 서버 측에서 기록합니다. 픽셀은 중복을 받아들이지 않습니다. Whop이 볼 수 없는 이벤트만 전송하세요: 자체 인프라에서 발생하는 리드와 예약, 그리고 [자체 결제에서의 판매](#track-sales-on-your-own-checkout).
