Přeskočit na hlavní obsah

Nativní reklama z Xandru

Požadavek na výdej nativní reklamy

Zápis požadavku na výdej nativní reklamy je stejný jako zápis pro jakoukoliv reklamu dodávanou jako data v objektu (JSON), například:

<div id="ssp-zone-12345"></div>

<script>
sssp.getAds([
{
zoneId: 12345,
id: 'ssp-zone-12345',
width: 300,
height: 250,
callback: function (ads) {
// JS pro zpracování dat, vykreslení reklamy a zobrazení měřících pixelů
},
},
]);
</script>

Element div#ssp-zone-12345 je určený pro vykreslení reklamy callbackovou funkcí. Parametry width a height jsou v případě nativní reklamy bezpředmětné, ale kvůli validitě požadavku je třeba je uvádět (s libovolnými hodnotami) i v případě, kdy se do dané zóny vydává výhradně nativní reklama z Xandru. Pokud se střídá například s nativní reklamou z Skliku, použijí se rozměry nastavené v SSP rozhraní pro Sklik.

Výdej z Xandru v režimu nativní reklamy je podmíněný nastavením hodnoty „Typ média“ v základním nastavení zóny v SSP rozhraní na „Native“ (místo „Banner“). K tomuto nastavení je třeba mít oprávnění. Pokud typ sami změnit nemůžete, zašlete prosím tento požadavek na seznam.partner@firma.seznam.cz.

Struktura dat nativky z Xandru v bid requestu

V rámci bid requestu posílá backend SSP do Xandru níže uvedenou datovou strukturu JSON vyhovující specifikaci:

  • Native v1.1 podle dokumentu OpenRTB Dynamic Native Ads API Specification Version 1.1 (iAB, 2016)1.
  • Native v1.2 podle dokumentu OpenRTB Dynamic Native Ads API Specification Version 1.2 (iAB, 2017)2.

Verze nativní reklamy je určena podle hodnoty "ver" v objektu "native" ("ver": "1.2").

Vždy požadujeme ("required": 1) dva obrázky:

  1. ilustrační obrázek ("type": 3) s poměrem stran 1,91:1 a minimálními rozměry 880 × 460 px ("wmin": 880, "hmin": 460),
  2. obrázek-ikonu ("type": 1) s poměrem stran 1:1 a minimálními rozměry 338 × 338 px ("wmin": 338, "hmin": 338).

Dále požadujeme dva textové řetězce:

  1. nadpis o délce až 50 znaků ("len": 50),
  2. popisek ("type": 2) o délce až 90 znaků ("len": 90).
{
"native": {
"ver": "1.2",
"context": 1,
"contextsubtype": 11,
"plcmttype": 1,
"plcmtcnt": 1,
"assets": [
{
"id": 1,
"required": 1,
"img": {
"wmin": 880,
"hmin": 460,
"type": 3
}
},
{
"id": 2,
"required": 1,
"img": {
"wmin": 338,
"hmin": 338,
"type": 1
}
},
{
"id": 11,
"required": 1,
"title": {
"len": 50
}
},
{
"id": 12,
"required": 1,
"data": {
"type": 2,
"len": 90
}
}
]
}
}

Příklad odezvy SSP obsahující nativní reklamu z Xandru (JSON)

Nativní reklama z Xandru se v odezvě SSP pozná podle specifické kombinace hodnot dvou položek:

  • "type": "native"
  • "dsp": "APPNEXUS"
{
"requestId": "40e04ff7-fc73-45e2-a0ed-e05b8f1532d8",
"ads": [
{
"data": "data odezvy z Xandru (viz níže)",
"type": "native",
"width": 0,
"height": 0,
"responsive": 1,
"tracking": {
"served": [
"https://ssp.seznam.cz/v1/impress?r=40e04ff7-fc73-45e2-a0ed-e05b8f1532d8&z=179421&i=0&sid=16788573327959960715&s=3w_nrajmuDQ1KvIDOgbz"
],
"visible": [
"https://ssp.seznam.cz/v1/visibleimpress?r=40e04ff7-fc73-45e2-a0ed-e05b8f1532d8&z=179421&i=0&sid=16788573327959960715&s=rVqe0xLnPC_lXwLcFfPd"
]
},
"zoneId": 123456,
"zoneName": "nativka.xandr",
"dsp": "APPNEXUS",
"iframe": 0
}
]
}

Příklad dat odezvy z Xandru (hodnota položky data)

