> ## 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.

# PixelSetupElement

> Whop Pixel'i kurar ve dönüşüm olaylarını bağlar: kod parçacığını kopyalayın, bir sayfada olup olmadığını kontrol edin, olayların tetiklendiğini doğrulayın. Satır içi olarak veya kendi katmanınızın içinde bağlayın.

> [!NOTE]
>
> Bu sayfa `@whop/elements@1.10.0` ve `@whop/elements-react@1.10.0` sürümlerini belgeler.

*`v1.0.0` sürümünden beri.*

[`Websites`](https://docs.whop.com/tr/elements/latest/websites/overview) içine bağlanır. Props ve geri çağırmaları create seçenekleri veya React props'ları üzerinden iletin.

> [!NOTE]
>
> Bu öğeyi **satır içi** (`create`) olarak bağlayabilir veya **modal** bir katman (`createOverlay`) olarak açabilirsiniz.

```tsx React theme={null}
import { WhopElements, Websites, PixelSetupElement } from "@whop/elements-react";
import { loadWhop } from "@whop/elements";

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Websites /* options */>
        <PixelSetupElement onRedirectUrlChanged={(e) => console.log(e)} onScanned={(e) => console.log(e)} onFinished={(e) => console.log(e)} onUrlSubmitted={(e) => console.log(e)} onVerifyLaunched={(e) => console.log(e)} onVerifyConnected={(e) => console.log(e)} onVerdict={(e) => console.log(e)} onEventVerified={(e) => console.log(e)} />
      </Websites>
    </WhopElements>
  );
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const websites = window.WhopElements().websites.create({ /* options */ });
  websites.create('pixel-setup', {
    onRedirectUrlChanged: (e) => console.log(e),
    onScanned: (e) => console.log(e),
    onFinished: (e) => console.log(e),
    onUrlSubmitted: (e) => console.log(e),
    onVerifyLaunched: (e) => console.log(e),
    onVerifyConnected: (e) => console.log(e),
    onVerdict: (e) => console.log(e),
    onEventVerified: (e) => console.log(e)
  }).mount('#websites-pixel-setup');
</script>
```

Örnek veriler. [Deneme alanını açın](https://docs.whop.com/tr/elements/latest/websites/overview#playground).

## Props

**accountId** `string`

Pikselin ait olduğu, `biz_` önekli hesap kimliği. Zorunludur; kod parçacığı, taramalar ve davetlerin tümü bu hesap üzerinde çalışır. Varsayılan: `""`.

**accessToken** `string`

Taramalar ve geliştirici daveti için kapsamlı bir token. Taramalar `company:basic:read` gerektirir; “Bir geliştirici davet et” ayrıca `authorized_user:create` gerektirir ve olay ön ayarları hesabı `company:balance:read` ile okur (bu olmadan sihirbaz genel bir ön ayar listesiyle yine çalışır). `destinationUrl` iletilmediğinde boş URL alanı, hesabın reklamlarından ve piksel trafiğinden sayfalar da önerir; bu okumalar `ad_campaign:basic:read` ve `stats:read` gerektirir, bunlar olmadan alan yalnızca boş kalır. Token'ı sunucunuzda `POST /api/v1/access_tokens` ile oluşturun ve süresi dolmadan yenisini ayarlayın. Bu sihirbazı kendi içinde açan başka bir öğe (reklamların `campaign-creator` öğesi gibi) bu çağrıları kendi token'ı ile yapar; bu nedenle ikinci bir token oluşturmak yerine bu kapsamları o tek token'a ekleyin: bu öğenin başka bir yerde ayarladığınız bir kimlik bilgisini okuma yolu yoktur. Belirtilmezse çağrılar görüntüleyenin kendi oturumunu taşır ve bu oturum yalnızca aynı kaynaktan (same-origin) gelen isteklere yanıt verir.

**destinationUrl** `string`

Kontrol edilecek sayfa; bağlama sırasında taranır. Boş bırakırsanız sihirbaz bir sayfa ister. Olaylar adımındaki "Verify live" düğmesini de bu belirler: bu düğme, sunucu tarafı bir taramanın göremediği olayları yakalamak için hesap sahibini kendi hunisinde gezdirir; bu nedenle yalnızca burada belirtilen veya sihirbazda adlandırılan bir hedef bilindiğinde görünür. Açılışta bir kez okunur, bu nedenle `update()` akışın ortasında hedefi değiştirmez; farklı bir sayfa için yeni bir bağlama oluşturun. Varsayılan: `""`.

**eventName** `string`

İsteğe bağlı. O sayfada tetiklenmesi gereken bir olay (`lead`, `schedule`, `view_content`, …); olaylar adımı bu olay algılanana kadar ilerlemez. Ayarlanmazsa her olay sunulur ve hiçbiri zorunlu değildir. Whop'un sunucu tarafında kaydettiği olaylar (`purchase`, `subscribe`, deneme süreleri, ödeme adımları) yok sayılır. Açılışta bir kez okunur. Varsayılan: `""`.

**redirectUrl** `string`

Olay hedef sayfa yerine orada tetikleniyorsa, hedefin yönlendirdiği URL. Hesap sahibi bunu sihirbazda da ayarlayabilir; `redirectUrlChanged` olayını dinleyin ve bir dahaki sefere geri iletin. Varsayılan: `""`.

**initialStep** `"events" | "install"`

Sihirbazın nerede açılacağı: kurulum adımı veya piksel zaten mevcutsa ve yalnızca dönüşüm olayı eksikse doğrudan `events`. Varsayılan: `"install"`.

**showIntro** `boolean`

"Neden bir piksel" giriş ekranında açılır. Hesap sahibinin burada neden olduğunu zaten bildiği yerlerde (örneğin onu başlatmanın ortasında buraya gönderen bir kampanya akışında) kapatın; sihirbaz doğrudan kurulum adımında açılır. Varsayılan: `true`.

**showInviteDeveloper** `boolean`

"Kurulum için bir geliştirici davet et" yolunu sunar. Yerleştirmenizi kullanan kişilerin arkasındaki Whop ekibine üye davet etmemesi gereken yerlerde gizleyin. Varsayılan: `true`.

**showOptimizePrompt** `boolean`

Bir sayfa kontrolden geçtikten sonra, sonraki adım olarak dönüşüm olaylarını sunan "pikseliniz yayında" ekranını gösterir. Hesap sahibinin doğrudan olaylar için geldiği yerlerde kapatın; başarılı bir kontrol, tıklayıp geçecekleri bir ekranda beklemek yerine doğrudan olaylara gider. Varsayılan: `true`.

**verifyFirst** `boolean`

Kurulum talimatları yerine sayfa kontrolüyle başlar: URL alanı (ve önerileri) en üstte yer alır, kurulum yolları "Pixel not installed yet?" anahtarının altına katlanır ve başlıkta "Verify your pixel" yazar. Zaten bir pikseli olan ve neden hiçbir şeyin ilişkilendirilmediğini öğrenmek için burada olan bir hesap sahibi içindir. `showIntro: false` ile birlikte kullanın. Varsayılan: `false`.

## Olaylar

Geri çağırmaları create seçeneklerinde veya React props'larında iletin.

### `onRedirectUrlChanged`

Hesap sahibi sihirbazda bir yönlendirme URL'si ayarladı veya temizledi. Bunu saklayın ve bir dahaki sefere `redirectUrl` olarak geri iletin.

**payload** `object`

**properties**

**url** `string` *required*

### `onScanned`

Bir piksel taraması sonuçlandı. Sihirbazın kontrol ettiği her URL için tetiklenir, böylece kendi kurulum rozetiniz bunu takip edebilir. `primary`, kurulmakta olan sayfayı işaretler: huni denetleyicisi, diğer ana makine adları da dahil olmak üzere hesap sahibinin listelediği diğer her şeyi tarar; bu nedenle bir sonucu onların sitesiyle ilgili kabul etmeden önce bu değeri kontrol edin. Bir `websites` tablosunu doğru tutmak için buna ihtiyacınız yoktur: o tanıtıcı altında bağlandığında, yayında olduğu kanıtlanan bir site bekleyen satırını zaten alır.

**payload** `object`

**properties**

**url** `string` *required*

**status** `"installed" | "missing" | "unreachable"` *required*

**installed** `boolean` *required*

**primary** `boolean` *required*

### `onFinished`

Done düğmesine basıldı. Sayfayı kendiniz yeniden kontrol edin; bu olay gereksinimlerinizin karşılandığını değil, sihirbazın bittiğini bildirir.

### `onUrlSubmitted`

Hesap sahibi kontrol edilecek sayfayı sihirbazın içinden belirtti: elle yazarak veya önerilen sayfalardan seçerek. Yalnızca bağlama sırasında bir hedef sağlanmadığında erişilebilir.

**payload** `object`

**properties**

**url** `string` *required*

**source** `"typed" | "suggested"` *required*

### `onVerifyLaunched`

"Verify live" düğmesine basıldı. `popupBlocked`, tarayıcının huni penceresini reddettiği ve bu nedenle gezintinin hiç başlamadığı anlamına gelir.

**payload** `object`

**properties**

**url** `string` *required*

**popupBlocked** `boolean` *required*

### `onVerifyConnected`

Huni sayfası sihirbaza geri sinyal gönderdi: piksel orada yüklü ve gezinti canlı.

**payload** `object`

**properties**

**url** `string` *required*

### `onVerdict`

Canlı doğrulama gezintisi tamamlandı. `ok`, izleme boşluğu olmadığı anlamına gelir; aksi takdirde `gaps`, gezintinin bulduğu boşluk kodlarını taşır.

**payload** `object`

**properties**

**url** `string` *required*

**ok** `boolean` *required*

**gaps** `string[]` *required*

**eventsCaptured** `number` *required*

### `onEventVerified`

Hesap sahibi "Verify live" ile hunisinde gezindi ve bu olay tetiklendi; bu, olayın sunucu tarafı bir taramanın erişemediği yerde bağlı olduğunun kanıtıdır.

**payload** `object`

**properties**

**url** `string` *required*

**event** `string` *required*

### `onLoaderStart`

Yükleme iskeleti ilk kez çizildikten sonra ve `onReady` öncesinde çalışır.

### `onReady`

Öğenin ilk tam çiziminden sonra çalışır.

### `onError`

Öğe yüklenemediğinde veya çöktüğünde çalışır. Yedek görünüm görünür kalır. Programatik işleme için `code` kullanın. `sourceKey`, başarısız olan bir host-state kaynağını tanımlar.

**e** `object`

**properties**

**message** `string` *required*

**code** `string`

**sourceKey** `string`

## Yöntemler

Bunları `create` tarafından döndürülen tanıtıcı üzerinde veya bir React `ref` aracılığıyla çağırın.

### `mount`

Öğeyi `target` içine bağlar ve yüklemeyi başlatır. React bileşenleri kendilerini bağlar.

**Parametreler**

**target** `string | HTMLElement` *required*

### `destroy`

Öğeyi kaldırır, çerçevesini ve aboneliklerini serbest bırakır. Birden fazla kez çağırabilirsiniz. React öğeyi otomatik olarak kaldırır.

### `update`

Yeni props'ları bağlı öğeyle birleştirir. React'te bunun yerine bileşen props'larını değiştirin.

**Parametreler**

**options** `Partial\<PixelSetupElementProps\>` *required*

## Stil verme

Bu parçalara `appearance.classes` aracılığıyla stil verin. Özellik adları için camel case veya kebab case kullanın ve birimleri ekleyin. Sayfa stil sayfaları öğenin çerçevesine ulaşamaz. Framework her bildirimi eklemeden önce doğrular.

| Sınıf | Hedef |
| - | - |
| `.whop-PixelSetupSurface` | Piksel kurulum sihirbazının kökü: her seferinde bir adım |

```ts theme={null}
const websites = whop.websites.create({
  appearance: {
    classes: {
      'whop-PixelSetupSurface': { borderRadius: '8px', fontWeight: '600' }
    }
  }
});

websites.update({
  appearance: {
    classes: { 'whop-PixelSetupSurface': { fontWeight: '700' } }
  }
});
```

React'te `appearance` değerini `<Websites>` bileşenine iletin. Genel olarak `WhopElements({ appearance })` ile ayarlayın.


## Related topics

- [Websites](https://docs.whop.com/tr/elements/latest/websites/overview.md)
- [CampaignCreatorElement](https://docs.whop.com/tr/elements/latest/ads/campaign-creator.md)
- [BillingSetupElement](https://docs.whop.com/tr/elements/latest/ads/billing-setup.md)
