> ## 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 Groups API

> Ad Group, bir reklam kampanyasının içinde yer alır ve reklamların yayınını kontrol eder. Reklamları için hedef kitleyi, zamanlamayı ve bütçeyi belirler.

Ad Group, bir [reklam kampanyasının](https://docs.whop.com/tr/api-reference/ad-campaigns/ad-campaign) içinde yer alır ve [reklamların](https://docs.whop.com/tr/api-reference/ads/ad) yayınını kontrol eder. Reklamları için hedef kitleyi, zamanlamayı ve bütçeyi belirler.

Kampanyalarda reklam grupları oluşturmak, hedefleme ve yayın ayarlarını listelemek veya almak, bütçeleri ya da hedeflemeyi güncellemek, çalışmayı durdurması gereken grupları silmek ve yayını duraklatmak ya da sürdürmek için Ad Groups API'yi kullanın.

## Uç noktalar

| Uç nokta | İstek |
| - | - |
| [List Ad Groups](https://docs.whop.com/tr/api-reference/ad-groups/list-ad-groups.md) | GET `/ad_groups` |
| [Retrieve an Ad Group](https://docs.whop.com/tr/api-reference/ad-groups/retrieve-an-ad-group.md) | GET `/ad_groups/{id}` |
| [Create an Ad Group](https://docs.whop.com/tr/api-reference/ad-groups/create-an-ad-group.md) | POST `/ad_groups` |
| [Duplicate an Ad Group](https://docs.whop.com/tr/api-reference/ad-groups/duplicate-an-ad-group.md) | POST `/ad_groups/{id}/duplicate` |
| [Pause an Ad Group](https://docs.whop.com/tr/api-reference/ad-groups/pause-an-ad-group.md) | POST `/ad_groups/{id}/pause` |
| [Unpause an Ad Group](https://docs.whop.com/tr/api-reference/ad-groups/unpause-an-ad-group.md) | POST `/ad_groups/{id}/unpause` |
| [Update an Ad Group](https://docs.whop.com/tr/api-reference/ad-groups/update-an-ad-group.md) | PATCH `/ad_groups/{id}` |
| [Delete an Ad Group](https://docs.whop.com/tr/api-reference/ad-groups/delete-an-ad-group.md) | DELETE `/ad_groups/{id}` |

## Hedefleme kısıtlamaları

Reklam grupları [reklamcılık kılavuzunda listelenen ülkeleri](https://docs.whop.com/tr/developer/ads/overview.md#countries-you-cannot-target) hedefleyemez. Bir reklam grubu oluşturma veya hedeflenen ülkelerini güncelleme istekleri, `regions.include.countries` içinde engellenmiş bir ülke içeriyorsa reddedilir.

## Özellikler

**id** `string` *required*

Reklam grubunun `adgrp_` önekli benzersiz tanımlayıcısı.

**ad\_campaign** `object` *required*

Bu reklam grubunun ait olduğu reklam kampanyası.

> [accordion] Özellikler
>
> **id** `string` *required*
>
> Başvurulan varlığın kimliği.

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

**audiences** `object` *required*

Bu reklam grubunun yayın yaptığı veya hariç tuttuğu kayıtlı hedef kitleler.

> [accordion] Özellikler
>
> **exclude** `string[]` *required*
>
> Yayından hariç tutulan, `adaud_` önekli kayıtlı hedef kitle kimlikleri.
>
> **include** `string[]` *required*
>
> Reklam grubunun yayın yaptığı, `adaud_` önekli kayıtlı hedef kitle kimlikleri.

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

Reklam açık artırmasında yayın tekliflerinin nasıl belirlendiği. Hedef tabanlı stratejiler `desired_cost_per_result` kullanır.

Kullanılabilir seçenekler: `minimum_cost`, `average_target`, `maximum_target`

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

Bu reklam grubunun USD cinsinden bütçesi; saklandığı ve faturalandırıldığı para birimi budur. Bütçe bunun yerine kampanyada ayarlandığında `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\_type** `string | null` *required*

`budget_amount` değerinin günlük (`daily`) mi yoksa reklam grubunun tüm süresi boyunca (`lifetime`) mı harcandığı. `lifetime` bir reklam grubu ayrıca başlangıcından en az 24 saat sonra olan bir `ends_at` değerine ihtiyaç duyar.

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

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

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

Optimize edilen piksel olayı. Standart bir olay veya herhangi bir özel piksel olayı adı.

**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*

Reklam grubunun 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\_schedule** `object | null` *required*

Reklam grubunun her hafta yayın yaptığı saatler, güne göre anahtarlanmış. Yayın yapmadığı günler dahil edilmez. Her saatte yayın yaptığında `null`. Bazı platformlar bir zamanlama için, reklam grubunda veya bütçeyi kampanya tuttuğunda kampanyasında, ömür boyu (`lifetime`) bir `budget_type` gerektirir.

> [accordion] Özellikler
>
> **friday** `object[]`
>
> Reklam grubunun cuma günü yayın yaptığı zaman aralıkları, zaman sırasına göre. O gün yayın yapmadığında dahil edilmez.
>
> > [accordion] Özellikler
> >
> > **end** `string` *required*
> >
> > Yayının durduğu zaman; gece yarısı için `24:00`'e kadar 24 saatlik `HH:00` biçiminde. `start` değerinden sonra olmalıdır; gece yarısını geçen bir aralık iki güne bölünür.
> >
> > **start** `string` *required*
> >
> > Yayının başladığı zaman; `00:00` ile `23:00` arasında 24 saatlik `HH:00` biçiminde.
>
> **monday** `object[]`
>
> Reklam grubunun pazartesi günü yayın yaptığı zaman aralıkları, zaman sırasına göre. O gün yayın yapmadığında dahil edilmez.
>
> > [accordion] Özellikler
> >
> > **end** `string` *required*
> >
> > Yayının durduğu zaman; gece yarısı için `24:00`'e kadar 24 saatlik `HH:00` biçiminde. `start` değerinden sonra olmalıdır; gece yarısını geçen bir aralık iki güne bölünür.
> >
> > **start** `string` *required*
> >
> > Yayının başladığı zaman; `00:00` ile `23:00` arasında 24 saatlik `HH:00` biçiminde.
>
> **saturday** `object[]`
>
> Reklam grubunun cumartesi günü yayın yaptığı zaman aralıkları, zaman sırasına göre. O gün yayın yapmadığında dahil edilmez.
>
> > [accordion] Özellikler
> >
> > **end** `string` *required*
> >
> > Yayının durduğu zaman; gece yarısı için `24:00`'e kadar 24 saatlik `HH:00` biçiminde. `start` değerinden sonra olmalıdır; gece yarısını geçen bir aralık iki güne bölünür.
> >
> > **start** `string` *required*
> >
> > Yayının başladığı zaman; `00:00` ile `23:00` arasında 24 saatlik `HH:00` biçiminde.
>
> **sunday** `object[]`
>
> Reklam grubunun pazar günü yayın yaptığı zaman aralıkları, zaman sırasına göre. O gün yayın yapmadığında dahil edilmez.
>
> > [accordion] Özellikler
> >
> > **end** `string` *required*
> >
> > Yayının durduğu zaman; gece yarısı için `24:00`'e kadar 24 saatlik `HH:00` biçiminde. `start` değerinden sonra olmalıdır; gece yarısını geçen bir aralık iki güne bölünür.
> >
> > **start** `string` *required*
> >
> > Yayının başladığı zaman; `00:00` ile `23:00` arasında 24 saatlik `HH:00` biçiminde.
>
> **thursday** `object[]`
>
> Reklam grubunun perşembe günü yayın yaptığı zaman aralıkları, zaman sırasına göre. O gün yayın yapmadığında dahil edilmez.
>
> > [accordion] Özellikler
> >
> > **end** `string` *required*
> >
> > Yayının durduğu zaman; gece yarısı için `24:00`'e kadar 24 saatlik `HH:00` biçiminde. `start` değerinden sonra olmalıdır; gece yarısını geçen bir aralık iki güne bölünür.
> >
> > **start** `string` *required*
> >
> > Yayının başladığı zaman; `00:00` ile `23:00` arasında 24 saatlik `HH:00` biçiminde.
>
> **tuesday** `object[]`
>
> Reklam grubunun salı günü yayın yaptığı zaman aralıkları, zaman sırasına göre. O gün yayın yapmadığında dahil edilmez.
>
> > [accordion] Özellikler
> >
> > **end** `string` *required*
> >
> > Yayının durduğu zaman; gece yarısı için `24:00`'e kadar 24 saatlik `HH:00` biçiminde. `start` değerinden sonra olmalıdır; gece yarısını geçen bir aralık iki güne bölünür.
> >
> > **start** `string` *required*
> >
> > Yayının başladığı zaman; `00:00` ile `23:00` arasında 24 saatlik `HH:00` biçiminde.
>
> **wednesday** `object[]`
>
> Reklam grubunun çarşamba günü yayın yaptığı zaman aralıkları, zaman sırasına göre. O gün yayın yapmadığında dahil edilmez.
>
> > [accordion] Özellikler
> >
> > **end** `string` *required*
> >
> > Yayının durduğu zaman; gece yarısı için `24:00`'e kadar 24 saatlik `HH:00` biçiminde. `start` değerinden sonra olmalıdır; gece yarısını geçen bir aralık iki güne bölünür.
> >
> > **start** `string` *required*
> >
> > Yayının başladığı zaman; `00:00` ile `23:00` arasında 24 saatlik `HH:00` biçiminde.

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

Bu reklam grubundaki reklamların şu anda yayında olup olmadığı ve değilse nedeni. 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: `all_ads_rejected`, `rejected`, `draft`, `campaign_paused`, `paused`, `in_review`, `processing`, `revise_content`, `issues`, `scheduled`, `completed`, `learning`, `active`

**demographics** `object` *required*

Yaş, cinsiyet ve otomatik hedef kitle hedeflemesi.

> [accordion] Özellikler
>
> **automatic** `boolean` *required*
>
> Otomatik hedef kitle hedeflemesinin açık olup olmadığı. `true` olduğunda yayın, belirlediğiniz yaş ve cinsiyetleri öneri olarak ele alarak bunların ötesine ulaşabilir.
>
> **gender** `string` *required*
>
> Hedeflenen cinsiyet.
>
> Kullanılabilir seçenekler: `all`, `male`, `female`
>
> **maximum\_age** `number | null` *required*
>
> Hedeflenen en yüksek yaş. Üst sınır ayarlanmadığında `null`.
>
> **minimum\_age** `number | null` *required*
>
> Hedeflenen en düşük yaş. Alt sınır ayarlanmadığında `null`.

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

Hedeflenecek (`average_target`) veya asla aşılmayacak (`maximum_target`) sonuç başına maliyet. `minimum_cost` teklif verme için `null`.

**devices** `object` *required*

Hedeflenen cihaz platformları ve işletim sistemleri.

> [accordion] Özellikler
>
> **operating\_systems** `object[]` *required*
>
> Hedeflenen işletim sistemleri. Boş olduğunda tüm işletim sistemleri hedeflenir.
>
> > [accordion] Özellikler
> >
> > **minimum\_version** `string`
> >
> > Hedeflenen en düşük işletim sistemi sürümü, örneğin `18.0`. Her sürüm uygun olduğunda yer almaz.
> >
> > **os** `string` *required*
> >
> > Hedeflenen işletim sistemi.
> >
> > Kullanılabilir seçenekler: `ios`, `android`
>
> **platforms** `string[]` *required*
>
> Hedeflenen cihaz türleri. Boş olduğunda tüm cihazlar hedeflenir.
>
> Kullanılabilir seçenekler: `mobile`, `desktop`

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

Reklam grubunun yayını durdurduğu zaman, ISO 8601 zaman damgası olarak. Duraklatılana kadar çalıştığında `null`.

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

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

**impressions** `number` *required*

Gösterim sayısı.

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

Bu reklam grubunu ve reklamlarını etkileyen açık sorunlar. Hiç yoksa boştur.

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

**keywords** `object[]`

Bu reklam grubunun reklamlarının gösterilebileceği arama terimleri ve asla gösterilmeyeceği terimler. Yalnızca arama kampanyalarında geçerlidir; burada her reklam grubunun başlatılmadan önce en az bir terime ihtiyacı vardır.

> [accordion] Özellikler
>
> **match\_type** `string` *required*
>
> Bir aramanın ne kadar yakın eşleşmesi gerektiği: `broad` ilgili aramalara da ulaşır, `phrase` ifadenin anlamını gerektirir ve `exact` terimle aynı anlamı gerektirir. Varsayılan değer `broad`'dur.
>
> Kullanılabilir seçenekler: `broad`, `phrase`, `exact`
>
> **negative** `boolean` *required*
>
> Bu terimin reklamları uygun hale getirmek yerine gösterilmelerini engelleyip engellemediği. Varsayılan değer `false`'tur.
>
> **text** `string` *required*
>
> En fazla 80 karakter ve 10 kelimeden oluşan arama terimi.

**languages** `string[]` *required*

`en` veya `es` gibi ISO 639 kodları olarak hedeflenen diller. ISO kodu olmayan bölgeye özgü bir yerel ayar, sayısal bir yerel ayar anahtarı olarak görünür. Boş olduğunda tüm diller hedeflenir.

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

**learning\_progress** `object | null` *required*

Bu reklam grubunun öğrenme aşamasının ihtiyaç duyduğu dönüşümlere yönelik ilerleme. Öğrenme veya sınırlı öğrenme aşamasında olmadıkça ve geçerli sayılar mevcut olmadıkça null. Eşiğe ulaşmak yayın durumunu belirlemez.

> [accordion] Özellikler
>
> **conversion\_threshold** `integer` *required*
>
> Bu reklam grubunun öğrenme aşamasının ihtiyaç duyduğu dönüşümler. Yayın sırasında değişebilir.
>
> **conversions** `integer` *required*
>
> Bu reklam grubunun öğrenme aşamasında son önemli düzenlemeden bu yana sayılan dönüşümler.
>
> **progress\_percent** `number` *required*
>
> Dönüşümlerin eşiğe bölümü; 0–100 aralığına sınırlandırılmış yüzde olarak. Reklam grubunun `delivery_status` değeri belirleyici olmaya devam eder.

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

**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ı.

**regions** `object` *required*

Hedeflenen ve hariç tutulan konumlar.

> [accordion] Özellikler
>
> **exclude** `object` *required*
>
> Hedeflemeden hariç tutulan konumlar. Ülke grupları hariç tutulamaz.
>
> > [accordion] Özellikler
> >
> > **cities** `object[]` *required*
> >
> > Konum taksonomisine göre anahtarlanmış şehirler.
> >
> > > [accordion] Özellikler
> > >
> > > **key** `string` *required*
> > >
> > > Şehrin konum taksonomisindeki anahtarı.
> > >
> > > **name** `string`
> > >
> > > Şehir adı, örneğin `Austin`. Konum taksonomisinde yoksa yer almaz.
> >
> > **countries** `string[]` *required*
> >
> > `US` gibi ISO 3166-1 alpha-2 kodları olarak ülkeler.
> >
> > **country\_groups** `string[]` *required*
> >
> > `worldwide` veya `europe` gibi çok ülkeli gruplar.
> >
> > **custom\_locations** `object[]` *required*
> >
> > Her biri bir koordinat ve bir yarıçaptan oluşan dairesel alanlar.
> >
> > > [accordion] Özellikler
> > >
> > > **country\_code** `string`
> > >
> > > Noktanın içinde bulunduğu ISO 3166-1 alpha-2 ülke. Kampanyanın, reklam setlerinin ulaştığı ülkeleri beyan etmesi gereken özel bir reklam kategorisi altında gönderin.
> > >
> > > **distance\_unit** `string` *required*
> > >
> > > `radius` için birim.
> > >
> > > Kullanılabilir seçenekler: `mile`, `kilometer`
> > >
> > > **latitude** `number` *required*
> > >
> > > Merkez noktanın enlemi.
> > >
> > > **longitude** `number` *required*
> > >
> > > Merkez noktanın boylamı.
> > >
> > > **name** `string`
> > >
> > > Konum için şehir veya adres gibi bir etiket. Konumun etiketi yoksa yer almaz.
> > >
> > > **radius** `number` *required*
> > >
> > > Merkez noktanın etrafındaki, `distance_unit` cinsinden yarıçap.
> >
> > **regions** `string[]` *required*
> >
> > `US-CA` gibi ISO 3166-2 kodları olarak ABD eyaletleri ve DC. ABD toprakları (`PR`, `GU`, `VI`, `AS`, `MP`) ve ABD dışındaki her yer `countries` üzerinden hedeflenir.
> >
> > **zips** `string[]` *required*
> >
> > `US:78756` gibi `COUNTRY:CODE` olarak anahtarlanmış ZIP ve posta kodları.
>
> **include** `object` *required*
>
> Reklam grubunun hedeflediği konumlar.
>
> > [accordion] Özellikler
> >
> > **cities** `object[]` *required*
> >
> > Konum taksonomisine göre anahtarlanmış şehirler.
> >
> > > [accordion] Özellikler
> > >
> > > **key** `string` *required*
> > >
> > > Şehrin konum taksonomisindeki anahtarı.
> > >
> > > **name** `string`
> > >
> > > Şehir adı, örneğin `Austin`. Konum taksonomisinde yoksa yer almaz.
> >
> > **countries** `string[]` *required*
> >
> > `US` gibi ISO 3166-1 alpha-2 kodları olarak ülkeler.
> >
> > **country\_groups** `string[]` *required*
> >
> > `worldwide` veya `europe` gibi çok ülkeli gruplar.
> >
> > **custom\_locations** `object[]` *required*
> >
> > Her biri bir koordinat ve bir yarıçaptan oluşan dairesel alanlar.
> >
> > > [accordion] Özellikler
> > >
> > > **country\_code** `string`
> > >
> > > Noktanın içinde bulunduğu ISO 3166-1 alpha-2 ülke. Kampanyanın, reklam setlerinin ulaştığı ülkeleri beyan etmesi gereken özel bir reklam kategorisi altında gönderin.
> > >
> > > **distance\_unit** `string` *required*
> > >
> > > `radius` için birim.
> > >
> > > Kullanılabilir seçenekler: `mile`, `kilometer`
> > >
> > > **latitude** `number` *required*
> > >
> > > Merkez noktanın enlemi.
> > >
> > > **longitude** `number` *required*
> > >
> > > Merkez noktanın boylamı.
> > >
> > > **name** `string`
> > >
> > > Konum için şehir veya adres gibi bir etiket. Konumun etiketi yoksa yer almaz.
> > >
> > > **radius** `number` *required*
> > >
> > > Merkez noktanın etrafındaki, `distance_unit` cinsinden yarıçap.
> >
> > **regions** `string[]` *required*
> >
> > `US-CA` gibi ISO 3166-2 kodları olarak ABD eyaletleri ve DC. ABD toprakları (`PR`, `GU`, `VI`, `AS`, `MP`) ve ABD dışındaki her yer `countries` üzerinden hedeflenir.
> >
> > **zips** `string[]` *required*
> >
> > `US:78756` gibi `COUNTRY:CODE` olarak anahtarlanmış ZIP ve posta kodları.

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

**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*

Reklam grubunun yayına başladığı zaman, ISO 8601 zaman damgası olarak. Aktif olur olmaz başladığında `null`.

**status** `string` *required*

Reklam grubunun etkin olup olmadığı. `active` ve `paused` sizin tarafınızdan ayarlanır; `rejected` reklam incelemesinden geçemediği anlamına gelir; `duplicating` hâlâ doldurulmakta olan bir kopyadır.

Kullanılabilir seçenekler: `active`, `paused`, `rejected`, `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.

**title** `string | null` *required*

Reklam grubunun 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*

Reklam grubunun 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 AdGroup theme={null}
{
	"id": "adgrp_xxxxxxxxxxx",
	"ad_campaign": {
		"id": "adcamp_xxxxxxxxxx"
	},
	"added_to_cart_value": 1050,
	"added_to_carts": 24,
	"audiences": {
		"exclude": [],
		"include": ["adaud_xxxxxxxxxxx"]
	},
	"bid_type": "minimum_cost",
	"budget_amount": 100,
	"budget_amount_local": 100,
	"budget_currency": "usd",
	"budget_type": "daily",
	"click_through_rate": 0.036,
	"clicks": 720,
	"completed_registration_value": 0,
	"completed_registrations": 16,
	"contact_value": 0,
	"contacts": 10,
	"conversion_event": "purchase",
	"cost_per_added_to_cart": 8.33,
	"cost_per_click": 0.28,
	"cost_per_completed_registration": 12.5,
	"cost_per_contact": 20,
	"cost_per_lead": 13.33,
	"cost_per_mille": 10,
	"cost_per_purchase": 25,
	"cost_per_result": 25,
	"cost_per_schedule": null,
	"cost_per_submitted_application": null,
	"cost_per_unique_click": 0.33,
	"cost_per_viewed_content": 0.67,
	"created_at": "2026-06-01T12:00:00Z",
	"custom_conversions": 5,
	"custom_event_counts": {
		"QualifiedCall": 4,
		"BookedDemo": 1
	},
	"custom_event_values": {
		"QualifiedCall": 2000,
		"BookedDemo": 0
	},
	"delivery_status": "issues",
	"learning_progress": null,
	"demographics": {
		"automatic": false,
		"minimum_age": 21,
		"maximum_age": 45,
		"gender": "all"
	},
	"delivery_schedule": {
		"monday": [
			{
				"start": "09:00",
				"end": "17:00"
			}
		],
		"tuesday": [
			{
				"start": "09:00",
				"end": "17:00"
			}
		],
		"wednesday": [
			{
				"start": "09:00",
				"end": "17:00"
			}
		],
		"thursday": [
			{
				"start": "09:00",
				"end": "17:00"
			}
		],
		"friday": [
			{
				"start": "09:00",
				"end": "12:00"
			},
			{
				"start": "16:00",
				"end": "20:00"
			}
		],
		"saturday": [
			{
				"start": "10:00",
				"end": "14:00"
			}
		],
		"sunday": [
			{
				"start": "12:00",
				"end": "16:00"
			}
		]
	},
	"desired_cost_per_result": 30,
	"devices": {
		"platforms": ["mobile", "desktop"],
		"operating_systems": [
			{
				"os": "ios",
				"minimum_version": "18.0"
			}
		]
	},
	"ends_at": "2026-07-01T12:00:00Z",
	"frequency": 1.6,
	"impressions": 20000,
	"issues": [
		{
			"id": "adiss_xxxxxxxxxxx",
			"category": "error",
			"title": "Ad issue",
			"message": "The audience is too narrow to deliver. Broaden the targeting to reach more people.",
			"resource_id": "adgrp_xxxxxxxxxxx",
			"resource_type": "ad_group"
		}
	],
	"languages": ["en"],
	"lead_value": 750,
	"leads": 15,
	"link_clicks": 576,
	"purchase_value": 5200,
	"purchases": 8,
	"reach": 12500,
	"regions": {
		"include": {
			"countries": ["US"],
			"country_groups": [],
			"regions": ["US-CA"],
			"cities": [
				{
					"key": "2418779",
					"name": "Miami"
				}
			],
			"zips": [],
			"custom_locations": [
				{
					"latitude": 30.2672,
					"longitude": -97.7431,
					"radius": 10,
					"distance_unit": "mile",
					"name": "Austin, TX"
				}
			]
		},
		"exclude": {
			"countries": [],
			"country_groups": [],
			"regions": [],
			"cities": [
				{
					"key": "2421215",
					"name": "Anchorage"
				}
			],
			"zips": [],
			"custom_locations": [
				{
					"latitude": 40.758,
					"longitude": -73.9855,
					"radius": 2,
					"distance_unit": "mile",
					"name": "Times Square"
				}
			]
		}
	},
	"result_event": "purchase",
	"result_event_name": null,
	"results": 8,
	"return_on_ad_spend": 26,
	"schedule_value": 0,
	"schedules": 0,
	"spend": 200,
	"spend_currency": "usd",
	"starts_at": "2026-06-01T12:00:00Z",
	"status": "active",
	"submitted_application_value": 0,
	"submitted_applications": 0,
	"title": "US founders",
	"unique_click_through_rate": 0.03,
	"unique_clicks": 600,
	"updated_at": "2026-06-02T12:00:00Z",
	"viewed_content_value": 0,
	"viewed_contents": 300
}
```
