Skip to main content
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. 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

Hedefleme kısıtlamaları

Reklam grupları reklamcılık kılavuzunda listelenen ülkeleri hedefleyemez. Bir reklam grubu oluşturma veya hedeflenen ülkelerini güncelleme istekleri, regions.include.countries içinde engellenmiş bir ülke içeriyorsa reddedilir.

Özellikler

string
gerekli
Reklam grubunun adgrp_ önekli benzersiz tanımlayıcısı.
object
gerekli
Bu reklam grubunun ait olduğu reklam kampanyası.

Özellikler

string
gerekli
Başvurulan varlığın kimliği.
number
gerekli
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.
number
gerekli
Whop pikseli tarafından atfedilen sepete ekleme olayları, son tıklama.
object
gerekli
Bu reklam grubunun yayın yaptığı veya hariç tuttuğu kayıtlı hedef kitleler.

Özellikler

string[]
gerekli
Yayından hariç tutulan, adaud_ önekli kayıtlı hedef kitle kimlikleri.
string[]
gerekli
Reklam grubunun yayın yaptığı, adaud_ önekli kayıtlı hedef kitle kimlikleri.
string | null
gerekli
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
number | null
gerekli
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.
number | null
gerekli
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.
string
gerekli
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.
string | null
gerekli
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
number
gerekli
Tıklamaların gösterimlere bölümü, 0 ile 1 arasında.
number
gerekli
Tıklama sayısı.
number
gerekli
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.
number
gerekli
Whop pikseli tarafından atfedilen kayıt tamamlama olayları, son tıklama.
number
gerekli
İ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.
number
gerekli
Whop pikseli tarafından atfedilen iletişim olayları, son tıklama.
string | null
gerekli
Optimize edilen piksel olayı. Standart bir olay veya herhangi bir özel piksel olayı adı.
number | null
gerekli
Harcamanın atfedilen sepete ekleme olaylarına bölümü; hedef bunlar değilse ve hiçbiri atfedilmemişse null.
number
gerekli
Harcamanın tıklamalara bölümü; tıklama yoksa 0.
number | null
gerekli
Harcamanın atfedilen kayıt tamamlama olaylarına bölümü; hedef bunlar değilse ve hiçbiri atfedilmemişse null.
number | null
gerekli
Harcamanın atfedilen iletişim olaylarına bölümü; hedef iletişimler değilse ve hiçbiri atfedilmemişse null.
number | null
gerekli
Harcamanın atfedilen potansiyel müşterilere bölümü; potansiyel müşteriler bir hedef değilse ve hiçbiri atfedilmemişse null.
number
gerekli
1.000 gösterim başına harcama; gösterim yoksa 0.
number | null
gerekli
Harcamanın atfedilen satın almalara bölümü; satın almalar bir hedef değilse ve hiçbiri atfedilmemişse null.
number | null
gerekli
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.
number | null
gerekli
Harcamanın atfedilen randevu olaylarına bölümü; hedef randevular değilse ve hiçbiri atfedilmemişse null.
number | null
gerekli
Harcamanın atfedilen başvuru gönderme olaylarına bölümü; hedef bunlar değilse ve hiçbiri atfedilmemişse null.
number | null
gerekli
Harcamanın benzersiz tıklamalara bölümü; benzersiz tıklama yoksa null.
number | null
gerekli
Harcamanın atfedilen içerik görüntüleme olaylarına bölümü; hedef bunlar değilse ve hiçbiri atfedilmemişse null.
string
gerekli
Reklam grubunun oluşturulduğu zaman, ISO 8601 zaman damgası olarak.
number
gerekli
Tüm özel olay adları genelinde, Whop pikseli tarafından atfedilen özel (satıcı tanımlı) dönüşüm olayları, son tıklama.
object
gerekli
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.
object
gerekli
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.
object | null
gerekli
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.

Özellikler

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.

Özellikler

string
gerekli
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.
string
gerekli
Yayının başladığı zaman; 00:00 ile 23:00 arasında 24 saatlik HH:00 biçiminde.
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.

Özellikler

string
gerekli
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.
string
gerekli
Yayının başladığı zaman; 00:00 ile 23:00 arasında 24 saatlik HH:00 biçiminde.
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.

