> ## 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 Pixel'i kurun

> Whop Pixel'i hunizin her sayfasına ekleyin, ardından reklamlarınızın potansiyel müşteriler ve satışlar için pay alması amacıyla olaylar gönderin.

Whop Pixel, web sitenize eklediğiniz bir JavaScript kod parçacığıdır. Sayfa görüntülemelerini ölçer, ziyaretçileri satın alımlarıyla ilişkilendirir ve dönüşüm olaylarını reklamlarınıza atfeder. Kurulduktan sonra web sitenizi [Websites sayfasında](https://whop.com/dashboard/websites) görürsünüz.

## Whop Pixel'i kurun

## 1. Whop Hesap Kimliğinizi alın

Bunu [Whop Kontrol Panelinizden](https://whop.com/dashboard/) bulabilirsiniz: URL'nin `dashboard/` sonrasındaki, `biz_` ile başlayan kısmı. `biz_xxxxxxxxxxxxx` gibi görünür.

![Tarayıcı adres çubuğunda Whop kontrol paneli URL'si; dashboard sonrasındaki hesap kimliğinin altı çizili](https://mintcdn.com/whop/i81Det37UaKELkrh/images/dashboard-url.png?fit=max\&auto=format\&n=i81Det37UaKELkrh\&q=85\&s=f8dce6ea378318d4c89f7bce9239605d)

## 2. Kod parçacığını kurun

Bu kod parçacığını yalnızca ana sayfanıza değil, hunizdeki **her sayfanın** `<head>` bölümüne yapıştırın: açılış sayfaları, advertorial'lar, ödeme sayfaları ve teşekkür sayfaları. `biz_xxxxxxxxxxxxx` değerini kendi hesap kimliğinizle değiştirin.

```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>
```

**Birden fazla Whop hesabından reklam yayınlıyorsanız**, her hesap kimliğini `setScope` içine ekleyin. Piksel her olayı listelenen tüm hesaplara gönderir; böylece her kontrol paneli, dönüşümleri kendi kampanyalarına atfetmek için ihtiyaç duyduğu sayfa görüntülemelerini alır.

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

Whop verileri hesap başına ayrı tutar. `setScope` içinde bulunmayan bir hesap bu sayfadan hiçbir olay almaz. Ayrıca [sunucunuzdan olay gönderiyorsanız](https://docs.whop.com/tr/developer/ads/events-api.md), her olayı hesap başına bir kez, o hesabın kimliğiyle gönderin.

Hunizi ham HTML yerine bir platform üzerinde mi oluşturuyorsunuz? Kod parçacığını bir sayfa oluşturucunun metin bloğuna yapıştırmak yerine ilgili kurulum kılavuzunu kullanın.

| Kullandığınız platform | İzlenecek kılavuz |
| - | - |
| ClickFunnels | [Whop Pixel'i ClickFunnels'a kurun](https://docs.whop.com/tr/developer/ads/platforms/clickfunnels.md) |
| GoHighLevel | [Whop Pixel'i GoHighLevel'a kurun](https://docs.whop.com/tr/developer/ads/platforms/gohighlevel.md) |
| Kajabi | [Whop Pixel'i Kajabi'ye kurun](https://docs.whop.com/tr/developer/ads/platforms/kajabi.md) |
| WordPress | [Whop Pixel'i WordPress'e kurun](https://docs.whop.com/tr/developer/ads/platforms/wordpress.md) |
| WooCommerce | [Whop Pixel'i WooCommerce'e kurun](https://docs.whop.com/tr/developer/ads/platforms/woocommerce.md) |
| Shopify | [Whop Pixel'i Shopify'a kurun](https://docs.whop.com/tr/developer/ads/platforms/shopify.md) |
| WebinarJam | [Whop Pixel'i WebinarJam'e kurun](https://docs.whop.com/tr/developer/ads/platforms/webinarjam.md) |
| iClosed | [Whop Pixel'i iClosed ile kurun](https://docs.whop.com/tr/developer/ads/platforms/iclosed.md) |
| Calendly | [Whop Pixel'i Calendly ile kurun](https://docs.whop.com/tr/developer/ads/platforms/calendly.md) |

## 3. Olayları izleyin

Hunizde Whop ödeme sayfası dışında bir potansiyel müşteri formu, görüşme rezervasyonu veya başvuru gibi önemli adımlar varsa, bu olayları izlemek için `whop.track` çağrıları ekleyin.

```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ğrının nereye konulacağı, eylemden sonra ne olduğuna bağlıdır:

**a. Eylem yönlendirme yapıyor** (ziyaretçiyi bir teşekkür sayfasına gönderen bir form)

Olayı ziyaretçinin ulaştığı sayfada tetikleyin. Çağrı o sayfanın HTML'ine (veya bir sayfa oluşturucunun kod alanına) yerleştirilir, bu yüzden onu `<script>` etiketleriyle sarın. Piksel kod parçacığı o sayfada da kurulu olmalıdır.

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

**b. Eylem aynı sayfada kalıyor** (satır içi bir başarı mesajı gösteren bir form)

Olayı eylemin başarı işleyicisinde tetikleyin. Zaten JavaScript içindesiniz, bu nedenle `<script>` etiketlerine gerek yoktur.

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

**Hunizin her aşamasında müşteri hakkında sahip olduğunuz tüm bilgileri eklemeniz önemlidir.** Ad, e-posta ve telefon numarasıyla bir potansiyel müşteri kabul ediyorsanız, bunları Whop'a gönderilen olaya ekleyin.

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

## Standart olaylar

Whop Pixel, bir hunizin yaygın aşamaları için bir dizi standart olay adı içerir. Her biri isteğe bağlı bir `value` (sayı) ve `currency` (ISO 4217 kodu) kabul eder. İstisna, pozitif bir `value` gerektiren `purchase` olayıdır.

| Olay | Ne zaman tetiklenir |
| - | - |
| `lead` | Bir ziyaretçi iletişim bilgilerini veya bir kayıt formunu gönderdiğinde |
| `schedule` | Bir ziyaretçi bir görüşme veya randevu ayarladığında |
| `submit_application` | Bir ziyaretçi bir başvuru gönderdiğinde |
| `contact` | Bir ziyaretçi bir konuşma veya iletişim talebi başlattığında |
| `complete_registration` | Bir üyelik veya kayıt tamamlandığında |
| `view_content` | Bir ziyaretçi önemli bir sayfayı veya içeriği görüntülediğinde |
| `add_to_cart` | Bir ziyaretçi sepete bir ürün eklediğinde |
| `initiate_checkout` | Bir ziyaretçi ödeme sayfasına ulaştığında |
| `purchase` | [Kendi ödeme sayfanızda](#track-sales-on-your-own-checkout) bir satış tamamlandığında; yalnızca Whop dışında gerçekleşen ödemeler için. Whop kendi ödeme sayfasını otomatik olarak izler |

Bir olayın hangi Whop varyantı ve ürünüyle ilgili olduğunu belirtmek için `variant_id` (`plan_` önekli) ve `product_id` (`prod_` önekli) değerlerini geçirin; bu genellikle `view_content` ve `add_to_cart` olaylarında yapılır ([Ürünleri ve sepetleri izleyin](https://docs.whop.com/tr/developer/websites/tracking.md#track-products-and-carts) her ikisini de yapan bir ürün sayfası gösterir):

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

## Özel olaylar

Whop'un standart olayları hunizin ihtiyaçlarını karşılamıyorsa veya müşteri yolculuğunun belirli aşamalarını izlemek istiyorsanız, özel olaylar tetikleyebilirsiniz.

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

Adları kısa ve sabit tutun ve küçük bir kümeyi yeniden kullanın. Whop 250 karaktere kadar olan adları saklar.

Özel olaylar, standart olaylarla aynı yerleştirme kurallarını izler; bkz. [Olayları izleyin](#track-events).

## Kendi ödeme sayfanızdaki satışları izleyin

Whop'un ödeme sayfası yerine kendi ödeme sayfanız üzerinden satış yapıyorsanız, bir satış tamamlandığında bir `purchase` olayı tetikleyin. `value` zorunludur: Whop, pozitif değeri olmayan bir satın alma olayını reddeder, çünkü reklam platformları tutarı olmayan bir satışa yönelik optimizasyon yapamaz. `currency` isteğe bağlıdır ve varsayılan olarak USD'dir.

```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 bunları reklam platformlarına standart Purchase olayı olarak iletir; böylece satın almaya göre optimize edilmiş bir kampanya bunlardan öğrenir. Whop raporlarında bunlar harici satın almalar olarak görünür ve satın almalardan ayrı tutulur; satın almalar ve ROAS yalnızca Whop'un işlediği ödemeleri sayar.

> [!WARNING]
>
> Whop'un işlediği bir satış için asla `purchase` tetiklemeyin. Whop bu satışı reklam platformuna zaten bildirir, bu nedenle sizinki onu iki kez saymış olur.

## Her olaya bir kimlik verin

Whop'a birden fazla kez ulaşabilecek her olayla birlikte bir `event_id` geçirin. Örneğin, bir teşekkür sayfasına ulaşıldığında bir olay tetikliyorsanız, bu olayın sayfa görüntüleme başına bir kez değil, gerçek dönüşüm başına bir kez tetiklendiğinden emin olun. Whop her `event_name` ve `event_id` çiftini bir kez sayar; böylece bir yeniden deneme, bir sayfa yenileme veya iki farklı yerden gönderilen aynı dönüşüm tek bir olayda birleşir.

```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>
```

**Kimlik, olay türünü değil, tek bir olayı tanımlar.** Her potansiyel müşterinin kendi kimliği olmalıdır. Her potansiyel müşteri için kimlik olarak `"lead"` gönderirseniz Whop hepsini tek bir olay olarak değerlendirir ve yüzlerce potansiyel müşteri tek bir tane olarak görünür.

Kendi sisteminizde o tek eylem için zaten bulunan bir değeri kullanın: bir potansiyel müşteri kimliği, sipariş numarası veya form gönderim kimliği. Bu değeri yalnızca aynı eylemi tekrar gönderirken yeniden kullanın. Bir yeniden deneme aynı eylem sayılır. Sunucunuzdan yansıtılan aynı dönüşüm de öyle. Tetikleme anında uydurulan bir değer her seferinde yenidir, bu nedenle yinelemeleri engellemez.

Aynı dönüşüm hem web sitenizden hem de sunucunuzdan gelebiliyorsa, tek bir olay olarak kaydedilmesi için her ikisinden de aynı `event_id` değerini gönderin.

## Müşteri bilgilerini ekleyin

Her zaman elinizdeki müşteri bilgilerinin mümkün olduğunca fazlasını gönderin. Bu, Whop'un olayları müşterilerle eşleştirmesine ve dönüşüm izlemeyi iyileştirmesine yardımcı olur.

Bu alanlar herhangi bir olay türüne eklenebilir ve isteğe bağlıdır. Yalnızca sahip olduğunuz alanları gönderin.

```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>
```

| Alan | Açıklama |
| - | - |
| `email` | Ziyaretçinin e-posta adresi |
| `first_name` | Ziyaretçinin adı |
| `last_name` | Ziyaretçinin soyadı |
| `name` | Ziyaretçinin tam görünen adı |
| `phone` | Ziyaretçinin telefon numarası |
| `external_id` | Kendi kullanıcı/müşteri kimliğiniz |
| `city` | Ziyaretçinin şehri |
| `state` | Ziyaretçinin eyaleti veya bölgesi |
| `postal_code` | Ziyaretçinin posta kodu |
| `country` | Ziyaretçinin ülkesi |

> [!WARNING]
>
> Bunları düz metin olarak gönderin. Karma (hash) uygulanmış bir e-posta geçerli bir adres olmadığı için atılır. Karma uygulanmış bir telefon numarası anlamsız rakamlar olarak saklanır ve hiç kimseyle eşleşmez.

> [!NOTE]
>
> **Whop ödeme sayfalarını, aboneliklerini veya deneme sürelerini izlemeyin.** Whop, kendi ödeme sayfasındaki her ödeme sayfası görüntülemesini, satın almayı, aboneliği ve deneme başlangıcını sunucu tarafında, hiçbir yapılandırma gerektirmeden kaydeder. Piksel yinelemeleri kabul etmez. Yalnızca Whop'un göremediği olayları gönderin: kendi altyapınızdaki potansiyel müşteriler ve rezervasyonlar ile [kendi ödeme sayfanızdaki satışlar](#track-sales-on-your-own-checkout).


## Related topics

- [Whop Pixel'i Shopify'a kurun](https://docs.whop.com/tr/developer/ads/platforms/shopify.md)
- [Whop Pixel'i Kajabi'ye kurun](https://docs.whop.com/tr/developer/ads/platforms/kajabi.md)
- [Whop Pixel'i Calendly ile kurun](https://docs.whop.com/tr/developer/ads/platforms/calendly.md)
