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

Uç noktalar

Özellikler

string
gerekli
Reklam kampanyasının adcamp_ önekli benzersiz tanımlayıcısı.
object | null
gerekli
Bu kampanyayı yürüten işletme; reklamlarında gösterilen ad ve logo ile birlikte.

Özellikler

string
gerekli
biz_ önekli hesap kimliği.
string | null
gerekli
Hesap logosu görsel URL’si. Hesap bir logo ayarlamadığında null.
string
gerekli
whop.com/\{route} mağaza yolunda kullanılan, hesabın herkese açık rota tanımlayıcısı.
string
gerekli
Hesabın görünen adı.
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.
number | null
gerekli
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.
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
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
string | null
gerekli
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
string
gerekli
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
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.
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
Kampanyanın 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.
string
gerekli
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
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.
string | null
gerekli
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.
number | null
gerekli
Gösterimlerin erişime bölümü.
number
gerekli
Gösterim sayısı.
object[]
gerekli
Kampanyayı ve ona bağlı reklam gruplarını ve reklamları etkileyen açık sorunlar.

Ö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.
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.
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.
string | null
gerekli
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
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ı.
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.
string[]
gerekli
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
number
gerekli
spend_currency cinsinden tahsil edilen tutar.
string | null
gerekli
Tüm parasal metriklerin ISO 4217 para birimi kodu.
string | null
gerekli
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.
string
gerekli
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
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.
number | null
gerekli
target_result_event için USD cinsinden istenen sonuç başına maliyet. Hiçbiri ayarlanmadığında null.
string | null
gerekli
target_cost_per_result değerinin fiyatlandırıldığı olay; örneğin purchase veya lead. Kampanyanın tek bir hedefi olmadığında null.
string
gerekli
Reklam kampanyasının 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
Kampanyanın 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.
AdCampaign