AdService Hızlı Entegrasyon

AdService Hızlı Entegrasyon Dökümanı

AdService Entegrasyon

head arasına aşağıdaki script eklenir. script async olmak zorundadır ve id değeri değiştirilemez.

<script async id="adservice_gpt_script" src="https://securepubads.g.doubleclick.net/tag/js/gpt.js"></script>
<script async id="adservice_script" src="https://ad.medyanetads.com/adservice/adservice.js"></script>

AdService’in tanımlanması aşağıdaki gibi yapılır. Yukarıda eklenen script’in altına eklenir.

var adservice = adservice || {
	targetings: [],
	adUnits: [],
	oopAdUnits: [],
	interactiveAdUnits: [],
	modules: []
};

Modüllerin Tanımlanması

AdService 9 modülden oluşur. Yayıncı tarafından hangi modüller kullanılacak ise adservice’in modules kısmında tanımlanır.

var adservice = adservice || {
	...
	modules: ['prebid', 'blueKai', 'adsByGoogle', 'neustar', 'veriSmart', 'pg', 'interstitial', 'scroll', 'pauseroll']
};

Ayar tanımlamaları olan modüller aşağıda belirtilmiştir.

Gpt Modül Ayarlarının Tanımlanması

Gpt ayarları aşağıdaki gibi tanımlanır.

Parametre	Açıklama	Tipi
justDestroySendedAdUnits	Bu parametreye “true” geçilirse; infinite sayfalarda sadece push edilen adUnit’lerin destroy edilmesi sağlanır.	boolean

var adservice = adservice || {
	...
	modules: ['gpt'],
	gptSettings: {
		justDestroySendedAdUnits: false
	}
};

Prebid Modül Ayarlarının Tanımlanması

Prebid ayarları aşağıdaki gibi tanımlanır.

Parametre	Açıklama	Tipi
bidders	json dönen URL tanımlanır	string

var adservice = adservice || {
	...
	modules: ['prebid'],
	prebidSettings: {
		bidders: 'https://ad.medyanetads.com/adservice/prebid/xxx_com_tr.json'
	}
};

BlueKai Modül Ayarlarının Tanımlanması

BlueKai ayarları aşağıdaki gibi tanımlanır.

Parametre	Açıklama	Tipi
id	Yayıncının blueKai id’si tanımlanır	integer
pageType	Sayfanın tipi tanımlanır	string

var adservice = adservice || {
	...
	modules: ['blueKai'],
	blueKaiSettings: {
		id: 1453,
		pageType: 'istanbul'
	}
};

VeriSmart Modül Ayarlarının Tanımlanması

VeriSmart ayarları aşağıdaki gibi tanımlanır.

Parametre	Açıklama	Tipi
keywords	Sayfanın anahtar kelimeleri tanımlanır.	array

var adservice = adservice || {
	...
	modules: ['veriSmart'],
	veriSmartSettings: {
		keywords: ['istanbul']
	}
};

P&G Modül Ayarlarının Tanımlanması

P&G ayarları aşağıdaki gibi tanımlanır.

Parametre	Açıklama	Tipi
bpId	MedyaNet’in vereceği değer gönderilir.	string

var adservice = adservice || {
	...
	modules: ['pg'],
	pgSettings: {
		bpId: 'istanbul'
	}
};

Hedeflemelerin Tanımlanması

Sayfa yüklenmeden önce hedeflemeler adservice’in targetings kısmına eklenir.

adservice.targetings.push({ "kategori": "k123" });
adservice.targetings.push({ "contentid": "c123" });

AdUnit’lerin Tanımlanması

Sayfa yüklenmeden önce adUnit’ler adservice’in adUnits kısmına eklenir.

Parametre	Açıklama	Tipi
path	GAM’da tanımlanan adUnit path’i tanımlanır.	string
size	adUnit’lerin boyutları tanımlanır.	array
divId	Reklamın basılacağı div tanımlanır.	string
sizeMappings	adUnit’lerin boyutları tanımlanır.	array