Stejné položky bid requestu a odezvy lze poznat podle totožné hodnoty identifikátoru id.

Obrázky:

  1. ilustrační obrázek ("id": 1) s poměrem stran 1,91:1 dodán v rozměrech 1 200 × 627 px,
  2. obrázek-ikona ("id": 2) s poměrem stran 1:1 dodán v rozměrech 338 × 338 px.

Textové řetězce:

  1. nadpis ("id": 11) dodán v maximální délce 50 znaků (může být kratší),
  2. popisek ("id": 12) dodán v maximální délce 90 znaků (může být kratší).

Položka link.url obsahuje URL cílové stránky s měřením prokliku.

Měření imprese v Native v1.1:

  • pole imptrackers obsahuje URL průhledných obrázků o rozměru 1×1 px pro měření zobrazení (obecně 0..n URL).
  • položka jstracker může obsahovat JS pro měření imprese.

Měření impresí oběma způsoby je ekvivalentní, stačí tedy buď provolat URL v poli imptrackers, nebo provést skript z položky jstracker.

Měření imprese v Native v1.2:

  • pole eventtrackers obsahuje objekty s položkami event, method a url:
    • event - událost, která se má měřit,
    • method - metoda měření události,
    • url - url pro měření události.

Více informací můžete najít v IAB dokumentaci kapitole 7.6 Event Types Table a 7.7 Event Tracking Methods Table.

{
"native": {
"assets": [
{
"id": 1,
"img": {
"url": "https://s1.adform.net/Banners/Elements/Files/87415/7980265.jpg?bv=1",
"w": 1200,
"h": 627,
"ext": {
"appnexus": {
"prevent_crop": 0
}
}
}
},
{
"id": 2,
"img": {
"url": "https://s1.adform.net/Banners/Elements/Files/87415/7980264.jpg?bv=1",
"w": 338,
"h": 338,
"ext": {
"appnexus": {
"prevent_crop": 0
}
}
}
},
{
"id": 11,
"title": {
"text": "Kadeřnictví nedaleko centra je plné lidských osudů"
}
},
{
"id": 12,
"data": {
"value": "Otevřeně a s nadsázkou s vámi hrdinky seriálu Kadeřnictví sdílí své životní výhry i prohry"
}
}
],
"link": {
"url": "https://fra1-ib.adnxs.com/click?sZL1Thzy-T8mGVVFpJ_3P3sUrkfheoQ_JhlVRaSf9z…"
},

// Pro Native v1.1
"imptrackers": [
"https://fra1-ib.adnxs.com/it?an_audit=0&referrer=http%3A%2F%2Fwww.seznam.cz&e=wqT_3QLRC_BM0QUAAAM…",
"https://fra1-ib.adnxs.com/ot?ps=d718f9945eccdaf75de9983304bd7ad7746b07c8&pe=wqT_3QJeAAAAAwDqAAZL1Thzy…"
],
"jstracker": "<script type=\"text/javascript\" async=\"true\" src=\"https://cdn.adnxs.com/v/s/191/trk.js#v;vk=appnexus.com-omid;tv=native1-18hs;dom_id=%native_dom_id%;st=0;d=1x1;vc=iab;vid_ccr=1;tag_id=18409182;cb=https%3A%2F%2Ffra1-ib.adnxs.com%2Fvevent%3Fan_audit%3D0%26referrer%3Dhttp%253A%252F%252Fwww.seznam.cz%26e%3DwqT_3QLRC_.%26s%3D78c867ac1a90814473f7b562d10e064c31cdec67;ts=1595321514;cet=0;cecb=\">",

// Pro Native v1.2
"eventtrackers": [
{
"event": 1,
"method": 1,
"url": "https://fra1-ib.adnxs.com/it?an_audit=0&referrer=http%3A%2F%2Fwww.seznam.cz&e=wqT_3QLRC_BM0QUAAAM…"
}
]
}
}

Zdroje

[1] OpenRTB Dynamic Native Ads API Specification Version 1.1. Iab.com [online]. New York: IAB, 2016 [cit. 2020-08-04]. Dostupné z: https://www.iab.com/wp-content/uploads/2016/03/OpenRTB-Native-Ads-Specification-1-1_2016.pdf.

[2] OpenRTB Dynamic Native Ads API Specification Version 1.2. Iab.com [online]. New York: IAB, 2017 [cit. 2024-08-14]. Dostupné z: https://www.iab.com/wp-content/uploads/2018/03/OpenRTB-Native-Ads-Specification-Final-1.2.pdf.