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

# TableElement

> Bir reklam hesabının kampanyaları, reklam grupları ve reklamları, aralarında geçiş yapan sekmelerle tek bir tabloda: alt düzeyi daraltmak için satırlar seçin, arayın, sıralayın, rakamları kırılımlara ayırın, sütunlarınızı seçin ve doğrudan bir satırdan duraklatın, devam ettirin, çoğaltın veya silin. Raporladığı zaman aralığı ve filtrelendiği satırlar tanıtıcıda tutulur, böylece yanına bağlanan bir grafik tam olarak aynı şeyi raporlar.

> [!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.*

[`Ads`](https://docs.whop.com/tr/elements/latest/ads/overview) içindeki [`Reporting`](https://docs.whop.com/tr/elements/latest/ads/reporting) içine bağlanır. `accountId` ve `accessToken`, `Ads` öğesinden gelir. Props ve geri çağırmaları create seçenekleri veya React props'ları üzerinden iletin.

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

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Ads /* options */>
        <Reporting>
          <TableElement onTabChanged={(e) => console.log(e)} onFilterChanged={(e) => console.log(e)} onColumnsChanged={(e) => console.log(e)} onCustomMetricsChanged={(e) => console.log(e)} onViewChanged={(e) => console.log(e)} onSourcesChanged={(e) => console.log(e)} onAttributionModelChanged={(e) => console.log(e)} />
        </Reporting>
      </Ads>
    </WhopElements>
  );
}
```

```html JavaScript theme={null}
<script src="https://cdn.whop.com/elements/amber/elements.js" data-whop-elements></script>
<script type="module">
  const ads = window.WhopElements().ads.create({ /* options */ });
  const reporting = ads.create('reporting', { /* options */ });
  reporting.create('table', {
    onTabChanged: (e) => console.log(e),
    onFilterChanged: (e) => console.log(e),
    onColumnsChanged: (e) => console.log(e),
    onCustomMetricsChanged: (e) => console.log(e),
    onViewChanged: (e) => console.log(e),
    onSourcesChanged: (e) => console.log(e),
    onAttributionModelChanged: (e) => console.log(e)
  }).mount('#ads-reporting-table');
