Yayıncı API'si

Web sitesi ekleyin ve doğrulayın, reklam alanı oluşturup kodlarını alın, reklam alanı kalitesini kontrol edin, kazançları okuyun ve API üzerinden yayıncı ödemesi talep edin.

Tüm yayıncı endpoint'leri /publisher altında yer alır ve yayıncı rolüne sahip bir hesap gerektirir. 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.

Web siteleri

Yöntem ve yol	Ne yapar
`GET /publisher/websites`	Siteleriniz, reklam alanı sayısıyla birlikte. `per_page` en fazla 100, varsayılan 25.
`POST /publisher/websites`	Bir site ekler. Doğrulama talimatlarıyla birlikte 201 döndürür.
`GET /publisher/websites/{id}`	Reklam alanları ve doğrulama talimatlarıyla tek bir site.
`PUT /publisher/websites/{id}`	Ayrıntıları günceller. Alan adı değiştirilemez.
`DELETE /publisher/websites/{id}`	Siteyi kaldırır ve reklam alanlarını arşivler.
`POST /publisher/websites/{id}/verify`	Doğrulama kodunu kontrol eder. Dakikada en fazla 6 çağrı.

Site oluşturma:

{
  "name": "Example blog",
  "url": "https://example.com",
  "verification_method": "meta_tag",
  "categories": ["technology"],
  "languages": ["en"]
}

verification_method, meta_tag, file_upload veya dns_txt değerlerinden biridir. Yanıttaki verification nesnesi, kodun nereye konacağını (place) ve neyin konacağını (value) söyler. description ve website_type isteğe bağlıdır.

PUT, name, description, category, categories, languages ve website_type alanlarını kabul eder. Reddedilmiş bir siteyi düzenlemek, siteyi yeniden incelemeye gönderir.

verify, kod bulunduğunda verified_at değeri ayarlanmış siteyi, bulunamadığında ise talimatları yeniden içeren 422 döndürür. Doğrulamanın ardından, reklam alanları yayın yapmadan önce manuel bir inceleme gelir. Bkz. Web sitesi ekleme.

Reklam alanları

Yöntem ve yol	Ne yapar
`GET /publisher/zones`	Reklam alanlarınız, sayfa başına 50. `website_id` ile filtreleyin.
`POST /publisher/zones`	Bir reklam alanı oluşturur. Kodlarıyla birlikte `tag` altında 201 döndürür.
`PUT /publisher/zones/{id}`	Bir reklam alanını günceller.
`GET /publisher/zones/{id}/tag`	Reklam alanının kodları.
`DELETE /publisher/zones/{id}`	Hiç reklam göstermemiş bir reklam alanını siler, göstermiş olanı arşivler. `{"status": "deleted"}` veya `{"status": "archived"}` döner.
`GET /publisher/zones/quality`	Reklam alanı başına son 7 gün: gösterim, tıklama, dönüşüm, işaretlenen olaylar, kazanç, CTR ve işaretlenen pay.

Reklam alanı oluşturma:

{
  "website_id": 77,
  "name": "Header banner",
  "format": "banner",
  "banner_size": "728x90",
  "reserve_cpm": 0.5
}

format şunlardan biridir: popunder, push, in_page_push, native, banner, interstitial, redirect, video veya telegram.
banner_size bannerlar için zorunludur, diğer formatlar için kullanılamaz: 300x250, 728x90, 320x50 veya 160x600.
reserve_cpm, kabul ettiğiniz en düşük CPM'dir; USD cinsinden, 0 ile 100 arasında.
anti_adblock (reklam engelleyici atlatma) bir boolean değerdir.
fallback_url, hiçbir kampanya reklam alanını doldurmadığında bu reklam alanında gösterilen isteğe bağlı bir http veya https adresidir (en fazla 2.048 karakter; null kaldırır).
settings, allow_animation, allow_iframes (boolean) ve display_type (inline veya floater) alanlarını içerebilir.

PUT isteğinde website_id, format ve banner_size gönderilemez. name, reserve_cpm, anti_adblock, fallback_url, settings ve status (active, paused veya archived) değiştirilebilir. Silme yoktur; bunun yerine reklam alanını arşivleyin.

tag yanıtında her zaman script bulunur, ayrıca şunlardan biri yer alır:

Anahtar	Formatlar
`direct_url`	`popunder`, `redirect`
`iframe`	`banner`
`vast_url`	`video`
`json_url`	Diğer tüm formatlar

Her birinin nasıl kullanılacağı için Reklam alanı kodları sayfasına bakın.

Raporlar

GET /publisher/reports, campaign_id ve ad_id hariç, reklamveren raporuyla aynı parametreleri alır ve earnings döndürür. Bkz. Rapor API'si.

Kazançlar ve yayıncı ödemeleri

Yöntem ve yol	Ne yapar
`GET /publisher/earnings`	`earnings_balance` (kullanılabilir), `hold_balance` (talep edilmiş, ödenmemiş), `min_payout` ve sayfalanmış `transactions`.
`GET /publisher/payout-methods`	Ödeme alma yöntemleriniz, ayrıntılar maskelenmiş olarak.
`POST /publisher/payout-methods`	Bir ödeme alma yöntemi ekler; hesap şifrenizi `password` alanında, iki adımlı giriş açıksa kodu `code` alanında gönderin. Hesaba e-postayla gönderdiğimiz bağlantıyla onaylanır ve 48 saat sonra ödeme alabilir.
`PUT /publisher/payout-methods/{id}`	`label` ve/veya `details` alanlarını değiştirir; yeni ayrıntılar şifre (ve kod) ile yeniden onay gerektirir.
`DELETE /publisher/payout-methods/{id}`	Yolda yayıncı ödemesi olmayan bir yöntemi kaldırır.
`POST /publisher/payout-methods/{id}/default`	Yöntemi varsayılan yapar.
`POST /publisher/payout-methods/{id}/confirm`	Onay bağlantısını yeniden gönderir.
`POST /publisher/payouts/request`	Yayıncı ödemesi talep eder. Gövde: `{"amount": 150}`; kullanılabilir tutarın tamamı için boş bırakın.

Ödeme alma yöntemi ekleme:

{"method": "usdt_trc20", "details": {"address": "T..."}, "is_default": true}

`method`	`details` alanları
`usdt_trc20`, `bitcoin`	`address`
`paypal`, `payoneer`	`email`
`capitalist`	`account`
`wire`	`account_name`, `iban`, `bic`, `country`

Bir yayıncı ödemesi talebi, beklemedeki işlemle birlikte 201 döndürür; varsayılan ödeme alma yöntemi yoksa, tutar asgari tutarın altındaysa veya kullanılabilir tutarın üzerindeyse ya da son talep 7 günden daha yeniyse 422 döndürür. Bkz. Yayıncı ödemeleri.

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