adservice.adUnits.push({
	path: '/166474567/Medyanet-Backfill-Inventory/Cnnturk',
	size: [[728, 90], [300, 250]],
	divId: 'div-gpt-ad-3683233-1',
	sizeMappings: [[[1000, 100], [[728, 90]]], [[200, 100], [[300, 250]]]]
});

OOP AdUnit’lerin Tanımlanması

Sayfa yüklenmeden önce oop adUnit’ler adservice’in oopAdUnits kısmına eklenir.

Parametre	Açıklama	Tipi
path	GAM’da tanımlanan adunit path’i tanımlanır.	string
divId	Reklamın basılacağı div tanımlanır.	string

adservice.oopAdUnits.push({
	path: '/166474567/Medyanet-Backfill-Inventory/Cnnturk',
	divId: 'div-gpt-ad-3683233-1',
});

Interactive AdUnit’lerin Tanımlanması

Sayfa yüklenmeden önce interactive adUnit’ler adservice’in interactiveAdUnits kısmına eklenir.

Parametre	Açıklama	Tipi
path	GAM’da tanımlanan adUnit path’i tanımlanır.	string
size	adUnit’lerin boyutları tanımlanır.	array
divId	Reklamın basılacağı div tanımlanır.	string
sizeMappings	adUnit’lerin boyutları tanımlanır.	array
type	reklam modelinin tipi tanımlanır. interstitial, scroll, pauseroll	string
playerId	Reklam modeli pauseroll ise tanımlanır. Benzersiz bir id atanır.	string

adservice.interactiveAdUnits.push({
	path: '/166474567/Medyanet-Backfill-Inventory/Cnnturk',
	size: [[800, 600], [320, 480]],
	divId: 'div-gpt-ad-3683233-1',
	sizeMappings: [[[1000, 100], [800, 600]],[[100, 100], [320, 480]]],
	type: 'interstitial'
});

Pauseroll reklam modelinde, pause tuşuna basıldığında ilgili yayıncının ilgili business’ı çalıştıktan sonra aşağıdaki event tetiklenmeli.

Event detayında yukarıda belirtilen playerId değeri gönderilmeli.

document.addEventListener('adservice-pauseroll-paused', (e) => {
	//e.detail.playerId
});

Interactive AdUnit’lerin Tanımlanması

Sayfa yüklenmeden önce interactive adUnit’ler adservice’in interactiveAdUnits kısmına eklenir.

document.addEventListener('adservice-gpt-slot', function(event) {
	//console.log(event);
});

event argümanında gönderilecek bilgiler aşağıdaki tablo belirtilmiştir.

Parametre	Açıklama
status	Reklam isteği yapıldığında “adUnitRequested”, reklam yanıtı alındığında “adUnitRenderEnded” yazılır.
adUnitPath	Reklam isteği yapılan veya reklam yanıtı alınan adUnit’in path’i yazılır.
adUnitDivId	Reklam isteği yapılan veya reklam yanıtı alınan adUnit’in divId’si yazılır.
type	Reklam isteği yapılan veya reklam yanıtı alınan adUnit’in tipi yazılır. “interstitial” ve “scroll”. Tanımsız ise interaktif olmayan adUnit’tir.
isEmpty	status “adUnitRenderEnded” ise event’e bu bilgi eklenir. Reklam varsa false, yoksa true yazılır.
width	status “adUnitRenderEnded” ise event’e bu bilgi eklenir. isEmpty false ise reklamın genişliği yazılır. Örneğin 300.
height	status “adUnitRenderEnded” ise event’e bu bilgi eklenir. isEmpty false ise reklamın yüksekliği yazılır. Örneğin 250.

Infinite Kullanımı

Infinite sayfalarda önce yukarıdaki gibi targeting’ler, adUnit’ler ve oopAdUnit’ler eklenir. Daha sonra aşağıdaki metot çağrılır.

adservice.admanager.reInitAds();