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

# Ads

> Bir reklam hesabı. `accountId` ile bir Whop hesabına sınırlandırın (alttaki reklam hesabı sunucu tarafında atanır ve burada hiçbir zaman görünmez), ardından hesabın ne harcadığını ve karşılığında ne geldiğini görmek için `reporting`, bir kampanya oluşturmak için `campaign-creator` veya bir başlatmanın gerektirdiği Whop Ads sözleşmesini imzalamak için `ads-agreement` 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.*

## Deneme alanı

Öğeleri örnek verilerle bir araya getirin. Kontrolleri kullanın, öğe ekleyip düzenleyin ve olayların canlı olarak tetiklenmesini izleyin:

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

function Example() {
  return (
    <WhopElements elements={loadWhop()}>
      <Ads /* options */>
        {/* mount elements here */}
      </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 */ });
</script>
```

## Seçenekler

Bunları `whop.ads.create({ … })` fonksiyonuna veya React'te `<Ads>` üzerinde props olarak iletin.

**accountId** `string`

Reklamlarının okunacağı, `biz_` önekli Whop hesap kimliği. Zorunludur; bu bir reklam hesabı kimliği değildir. Varsayılan: `""`.

**accessToken** `string`

Bu tanıtıcı altındaki her yüzeyin okuma ve yazma için kullandığı kapsamlı bir token. **Öğe başına bir değil, tüm tanıtıcı için tek bir token oluşturun.** Bağlayacağınız her öğenin kapsamlarını belirleyin, bunları tek bir token üzerinde isteyin ve burada ayarlayın; tanıtıcı bu tek kimlik bilgisini her öğenin çerçevesine yansıtır, bu nedenle yüzey başına ikinci bir token hiçbir şey kazandırmaz ve size bir yerine birkaç son kullanma tarihi takip ettirir. Token'ı sunucunuzda `POST /api/v1/access_tokens` ile oluşturun ve süresi dolmadan önce `update({ accessToken })` ile yenisini ayarlayın. Her şeyi bağlamak için `ad_campaign:read`/`:create`, `ad_group:read`, `ad:read`, `stats:read`, tablonun satır işlemlerinin kullandığı `:update`/`:delete` kapsamları, `campaign-creator` öğesinin çalıştırdığı piksel kontrolleri için `company:basic:read` ve bir reklam harcaması kartı eklemek için `payment:charge` ile `user:email:read` gerekir; faturalandırma yuvaları kayıtlı kartları ve harcanabilir cüzdanları `member:payment_methods:read` ile listeler. Daha az yüzey bağlamak daha az kapsam gerektirebilir; yine de tek token üzerinde. Atlanırsa çağrılar, yalnızca aynı kaynakta yanıt veren görüntüleyenin kendi oturumunu taşır.

**links** `CrossLinksConfig`

Raporlama `table` öğesinin tıklama ve sonuç sayılarının sitenizde nereye bağlandığı; genellikle `tracking` ad alanının `people` ve `events` öğelerini bağladığınız sayfalar. `people` ve `events` mutlak temel URL'lerdir (`https://…`); tablo, bu öğelerin props olarak aldığı aynı sorgu parametrelerini ekler (`?source=whop:adcamp_…:*&event=…&from=…&to=…`), böylece hedef sayfa öğesini doğrudan URL'sinden doldurabilir. Göreli bir URL öğe çerçevesine göre çözümleneceğinden ayarlanmamış kabul edilir; ayarlanmamış bağlantılar sayıları düz rakamlar olarak gösterir. Varsayılan: `{}`.

**properties**

**people** `string`

**events** `string`

**person** `string`

**appearance** `Appearance`

Bu grubun öğeleri için görsel özelleştirme. Genel `WhopElements({ appearance })` ayarını geçersiz kılar. `update({ appearance })` ile canlı olarak değiştirin.

**locale** `WhopElementsLocale`

Bu grubun öğe arayüz metinleri için yerel ayar. Genel yapılandırmayı geçersiz kılmak için uygulamanın derlenmiş yerel ayarlarından birine ayarlayın. Diğer tüm değerler varsayılan yerel ayara geri döner.

## Olaylar

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

### `onBillingChanged`

Hesabın reklam harcaması ödeme yöntemleri değişti ve değişiklik kaydedildi. Yuva değerleri yöntem kimliklerinin kendisidir: kart için `payt_…`, bakiye için `ldgr_…`; boş bir `backup` hiçbirinin ayarlanmadığı anlamına gelir.

**payload** `object`

**properties**

**primary** `string` *required*

**backup** `string` *required*

### `onLoadingChange`

Gruplanmış yükleme durumu değiştiğinde çalışır. Bağlı herhangi bir öğe hâlâ yükleniyorken değer `true` olur.

**loading** `boolean`

## Yöntemler

Bunları `whop.ads.create({ … })` veya `useAds()` ile alınan Ads tanıtıcısı üzerinde çağırın.

### `update`

Yeni tanıtıcı seçeneklerini bağlı her öğeyle birleştirir. React'te bunun yerine ad alanı props'larını değiştirin.

**Parametreler**

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

### `destroy`

Bu tanıtıcının oluşturduğu her öğeyi ve alt denetleyiciyi yok eder, denetleyici çerçevesini kaldırır ve aboneliklerini serbest bırakır. Birden fazla kez çağırabilirsiniz, ancak yok edilmiş bir tanıtıcı diğer tüm çağrıları reddeder; baştan başlamak için yeni bir tanıtıcı oluşturun. Sağlayıcı bağlantısı kaldırıldığında React grubu otomatik olarak kaldırır.

## Öğeler

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

> [card] [Raporlama](https://docs.whop.com/tr/elements/latest/ads/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. *(alt denetleyici, 3 öğe)*

> [card] [BillingSetupElement](https://docs.whop.com/tr/elements/latest/ads/billing-setup.md)
>
> Reklam harcamasının hangi ödeme yöntemlerinden faturalandırılacağı: önce kullanılan bir birincil yöntem ve başarısız olduğunda kullanılacak isteğe bağlı bir yedek. Her ikisi de hesapta zaten kayıtlı yöntemler arasından seçilir ve birini seçmek onu hemen kaydeder; ayrı bir gönderme adımı yoktur. Kart eklemek, sayfanızın üzerinde bir kart formu açar ve onu isteyen yuvaya geri döner. Hesabın bir bakiyesi varsa, bakiye kartlarının yanında görünür.

> [card] [CampaignCreatorElement](https://docs.whop.com/tr/elements/latest/ads/campaign-creator.md)
>
> Reklam kampanyası oluşturucu: hedef ve bütçe, hedeflemeleri ve zamanlamalarıyla reklam grupları ve kreatifleriyle reklamların kendisi; başlatmaya kadar tüm akış. Yeni bir kampanya oluşturmak için boş açılır veya `campaignId` ilettiğinizde mevcut bir kampanyada açılır. Piksel denetleyicisini de çalıştırır: bir başlatma, reklam grubunun dönüşüm olayının hedef URL'de etkin olmasına bağlıdır ve eksik bir kurulumu düzeltmek için `pixel-setup` sihirbazı bu öğenin içinde açılır. Bir başlatma ayrıca hesabın Whop Ads sözleşmesini imzalamış olmasına bağlıdır: imzalamadıysa tanıtıcı oluşturucunun üzerinde `ads-agreement` açar ve imzalandıktan sonra başlatma devam eder. Bütçeler hesabın `ads_reporting_currency` para biriminde (raporlarının zaten kullandığı para birimi) girilir ve gösterilir, güncel döviz kuruyla USD'ye çevrilerek USD üzerinden faturalandırılır. `ads` tanıtıcısında ayarladığınız tek token, öğe başına ayrı bir token kullanmak yerine kampanya kapsamlarının yanında piksel kapsamlarını da (`ad_campaign:create` ve `company:basic:read`) taşımalıdır.

> [card] [AdsAgreementElement](https://docs.whop.com/tr/elements/latest/ads/ads-agreement.md)
>
> Bir hesap için Whop Ads Services and Payment Authorization Agreement sözleşmesini imzalar. Hesabın reklam harcaması faturalandırmasını kaydetmek sözleşmeyi açar; yetkili bir temsilci imzalayana kadar hiçbir kampanya başlatılamaz. İmzalayan kişi tam yasal adını ve isteğe bağlı olarak unvanını yazar, koşulları kabul eder ve yazılan imza sözleşmeyle birlikte dosyalanır. İmzalandıktan sonra bu öğe kimin ve ne zaman imzaladığını gösterir; faturalandırma kurulmadan önce imzalanacak bir şey yoktur ve bunu belirtir. Bir başlatma imza gerektirdiğinde `campaign-creator` bunu oluşturucunun üzerinde kendiliğinden açar; bu nedenle bunu yalnızca imzalamayı önceden sunmak için (örneğin bir ayarlar veya onboarding sayfasında) kendiniz bağlayın.


## Related topics

- [Ads API](https://docs.whop.com/tr/api-reference/ads/ad.md)
- [List Ads](https://docs.whop.com/tr/api-reference/ads/list-ads.md)
- [AdsAgreementElement](https://docs.whop.com/tr/elements/latest/ads/ads-agreement.md)
