Интеграция кода в VPAID-креатив

Краткое содержание

Шаг 1. Добавить код в креатив
Добавьте скрипт в VPAID-креатив для отслеживания событий и передачи данных в МТС Аналитику. Скрипт подписывается на события, такие как "AdLoaded", "AdStarted", "AdSkipped" и другие, и записывает их в vpaidDataLayer.

Шаг 2. Заполнить параметры
Обязательные параметры (например, flowId, ofr) необходимы для получения результатов верификации. Рекомендуемые параметры (например, bannerId, url) улучшают точность анализа и позволяют получить детальную статистику по каждому баннеру.

В тексте приведена таблица с перечнем параметров, их названиями, типами, способами получения и статусом (обязательный/рекомендуемый).

Данные начнут поступать в МТС Аналитику после размещения креатива и запуска кампании.

Используйте статью, если необходимо добавить код верификации в VPAID-креатив, чтобы получать результаты аудита видео-рекламы в МТС Аналитике.

Шаг 1. Добавить код в креатив

Добавьте скрипт в VPAID-креатив

const vpaidSrc = "https://static.a.mts.ru/adm/msr-vpaid.js?flowId=${FLOW_ID}&bnr=${BANNER_ID}&ofr=${OFFER_ID}&rsc=${RESOURCE_ID}&usr=${USER_ID}&imp=${IMPRESSION_ID}&f=video&p_bnd=${BUNDLE}&p_plt=${TRAFFIC_TYPE}&p_aid=${ADV_ID}&d={DOMAIN}&dr={REFERRER}&url=${URL}&clickUrl=${CLICK_URL}&ua=${USER_AGENT_RTB}&u_utc_ofs=${USER_UTC_OFFSET_RTB}";
const vpaidDataLayer = (window["vpaidDataLayer"] = window["vpaidDataLayer"] || []);
const vpaidCreative = window["getVPAIDAd"]();
 
if (vpaidCreative) {
  [
    "AdLoaded",
    "AdStarted",
    "AdStopped",
    "AdSkipped",
    "AdSkippableStateChange",
    "AdSizeChange",
    "AdLinearChange",
    "AdDurationChange",
    "AdExpandedChange",
    "AdRemainingTimeChange",
    "AdVolumeChange",
    "AdImpression",
    "AdVideoStart",
    "AdVideoFirstQuartile",
    "AdVideoMidpoint",
    "AdVideoThirdQuartile",
    "AdVideoComplete",
    "AdClickThru",
    "AdInteraction",
    "AdUserAcceptInvitation",
    "AdUserMinimize",
    "AdUserClose",
    "AdPaused",
    "AdPlaying",
    "AdLog",
    "AdError",
  ].forEach((event) => {
    vpaidCreative.subscribe((...args) => {
      vpaidDataLayer.push({ event, args, time: Date.now() });
    }, event);
  });
}
const script = document.createElement('script');
script.src = vpaidSrc;
document.body.appendChild(script);

Шаг 2. Заполнить параметры

Статус параметров

• Обязательный — обязательно заполнять, чтобы получить результат верификации. Если не заполнить, результат не будет предоставлен.

• Рекомендованный — крайне рекомендуем заполнять, чтобы качество результатов было выше, а определение фрода — ещё точнее. Например, если передаёте bannerId, покажем статистику по: числу показов, видимых показов и другие данные по каждому баннеру.

Параметр	Название	Тип	Как получить	Статус
flowId	Идентификатор потока данных	string	Предоставляется МТС Аналитикой	Обязательный
imp	Идентификатор показа креатива	string	Формируется DSP	Рекомендованный
ofr	Идентификатор рекламной кампании	string	Формируется DSP	Обязательный
usr	Идентификатор пользователя	string	Формируется DSP	Рекомендованный
bnr	Идентификатор креатива	string	Формируется DSP	Рекомендованный
rsc	Идентификатор рекламируемого сайта, куда ведет клик с креатива	string	Формируется DSP	Рекомендованный
p_bnd	Имя или идентификатор пакета мобильного приложения	string	Из RTB-аукциона	Рекомендованный
p_plt	Тип трафика. Значения: 1. inapp (из мобильного приложения) 2. web (из браузера)	string	Из RTB-аукциона	Рекомендованный
p_aid	Рекламный идентификатор устройства: IDFA (iOS) или идентификатор объявления (Android)	string	Из RTB-аукциона	Рекомендованный
pubId	Идентификатор рекламной площадки. Например, SSP-площадки	string	Формируется DSP	Рекомендованный
url	Адрес, где должна быть показана реклама: URL для сайта, URI для приложения	string	Из RTB-аукциона	Рекомендованный
d	Сайт, где должна быть показана реклама. Заполните, если невозможно указать url	string	Из RTB-аукциона	Рекомендованный
dr	Адрес, откуда пришёл пользователь: URL для сайта, URI для приложения	string	Из RTB-аукциона	Рекомендованный
clickUrl	Адрес рекламного перехода, заданный в креативе	base64	Формируется DSP	Рекомендованный
ua	User-Agent устройства пользователя	string	Из RTB-аукциона	Рекомендованный
u_utc_ofs	Смещение времени на устройстве пользователя. Например: UTC+3 или в минутах: 180	string	Из RTB-аукциона	Рекомендованный

Результат

Данные начнут поступать в МТС Аналитику после размещения креатива и запуска кампании.