Skip to main content
Whop Ads, ücretli reklamları doğrudan Whop hesabınızdan harici reklam ağlarında yayınlar. Reklam harcaması, hesabın tüm kampanyaları genelinde yapılandırılmış kartına veya bakiyesine faturalandırılır. Reklam hesabı, inceleme, başlatma ve faturalandırma işlemlerini Whop yürütür. İki API çağrısı sizi sıfırdan yayında bir reklama götürür: bir kreatif oluşturun, ardından kampanyayı, reklam grubunu ve reklamı tek bir istekte oluşturun.

Kaynaklar

Faturalandırma ve ödeme kurtarma

Harcama, kampanyalar genelinde hesap düzeyinde tahsil edilir. Başarısız bir ödeme, her kampanyanın 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, ardından hesap için bir kez Retry Failed Ads Payments çağrısını yapın. Yanıt arka planda bir deneme kuyruğa alır; ödemeyi onaylamaz. Tahsilattan sonra, diğer yayın gereksinimlerine bağlı olarak aktif kampanyalar devam edebilir ve duraklatılmış kampanyalar duraklatılmış kalır. Pano akışı, istek örneği, yinelenen istek davranışı ve eski kampanyaların ele alınması için Reklamlar için ödeme bölümüne bakın.

Tek seferlik kurulum

  • Kapsamlar: media:generate, media:read, ad_campaign:create, ad_campaign:update, ad_campaign:basic:read.
  • Reklam ödeme yöntemi: panoda bağlanır (bakiye veya kart). Yalnızca başlatma için gereklidir — taslaklar onsuz çalışır.
1

Bir kreatif oluşturun

Bakiyenizden faturalandırılır (amount_charged; yetersiz bakiye → deposit_url ile birlikte 402). status ready olana kadar GET /media/{id} uç noktasını yoklayın, ardından file.id değerini kullanın:
failed ücreti iade eder — istemi düzenleyip yeniden deneyin. Video: "type": "video" ile birlikte isteğe bağlı duration_seconds (5/10/15), resolution (480p–4k) ve en fazla 4 reference_media dosya kimliği (ilki açılış karesinin temelini oluşturur).
2

Reklamı oluşturun ve başlatın — tek istek

Satır içi bir ad_group ve ad_campaign ile POST /ads, tüm ağacı tek bir işlemde oluşturur ve başlatır:
Harcamaya hazır değil misiniz? ad_campaign’e "status": "draft" ekleyin, ardından daha sonra PATCH /ad_campaigns/{id} {"status": "active"} ile başlatın.Mevcut kapsayıcıları yeniden kullanmak için ad_group yerine ad_group_id veya ad_campaign yerine ad_campaign_id iletin.
3

İzleyin

GET /ads/{id} uç noktasını yoklayın: delivery_status canlı durumdur (içerik denetimi için kısa bir in_review normaldir) ve issues[], reklam ağının eşzamansız olarak reddettiği her şey için insan tarafından okunabilir bir message içerir.Yayını reklamlar, reklam grupları veya kampanyalar üzerinde pause / unpause ile kontrol edin. Metni veya kreatifleri PATCH /ads/{id} ile düzenleyin — creatives göndermek tüm kümeyi değiştirir, bu nedenle temel girişi de ekleyin.

Hatalar

Her kontrol, mesajı neyin düzeltilmesi gerektiğini söyleyen bir 400 hatasıdır: