Skip to main content
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 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: 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 gerekir.
Ads API genel bakışı, 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 sayfasında tanımlanmıştır. Reklamcılığın tek bir hiyerarşisi vardır ve her nesne kendisinin bir üst seviyesine aittir.
adcamp_
Hedefi ve bütçe stratejisini barındırır. Bkz. Reklam Kampanyaları.
adgrp_
Hedeflemeyi, optimizasyon hedefini, zaman planını ve varsayılan olarak kendi bütçesini barındırır. Bkz. Reklam Grupları.
ad_
Kreatifleri, metin varyantlarını, harekete geçirici mesajı ve hedef URL’yi barındırır. Bkz. Reklamlar.
POST /ads 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} 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 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ı 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.
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ı, 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: 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

Bir reklam oluşturun ve yayınlayın

Kreatiften canlı reklama kadar tüm akış, iki çağrıda.

Pikseli kurun

Sonuçların atfedilebilmesi için gereklidir.

Bir kitle oluşturun

Hedeflemek veya hariç tutmak için bir müşteri listesi yükleyin.

Reklam referansı

Her reklam uç noktası, bir deneme alanıyla birlikte.