Дисплей и Видео 360 работает со множеством сторонних серверов объявлений. С помощью целого ряда макросов для отслеживания кликов и очистки кеша эти сторонние инструменты могут регистрировать клики по медийным креативам, которые демонстрируются через Дисплей и Видео 360.
Когда вы добавите в Дисплей и Видео 360 тег объявления от одобренного стороннего партнера, макросы для отслеживания кликов и очистки кеша будут вставлены автоматически. Если наш сервис не поддерживает этот тег, необходимо вставить макрос самостоятельно. Каждый сторонний тег медийной рекламы имеет особенности, но для справки вы можете изучить примеры ниже.
Что такое макрос?
Макрос – это плейсхолдер (например, ${CLICK_URL}
), вместо которого сервер объявлений при показе креатива подставляет определенное значение. Если вы добавите макросы в свои теги, Дисплей и Видео 360 будет вставлять информацию в эти теги в режиме реального времени.
Допустим, вы используете следующий тег стороннего объявления:
<script type="text/javascript" src="http://example.com?click="></script>
После строки click=
сторонний сервер объявлений ожидает URL отслеживания кликов от Дисплея и Видео 360. Чтобы получить этот URL, вставьте макрос для отслеживания кликов в тег:
<script type="text/javascript" src="http://example.com?click=${CLICK_URL}"></script>
Вместо плейсхолдера ${CLICK_URL}
будет подставляться настоящий URL для отслеживания кликов, который передается из Дисплея и Видео 360.
Примеры использования
Макросы отслеживания кликов и очистки кеша
Макрос отслеживания кликов – это самый распространенный вид макроса. Такие макросы позволяют сторонним серверам объявлений отслеживать клики и соотносить их с нужным креативом, кампанией или аукционом в Дисплее и Видео 360. Когда пользователь нажимает на креатив, информация об этом сначала поступает на сервер объявлений Дисплея и Видео 360, что позволяет зарегистрировать клик и связанную с ним информацию об аукционе. Только после этого происходит перенаправление на URL издателя.
Макрос очистки кеша вставляет случайное число в URL запроса объявления, что предотвращает показ кешированного объявления в случае, если пользователь возвращается к странице с ним.
Поддерживаемые макросы отслеживания кликов и очистки кеша:
${CLICK_URL}
${CLICK_URL_ENC}
${CLICK_URL_ENC_ENC}
${CLICK_POINTROLL}
${CACHEBUSTER}
CLICK_URL
не будут работать с креативами, которые размещаются с помощью Дисплея и Видео 360.Макросы для видео
Не все макросы, которые поддерживаются в Дисплее и Видео 360, можно использовать с видеокреативами. Ниже приведен список поддерживаемых макросов для видеокреативов:
${CREATIVE_ID}
${CAMPAIGN_ID}
${INSERTION_ORDER_ID}
${AUCTION_ID}
${CACHEBUSTER}
${PUBLISHER_ID}
${UNIVERSAL_SITE_ID}
${SOURCE_URL}
${SOURCE_URL_ENC}
${PIXEL_ID_COMMA}
и CLICK_URL
не поддерживаются.Примеры тегов и макросов
В приведенных ниже примерах показано, в каком разделе кода необходимо вставить макросы отслеживания кликов и очистки кеша для некоторых сторонних серверов объявлений.
Теги Celtra
Код без макроса отслеживания кликов:
<div class="celtra-ad-v3">
<img src="data:image/png,celtra" style="display: none" onerror="
(function(img) {
var params = {'clickUrl':'http://celtra.com/','preferredClickThroughWindow':'new','clickEvent':'advertiser','externalAdServer':'Custom'};
var req = document.createElement('script');
req.id = params.scriptId = 'celtra-script-' + (window.celtraScriptIndex = (window.celtraScriptIndex||0)+1);
params.clientTimestamp = new Date/1000;
var src = (window.location.protocol == 'https:' ? 'https' : 'http') + '://ads.celtra.com/65fb825c/mraid-ad.js?';
for (var k in params) {
src += '&' + encodeURIComponent(k) + '=' + encodeURIComponent(params[k]);
}
req.src = src;
img.parentNode.insertBefore(req, img.nextSibling);
})(this);
"/></div>
Код с макросом отслеживания кликов:
<div class="celtra-ad-v3">
<img src="data:image/png,celtra" style="display: none" onerror="
(function(img) {
var params = {'clickUrl':'${CLICK_URL}','preferredClickThroughWindow':'new','clickEvent':'advertiser','externalAdServer':'Custom'};
var req = document.createElement('script');
req.id = params.scriptId = 'celtra-script-' + (window.celtraScriptIndex = (window.celtraScriptIndex||0)+1);
params.clientTimestamp = new Date/1000;
var src = (window.location.protocol == 'https:' ? 'https' : 'http') + '://ads.celtra.com/65fb825c/mraid-ad.js?';
for (var k in params) {
src += '&' + encodeURIComponent(k) + '=' + encodeURIComponent(params[k]);
}
req.src = src;
img.parentNode.insertBefore(req, img.nextSibling);
})(this);
"/></div>
Теги Conversant (ранее – Mediaplex)
Код без макроса отслеживания кликов:
<a href="http://adfarm.mediaplex.com/ad/ck/1091-86796-2738-5?mpt=[CACHEBUSTER]">
<img src="http://adfarm.mediaplex.com/ad/bn/1234-12345-1234-1?mpt=[CACHEBUSTER]"?alt="Click Here" border="0"></a></noscript>
Код с макросом отслеживания кликов:
<a href="${CLICK_URL}http://adfarm.mediaplex.com/ad/ck/1234-12345-1234-1?mpt=${CACHEBUSTER}"> <img src="http://adfarm.mediaplex.com/ad/bn/1091-86796-2738-5?mpt=${CACHEBUSTER}"alt="Click Here" border="0"></a></noscript>
${CLICK_URL_ENC}
, но иногда им нужен дважды закодированный макрос ${CLICK_URL_ENC_ENC}
. Если ваш сервер объявлений не указывает, какой из этих макросов использовать, вы можете проверить отслеживание кликов через Дисплей и Видео 360 во время размещения рекламы.Теги JavaScript Менеджера кампаний 360
Код без макроса отслеживания кликов:
<SCRIPT language='JavaScript1.1' SRC="https://ad.doubleclick.net/ddm/adj/Nxxxx.site-keyname/Byyyyyyy;sz=widthxheight;dc_expa=URL;ord=[timestamp];dc_lat=N;dc_rdid=Czzzz;tag_for_child_directed_treatment=I;kw=[keyword];click=?">
Код с макросом отслеживания кликов:
<SCRIPT language='JavaScript1.1' SRC="https://ad.doubleclick.net/ddm/adj/Nxxxx.site-keyname/Byyyyyyy;sz=widthxheight;dc_expa=URL;ord=${CACHEBUSTER};dc_lat=N;dc_rdid=Czzzz;tag_for_child_directed_treatment=I;kw=[keyword];click=
${CLICK_URL}?">
Теги ins Менеджера кампаний 360
Если вы используете теги ins Менеджера кампаний 360, добавьте параметр data-dcm-click-tracker
и задайте значение макроса ${CLICK_URL}
. Кроме того, чтобы избежать расхождений в отчетах, используйте режим обработки скриптов, а не окна iframe (присвойте атрибуту data-dcm-rendering-mode значение script: data-dcm-rendering-mode='script'
).
Ознакомьтесь с более подробной информацией о добавлении тега ins в Справочном центре Менеджера кампаний 360.
Код без макроса отслеживания кликов:
<ins class='dcmads'
style='display:inline-block;width:300px;height:250px'
data-dcm-placement='N7480.1664088DOUBLECLICK.NETTEST/B8299600.114131924'
data-dcm-param-custom_key='custom_value'
data-dcm-rendering-mode='script'>
<script src='https://googletagservices.com/dcm/dcmads.js'></script>
</ins>
Код с макросом отслеживания кликов:
<ins class='dcmads'
style='display:inline-block;width:300px;height:250px'
data-dcm-placement='N7480.1664088DOUBLECLICK.NETTEST/B8299600.114131924'
data-dcm-rendering-mode='script'
data-dcm-click-tracker='${CLICK_URL}'>
<script src='https://googletagservices.com/dcm/dcmads.js'></script>
</ins>
Теги i-frame/JavaScript Менеджера кампаний 360
Код без макроса отслеживания кликов:
<IFRAME SRC="https://ad.doubleclick.net/ddm/adi/Nxxxx.site-keyname/Byyyyyyy;sz=widthxheight;ord=[timestamp];dc_lat=N;dc_rdid=Czzzz;tag_for_child_directed_treatment=I;kw=[keyword];click=?" WIDTH=X HEIGHT=Y MARGINWIDTH=0 MARGINHEIGHT=0 HSPACE=0 VSPACE=0 FRAMEBORDER=0 SCROLLING=no BORDERCOLOR='#000000'>
<SCRIPT language='JavaScript1.1' SRC="https://ad.doubleclick.net/ddm/adj/Nxxxx.site-keyname/Byyyyyyy;abr=!ie;sz=widthxheight;ord=[timestamp];dc_lat=N;dc_rdid=Czzzz;tag_for_child_directed_treatment=I;kw=[keyword];click=?">
</SCRIPT>
</IFRAME>
Код с макросом отслеживания кликов:
<IFRAME SRC="https://ad.doubleclick.net/ddm/adi/Nxxxx.site-keyname/Byyyyyyy;sz=widthxheight;ord=${CACHEBUSTER};dc_lat=N;dc_rdid=Czzzz;tag_for_child_directed_treatment=I;kw=[keyword];click=${CLICK_URL}" WIDTH=X HEIGHT=Y MARGINWIDTH=0 MARGINHEIGHT=0 HSPACE=0 VSPACE=0 FRAMEBORDER=0 SCROLLING=no BORDERCOLOR='#000000'>
<SCRIPT language='JavaScript1.1' SRC="https://ad.doubleclick.net/ddm/adj/Nxxxx.site-keyname/Byyyyyyy;abr=!ie;sz=widthxheight;ord=${CACHEBUSTER};dc_lat=N;dc_rdid=Czzzz;tag_for_child_directed_treatment=I;kw=[keyword];click=${CLICK_URL}?">
</SCRIPT>
</IFRAME>
Теги FlashTalking и DoubleVerify
Код без макроса отслеживания кликов:
<script language="javascript" type="text/javascript">
new function() {
this.rand = Math.floor((Math.random() + "") * 1000000000000);
this.dvparams = 'ctx=12345&cmp=12345&plc=12345&sid=12345';
this.dvregion = '0';
this.tagsrc = '<noscr'+'ipt>\n<a href="http://servedby.flashtalking.com/
click/4/12345;12345;0;12345;0/?url=12345" target="_blank">\n
<img border="0" src="http://servedby.flashtalking.com/imp/4/12345;12345;12345;gif;
FIOS112MDUInviteBT2DallasDMAMPG3160x600FT213to331/?"></a>\n
</noscr'+'ipt>\n<scr'+'ipt language="Javascr'+'ipt1.1" type="text/javascr'+'ipt">
\nvar ftClick = "";\nvar ftX = "";\nvar ftY = "";\nvar ftZ = "";\nvar ftContent = "";
\nvar ftCustom = "";\nvar ft160x600_OOBclickTrack = "";\nvar ftRandom = Math.random()*1000000;
\nvar ftBuildTag1 = "<scr";\nvar ftBuildTag2 = "</";\nvar ftTag = ftBuildTag1 +
'ipt language="javascr'+'ipt1.1" type="text/javascr'+'ipt" ';nftTag +=
'src="http://servedby.flashtalking.com/imp/4/12345;12345;12345;js;
FIOS112MDUInviteBT2DallasDMAMPG3160x600FT213to331/?click='+ftClick+'&
ftx='+ftX+'&fty='+ftY+'&ftadz='+ftZ+'&ftscw='+ftContent+'&
ft_custom='+ftCustomn+'&cachebuster='+ftRandom+'" id="ftscr'+'ipt_160x600"
name="ftscr'+'ipt_160x600"';nftTag += '">' + ftBuildTag2 + 'scr'+'ipt>
';ndocument.write(ftTag);\n</scr'+'ipt>nn';
this.altsrc = '<a href="http://example.com/defaultads/comp160x600.gif"
width="160" height="600" border="0"></a>';
this.callbackName = '__dvredirect_callback_' + this.rand;
var thisRedirect = this;
window[this.callbackName] = function () { return thisRedirect; };
var src = 'http://rtbcdn.doubleverify.com/bsredirect5.js?callback=' + this.callbackName;
document.write('<scr' + 'ipt src=' + src + '></scr' + 'ipt>');
}
</script>
Код с макросом отслеживания кликов:
<script language="javascript" type="text/javascript">
new function() {
this.rand = Math.floor((Math.random() + "") * 1000000000000);
this.dvparams = 'ctx=12345&cmp=12345&plc=12345&sid=12345';
this.dvregion = '0';
this.tagsrc = '<noscr'+'ipt>\n<a href="${CLICK_URL}http://servedby.flashtalking.com/
click/4/12345;12345;0;12345;0/?url=1419304" target="_blank">\n
<img border="0" src="http://servedby.flashtalking.com/imp/4/12345;12345;12345;gif;
FIOS112MDUInviteBT2DallasDMAMPG3160x600FT213to331/?"></a>\n
</noscr'+'ipt>\n<scr'+'ipt language="Javascr'+'ipt1.1" type="text/javascr'+'ipt">
\nvar ftClick = "${CLICK_URL_ENC}";\nvar ftX = "";\nvar ftY = "";\nvar ftZ = "";\nvar ftContent = "";
\nvar ftCustom = "";\nvar ft160x600_OOBclickTrack = "";\nvar ftRandom = Math.random()*1000000;
\nvar ftBuildTag1 = "<scr";\nvar ftBuildTag2 = "</";\nvar ftTag = ftBuildTag1 +
'ipt language="javascr'+'ipt1.1" type="text/javascr'+'ipt" ';nftTag +=
'src="http://servedby.flashtalking.com/imp/4/12345;12345;12345;js;
FIOS112MDUInviteBT2DallasDMAMPG3160x600FT213to331/?click='+ftClick+'&
ftx='+ftX+'&fty='+ftY+'&ftadz='+ftZ+'&ftscw='+ftContent+'&
ft_custom='+ftCustomn+'&cachebuster='+ftRandom+'" id="ftscr'+'ipt_160x600"
name="ftscr'+'ipt_160x600"';nftTag += '">' + ftBuildTag2 + 'scr'+'ipt>
';ndocument.write(ftTag);\n</scr'+'ipt>nn';
this.altsrc = '<a href="http://example.com/defaultads/comp160x600.gif"
width="160" height="600" border="0"></a>';
this.callbackName = '__dvredirect_callback_' + this.rand;
var thisRedirect = this;
window[this.callbackName] = function () { return thisRedirect; };
var src = 'http://rtbcdn.doubleverify.com/bsredirect5.js?callback=' + this.callbackName;
document.write('<scr' + 'ipt src=' + src + '></scr' + 'ipt>');
}
</script>
Теги Sizmek
Please note, Display & Video 360 will automatically insert click tracking macros into your Sizmek tags for you.
Теги 1-го типа
Код без макроса отслеживания кликов:
<noscript>
<a href="http://bs.serving-sys.com/BurstingPipe/BannerRedirect.asp?FlightID=1234567&Page=&PluID=0&Pos=5756" target="_blank"><img src="http://bs.serving-sys.com/BurstingPipe/BannerSource.asp?FlightID=1280098&Page=&PluID=0&Pos=5756" border=0 width=160 height=600></a>
</noscript>
Код с макросом отслеживания кликов:
<noscript>
<a href="${CLICK_URL}http://bs.serving-sys.com/BurstingPipe/BannerRedirect.asp?FlightID=134567&Page=&PluID=0&Pos=5756" target="_blank"><img src="http://bs.serving-sys.com/BurstingPipe/BannerSource.asp?FlightID=1234567&Page=&PluID=0&Pos=5756" border=0 width=160 height=600></a>
</noscript>
Теги 2-го типа
Код без макроса отслеживания кликов:
Код с макросом отслеживания кликов: