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

# Whop Ads ile reklam verin

> Whop hesabınız üzerinden harici reklam ağlarında reklam satın alın; faturalandırma hesap düzeyinde yönetilir.

Reklamcılık, Whop hesabınızdan harici reklam ağlarında reklam satın almanızı sağlar. Reklam hesabı, inceleme ve yayına alma süreci ile faturalandırma ilişkisi Whop'a aittir. Kendi yönettiğiniz bir reklam hesabını bağlamak yerine API üzerinden bir kampanya oluşturursunuz.

## Neler oluşturabilirsiniz

* Bir hedef, bütçe ve zaman planıyla **kampanyalar yürütün**.
* Konum, demografi, ilgi alanları, cihazlar ve dillere göre **bir kitleyi hedefleyin** veya bir müşteri listesini [kitle](https://docs.whop.com/tr/api-reference/audiences/audience) olarak yükleyin.
* Bir istemden yapay zekâ görselleri veya videosu olarak **kreatifler oluşturun**, kendi varlıklarınızı sağlayın ya da bağlı bir harici hesapta zaten mevcut olan bir gönderiyi tanıtın.
* **Atfedilen performansı okuyun**: harcama, sonuçlar, sonuç başına maliyet ve reklam harcamasının getirisi; bunların tümü doğrudan kampanya nesnesinin üzerindedir.

## Hedefleyemeyeceğiniz ülkeler

Whop, kampanyaların şu ülkeleri hedeflemesine izin vermez:

| Ülke | Ülke kodu |
| - | - |
| Sudan | `SD` |
| Rusya | `RU` |
| Küba | `CU` |
| İran | `IR` |
| Kuzey Kore | `KP` |

Bir reklam grubu oluşturma veya hedeflenen ülkelerini güncelleme istekleri, bu kodlardan herhangi birini içeriyorsa reddedilir. İsteği göndermeden önce bunları hedeflenen konumlarınızdan kaldırın.

## Harcama yapmadan önce

Canlı bir reklamın önünde iki koşul vardır ve ikisi de tek seferlik kurulumdur:

* Kontrol panelinde bağlanmış **bir ödeme yöntemi**: Whop bakiyeniz veya bir kart. Taslaklar ödeme yöntemi olmadan da çalışır.
* Trafiği bir whop.com mağaza sayfasına göndermediğiniz sürece, hedef sayfanızda **Whop pikseli**. Herhangi bir harici açılış sayfası için önce [piksel](https://docs.whop.com/tr/developer/ads/pixel.md) gerekir.

[Ads API genel bakışı](https://docs.whop.com/tr/api-reference/ads/overview.md), bunların her birini tam çağrılar, gerekli kapsamlar ve biri eksik olduğunda aldığınız hata metinleriyle birlikte ele alır.

## Temel nesneler

Reklam kampanyası, reklam grubu, reklam, kitle. Her biri [Temel Kavramlar](https://docs.whop.com/tr/developer/concepts.md) sayfasında tanımlanmıştır.

Reklamcılığın tek bir hiyerarşisi vardır ve her nesne kendisinin bir üst seviyesine aittir.

**ad campaign** `adcamp_`

Hedefi ve bütçe stratejisini barındırır. Bkz. [Reklam Kampanyaları](https://docs.whop.com/tr/api-reference/ad-campaigns/ad-campaign).

**ad group** `adgrp_`

Hedeflemeyi, optimizasyon hedefini, zaman planını ve varsayılan olarak kendi bütçesini barındırır. Bkz. [Reklam Grupları](https://docs.whop.com/tr/api-reference/ad-groups/ad-group).

**ad** `ad_`

Kreatifleri, metin varyantlarını, harekete geçirici mesajı ve hedef URL'yi barındırır. Bkz. [Reklamlar](https://docs.whop.com/tr/api-reference/ads/ad).

[`POST /ads`](https://docs.whop.com/tr/api-reference/ads/create-an-ad) satır içi bir `ad_group` kabul eder; bu da satır içi bir `ad_campaign` kabul eder; böylece tek bir istek tüm ağacı tek bir işlemde oluşturur. Reklamı zaten var olan bir reklam grubuna eklemek için bunun yerine `ad_group_id` geçirin.

Hemen değil de daha sonra yayına almak için satır içi `ad_campaign` üzerinde `status` değerini `draft` olarak ayarlayın, ardından [`PATCH /ad_campaigns/{id}`](https://docs.whop.com/tr/api-reference/ad-campaigns/update-an-ad-campaign) ile etkinleştirin.

Bütçe her zaman tam olarak tek bir seviyede bulunur, asla ikisinde birden değil: varsayılan olarak reklam grubunda veya `budget_optimization` değerini `ad_campaign` olarak ayarladığınızda kampanyada.

## Sonuçlar nasıl sayılır

Whop'un raporladığı her performans rakamı reklam ağı tarafından değil, **Whop pikseli** tarafından atfedilir.

`result_event`, bir kampanyanın değerlendirildiği dönüşüm olayını adlandırır ve `results` bu olayın piksel tarafından atfedilen sayısıdır. `cost_per_result`, harcamayı bu sayıya böler. Bir kampanyanın reklam grupları farklı hedeflere göre optimize edildiğinde tek bir `result_event` yoktur; bu durumda değer `null` olur ve `results` her reklam grubunun kendi atfedilen sonuçlarının toplamı haline gelir. Whop tarafından atfedilebilir hiçbir şey için optimizasyon yapılmadığında, ikisi de sıfır yerine `null` olur.

## Hedeflenen sonuç başına maliyet

Bir kampanyanın `desired_cost_per_result` değeri, ulaşmasını istediğiniz USD cinsinden sonuç başına maliyettir. Bu yalnızca bir hedeftir: bir maliyet sınırı veya teklif sınırı değildir ve kampanyanın reklamlarının nasıl teklif verdiğini değiştirmez. Kampanyayı yürüten satış ortakları bunu hedeflenecek sonuç başına maliyet olarak görür. Bir reklam grubunun kendi `desired_cost_per_result` değeri farklı bir ayardır: o, reklam grubunun maliyet sınırı veya teklif sınırıdır. Hedefi temizlemek için kampanyanın `desired_cost_per_result` değerini `null` olarak ayarlayın.

## Reklamlar için ödeme

Harcama, reklamlar yayınlandıkça birikir ve sonrasında tahsil edilir. **Faturalandırma, kampanyaları genelinde hesaba aittir.** Her tahsilat, uygun ödenmemiş kampanya harcamalarını hesabın yapılandırılmış reklam ödeme yöntemlerini kullanarak tek bir ödemede birleştirir. Her kampanya için ayrı bir ödeme yöntemi yapılandırmazsınız veya ayrı bir yeniden deneme talep etmezsiniz. Bir kampanyadaki `spend` alanı, `spend_currency` cinsinden size tahsil edilen tutardır.

Tahsilat zamanlaması biriken harcamaya ve faturalandırma eşiklerine bağlıdır. Birleştirme, günde bir ödeme anlamına gelmez. Yapay zekâ ile kreatif oluşturma kendi bakiye ödemesini kullanır. Yetersiz bakiye, `deposit_url` içeren bir `402` döndürür.

### Bir ödeme başarısız olduğunda

Bir hesap ödeme hatası, hesabın faturalandırılabilir tüm kampanyalarında yayını engeller. Etkilenen her kampanya `delivery_status: "payment_failed"` bildirir; yapılandırılmış `status` değeri ise `active` veya `paused` olarak kalır. Bir kampanyanın yayınlanıp yayınlanamayacağını belirlemek için `delivery_status` değerini, hata nedeni için ise `issues` değerini okuyun.

Hesap, çözülmemiş ödeme hataları varken kampanyaları etkinleştiremez. Ödeme düzeldikten sonra kapalı kalmasını sağlamak için bir kampanyayı yine de duraklatabilirsiniz. Whop ayrıca otomatik yeniden denemeler planlar. Ödeme yöntemini düzelttikten sonra bir yeniden deneme talep edebilirsiniz.

### Bir ödemeyi yeniden deneyin

1. Hesabınızın Ads kontrol panelinde, başarısız ödeme başlığındaki **Update payment method** seçeneğini seçin veya Ads ayarlarını açıp **Billing** seçeneğini seçin. Hesabın kartını güncelleyin veya kullandığı bakiyeye para yükleyin.
2. Hesap için bir kez **Retry payment** seçeneğini seçin. API entegrasyonları, hesabın `biz_` kimliği ve `ad_campaign:update` izniyle [Retry Failed Ads Payments](https://docs.whop.com/tr/api-reference/accounts/retry-failed-ads-payments.md) uç noktasını çağırmalıdır.
3. Arka plandaki denemeyi bekleyin. `queued: true` içeren bir `202` yanıtı, işin kabul edildiğini onaylar, **ödemenin başarılı olduğunu değil**. Sonuç için hesabın [reklam kampanyalarını](https://docs.whop.com/tr/api-reference/ad-campaigns/list-ad-campaigns.md) okuyun.
4. Başarılı bir ödemeden sonra ödeme engeli kalkar. Yayın durumu yeniden hesaplanıp senkronize edilirken `processing` gösterebilir. Etkin olarak yapılandırılmış kampanyalar, diğer yayın gereksinimleri karşılanıyorsa devam edebilir. Duraklatılmış olarak yapılandırılmış kampanyalar duraklatılmış kalır.

```bash theme={null}
curl -X POST "https://api.whop.com/api/v1/accounts/biz_YOUR_ACCOUNT/retry_ads_payment" \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Api-Version-Date: 2026-09-22"
```

```json theme={null}
{ "account_id": "biz_YOUR_ACCOUNT", "queued": true }
```

Bir hesap yeniden denemesi kuyruktayken veya çalışırken yapılan tekrarlanan istekler, beklemenizi isteyen bir hata döndürür. Ödeme yeniden başarısız olursa yayın engelli kalır: tekrar denemeden önce hata nedenini kontrol edin ve ödeme yöntemini düzeltin. Her birini yeniden denemek için kampanyalar üzerinde döngü kurmayın. Eski [kampanya yeniden deneme uç noktası](https://docs.whop.com/tr/api-reference/ad-campaigns/retry-a-failed-ad-campaign-payment.md), `2026-09-22` öncesindeki API sürümlerinde hâlâ bir hesap yeniden denemesini kuyruğa alır. `2026-09-22` ile birlikte `410 Gone` döndürür. Yukarıdaki hesap uç noktasını kullanın.

Yapılandırılmış `status` değeri zaten `payment_failed` olan eski kampanyalar, önceki etkin/duraklatılmış ayarları saklanmadığından başarılı bir yeniden denemeden sonra `paused` durumuna döner.

## Bir kampanya neden yayınlanmıyor

`delivery_status` bunu doğrudan yanıtlar. Bir kampanya var olduğu halde hiçbir şey olmuyorsa okunacak ilk alan budur. Aynı anda birden fazla durum geçerli olabilir; bu nedenle değer, bu sıralamadaki en yüksek durumdur:

| `delivery_status` | Anlamı |
| - | - |
| `payment_failed` | Hesap faturalandırması başarısız oldu. Yapılandırılmış etkin/duraklatılmış ayarı değiştirilmeden yayın engellenir |
| `all_ads_rejected` | Kampanyadaki her reklam reddedildi |
| `draft` | Yayın için gönderilmedi |
| `paused` | Kampanyayı veya içindeki her reklam grubunu duraklattınız ya da kampanyada hiç reklam kalmadı. Bir kampanyanın son reklamını veya reklam grubunu silmek kampanyayı duraklatır |
| `in_review` | Bir reklam hâlâ içerik incelemesinde ve henüz hiçbir şey yayınlanmıyor |
| `learning` | Yayınlanıyor ve hâlâ öğrenme dönemi içinde |
| `processing` | Kampanya henüz reklam ağına ulaşmadı veya her reklam grubu hâlâ işleniyor |
| `revise_content` | Kampanya çalışmayı bekliyor ve içerik incelemesi, bekleyen her reklamı en az bir reklam ağında kapalı tutuyor. Her reklamın `content_review` değerini okuyun |
| `issues` | Kampanyanın açık sorunları var veya her reklamın bir sorunu var. `issues` dizisini okuyun |
| `scheduled` | Kampanyanın başlangıcı gelecekte veya her reklam grubu kendi başlangıcını bekliyor |
| `completed` | Kampanyanın bitiş zamanı geçti. Bitişi olmayan bir kampanya asla tamamlanmaz |
| `active` | Yayınlanıyor |

Reklamlar ve reklam grupları, farklı değerlere sahip kendi `delivery_status` alanlarını taşır. Yeni bir reklam, yayınlanmadan önce `in_review` durumundan geçer.

## Sonraki adımlar

> [card] [Bir reklam oluşturun ve yayınlayın](https://docs.whop.com/tr/api-reference/ads/overview.md)
>
> Kreatiften canlı reklama kadar tüm akış, iki çağrıda.

> [card] [Pikseli kurun](https://docs.whop.com/tr/developer/ads/pixel.md)
>
> Sonuçların atfedilebilmesi için gereklidir.

> [card] [Bir kitle oluşturun](https://docs.whop.com/tr/api-reference/audiences/create-audience.md)
>
> Hedeflemek veya hariç tutmak için bir müşteri listesi yükleyin.

> [card] [Reklam referansı](https://docs.whop.com/tr/api-reference/ad-campaigns/ad-campaign)
>
> Her reklam uç noktası, bir deneme alanıyla birlikte.


## Related topics

- [Ads](https://docs.whop.com/tr/elements/latest/ads/overview.md)
- [Ads API Genel Bakış](https://docs.whop.com/tr/api-reference/ads/overview.md)
- [Elements ile başlarken](https://docs.whop.com/tr/elements/latest/getting-started.md)
