Kampanya API'si

Reklamveren API'siyle kampanya oluşturun, güncelleyin, duraklatın ve silin; kaynakları engelleyin, kaynak listelerini, kreatifleri ve dönüşüm takibini yönetin.

Tüm reklamveren endpoint'leri /advertiser altında yer alır ve reklamveren rolüne sahip bir hesap gerektirir. Aşağıdaki yollar https://ulumob.com/api/v1 adresine görelidir. Göndermeniz gereken başlık için Kimlik doğrulama ve anahtarlar sayfasına bakın.

Kampanya endpoint'leri

Yöntem ve yol	Ne yapar
`GET /advertiser/campaigns`	Sayfalanmış liste, en yeni başta. Filtreler: `status` (`moderation`, `active`, `paused`, `rejected`, `completed`), `format`, `per_page` (en fazla 100, varsayılan 25).
`POST /advertiser/campaigns`	Bir kampanya oluşturur. `moderation` durumunda başlar. 201 döndürür.
`GET /advertiser/campaigns/{id}`	Hedeflemesi ve reklamlarıyla tek bir kampanya.
`PUT /advertiser/campaigns/{id}`	Kampanya ayarlarını ve reklamları değiştirir.
`POST /advertiser/campaigns/{id}/toggle`	Onaylanmış bir kampanyayı `active` ve `paused` arasında geçirir.
`DELETE /advertiser/campaigns/{id}`	Kampanyayı siler. Hemen yayını durdurur; rapor geçmişi kalır.
`POST /advertiser/campaigns/{id}/block`	Bir reklam alanından veya sub-ID'den satın almayı durdurur.

Kampanya gövdesi

{
  "name": "Pop US mobile",
  "format": "popunder",
  "pricing_model": "cpm",
  "bid_amount": 1.5,
  "daily_budget": 50,
  "total_budget": 1000,
  "frequency_cap": {"count": 1, "unit": "impressions", "period_minutes": 1440},
  "targeting": {
    "geos": {"mode": "include", "values": ["US", "CA"]},
    "devices": {"mode": "include", "values": ["mobile"]},
    "blacklist_zones": [123]
  },
  "ads": [
    {"destination_url": "https://tracker.example/c?cid={click_id}&z={zone_id}", "weight": 100}
  ]
}

Temel kurallar:

Format ve fiyatlandırma. Her format belirli fiyatlandırma modellerine izin verir; örneğin popunder cpm veya cpa, push cpc veya cpa, video cpm veya cpv kabul eder. İkisi de oluşturulduktan sonra değiştirilemez.
Açık artırma teklifi. bid_amount, hedeflenen ülkelerin taban fiyatını karşılamalıdır.
Günlük bütçe. En az 15, video için 50.
Reklam alanı teklifleri. zone_bids, {"zone_id": 123, "bid": 0.45} biçiminde bir listedir: o reklam alanında bid_amount yerine kullanılan açık artırma teklifi. Her reklam alanı aktif olmalı ve kampanyayla aynı formatta olmalı; her teklif taban fiyata ulaşmalıdır. En fazla 50 reklam alanı. PUT isteğinde zone_bids göndermek listeyi değiştirir (boş liste temizler), göndermemek korur; GET listeyi döndürür.
Bütçe uyarısı. notify_on_budget (true veya false), günlük bütçe hesap saat diliminize göre her gün ilk kez harcandığında bir e-posta gönderir.
Tamamlandı. Bir kampanya, bitiş tarihi geçtiğinde veya toplam bütçesi harcandığında completed olur. Tamamlanan bir kampanya toggle ile sürdürülemez; PUT ile ends_at veya total_budget değerini uzatın, kampanya active durumuna döner.
Reklamlar. Kampanya başına 1 ile 50 arası. Her formatın ihtiyaç duyduğu alanlar Kreatif özellikleri sayfasında listelenir. Görseller ve simgeler, medya kitaplığınızdan creative_id ve icon_creative_id ile referans verilir.
Hedefleme. Her boyut null (herhangi biri) veya {"mode": "include" | "exclude", "values": [...]} biçimindedir. Boyutlar arasında geos, regions, cities, devices, os, browsers, browser_languages, site_languages, categories, site_types, domains ve subids bulunur. Reklam alanı listeleri düz dizilerdir: whitelist_zones ve blacklist_zones.

