Media Native

Media Native — это формат, позволяющий разместить как изображение, так и подготовить свой набор текстово-графических элементов баннера, которые можно органично адаптировать под внешний вид приложения.

Пример рекламы Media Native:

Создание нативного баннера

1. Определите, какие нативные элементы в баннере вам необходимы.

2. Подготовьте JSON-код. Пропишите в нем параметры кастомизации: элемент и его значение.

   Пример JSON

   {
     "content": [
       "text",
       "button"
     ],
     "text": {
       "value": "Кастомизируемый текст из рекламного блока Adfox"
     },
     "button": {
       "label": "Кастомная кнопка",
       "link": " https://ya.ru/ ",
       "backgroundColor": "#5D9B9B"
     }
   }
   

3. Запишите JSON в одну строку и добавьте экранирование кавычек с помощью символа \.

   Пример JSON с экранированием

   {   \"content\": [     \"text\",     \"button\"   ],   \"text\": {     \"value\": \"Кастомизируемый текст из рекламного блока Adfox\"   },   \"button\": {     \"label\": \"Кастомная кнопка\",     \"link\": \"https:\/\/ya.ru\/\",     \"backgroundColor\": \"#5D9B9B\"   }
   

4. На стороне приложения поддержите чтение JSON-данных, чтобы нативные элементы корректно отображались в приложении. Важно учесть, что каждый нативный элемент, указанный в JSON, должен быть соответствующим образом реализован в коде приложения.

   Пример парсинга JSON-данных (Kotlin)

   
   private fun processAdditionalText(rawJson: String) {
       try {
           val jsonObject = JSONObject(rawJson)
           val contentJSONArray = jsonObject.getJSONArray("content")
   
           repeat(contentJSONArray.length()) { index ->
               val elementName = contentJSONArray.getString(index)
               val elementConfiguration = jsonObject.getJSONObject(elementName)
   
               when (elementName) {
                   "text" -> addTextToLayout(elementConfiguration, index)
                   "button" -> addButtonToLayout(elementConfiguration, index)
               }
           }
       } catch (e: JSONException) {
           adInfoFragment.log(e.message ?: "JSON parsing error")
       }
   }
   
   private fun addTextToLayout(textConfiguration: JSONObject, index: Int) {
       val textView = TextView(this).apply {
           setPadding(resources.getDimension(R.dimen.item_padding).toInt())
   
           text = textConfiguration.getString("value")
       }
       additionalContainer.addView(textView, index)
   }
   
   private fun addButtonToLayout(buttonConfiguration: JSONObject, index: Int) {
       val buttonView = Button(this).apply {
           setPadding(resources.getDimension(R.dimen.item_padding).toInt())
   
           text = buttonConfiguration.getString("label")
   
           val colorHex = buttonConfiguration.getString("backgroundColor")
           setBackgroundColor(Color.parseColor(colorHex))
   
           setOnClickListener {
               val link = buttonConfiguration.getString("link")
               val intent = Intent(Intent.ACTION_VIEW, Uri.parse(link))
               startActivity(intent)
           }
       }
       additionalContainer.addView(buttonView, index)
   }
   
   

5. Добавьте баннер по инструкции ниже.

Добавление баннера в Adfox

1. В настройках кампании перейдите на вкладку Баннеры и нажмите Добавить.

2. Выберите тип баннера App Mobile Native и шаблон Media Native.

3. Укажите параметры баннера:

   Основные

   Дополнительные

   • Приоритет — числовое значение, определяющее порядок показа баннера в рамках кампании. Чем больше число, тем выше приоритет у баннера перед другими баннерами этой же кампании. Подробнее о приоритетах читайте в Справке Adfox.

   • URL изображения (URL) или URL изображения (Файл) — загрузите изображение.

   • Ширина — укажите ширину баннера (только целое число в пикселях, без указания размерности).

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

   • Дополнительный текст — если необходимо добавить кастомные элементы в рекламу или креатив, добавьте предварительно созданный JSON.

     Пример заполнения поля Дополнительный текст

     

   • Дата, время начала — обязательные параметры. По умолчанию стоит текущая дата. Если ее не изменить, баннеры начнут показываться сразу после их добавления (если статус баннера активен).

   • Метка рекламы — выберите Реклама или Соцреклама, чтобы добавить метку на баннер. Если метка уже есть в дизайне креатива, в выпадающем списке можно оставить значение Отключена.

     Примечание

     Добавление метки Соцреклама не определяет креатив как социальную рекламу. Чтобы креатив был маркирован как социальная реклама в ЕРИР, необходимо включить опцию Договор социальной рекламы в соответствующем договоре с конечным рекламодателем.

   • Домен — укажите домен рекламодателя, он будет добавлен в метку: Реклама / Example.com или Соцреклама / Example.com (только если в выпадающем списке выбрано значение Реклама или Соцреклама).

   • Добавить рекламное меню — включите эту опцию, чтобы добавить токен на некликабельный баннер. При показе баннера на нем будет отображаться значок меню в правом верхнем углу. По клику на значок откроется информация о рекламодателе и кнопка для копирования токена (если для баннера включена маркировка или указан сторонний токен).

     В рекламном меню находится ссылка на правила применения рекомендательных технологий. Она необходима, чтобы соблюсти требования п. 3 ч. 1 ст. 10.2-2 Федерального закона от 27.07.2006 N 149-ФЗ «Об информации, информационных технологиях и о защите информации».

     Примечание

     Если баннер некликабельный (поле URL перехода не заполнено) и подлежит маркировке, вы можете включить рекламное меню: так токен будет доступен при показе баннера.

   • Маркировка рекламы — раздел доступен, только если в настройках рекламной кампании выбран порядок маркировки Передавать данные о креативах в ЕРИР. Заполните поля в этом разделе, чтобы зарегистрировать креатив в ОРД Яндекса. Токен будет присвоен креативу автоматически. Подробнее о маркировке рекламы читайте в Справке Adfox.

   • Название — укажите произвольное название баннера. Если поле оставить пустым, баннеру будет присвоен порядковый номер.

   • Статус — выберите статус для баннера:

     • активен — баннер готов для показа;
     • приостановлен — показ баннера приостановлен;
     • Завершенная — баннер показываться не будет.

   • Отключен на новых площадках — по умолчанию опция включена. После создания баннера он не будет размещаться автоматически:

     • на новых площадках, созданных внутри сайта или раздела, где размещена кампания;
     • на площадках, которые были включены в настройках размещения кампании после создания баннера. Если выключить опцию, баннер будет автоматически размещен на всех площадках, где включено размещение кампании.

   • Профиль таргетирования — выберите предварительно созданный профиль таргетирования. Подробнее о профилях читайте в Справке Adfox.

   • События включены — опция используется для получения прямых ссылок на события для промера в сторонней системе. Чтобы активировать опцию, на вкладке Размещения у баннера нажмите . В открывшемся окне вы увидите ссылки на события от 1 до 30, которые нужно скопировать и отправить для установки в стороннюю систему.

   • Показы всего, сутки, час:

     • Показы всего, сутки, час — максимальное количество показов баннера. Если кампания имеет равномерное распределение — необходимо установить дату завершения показа баннера. Как только количество показов достигнет максимального, статус баннера изменится на Завершенная и баннер перестанет показываться.
     • Показы сутки — максимальное количество показов в сутки. Как только количество показов с начала суток достигнет максимального, показы приостановятся до начала следующих суток.
     • Показы час — максимальное количество показов в час. Как только количество показов с начала часа достигнет максимального, показы приостановятся до начала следующего часа.

   • Переходы всего, сутки, час:

     • Переходы всего — максимальное количество переходов по баннеру. Если кампания имеет равномерное распределение — необходимо установить дату завершения показа баннера. Как только количество переходов достигнет максимального, статус баннера изменится на Завершенная и баннер перестанет показываться.
     • Переходы сутки — максимальное количество переходов по баннеру в сутки. Как только количество переходов с начала суток достигнет максимального, показы приостановятся до начала следующих суток.
     • Переходы час — максимальное количество переходов по баннеру в час. Как только количество переходов с начала часа достигнет максимального, показы приостановятся до начала следующего часа.

   • Дата, время окончания — чтобы установить дату и время окончания, сначала включите опцию.

4. Чтобы сохранить баннер, нажмите кнопку Добавить.

Обратиться в службу поддержки