Özellikler

string
gerekli
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.
string
gerekli
Yayının başladığı zaman; 00:00 ile 23:00 arasında 24 saatlik HH:00 biçiminde.
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.

Özellikler

string
gerekli
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.
string
gerekli
Yayının başladığı zaman; 00:00 ile 23:00 arasında 24 saatlik HH:00 biçiminde.
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.

Özellikler

string
gerekli
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.
string
gerekli
Yayının başladığı zaman; 00:00 ile 23:00 arasında 24 saatlik HH:00 biçiminde.
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.

Özellikler

string
gerekli
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.
string
gerekli
Yayının başladığı zaman; 00:00 ile 23:00 arasında 24 saatlik HH:00 biçiminde.
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.

Özellikler

string
gerekli
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.
string
gerekli
Yayının başladığı zaman; 00:00 ile 23:00 arasında 24 saatlik HH:00 biçiminde.
string
gerekli
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
object
gerekli
Yaş, cinsiyet ve otomatik hedef kitle hedeflemesi.

Özellikler

boolean
gerekli
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.
string
gerekli
Hedeflenen cinsiyet.Kullanılabilir seçenekler: all, male, female
number | null
gerekli
Hedeflenen en yüksek yaş. Üst sınır ayarlanmadığında null.
number | null
gerekli
Hedeflenen en düşük yaş. Alt sınır ayarlanmadığında null.
number | null
gerekli
Hedeflenecek (average_target) veya asla aşılmayacak (maximum_target) sonuç başına maliyet. minimum_cost teklif verme için null.
object
gerekli
Hedeflenen cihaz platformları ve işletim sistemleri.

Özellikler

object[]
gerekli
Hedeflenen işletim sistemleri. Boş olduğunda tüm işletim sistemleri hedeflenir.

Özellikler

string
Hedeflenen en düşük işletim sistemi sürümü, örneğin 18.0. Her sürüm uygun olduğunda yer almaz.
string
gerekli
Hedeflenen işletim sistemi.Kullanılabilir seçenekler: ios, android
string[]
gerekli
Hedeflenen cihaz türleri. Boş olduğunda tüm cihazlar hedeflenir.Kullanılabilir seçenekler: mobile, desktop
string | null
gerekli
Reklam grubunun yayını durdurduğu zaman, ISO 8601 zaman damgası olarak. Duraklatılana kadar çalıştığında null.
number | null
gerekli
Gösterimlerin erişime bölümü.
number
gerekli
Gösterim sayısı.
object[]
gerekli
Bu reklam grubunu ve reklamlarını etkileyen açık sorunlar. Hiç yoksa boştur.

Özellikler

string
gerekli
Sorunun benzersiz tanımlayıcısı.
string
gerekli
Sorunun türü: yayınla ilgili bilgi, bir uyarı veya ilgilenilmesi gereken bir hata.Kullanılabilir seçenekler: information, warning, error
string
gerekli
Sorunun ne olduğunu ve nasıl çözülebileceğini anlatan bir açıklama.
string | null
gerekli
Sorunun bağlı olduğu kampanyanın, reklam grubunun veya reklamın kimliği.
string
gerekli
Sorunun bağlı olduğu kaynağın türü.Kullanılabilir seçenekler: ad_campaign, ad_group, ad
string
gerekli
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.
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.

Özellikler

string
gerekli
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
boolean
gerekli
Bu terimin reklamları uygun hale getirmek yerine gösterilmelerini engelleyip engellemediği. Varsayılan değer false’tur.
string
gerekli
En fazla 80 karakter ve 10 kelimeden oluşan arama terimi.
string[]
gerekli
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.
number
gerekli
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.
number
gerekli
Whop pikseli tarafından atfedilen potansiyel müşteriler, son tıklama.
object | null
gerekli
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.

Özellikler

integer
gerekli
Bu reklam grubunun öğrenme aşamasının ihtiyaç duyduğu dönüşümler. Yayın sırasında değişebilir.
integer
gerekli
Bu reklam grubunun öğrenme aşamasında son önemli düzenlemeden bu yana sayılan dönüşümler.
number
gerekli
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.
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.
number
gerekli
Piksel tarafından atfedilen satın almaların USD değeri.
number
gerekli
Whop pikseli tarafından atfedilen satın almalar, son tıklama.
number
gerekli
Bunu gören benzersiz kişi sayısı.
object
gerekli
Hedeflenen ve hariç tutulan konumlar.

Özellikler

object
gerekli
Hedeflemeden hariç tutulan konumlar. Ülke grupları hariç tutulamaz.

Özellikler

object[]
gerekli
Konum taksonomisine göre anahtarlanmış şehirler.

Özellikler

string
gerekli
Şehrin konum taksonomisindeki anahtarı.
string
Şehir adı, örneğin Austin. Konum taksonomisinde yoksa yer almaz.
string[]
gerekli
US gibi ISO 3166-1 alpha-2 kodları olarak ülkeler.
string[]
gerekli
worldwide veya europe gibi çok ülkeli gruplar.
object[]
gerekli
Her biri bir koordinat ve bir yarıçaptan oluşan dairesel alanlar.

Özellikler

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.
string
gerekli
radius için birim.Kullanılabilir seçenekler: mile, kilometer
number
gerekli
Merkez noktanın enlemi.
number
gerekli
Merkez noktanın boylamı.
string
Konum için şehir veya adres gibi bir etiket. Konumun etiketi yoksa yer almaz.
number
gerekli
Merkez noktanın etrafındaki, distance_unit cinsinden yarıçap.
string[]
gerekli
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.
string[]
gerekli
US:78756 gibi COUNTRY:CODE olarak anahtarlanmış ZIP ve posta kodları.
object
gerekli
Reklam grubunun hedeflediği konumlar.

Özellikler

object[]
gerekli
Konum taksonomisine göre anahtarlanmış şehirler.

Özellikler

string
gerekli
Şehrin konum taksonomisindeki anahtarı.
string
Şehir adı, örneğin Austin. Konum taksonomisinde yoksa yer almaz.
string[]
gerekli
US gibi ISO 3166-1 alpha-2 kodları olarak ülkeler.
string[]
gerekli
worldwide veya europe gibi çok ülkeli gruplar.
object[]
gerekli
Her biri bir koordinat ve bir yarıçaptan oluşan dairesel alanlar.

Özellikler

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.
string
gerekli
radius için birim.Kullanılabilir seçenekler: mile, kilometer
number
gerekli
Merkez noktanın enlemi.
number
gerekli
Merkez noktanın boylamı.
string
Konum için şehir veya adres gibi bir etiket. Konumun etiketi yoksa yer almaz.
number
gerekli
Merkez noktanın etrafındaki, distance_unit cinsinden yarıçap.
string[]
gerekli
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.
string[]
gerekli
US:78756 gibi COUNTRY:CODE olarak anahtarlanmış ZIP ve posta kodları.
string | null
gerekli
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
string | null
gerekli
result_event custom olduğunda satıcı tanımlı olay adı; standart olaylar için null.
number | null
gerekli
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.
number
gerekli
Satın alma değerinin harcamaya bölümü; ikisi de USD cinsinden (para biriminden bağımsız bir oran); harcama yoksa 0.
number
gerekli
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.
number
gerekli
Whop pikseli tarafından atfedilen randevu olayları, son tıklama.
number
gerekli
spend_currency cinsinden tahsil edilen tutar.
string | null
gerekli
Tüm parasal metriklerin ISO 4217 para birimi kodu.
string | null
gerekli
Reklam grubunun yayına başladığı zaman, ISO 8601 zaman damgası olarak. Aktif olur olmaz başladığında null.
string
gerekli
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
number
gerekli
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.
number
gerekli
Whop pikseli tarafından atfedilen başvuru gönderme olayları, son tıklama.
string | null
gerekli
Reklam grubunun görünen adı.
number | null
gerekli
Benzersiz tıklamaların gösterimlere bölümü, 0 ile 1 arasında.
number
gerekli
Whop pikseli tarafından bildirilen, kişi başına bir kez sayılan tıklayan kişiler.
string
gerekli
Reklam grubunun en son güncellendiği zaman, ISO 8601 zaman damgası olarak.
number
gerekli
İç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.
number
gerekli
Whop pikseli tarafından atfedilen içerik görüntüleme olayları, son tıklama.
AdGroup