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/pausedstatus 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
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 Harcamaya hazır değil misiniz?
ad_group ve ad_campaign ile POST /ads, tüm ağacı tek bir işlemde oluşturur ve başlatır: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 bir400 hatasıdır:

