Bu kılavuz AdPlus Prebid.js bidder adaptörünün kullanımına ait geliştiricilerin ihtiyaç duyacağı bilgileri içermektedir. Burada yer alan yönergeleri izlemeden önce uygulamanızda Prebid.js entegrasyonu yapılmış olmalıdır. Prebid.js entegrasyonu için Prebid.js dökümanlarından faydalanabilirsiniz.
AdPlus Prebid.js bidder adaptör web uygulamalarınıza header bidding yöntemi ile görsel reklamların eklenmesini sağlayan bir Prebid.js adaptörüdür.
AdPlus Prebid.js bidder adaptör aracılığıyla web uygulamalarınıza Banner reklamlar entegre edebilirsiniz.
Bu döküman AdPlus Prebid.js bidder adaptör'ü uygulamanıza nasıl entegre edebileceğinizi anlatır.
Bu bölümde Web uygulamanıza AdPlus reklamlarını Prebid.js aracılığıyla ekleyebilmeniz için gereken adımlar yer almaktadır.
AdPlus Digital ID scriptini uygulamanıza yüklemeniz gereklidir. Bu script sayfanızın <head> tagi içine yerleştirilmelidir.
<script async src="https://ssp.ad-plus.com.tr/sdk/adplus_dg_id.js"></script>Eğer uygulamanızda head tagi içine Digital Id scriptini yerleştiremiyorsanız aşağıdaki scripti body içerisinde de çağırabilirsiniz.
<script type="text/javascript">
(function () {
var e = document.createElement("script");
(e.type = "text/javascript"),
(e.async = !0),
(e.id = "adplusads-dg-id-library"),
(e.src = "https://ssp.ad-plus.com.tr/sdk/adplus_dg_id.js"),
window.top.document.getElementsByTagName("head")[0].appendChild(e);
})();
</script>AdPlus bidder adaptörün çalışabilmesi için Prebid.js konfigürasyonunuza aşağıdaki gibi örnek bir AdPlus bidder adaptöre ait konfigürasyonları sayfanızın <body> tagi içine yerleştirilmelidir. Aşağıdaki örnekte sağlanan parametreler envanter id'si '-1' ve reklam alanı id'si '-3' olan bir reklam birimi için 300 piksel genişlik ve 250 piksel yükseklikte görünecek bir alana header bidding yöntemiyle AdPlus tarafından teklif verilmesini sağlayacaktır.
<script type="text/javascript">
var adUnits = [
{
code: "my-div", // Sayfada reklamı içerek DOM elementi.
mediaTypes: {
banner: {
sizes: [[300, 250]],
},
},
bids: [
{
bidder: "adplus",
params: {
inventoryId: "-1",
adUnitId: "-3",
},
},
],
},
];
</script>Reklam boyutları Adım 2 yer alan örnekteki mediaTypes isimli nesne aracılığı ile sağlanmalıdır. Bu nesnede ilgili reklam tipine ait genişlik ve yükseklik değerlerinin piksel tipinde sağlanması zorunludur. AdPlus bidder adaptör yalnızca banner tipinde reklamları desteklemektedir. AdPlus bidder adaptör için örnek bir mediaTypes nesnesi aşağıdaki gibidir.
mediaTypes: {
banner: {
sizes: [[300, 250]], // Reklamın boyutu piksel tipinde genişlik ve yükseklik değerleri içeren bir array içinde sağlanır
},
},Sayfanıza AdPlus Prebid.js adaptör ile ekleyeceğiniz Banner reklamın zorunlu ve opsiyonel parametreleri aşağıdaki gibi olmalıdır. Bu alanlar Adım 2 de tanımlanamanız gereken nesnede params altında sağlanmalıdır.
Zorunlu Alanlar
Opsiyonel Alanlar
Uygulamanızda yüklü bulunan Prebid.js kütüphanesi aracılığıyla Adım 2'de yer alan AdPlus'a ait nesnenin Prebid.js'e tanımlanması gereklidir. Prebid.js nesnesinin uygulamanızdaki isimlendirilmesine bağlı olarak bu işlem genelde aşağıdaki satırlar aracılığıyla ve addAdUnits metotu ile yapılmaktadır.
<script type="text/javascript">
var adUnits = [
{
code: "my-div", // Sayfada reklamı içerek DOM elementi.
mediaTypes: {
banner: {
sizes: [[300, 250]],
},
},
bids: [
{
bidder: "adplus",
params: {
inventoryId: "-1",
adUnitId: "-3",
},
},
],
},
];
var pbjs = pbjs || {}; // Prebid.js nesnesi
pbjs.addAdUnits(adUnits); // Reklam Birimlerini içeren nesne addAdUnits metotu aracılığıyla Prebid.js'e tanımlanır.
</script>