API'nin kapsamı
UluMob paneli, sizin de çağırabileceğiniz REST API'nin üzerine kuruludur. İstekler ve yanıtlar JSON formatındadır; yollar /api/v1 altında yer alır.
| Kapsam | Neler yapabilirsiniz |
|---|---|
| Kampanyalar | listeleme, oluşturma, güncelleme, duraklatma ve devam ettirme, silme, reklam alanlarını engelleme |
| Kreatifler | görsel, ikon ve video dosyaları yükleme, klasöre göre listeleme |
| Filtreler | hedefleme filtrelerini kaydetme ve yeniden kullanma |
| Takip | postback ayarlarınızı okuma, dönüşüm türlerini düzenleme, gizli anahtarı yenileme, reddedilen postback'leri listeleme |
| Raporlar | tarih, ülke, format, işletim sistemi, cihaz, reklam alanı, kampanya veya reklam bazında gruplama; istek başına en fazla 92 gün |
| Faturalandırma | işlemleri listeleme, kartla bakiye yükleme başlatma |
| Yayıncı siteleri | site ekleme ve doğrulama, reklam alanı oluşturma, etiket kodunu alma |
| Kazançlar | kazançları görüntüleme, ödeme alma yöntemlerini yönetme, yayıncı ödemesi talep etme |
| Hesap | API anahtarlarını listeleme ve iptal etme, referans istatistiklerini görüntüleme |
API anahtarları
Anahtarları paneldeki hesap sayfasından, /app/account adresinden oluşturun. Hangi script'in hangi anahtarı kullandığını bilmek için her anahtara bir ad verin ve geçerlilik süresini 1 ile 3.650 gün arasında seçin (varsayılan 365 gün). Anahtar yalnızca bir kez gösterilir; ardından yalnızca hash değeri saklanır.
Anahtarı bearer token olarak gönderin:
Authorization: Bearer <your key>
Aynı anda en fazla on anahtar tutabilir ve herhangi birini anında iptal edebilirsiniz. Bir anahtar hesabınızın rolleriyle çalışır; reklamveren anahtarı reklamveren endpoint'lerine, yayıncı anahtarı ise yayıncı endpoint'lerine erişir.
Gözetimsiz çalışan script'ler için tasarlandı
- Kolayca işlenebilen doğrulama: hatalar JSON olarak döner; doğrulama hataları alan başına bir mesajla birlikte
422kodu ile gelir. - Paneldeki kuralların aynısı: ülke bazında açık artırma teklifi taban fiyatları, minimum günlük bütçeler, formata göre izin verilen fiyatlandırma modelleri ve kreatif boyut sınırları birebir aynı şekilde uygulanır.
- Güvenli bakiye yükleme: kartla yüklemeler
Idempotency-Keybaşlığı gerektirir; böylece tekrar gönderilen bir istek asla iki kez ücretlendirilmez. - İnceleme yine geçerlidir: yeni kampanyalar ile yeni veya düzenlenmiş reklamlar yayına girmeden önce moderasyondan geçer.
- İstek sınırları: kullanıcı başına dakikada 120 istek; raporlama işleri ve toplu düzenlemeler için yeterlidir.
Yaygın kullanım senaryoları
Açık artırma teklifi yönetimi. Dünkü raporu reklam alanına göre gruplanmış şekilde çekin, dönüşüm başına maliyeti hedefinizle karşılaştırın, ardından kazandıran reklam alanlarında açık artırma tekliflerini yükseltin ve geri kalanları kampanyanın kara listesine ekleyin.
Kendi araçlarınıza raporlama. Harcama, gösterim, tıklama ve dönüşüm verilerini düzenli aralıklarla bir tabloya, veri ambarına veya dashboard'a, ekibinizin okuduğu şekilde gruplanmış olarak aktarın.
Kampanya kopyalama. Tek bir şablondan birçok ülke için aynı kampanyayı, her biri kendi ülke bazlı açık artırma teklifiyle oluşturun.
Yayıncı operasyonları. Sitenizin yeni bir bölümü için reklam alanları oluşturun, etiket kodunu alın ve reklam alanı kalitesini kendi dağıtım script'lerinizden kontrol edin.
Motor endpoint'leri
Reklam sunumunun kendisi ayrı, herkese açık endpoint'lere sahiptir: yayıncı etiketi; JSON, HTML, yönlendirme veya VAST wrapper döndüren özel entegrasyonlar için teslimat endpoint'i ve imzalı dönüşüm postback'i. Bunlar API anahtarı gerektirmez. REST API ile birlikte dokümantasyonda açıklanmıştır.
Anahtarınızı alın
Bir hesap oluşturun, hesap sayfanızı açın ve bir anahtar üretin. Dokümantasyon her endpoint'i parametreleri ve örnek bir kampanya payload'ı ile birlikte listeler. Entegrasyonla ilgili sorularınızı [email protected] adresine iletebilirsiniz.