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

# Reporting

> Bir reklam hesabının raporlaması: bir zaman aralığında, hangi düzeye daraltırsanız o düzeyde, ne harcadığı ve karşılığında ne geldiği. `chart`, `table` veya her ikisini bağlayın; aynı zaman aralığını, aynı atıf kuralını ve aynı seçimi okurlar, böylece yan yana iki yüzey gösterdikleri şey konusunda asla çelişmez. `ads` tanıtıcısının `links` yapılandırması, tablonun tıklama ve sonuç sayılarını kendi sayfalarınıza, yani `tracking` ad alanının `people` ve `events` öğelerini bağladığınız sayfalara bağlar.

> [!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çine bağlanır. Bir tanıtıcı almak için oluşturun, ardından öğelerini o tanıtıcı üzerinde bağlayın. Alt denetleyiciyi kaldırmak için `destroy()` çağırın. Yeni bir tanıtıcı almak için yeniden oluşturun.

## Önizleme

Bu alt denetleyicinin varsayılan düzeninin örnek verilerle canlı, etkileşimli bir demosu:

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

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Ads /* options */>
        <Reporting>
          <ChartElement />
          <TableElement />
        </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').mount('#ads-reporting-chart');
  reporting.create('table').mount('#ads-reporting-table');
</script>
```

## Seçenekler

Bunları `ads.create('reporting', { … })` fonksiyonuna veya React'te `<Reporting>` üzerinde props olarak iletin. Üst öğe tarafından enjekte edilen props'lar burada hiçbir zaman görünmez.

**period** `string`

Her yüzeyin raporladığı zaman aralığı: `today`, `yesterday`, `last_7_days`, `last_14_days`, `last_30_days`, `last_90_days`, `all_time` veya `custom` (`customRange` ile birlikte kullanın). Seçici grafikte bulunur ve bu değeri değiştirir; böylece bir ana bilgisayar zaman aralığını yönetebilir ve `periodChanged` üzerinden geri okuyabilir. Varsayılan: `"last_14_days"`.

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

**customRange** `object | null`

`period` değeri `custom` olduğunda kullanılan, ISO 8601 anları olarak açık zaman aralığı. Aksi takdirde yok sayılır. Varsayılan: `null`.

**properties**

**from** `string` *required*

**to** `string` *required*

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

Raporlanan her rakam için saat dilimi seçimi. Hesabın `preferences.ads_scheduling_timezone` ayarı için `account`, görüntüleyenin tarayıcı saat dilimi için `local` kullanın. Grafiğin sunduğu tek seçenekler bunlardır. Serbest biçimli bir IANA saat dilimi, seçicinin verileri yanlış etiketlemesine neden olabilir ve görüntüleyen seçimi değiştirdiğinde kaybolur. Başka bir saat diliminde raporlamak için hesap ayarını değiştirin. Hesabın bir ayarı yoksa `account`, görüntüleyenin saat dilimine geri döner. Varsayılan: `"account"`.

**currency** `string`

Dönüştürülen tutarlar için `usd` veya `eur` gibi küçük harfli, üç harfli ISO 4217 para birimi kodu. Ayarlanmazsa varsayılan olarak hesabın `preferences.ads_reporting_currency` değeri kullanılır. Varsayılan: `""`.

**attributionModel** `"last_touch" | "first_touch"`

Bir alıcının yolculuğundaki hangi temasın atfı aldığı: varsayılan olan `last_touch` veya `first_touch`. Her ikisinde de yolculuğun herhangi bir yerindeki bir Whop teması Whop grubunu kazanır; model yalnızca uç noktaları seçer. Seçici tabloda bulunur ve bu değeri değiştirir; böylece bir ana bilgisayar bunu yönetebilir ve `attributionModelChanged` üzerinden geri okuyabilir. Varsayılan: `"last_touch"`.

**campaignIds** `string[]`

Raporlamayı bu reklam kampanyalarıyla (`adcamp_…`) sınırlayın. Boş bırakılırsa tüm hesap raporlanır. `adGroupIds` veya `adIds` ayarlandığında bunlar tarafından geçersiz kılınır. **Kesin bir rakam için tek bir kimlik iletin:** raporlama API'si tek bir kaynak yoluna göre kapsamlandırır, bu nedenle birden fazla kimlik verildiğinde grafik yalnızca ilkini raporlar. Varsayılan: `[]`.

**adGroupIds** `string[]`

Raporlamayı bu reklam gruplarıyla (`adgrp_…`) sınırlayın. `campaignIds` üzerinde önceliklidir. Aynı tek kimlik uyarısı geçerlidir. Varsayılan: `[]`.

**adIds** `string[]`

Raporlamayı bu reklamlarla (`ad_…`) sınırlayın. En dar filtredir; diğer ikisinin üzerinde önceliklidir. Aynı tek kimlik uyarısı geçerlidir. Varsayılan: `[]`.

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

`table` öğesinin hangi tabloda açılacağı: `campaigns`, `ad-groups`, `ads` veya trafik kaynağı görünümü için `all`. `all` her zaman hesap genelinde raporlar (kaynak serisi yalnızca bu düzeyde vardır); bu nedenle yanında ayarlanan bir filtre tabloyu daraltır ancak grafiği daraltmaz. Varsayılan: `"campaigns"`.

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

Grafiğin hangi trafiği raporladığı, kaynak yolları olarak: Whop üzerinden satın alınan reklamlar için `whop:*`, başka yerlerde yayınlanan reklamlar için `ext:*` ve `ext:<platform>:*`, organik trafik için `referrer:*`, `direct`, `other`. Varsayılan olan `null` yalnızca Whop reklamlarını raporlar; `[]` her kaynağı raporlar; boş olmayan bir dizi yalnızca bunları raporlar. Bu, Whop reklamları içinde daraltma yapan `campaignIds` ve benzerlerinden FARKLI bir eksendir; harcamadan türetilen oranlar bu değer ne olursa olsun Whop'a atfedilmiş olarak kalır, çünkü harcama yalnızca Whop reklamları satın almıştır. `table` öğesinin All sekmesi bu değeri değiştirir. Varsayılan: `null`.

## Olaylar

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

### `onEditRequested`

Görüntüleyen bir şeyi düzenlemek istedi: bir satır menüsü, bir taslak satır veya ayrıntılar katmanındaki Edit ad. `campaignId` her zaman bulunur; `adGroupId` ve `adId` bunu tıklanan öğeye daraltır. Yalnızca `useCampaignCreator` kapalıyken tetiklenir; açıkken bunun yerine oluşturucu sayfanın üzerinde açılır ve bu olay tetiklenmez.

**payload** `AdsEditTarget`

**properties**

**campaignId** `string` *required*

**adGroupId** `string`

**adId** `string`

## Yöntemler

Bunları `ads.create('reporting', { … })` ile alınan alt tanıtıcı üzerinde çağırın.

### `update`

Yeni props ve geri çağırmaları alt denetleyiciyle birleştirir.

**Parametreler**

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

### `destroy`

Alt denetleyiciyi ve öğelerini yok eder, ardından özel yuvasını serbest bırakır. Sonraki bir `create("reporting")` sıfırdan başlar.

## Öğeler

Bu alt denetleyicinin bağladığı öğeler. Her birinin kendi sayfası vardır:

> [card] [ChartElement](https://docs.whop.com/tr/elements/latest/ads/reporting-chart.md)
>
> 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.

> [card] [TableElement](https://docs.whop.com/tr/elements/latest/ads/reporting-table.md)
>
> 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.


## Related topics

- [ChartElement](https://docs.whop.com/tr/elements/latest/ads/reporting-chart.md)
- [TableElement](https://docs.whop.com/tr/elements/latest/ads/reporting-table.md)
- [Ads](https://docs.whop.com/tr/elements/latest/ads/overview.md)
