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

# Ad Campaigns API

> Ad Campaign, ücretli reklamlar için en üst düzey kapsayıcıdır. Reklam grupları ve reklamları tarafından paylaşılan hedefi ve bütçe stratejisini belirler.

Ad Campaign, ücretli reklamlar için en üst düzey kapsayıcıdır. [Reklam grupları](https://docs.whop.com/tr/api-reference/ad-groups/ad-group) ve reklamları tarafından paylaşılan hedefi ve bütçe stratejisini belirler.

Kampanya oluşturmak, bir hesabın kampanyalarını listelemek, kampanya ayarlarını almak veya güncellemek ve kampanya yayınını duraklatmak ya da sürdürmek için Ad Campaigns API'yi kullanın.

Reklam faturalandırması, hesabın kampanyalarındaki uygun harcamaları birleştirir. Başarısız bir ödeme, yapılandırılmış active/paused `status` değerini korurken yayını `delivery_status: payment_failed` ile engeller. Hesabın ödeme yöntemini düzeltin ve hesap için bir kez [reklam ödemesini yeniden deneyin](https://docs.whop.com/tr/api-reference/accounts/retry-failed-ads-payments.md). Yeniden deneme eşzamansızdır: kabul edilmesi ödemeyi onaylamaz. Başarılı tahsilat engeli kaldırır; aktif kampanyalar başka açılardan uygunsa devam edebilir, duraklatılmış kampanyalar ise duraklatılmış kalır. Bkz. [faturalandırma ve yeniden denemeler](https://docs.whop.com/tr/developer/ads/overview.md#paying-for-ads).

## Uç noktalar

| Uç nokta | İstek |
| - | - |
| [List Ad Campaigns](https://docs.whop.com/tr/api-reference/ad-campaigns/list-ad-campaigns.md) | GET `/ad_campaigns` |
| [Retrieve an Ad Campaign](https://docs.whop.com/tr/api-reference/ad-campaigns/retrieve-an-ad-campaign.md) | GET `/ad_campaigns/{id}` |
| [Create an Ad Campaign](https://docs.whop.com/tr/api-reference/ad-campaigns/create-an-ad-campaign.md) | POST `/ad_campaigns` |
| [Duplicate an Ad Campaign](https://docs.whop.com/tr/api-reference/ad-campaigns/duplicate-an-ad-campaign.md) | POST `/ad_campaigns/{id}/duplicate` |
| [Pause an Ad Campaign](https://docs.whop.com/tr/api-reference/ad-campaigns/pause-an-ad-campaign.md) | POST `/ad_campaigns/{id}/pause` |
| [Retry a Failed Ad Campaign Payment](https://docs.whop.com/tr/api-reference/ad-campaigns/retry-a-failed-ad-campaign-payment.md) | POST `/ad_campaigns/{id}/retry_payment` |
| [Unpause an Ad Campaign](https://docs.whop.com/tr/api-reference/ad-campaigns/unpause-an-ad-campaign.md) | POST `/ad_campaigns/{id}/unpause` |
| [Update an Ad Campaign](https://docs.whop.com/tr/api-reference/ad-campaigns/update-an-ad-campaign.md) | PATCH `/ad_campaigns/{id}` |
| [Delete an Ad Campaign](https://docs.whop.com/tr/api-reference/ad-campaigns/delete-an-ad-campaign.md) | DELETE `/ad_campaigns/{id}` |

## Özellikler

**id** `string` *required*

Reklam kampanyasının `adcamp_` önekli benzersiz tanımlayıcısı.

**account** `object | null` *required*

Bu kampanyayı yürüten işletme; reklamlarında gösterilen ad ve logo ile birlikte.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> `biz_` önekli hesap kimliği.
>
> **logo\_url** `string | null` *required*
>
> Hesap logosu görsel URL'si. Hesap bir logo ayarlamadığında `null`.
>
> **route** `string` *required*
>
> `whop.com/\{route}` mağaza yolunda kullanılan, hesabın herkese açık rota tanımlayıcısı.
>
> **title** `string` *required*
>
> Hesabın görünen adı.

**added\_to\_cart\_value** `number` *required*

Sepete ekleme olaylarına atfedilen USD değeri. Her olayla gönderilen değeri USD'ye normalleştirerek toplar; değeri olmayan olaylar 0 katkıda bulunur.

**added\_to\_carts** `number` *required*

Whop pikseli tarafından atfedilen sepete ekleme olayları, son tıklama.

**budget\_amount** `number | null` *required*

Kampanyanın USD cinsinden bütçesi; saklandığı ve faturalandırıldığı para birimi budur. Bunun yerine her reklam grubu kendi bütçesini belirlediğinde `null`.

**budget\_amount\_local** `number | null` *required*

Hesabın reklam raporlama para biriminde gösterilmek üzere, bugünkü döviz kuruyla `budget_currency` cinsinden ifade edilen aynı bütçe. `budget_amount` `null` olduğunda `null`.

**budget\_currency** `string` *required*

`budget_amount_local` değerinin cinsinden olduğu ISO 4217 kodu: hesabın `ads_reporting_currency` tercihi. Hesap değiştirmediği sürece `usd`.

**budget\_optimization** `string | null` *required*

Bütçenin hangi düzeye ait olduğu: kampanyanın tamamı (`ad_campaign`) veya her reklam grubu ayrı ayrı (`ad_group`).

Kullanılabilir seçenekler: `ad_campaign`, `ad_group`

**budget\_type** `string | null` *required*

`budget_amount` değerinin günlük (`daily`) mi yoksa kampanyanın tüm süresi boyunca (`lifetime`) mı harcandığı.

Kullanılabilir seçenekler: `daily`, `lifetime`

**campaign\_type** `string` *required*

Oluşturma sırasında sabitlenen kampanya türü. `standard` görsel ve video reklamları yayınlar; `search`, reklam gruplarının anahtar kelimeleri için arama sonuçlarında metin reklamları gösterir.

Kullanılabilir seçenekler: `standard`, `search`

**click\_through\_rate** `number` *required*

Tıklamaların gösterimlere bölümü, 0 ile 1 arasında.

**clicks** `number` *required*

Tıklama sayısı.

**completed\_registration\_value** `number` *required*

Kayıt tamamlama olaylarına atfedilen USD değeri. Her olayla gönderilen değeri USD'ye normalleştirerek toplar; değeri olmayan olaylar 0 katkıda bulunur.

**completed\_registrations** `number` *required*

Whop pikseli tarafından atfedilen kayıt tamamlama olayları, son tıklama.

**contact\_value** `number` *required*

İletişim olaylarına atfedilen USD değeri. Her olayla gönderilen değeri USD'ye normalleştirerek toplar; değeri olmayan olaylar 0 katkıda bulunur.

**contacts** `number` *required*

Whop pikseli tarafından atfedilen iletişim olayları, son tıklama.

**cost\_per\_added\_to\_cart** `number | null` *required*

Harcamanın atfedilen sepete ekleme olaylarına bölümü; hedef bunlar değilse ve hiçbiri atfedilmemişse null.

**cost\_per\_click** `number` *required*

Harcamanın tıklamalara bölümü; tıklama yoksa 0.

**cost\_per\_completed\_registration** `number | null` *required*

Harcamanın atfedilen kayıt tamamlama olaylarına bölümü; hedef bunlar değilse ve hiçbiri atfedilmemişse null.

**cost\_per\_contact** `number | null` *required*

Harcamanın atfedilen iletişim olaylarına bölümü; hedef iletişimler değilse ve hiçbiri atfedilmemişse null.

**cost\_per\_lead** `number | null` *required*

Harcamanın atfedilen potansiyel müşterilere bölümü; potansiyel müşteriler bir hedef değilse ve hiçbiri atfedilmemişse null.

**cost\_per\_mille** `number` *required*

1.000 gösterim başına harcama; gösterim yoksa 0.

**cost\_per\_purchase** `number | null` *required*

Harcamanın atfedilen satın almalara bölümü; satın almalar bir hedef değilse ve hiçbiri atfedilmemişse null.

**cost\_per\_result** `number | null` *required*

Harcamanın Whop pikseli tarafından atfedilen sonuçlara bölümü; Whop tarafından atfedilebilen hiçbir şey için optimizasyon yapılmıyorsa null.

**cost\_per\_schedule** `number | null` *required*

Harcamanın atfedilen randevu olaylarına bölümü; hedef randevular değilse ve hiçbiri atfedilmemişse null.

**cost\_per\_submitted\_application** `number | null` *required*

Harcamanın atfedilen başvuru gönderme olaylarına bölümü; hedef bunlar değilse ve hiçbiri atfedilmemişse null.

**cost\_per\_unique\_click** `number | null` *required*

Harcamanın benzersiz tıklamalara bölümü; benzersiz tıklama yoksa null.

**cost\_per\_viewed\_content** `number | null` *required*

Harcamanın atfedilen içerik görüntüleme olaylarına bölümü; hedef bunlar değilse ve hiçbiri atfedilmemişse null.

**created\_at** `string` *required*

Kampanyanın oluşturulduğu zaman, ISO 8601 zaman damgası olarak.

**custom\_conversions** `number` *required*

Tüm özel olay adları genelinde, Whop pikseli tarafından atfedilen özel (satıcı tanımlı) dönüşüm olayları, son tıklama.

**custom\_event\_counts** `object` *required*

Olay adınıza göre anahtarlanmış ve değer olarak son tıklama sayısını içeren, Whop pikseli tarafından atfedilen özel dönüşümler. Adlandırılmış özel olay atfedilmemişse boştur. Ad olmadan tetiklenen özel olaylar custom\_conversions içinde sayılır ancak burada yer almaz; bu nedenle bu değerlerin toplamı en fazla custom\_conversions kadardır.

**custom\_event\_values** `object` *required*

Her özel olaya atfedilen dönüşüm değeri; custom\_event\_counts gibi olay adına göre anahtarlanır. whop.track'e iletilen değeri USD'ye normalleştirerek toplar; değer olmadan tetiklenen olaylar 0 katkıda bulunur.

**delivery\_status** `string` *required*

Kampanyanın reklamlarının şu anda yayında olup olmadığı ve değilse nedeni. İçerik incelemesi in\_review'dur; başlamayı bekleyen bir kampanya processing durumundadır. Hesap faturalandırma hataları, yapılandırılmış durumu değiştirmeden payment\_failed ayarlar. Başarılı ödeme yeniden denemesi bu engeli kaldırır ve yayını yeniden hesaplar. Aynı anda birden fazla durum geçerli olduğunda en yüksek önceliğe sahip olan döndürülür.

Kullanılabilir seçenekler: `payment_failed`, `all_ads_rejected`, `draft`, `paused`, `in_review`, `learning`, `processing`, `revise_content`, `issues`, `scheduled`, `completed`, `active`

**desired\_cost\_per\_result** `number | null`

Reklamverenin bu kampanyanın ulaşmasını istediği, USD cinsinden sonuç başına maliyet. Yalnızca bir hedeftir: teklif, 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. Hedef ayarlanmadığında `null`.

**ends\_at** `string | null` *required*

Kampanyanın yayını durdurduğu zaman, ISO 8601 zaman damgası olarak. Duraklatılana kadar çalıştığında veya reklam grupları kendi zamanlamalarını belirlediğinde `null`.

**frequency** `number | null` *required*

Gösterimlerin erişime bölümü.

**impressions** `number` *required*

Gösterim sayısı.

**issues** `object[]` *required*

Kampanyayı ve ona bağlı reklam gruplarını ve reklamları etkileyen açık sorunlar.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> Sorunun benzersiz tanımlayıcısı.
>
> **category** `string` *required*
>
> Sorunun türü: yayınla ilgili bilgi, bir uyarı veya ilgilenilmesi gereken bir hata.
>
> Kullanılabilir seçenekler: `information`, `warning`, `error`
>
> **message** `string` *required*
>
> Sorunun ne olduğunu ve nasıl çözülebileceğini anlatan bir açıklama.
>
> **resource\_id** `string | null` *required*
>
> Sorunun bağlı olduğu kampanyanın, reklam grubunun veya reklamın kimliği.
>
> **resource\_type** `string` *required*
>
> Sorunun bağlı olduğu kaynağın türü.
>
> Kullanılabilir seçenekler: `ad_campaign`, `ad_group`, `ad`
>
> **title** `string` *required*
>
> Sorun için içerik üreticiye yönelik kısa bir başlık: içerik incelemesi reddinin belirttiği kural veya genel bir etiket.

**lead\_value** `number` *required*

Potansiyel müşteri olaylarına atfedilen USD değeri. Her olayla gönderilen değeri USD'ye normalleştirerek toplar; değeri olmayan olaylar 0 katkıda bulunur.

**leads** `number` *required*

Whop pikseli tarafından atfedilen potansiyel müşteriler, son tıklama.

**link\_clicks** `number` *required*

Reklama tıklayan kişilerden hedef sayfanızda gelen ve Whop pikseli tarafından kaydedilen sayfa görüntülemeleri. Her reklam platformunda aynı şekilde sayılır.

**objective** `string | null` *required*

Kampanyanın optimize ettiği hedef. `awareness` yalnızca kullanımdan kaldırılmadan önce oluşturulan kampanyalarda görünür; bu kampanyalar başlatılamaz.

Kullanılabilir seçenekler: `awareness`, `traffic`, `engagement`, `leads`, `sales`

**purchase\_value** `number` *required*

Piksel tarafından atfedilen satın almaların USD değeri.

**purchases** `number` *required*

Whop pikseli tarafından atfedilen satın almalar, son tıklama.

**reach** `number` *required*

Bunu gören benzersiz kişi sayısı.

**result\_event** `string | null` *required*

Atfedilen sayısı sonuçları temsil eden Whop pikseli dönüşüm olayı: optimizasyon hedefi veya reklam grubu başına bütçe belirleyen kampanyalar için en yüksek hacimli atfedilen olay. Hedef Whop tarafından atfedilen bir olay değilse null.

Kullanılabilir seçenekler: `purchase`, `lead`, `schedule`, `submit_application`, `contact`, `complete_registration`, `view_content`, `add_to_cart`, `custom`, `messaging_conversation`

**result\_event\_name** `string | null` *required*

result\_event custom olduğunda satıcı tanımlı olay adı; standart olaylar için null.

**results** `number | null` *required*

result\_event'in arkasındaki, Whop pikseli tarafından atfedilen sayı. Bir kampanyanın reklam grupları farklı hedefleri optimize ettiğinde tek bir result\_event yoktur (null'dır) ve bu değer bunun yerine her reklam grubunun kendi atfedilen sonuçlarının toplamıdır. Whop tarafından atfedilebilen hiçbir şey için optimizasyon yapılmıyorsa null.

**return\_on\_ad\_spend** `number` *required*

Satın alma değerinin harcamaya bölümü; ikisi de USD cinsinden (para biriminden bağımsız bir oran); harcama yoksa 0.

**schedule\_value** `number` *required*

Randevu olaylarına atfedilen USD değeri. Her olayla gönderilen değeri USD'ye normalleştirerek toplar; değeri olmayan olaylar 0 katkıda bulunur.

**schedules** `number` *required*

Whop pikseli tarafından atfedilen randevu olayları, son tıklama.

**special\_ad\_categories** `string[]` *required*

Kampanyanın altında beyan edildiği düzenlemeye tabi kategoriler. Bu kategorilerdeki reklamlar ek hedefleme kısıtlamalarına tabidir. Hiçbiri geçerli değilse boştur.

Kullanılabilir seçenekler: `housing`, `employment`, `financial_products`, `politics`

**spend** `number` *required*

spend\_currency cinsinden tahsil edilen tutar.

**spend\_currency** `string | null` *required*

Tüm parasal metriklerin ISO 4217 para birimi kodu.

**starts\_at** `string | null` *required*

Kampanyanın yayına başladığı zaman, ISO 8601 zaman damgası olarak. Başlatılır başlatılmaz başladığında veya reklam grupları kendi zamanlamalarını belirlediğinde `null`.

**status** `string` *required*

Reklam kampanyasının yapılandırılmış yaşam döngüsü durumu. Faturalandırma hataları burada active veya paused değerini korur ve delivery\_status'u payment\_failed olarak ayarlar.

Kullanılabilir seçenekler: `active`, `paused`, `inactive`, `payment_failed`, `draft`, `duplicating`

**submitted\_application\_value** `number` *required*

Başvuru gönderme olaylarına atfedilen USD değeri. Her olayla gönderilen değeri USD'ye normalleştirerek toplar; değeri olmayan olaylar 0 katkıda bulunur.

**submitted\_applications** `number` *required*

Whop pikseli tarafından atfedilen başvuru gönderme olayları, son tıklama.

**target\_cost\_per\_result** `number | null` *required*

`target_result_event` için USD cinsinden istenen sonuç başına maliyet. Hiçbiri ayarlanmadığında `null`.

**target\_result\_event** `string | null` *required*

`target_cost_per_result` değerinin fiyatlandırıldığı olay; örneğin `purchase` veya `lead`. Kampanyanın tek bir hedefi olmadığında `null`.

**title** `string` *required*

Reklam kampanyasının görünen adı.

**unique\_click\_through\_rate** `number | null` *required*

Benzersiz tıklamaların gösterimlere bölümü, 0 ile 1 arasında.

**unique\_clicks** `number` *required*

Whop pikseli tarafından bildirilen, kişi başına bir kez sayılan tıklayan kişiler.

**updated\_at** `string` *required*

Kampanyanın en son güncellendiği zaman, ISO 8601 zaman damgası olarak.

**viewed\_content\_value** `number` *required*

İçerik görüntüleme olaylarına atfedilen USD değeri. Her olayla gönderilen değeri USD'ye normalleştirerek toplar; değeri olmayan olaylar 0 katkıda bulunur.

**viewed\_contents** `number` *required*

Whop pikseli tarafından atfedilen içerik görüntüleme olayları, son tıklama.

```json AdCampaign theme={null}
{
	"id": "adcamp_xxxxxxxxxx",
	"account": {
		"id": "biz_xxxxxxxxxxxxx",
		"title": "Acme Studio",
		"route": "acme-studio",
		"logo_url": "https://img.whop.com/acme-studio-logo.png"
	},
	"added_to_cart_value": 2100,
	"added_to_carts": 42,
	"budget_amount": 250,
	"budget_amount_local": 250,
	"budget_currency": "usd",
	"budget_optimization": "ad_campaign",
	"budget_type": "daily",
	"campaign_type": "standard",
	"click_through_rate": 0.032,
	"clicks": 1200,
	"completed_registration_value": 0,
	"completed_registrations": 28,
	"contact_value": 0,
	"contacts": 18,
	"cost_per_added_to_cart": 17.86,
	"cost_per_click": 0.63,
	"cost_per_completed_registration": 26.79,
	"cost_per_contact": 41.67,
	"cost_per_lead": 30,
	"cost_per_mille": 20,
	"cost_per_purchase": 50,
	"cost_per_result": 50,
	"cost_per_schedule": null,
	"cost_per_submitted_application": null,
	"cost_per_unique_click": 0.74,
	"cost_per_viewed_content": 1.25,
	"created_at": "2026-06-01T12:00:00Z",
	"custom_conversions": 10,
	"custom_event_counts": {
		"QualifiedCall": 7,
		"BookedDemo": 3
	},
	"custom_event_values": {
		"QualifiedCall": 3500,
		"BookedDemo": 0
	},
	"delivery_status": "issues",
	"ends_at": null,
	"frequency": 2.1,
	"impressions": 37500,
	"issues": [
		{
			"id": "adiss_xxxxxxxxxxx",
			"category": "error",
			"title": "Ad issue",
			"message": "The ad's creative violates the ad network's policies. Edit the creative and resubmit for review.",
			"resource_id": "adcamp_xxxxxxxxxx",
			"resource_type": "ad_campaign"
		}
	],
	"lead_value": 1250,
	"leads": 25,
	"link_clicks": 960,
	"objective": "sales",
	"purchase_value": 12600,
	"purchases": 15,
	"reach": 17800,
	"result_event": "purchase",
	"result_event_name": null,
	"results": 15,
	"return_on_ad_spend": 16.8,
	"schedule_value": 0,
	"schedules": 0,
	"special_ad_categories": [],
	"spend": 750,
	"spend_currency": "usd",
	"starts_at": null,
	"status": "active",
	"submitted_application_value": 0,
	"submitted_applications": 0,
	"target_cost_per_result": 12.5,
	"target_result_event": "purchase",
	"title": "Pickaxe Pro launch",
	"unique_click_through_rate": 0.027,
	"unique_clicks": 1010,
	"updated_at": "2026-06-02T12:00:00Z",
	"viewed_content_value": 0,
	"viewed_contents": 600
}
```


## Related topics

- [Reklam Kampanyaları](https://docs.whop.com/tr/api-reference/legacy/ad-campaigns/ad-campaign.md)
- [Delete an Ad Campaign](https://docs.whop.com/tr/api-reference/ad-campaigns/delete-an-ad-campaign.md)
- [Ad campaign updated](https://docs.whop.com/tr/api-reference/ad-campaigns/ad-campaign-updated.md)
