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

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

Шаг 1. Добавить код в креатив
Вставьте предоставленный JS-код в HTML-креатив. Рекомендуется разместить его в начале документа для корректной работы.

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

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

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

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

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

Добавьте код в шаблон вашего HTML-креатива.

Совет

Рекомендуем разместить его как можно ближе к началу креатива.

<script src="https://static.a.mts.ru/adm/msr-sdk.js" async></script>
<script type="text/javascript">
  (function (w, n) {
    w[n] = w[n] || [];
    w[n].push({
      flowId: '${FLOW_ID}',
      bannerId: '${BANNER_ID}',
      offerId: '${OFFER_ID}',
      measurerId: '${MEASURER_ID}',
      resourceId: '${ROSOURCED_ID}',
      partnerUserId: '${USER_ID}',
      impressionId: '${IMPRESSION_ID}',
      pubId: '${PLATFORM_ID}'
      adFormat: 'display',
      partnerBundle: '${BUNDLE}',
      partnerPlatformType: '${TRAFFIC_TYPE}',
      partnerAdvId: '${ADV_ID}',
      url: '${URL}',
      domain: '${DOMAIN}',
      referrer: '${REFERRER}',
      clickUrl: '${CLICK_URL_BASE64}',
      userAgent: '${USER_AGENT_RTB}',
      userUtcOffset: '${USER_UTC_OFFSET_RTB}'
    })
  })(window, 'maMsrSdk');
</script>

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

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

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

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

Параметр	Название	Тип	Как получить	Статус
flowId	Идентификатор потока данных	string	Предоставляется МТС Аналитикой	Обязательный
adFormat	Формат рекламы. Значения: 1. video — видео-реклама 2. display — баннерная реклама	string		Обязательный
impressionId	Идентификатор показа креатива	string	Формируется DSP	Рекомендованный
offerId	Идентификатор рекламной кампании	string	Формируется DSP	Обязательный
measurerId	Идентификатор кода верификации в конкретном размещении креатива	string	Формируется DSP	Рекомендованный
partnerUserId	Идентификатор пользователя	string	Формируется DSP	Рекомендованный
bannerId	Идентификатор креатива	string	Формируется DSP	Рекомендованный
resourceId	Идентификатор рекламируемого сайта, куда ведет клик с креатива	string	Формируется DSP	Рекомендованный
partnerBundle	Имя или идентификатор пакета мобильного приложения	string	Из RTB-аукциона	Рекомендованный
partnerPlatformType	Тип трафика. Значения: 1. inapp (из мобильного приложения) 2. web (из браузера)	string	Из RTB-аукциона	Рекомендованный
partnerAdvId	Рекламный идентификатор устройства: IDFA (iOS) или идентификатор объявления (Android)	string	Из RTB-аукциона	Рекомендованный
pubId	Идентификатор рекламной площадки. Например, SSP-площадки	string	Формируется DSP	Рекомендованный
url	Адрес, где должна быть показана реклама: URL для сайта, URI для приложения	string	Из RTB-аукциона	Рекомендованный
domain	Сайт, где должна быть показана реклама. Заполните, если невозможно указать url	string	Из RTB-аукциона	Рекомендованный
referrer	Адрес, откуда пришёл пользователь: URL для сайта, URI для приложения	string	Из RTB-аукциона	Рекомендованный
clickUrl	Адрес рекламного перехода, заданный в креативе	base64	Формируется DSP	Рекомендованный
userAgent	User-Agent устройства пользователя	string	Из RTB-аукциона	Рекомендованный
userUtcOffset	Смещение времени на устройстве пользователя. Например: UTC+3 или в минутах: 180	string	Из RTB-аукциона	Рекомендованный

Результат

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