İçeriğe geç
EN

Rapor API'si

Reklamveren ve yayıncı istatistiklerini JSON olarak çekin; en fazla 92 gün için en fazla dört boyuta göre gruplayın ve ID'ler için okunabilir adlar alın.

Rapor endpoint'i, panel raporuyla aynı toplamları JSON olarak döndürür. Reklamverenlerin ve yayıncıların her birinin kendi yolu vardır. İkisi de https://ulumob.com/api/v1 adresine görelidir:

GET /advertiser/reports
GET /publisher/reports

Her biri yalnızca kendi verilerinizi döndürür: reklamverenler kendi kampanyalarını, yayıncılar kendi reklam alanlarını görür.

Parametreler

Parametre Zorunlu Biçim
from Evet YYYY-MM-DD
to Evet YYYY-MM-DD, from tarihine eşit veya sonrası, en fazla 92 gün sonra
group_by[] Hayır En fazla dört farklı boyut. Varsayılan: date.
geo Hayır ISO ülke kodu, iki büyük harf
format Hayır Bir reklam formatı, örneğin popunder veya in_page_push
os Hayır İşletim sistemi ailesi, en fazla 20 karakter
device Hayır desktop, mobile, tablet veya other
campaign_id Hayır Kampanya ID'si (reklamverenler)
zone_id Hayır Reklam alanı ID'si
website_id Hayır Web sitesi ID'si
subid Hayır Sub-ID, en fazla 100 karakter

Boyutlar

Boyut Reklamveren Yayıncı
date Evet Evet
geo Evet Evet
format Evet Evet
os Evet Evet
device Evet Evet
zone_id Evet Evet
website_id Evet Evet
subid Evet Evet
campaign_id Evet Hayır
ad_id Evet Hayır

website_id ve subid, ister gruplama ister filtre olarak olsun, geo, format, os, device veya ad_id ile birlikte kullanılamaz. Böyle bir istek, mesajı errors.group_by altında olan 422 döndürür. Nedeni için Sub-ID'ler ve siteler sayfasına bakın.

Örnek

Ekim ayında bir kampanya için ülke başına günlük maliyet:

curl -G https://ulumob.com/api/v1/advertiser/reports \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Accept: application/json" \
  --data-urlencode "from=2026-10-01" \
  --data-urlencode "to=2026-10-31" \
  --data-urlencode "group_by[]=date" \
  --data-urlencode "group_by[]=geo" \
  --data-urlencode "campaign_id=815"

Yanıt

{
  "group_by": ["date", "geo"],
  "rows": [
    {"date": "2026-10-01", "geo": "US", "impressions": 48210, "clicks": 312,
     "conversions": 9, "fraud_events": 41, "cost": "72.315000", "revenue": "180.000000"}
  ],
  "names": {}
}

Her satır, gruplama sütunlarını ve ardından metrikleri içerir:

Metrik Kimler görür Anlamı
impressions, clicks, conversions İkisi de Satırın sayıları.
fraud_events İkisi de Kalite kontrolleriyle işaretlenen olaylar. Ücretlendirilmez ve ödenmez.
cost Reklamverenler Sizden tahsil edilen tutar, USD cinsinden.
revenue Reklamverenler Postback'lerinizin bildirdiği ödeme değerlerinin toplamı.
earnings Yayıncılar Reklamverenlerden tahsil edilen tutardan payınız, USD cinsinden.

names haritası

Satırlar ID'leri içerir. names nesnesi bu ID'leri görmenize izin verilen etiketlerle eşler; böylece ek çağrı yapmadan okunabilir tablolar yazdırabilirsiniz:

"names": {
  "campaign_id": {"815": "Pop US mobile"},
  "website_id": {"77": "example.com"}
}
  • Reklamverenler kampanya adlarını ve site alan adlarını alır.
  • Yayıncılar reklam alanı adlarını ve site alan adlarını alır.

Bir harita yalnızca ilgili ID satırlar arasında bulunuyorsa görünür.

Sınırlar

  • Yanıt başına en fazla 5.000 satır. Buna ulaşırsanız tarih aralığını daraltın veya bir boyutu çıkarın.
  • Satırlar gruplama sütunlarına göre sıralanır.
  • Endpoint, dakikada 120 isteklik genel sınırı paylaşır. Raporlar özettir; bu nedenle birkaç dakikadan sık sorgulamak nadiren yeni bir şey getirir. Bkz. Hız sınırları ve hatalar.

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