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

# ChartElement

> Bir hesabın bir zaman aralığındaki performansı; neyin çizileceğini seçmek için bir seçiciyle birlikte: harcama, gösterimler, tıklamalar veya hesabın kaydettiği herhangi bir dönüşüm. Salt okunur.

> [!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. Props ve geri çağırmaları create seçenekleri veya React props'ları üzerinden iletin.

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

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Ads /* options */>
        <Reporting>
          <ChartElement onMetricChanged={(e) => console.log(e)} onTimezoneChanged={(e) => console.log(e)} onPeriodChanged={(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('chart', {
    onMetricChanged: (e) => console.log(e),
    onTimezoneChanged: (e) => console.log(e),
    onPeriodChanged: (e) => console.log(e)
  }).mount('#ads-reporting-chart');
</script>
```

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

## Props

**metric** `string`

Grafiğin neyi çizdiği: `spend`, `impressions`, `clicks` veya bir dönüşüm. Seçici bunu değiştirir; başka bir şeyle açılması için ayarlayın. `conversions`, `conversion_value` ve `cost_per_conversion` için dönüşümü `metricEvent` içinde adlandırın. Varsayılan: `"spend"`.

Şunlardan biri: `"funnel"`, `"spend"`, `"impressions"`, `"clicks"`, `"cost_per_1k_impressions"`, `"cost_per_click"`, `"conversions"`, `"conversion_value"` veya `"cost_per_conversion"`.

**metricEvent** `string`

`metric` dönüşüm başına bir metrik olduğunda başvurduğu dönüşüm: `payment.completed`, `pixel.lead` veya hesabın kendisinin adlandırdığı özel bir olay. Diğer tüm metrikler tarafından yok sayılır. Varsayılan: `""`.

## Olaylar

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

### `onMetricChanged`

Görüntüleyen çizilecek farklı bir sonuç seçti. `metric` çizilen şeydir; `event` başvurduğu dönüşümü adlandırır ve yalnızca `conversions`, `conversion_value` ve `cost_per_conversion` için bulunur; bunların adını hesap belirlediğinden bir üye değil, bir dizedir. Seçimin sayfa yenilemeden sonra da korunmasını istiyorsanız bunu kendi URL'nize yansıtın ve `metric`/`metricEvent` olarak geri iletin; öğe her durumda bağlı kaldığı süre boyunca bunu tutar.

**payload** `object`

**properties**

**metric** `string` *required*

Şunlardan biri: `"funnel"`, `"spend"`, `"impressions"`, `"clicks"`, `"cost_per_1k_impressions"`, `"cost_per_click"`, `"conversions"`, `"conversion_value"` veya `"cost_per_conversion"`.

**event** `string`

### `onTimezoneChanged`

Görüntüleyen rakamların raporlandığı saat dilimini değiştirdi: yaptığı seçim VE bunun çözümlendiği IANA saat dilimi. Seçim, sayfa yenilemeden sonra korunan yarıdır; bunu saklayın ve `timezone` olarak geri iletin, Whop kontrol paneli de kendi kopyasıyla bunu yapar; öğe her durumda bağlı kaldığı süre boyunca bunu tutar. `resolved`, bir ana bilgisayarın hesap tercihi aramasını tekrarlamadan kendi rakamlarını etiketleyebilmesi için birlikte gelir ve hesap hiçbir ayar yapmadığında görüntüleyenin kendi saat dilimidir.

**payload** `object`

**properties**

**timezone** `"account" | "local"` *required*

**resolved** `string` *required*

### `onPeriodChanged`

Görüntüleyen raporlama zaman aralığını değiştirdi: seçtiği dönem VE bunun çözümlendiği zaman aralığı, ISO 8601 anları olarak. Tarihler çözümlenmiş olarak gelir, çünkü yalnızca bir dönem adı, buna göre işlem yapmak için gün sınırı ve hesap saat dilimi hesaplamalarını yeniden yapmanızı gerektirirdi; dönem de gelir, çünkü sayfa yenilemeden sonra KAYAN bir zaman aralığı olarak yalnızca o korunur; saklanan tarihler onu sabitlerdi. Aynı tanıtıcı altındaki her yüzey bu değişikliği zaten izlemiştir.

**payload** `object`

**properties**

**period** `string` *required*

Şunlardan biri: `"today"`, `"yesterday"`, `"last_7_days"`, `"last_14_days"`, `"last_30_days"`, `"last_90_days"`, `"all_time"` veya `"custom"`.

**from** `string` *required*

**to** `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\<ChartElementProps\>` *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)
- [BalanceElement](https://docs.whop.com/tr/elements/latest/wallet/balances-balance.md)
- [Elements ile başlarken](https://docs.whop.com/tr/elements/latest/getting-started.md)