</script>
```

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

## Props

**useCampaignCreator** `boolean`

Bir görüntüleyen düzenleme istediğinde (bir satır menüsünden, bir taslak satırdan veya ayrıntılar katmanındaki Edit ad seçeneğinden) ne olacağı. Varsayılan olarak açıktır: kampanya oluşturucu, istenen kampanya ve adımda sayfanın üzerinde açılır, böylece düzenleme hiçbir bağlantı yapmadan çalışır. Kampanya düzenlemeyi kendiniz yönetmek için kapatın; hiçbir şey açılmaz ve istek `editRequested` üzerinden geri gelir. Varsayılan: `true`.

**breakdown** `string | null`

Artık hiçbir etkisi yoktur: tablo her zaman satırların tamamını gösterir. Mevcut yerleştirmelerin çalışmaya devam etmesi için kabul edilir. Varsayılan: `null`.

**columns** `string[] | null`

Gösterilen sütunlar, ada göre: `impressions` ve `roas` gibi standart sütunlar ve görüntüleyenin eklediği piksel olayları. Ayarlanmazsa tablo kendi varsayılanlarıyla açılır. `columnsChanged` üzerinden eksiksiz olarak geri gelir; düzenin kalıcı olması için listeyi saklayın ve buraya iletin. Varsayılan: `null`.

**customMetrics** `CustomMetricDefinition[]`

Tablodaki mevcut rakamlardan hesaplanan sütunlar; adlandırdığınız ve biçimlendirdiğiniz bir formül. Tablo bunları düzenleyebilir ve her değişiklik `customMetricsChanged` üzerinden yeni listenin tamamı olarak geri gelir; kalıcı olması için saklayın ve buraya iletin. Varsayılan: `[]`.

**properties**

**name** `string` *required*

**formula** `string` *required*

**format** `"number" | "currency" | "percent"` *required*

**enabled** `boolean` *required*

**sourcesDrill** `string | null`

All sekmesinin hangi düzeye indiği, bir kaynak yolu olarak: kökler için `null`, bir platform listesi için `ext:*`, o platformun kampanyaları için `ext:<platform>:*`. `viewChanged` üzerinden geri gelir. Varsayılan: `null`.

**query** `string`

Ads sekmesinin arama kutusunun neye göre filtrelendiği. Varsayılan: `""`.

**showPausedCampaigns** `boolean`

Duraklatılmış kampanyaların listelenip listelenmeyeceği. Varsayılan: `true`.

**showPausedAdGroups** `boolean`

Duraklatılmış reklam gruplarının listelenip listelenmeyeceği. Varsayılan: `true`.

**showPausedAds** `boolean`

Duraklatılmış reklamların listelenip listelenmeyeceği. Varsayılan: `true`.

## Olaylar

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

### `onTabChanged`

Açık sekme değişti. Sayfa yenilemeden sonra da korunmasını istiyorsanız bunu kendi URL'nize yansıtın.

**payload** `object`

**properties**

**tab** `"ads" | "all" | "businesses" | "campaigns" | "ad-groups"` *required*

### `onFilterChanged`

Görüntüleyen görünümü daralttı: satırları işaretleyerek veya bir kampanyadan reklam gruplarına tıklayarak. Aynı tanıtıcı altındaki her yüzey bunu zaten izlemiştir.

**payload** `object`

**properties**

**campaignIds** `string[]` *required*

**adGroupIds** `string[]` *required*

**adIds** `string[]` *required*

### `onColumnsChanged`

Görüntüleyen bir sütunu gösterdi veya gizledi. Standart ve piksel olayı sütunları dahil şu anda gösterilen her sütunu taşır; listeyi saklayın ve doğrudan `columns` olarak geri iletin, aksi takdirde düzen bir sonraki bağlamada sıfırlanır.

**payload** `object`

**properties**

**columns** `string[]` *required*

### `onCustomMetricsChanged`

Görüntüleyen hesaplanan bir sütun ekledi, düzenledi veya kaldırdı. Her durumda listenin tamamını taşır; olduğu gibi saklayın ve `customMetrics` olarak geri iletin, aksi takdirde bir sonraki bağlamada kaybolurlar.

**payload** `object`

**properties**

**customMetrics** `CustomMetricDefinition[]` *required*

**properties**

**name** `string` *required*

**formula** `string` *required*

**format** `"number" | "currency" | "percent"` *required*

**enabled** `boolean` *required*

### `onViewChanged`

Görüntüleyen tablonun kendi kontrollerinden birini değiştirdi: All sekmesinin alt düzeyi, arama kutusu veya üç sekmeden herhangi birindeki duraklatılmış anahtarı. Hangisi değişirse değişsin hepsini taşır; bunları saklayın ve props olarak geri iletin, aksi takdirde bir sonraki bağlamada sıfırlanırlar.

**payload** `object`

**properties**

**sourcesDrill** `string | null` *required*

**breakdown** `null` *required*

**query** `string` *required*

**showPausedCampaigns** `boolean` *required*

**showPausedAdGroups** `boolean` *required*

**showPausedAds** `boolean` *required*

### `onSourcesChanged`

All sekmesinin şu anda neye baktığı, bir grafiğe verilmeye hazır kaynak yolları olarak: All sekmesi dışında `null` (yalnızca Whop reklamları), her kaynak için `[]`, aksi takdirde işaretlenen satırlar veya alt düzeyine inilen grup. Aynı tanıtıcı altındaki her yüzey bunu zaten izlemiştir.

**payload** `object`

**properties**

**sources** `string[] | null` *required*

### `onAttributionModelChanged`

Görüntüleyen, All sekmesindeki seçiciden atfı hangi temasın alacağını değiştirdi. Aynı tanıtıcı altındaki her yüzey atfı zaten yeniden hesaplamıştır; bunu saklayın ve `attributionModel` olarak geri iletin, aksi takdirde bir sonraki bağlamada son temasa geri döner.

**payload** `object`

**properties**

**attributionModel** `"last_touch" | "first_touch"` *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\<TableElementProps\>` *required*

## Stil

Bu öğe stil için sınıf adları sunmaz. Yeniden stillendirmek için `appearance` (tema, vurgu rengi, değişkenler) kullanın.


## Related topics

- [Reporting](https://docs.whop.com/tr/elements/latest/ads/reporting.md)
- [PaymentsTableElement](https://docs.whop.com/tr/elements/latest/dashboard/paymentsTable.md)
- [WebsitesElement](https://docs.whop.com/tr/elements/latest/websites/websites.md)