PUT isteğinde targeting göndermek onu değiştirir, göndermemek mevcut olanı korur. ads listesinde bulunmayan reklamlar kaldırılır; bir reklamı korumak için mevcut reklamın id değerini ekleyin. Yeni veya düzenlenmiş reklamlar tekrar incelemeye girer.

Doğrulama hatası, alanlara göre anahtarlanmış bir errors nesnesiyle 422 döndürür; örneğin ads.0.creative_id.

Kaynak engelleme

POST /advertiser/campaigns/{id}/block
{"zone_id": 123}

veya {"subid": "partner-a"}. İkisini birden değil, yalnızca birini gönderin. Engellenen bir reklam alanı blacklist_zones listesine eklenir; bir sub-ID ise hariç tutma listesine eklenir ya da kampanya bir dahil etme listesi kullanıyorsa o listeden çıkarılır. Yanıt, güncellenmiş hedeflemedir. Kampanya yeniden incelemeye girmez. Bkz. Kaynakları engelleme.

Kaynak listeleri

Birkaç kampanyaya ekleyebileceğiniz yeniden kullanılabilir listeler:

Yöntem ve yol	Ne yapar
`GET /advertiser/filters`	Listeleriniz, öğeleri ve bağlı `campaign_ids` ile birlikte.
`POST /advertiser/filters`	`{name, type, items, campaign_ids?}`
`PUT /advertiser/filters/{id}`	`name`, `items` ve gönderilirse `campaign_ids` değerlerini değiştirir. Tür sabittir.
`DELETE /advertiser/filters/{id}`	Listeyi siler ve her yerden ayırır.

type şunlardan biridir: zone_include, zone_exclude, domain_include, domain_exclude, subid_include, subid_exclude, isp_exclude, ip_allow veya ip_block. Bir liste 1 ile 10.000 arasında öğe içerir.

Kreatifler

Yöntem ve yol	Ne yapar
`GET /advertiser/creatives`	Filtreler: `kind`, `folder`, `per_page`.
`POST /advertiser/creatives`	Multipart: `kind` (`image`, `icon`, `video`), `file`, `folder?`.
`GET /advertiser/creatives/folders`	Kullanımdaki klasör adları.
`DELETE /advertiser/creatives/{id}`	Bir reklam kullanırken 422 ile reddedilir.

Sınırlar Medya kitaplığı sayfasında listelenir.

Dönüşüm takibi

Yöntem ve yol	Ne yapar
`GET /advertiser/tracking`	Postback URL şablonlarınız, postback gizli anahtarınız ve dönüşüm türleriniz.
`PUT /advertiser/tracking/conversion-types`	`{"conversion_types": [{"letter": "A", "name": "Sale", "is_active": true, "allow_repeats": false}]}`
`POST /advertiser/tracking/rotate-secret`	Yeni bir postback gizli anahtarı verir. Eski anahtarla imzalanan postback'ler anında doğrulanmayı bırakır.
`GET /advertiser/tracking/rejected`	Son 7 gündeki reddedilen en fazla 100 postback, nedeniyle birlikte.

Postback imzalama için Postback kurulumu sayfasına bakın.

Faturalandırma

GET /advertiser/billing/transactions bakiyenizi ve işlemlerinizi döndürür. POST /advertiser/billing/stripe-deposit kartla bir bakiye yükleme işlemi başlatır; bkz. Bakiye yüklemeleri ve makbuzlar.

Eksik ya da hatalı bir şey mi var? Bize bildirin.