Приложение: Сопоставление полей пользовательского интерфейса с полями API по типам объявлений

В таблице ниже поля пользовательского интерфейса сопоставлены с соответствующими полями API, разделенными по типам объявлений. Обратите внимание, что некоторые поля API требуют дополнительной спецификации через назначенную роль или тип предоставленного ресурса.

Стандартное графическое объявление

Тип объявления: CREATIVE_TYPE_STANDARD
Источник хостинга: HOSTING_SOURCE_HOSTED
Имя
Необходимый
Имя поля API: displayName
Креативный актив
Необходимый
Имя поля API: активы
Роль актива: ASSET_ROLE_MAIN
URL целевой страницы
Необходимый
Имя поля API: exitEvents[].url
Тип события выхода: EXIT_EVENT_TYPE_DEFAULT
Статус
Необходимый
Имя поля API: entityStatus
Добавлен HTML-тег отслеживания.
Необязательный
Имя поля API: AppededTag
Код интеграции
Необязательный
Имя поля API: код интеграции.
Примечания
Необязательный
Имя поля API: примечания
Статус аудита
Только чтение
Имя поля API: reviewStatus

HTML5-креатив

Тип объявления: CREATIVE_TYPE_STANDARD
Источник хостинга: HOSTING_SOURCE_HOSTED
Имя
Необходимый
Имя поля API: displayName
Креативный актив
Необходимый
Имя поля API: активы
Роль актива: ASSET_ROLE_MAIN
Статус
Необходимый
Имя поля API: entityStatus
Резервные изображения
Необязательный
Имя поля API: активы
Роль актива: ASSET_ROLE_BACKUP
URL резервной целевой страницы
Необязательный
Имя поля API: exitEvents[].url
Тип события выхода: EXIT_EVENT_TYPE_BACKUP
Ярлык отчета о выходе из резервного копирования
Необязательный
Имя поля API: exitEvents[].reportingName
Тип события выхода: EXIT_EVENT_TYPE_BACKUP
Вежливая загрузка изображений
Необязательный
Имя поля API: активы
Роль актива: ASSET_ROLE_POLITE_LOAD
Выходы
Необходимый
Имя поля API: exitEvents[]
Тип события выхода: EXIT_EVENT_TYPE_DEFAULT
Счетчики
Необязательный
Имя поля API: counterEvents[]
Таймеры
Необязательный
Имя поля API: timerEvents[]
Добавлен HTML-тег отслеживания.
Необязательный
Имя поля API: AppededTag
Код интеграции
Необязательный
Имя поля API: код интеграции.
Примечания
Необязательный
Имя поля API: примечания
Статус аудита
Необязательный
Имя поля API: reviewStatus

Стороннее медийное объявление

Тип объявления: CREATIVE_TYPE_STANDARD
Источник хостинга: HOSTING_SOURCE_THIRD_PARTY
Имя
Необходимый
Имя поля API: displayName
Статус
Необходимый
Имя поля API: entityStatus
Размеры
Необходимый
Имя поля API: размеры
URL целевой страницы
Необходимый
Имя поля API: exitEvents[].url
Тип события выхода: EXIT_EVENT_TYPE_DEFAULT
Требуется MRAID
Необязательный
Имя поля API: requireMraid
Требуется HTML5
Необязательный
Имя поля API: requireHtml5
Сторонний тег
Необходимый
Имя поля API: ThirdPartyTag
Требуется пинг для атрибуции
Необязательный
Имя поля API: requirePingForAttribution
Код интеграции
Необязательный
Имя поля API: код интеграции.
Примечания
Необязательный
Имя поля API: примечания
Статус аудита
Только чтение
Имя поля API: reviewStatus

Стороннее расширяемое объявление

Тип объявления: CREATIVE_TYPE_EXPANDABLE
Источник хостинга: HOSTING_SOURCE_THIRD_PARTY
Имя
Необходимый
Имя поля API: displayName
Статус
Необходимый
Имя поля API: entityStatus
Размеры
Необходимый
Имя поля API: размеры
URL целевой страницы
Необходимый
Имя поля API: exitEvents[].url
Тип события выхода: EXIT_EVENT_TYPE_DEFAULT
Требуется MRAID
Необязательный
Имя поля API: requireMraid
Требуется HTML5
Необязательный
Имя поля API: requireHtml5
Расширение направления
Необходимый
Имя поля API: ExpandingDirection
Развернуть при наведении
Необязательный
Имя поля API: expandOnHover
Третья сторона
Необходимый
Имя поля API: ThirdPartyTag
Требуется пинг для атрибуции
Необязательный
Имя поля API: requirePingForAttribution
Код интеграции
Необязательный
Имя поля API: код интеграции.
Примечания
Необязательный
Имя поля API: примечания
Статус аудита
Только чтение
Имя поля API: reviewStatus

Стороннее видеокреатив

Тип объявления: CREATIVE_TYPE_VIDEO
Источник хостинга: HOSTING_SOURCE_THIRD_PARTY
Имя
Необходимый
Имя поля API: displayName
Статус
Необходимый
Имя поля API: entityStatus
URL-адрес тега VAST
Необходимый
Имя поля API: обширныйТагурл
VPAID
Только чтение
Имя поля API: vpaid
HTML5-видео
Только чтение
Имя поля API: html5Video
Требуется пинг для атрибуции
Необязательный
Имя поля API: requirePingForAttribution
Код интеграции
Необязательный
Имя поля API: код интеграции.
Примечания
Необязательный
Имя поля API: примечания
Статус аудита
Только чтение
Имя поля API: reviewStatus

Стороннее аудиообъявление

Тип объявления: CREATIVE_TYPE_AUDIO
Источник хостинга: HOSTING_SOURCE_THIRD_PARTY
Имя
Необходимый
Имя поля API: displayName
Статус
Необходимый
Имя поля API: entityStatus
URL-адрес тега VAST
Необходимый
Имя поля API: обширныйТагурл
Требуется пинг для атрибуции
Необязательный
Имя поля API: requirePingForAttribution
Код интеграции
Необязательный
Имя поля API: код интеграции.
Примечания
Необязательный
Имя поля API: примечания
Статус аудита
Только чтение
Имя поля API: reviewStatus

Видео креатив

Тип объявления: CREATIVE_TYPE_VIDEO
Источник хостинга: HOSTING_SOURCE_HOSTED
Имя
Необходимый
Имя поля API: displayName
Статус
Необходимый
Имя поля API: entityStatus
Исходный файл
Необходимый
Имя поля API: активы
Роль актива: ASSET_ROLE_MAIN
URL целевой страницы
Необходимый
Имя поля API: exitEvents[].url
Тип события выхода: EXIT_EVENT_TYPE_DEFAULT
Включить кнопку пропуска
Необязательный
Имя поля API: пропускаемый
Пропустить смещение
Необязательный
Имя поля API: SkipOffset
Смещение прогресса
Необязательный
Имя поля API: ProgressOffset
Универсальный рекламный идентификатор
Необязательный
Имя поля API: UniversalAdId
OBA
Необязательный
Имя поля API: obaIcon
Сопутствующие объявления
Необязательный
Имя поля API: компаньонкреативидс
Обслуживание файла
Только чтение
Имя поля API: транскодирует
Сторонние URL-адреса
Необязательный
Имя поля API: ThirdPartyUrls
Код интеграции
Необязательный
Имя поля API: код интеграции.
Примечания
Необязательный
Имя поля API: примечания
Статус аудита
Только чтение
Имя поля API: reviewStatus

Аудио креатив

Тип объявления: CREATIVE_TYPE_AUDIO
Источник хостинга: HOSTING_SOURCE_HOSTED
Имя
Необходимый
Имя поля API: displayName
Статус
Необходимый
Имя поля API: entityStatus
Исходный файл
Необходимый
Имя поля API: активы
Роль актива: ASSET_ROLE_MAIN
URL целевой страницы
Необходимый
Имя поля API: exitEvents[].url
Тип события выхода: EXIT_EVENT_TYPE_DEFAULT
Сопутствующий ресурс (загрузить или назначить)
Необходимый
Имя поля API: компаньонкреативидс
Имя обслуживаемого файла
Только чтение
Имя поля API: transcodes[].name
Тип обслуживаемого файла
Только чтение
Имя поля API: transcodes[].mimeType
Скорость передачи аудиофайла
Только чтение
Имя поля API: transcodes[].audioBitRateKbps
Частота дискретизации аудиофайла
Только чтение
Имя поля API: transcodes[].audioSampleRateHz
Сторонние URL-адреса
Необязательный
Имя поля API: ThirdPartyUrls
Код интеграции
Необязательный
Имя поля API: код интеграции.
Примечания
Необязательный
Имя поля API: примечания
Статус аудита
Только чтение
Имя поля API: reviewStatus

Нативное медийное объявление

Тип объявления: CREATIVE_TYPE_NATIVE, CREATIVE_TYPE_NATIVE_SITE_SQUARE.
Источник хостинга: HOSTING_SOURCE_HOSTED
Имя
Необходимый
Имя поля API: displayName
статус
Необходимый
Имя поля API: entityStatus
Логотип
Необходимый
Имя поля API: активы
Роль актива: ASSET_ROLE_ICON
Изображение/Квадратное изображение
Необходимый
Имя поля API: активы
Роль актива: ASSET_ROLE_MAIN
Заголовок
Необходимый
Имя поля API: активы
Роль актива: ASSET_ROLE_HEADLINE
Длинный заголовок
Необязательный
Имя поля API: активы
Роль актива: ASSET_ROLE_LONG_HEADLINE
Основной текст
Необходимый
Имя поля API: активы
Роль актива: ASSET_ROLE_BODY
Длинный основной текст
Необязательный
Имя поля API: активы
Роль актива: ASSET_ROLE_LONG_BODY
URL целевой страницы
Необходимый
Имя поля API: exitEvents[].url
Тип события выхода: EXIT_EVENT_TYPE_DEFAULT
URL подписи
Необходимый
Имя поля API: активы
Роль актива: ASSET_ROLE_CAPTION_URL
Призыв к действию
Необходимый
Имя поля API: активы
Роль актива: ASSET_ROLE_CALL_TO_ACTION
Отслеживающее объявление Менеджера кампании 360
Необязательный
Имя поля API: cmTrackingAd
URL отслеживания показов 1
Необязательный
Имя поля API: trackUrls[]
URL отслеживания показов 2
Необязательный
Имя поля API: trackUrls[]
URL-адрес отслеживания JavaScript
Необязательный
Имя поля API: jsTrackerUrl
Код интеграции
Необязательный
Имя поля API: код интеграции.
Примечания
Необязательный
Имя поля API: примечания
Статус аудита
Только чтение
Имя поля API: reviewStatus

Нативный видеокреатив

Тип объявления: CREATIVE_TYPE_NATIVE_VIDEO
Источник хостинга: HOSTING_SOURCE_HOSTED
Имя
Необходимый
Имя поля API: displayName
Статус
Необходимый
Имя поля API: entityStatus
Логотип
Необходимый
Имя поля API: активы
Роль актива: ASSET_ROLE_ICON
Видео
Необходимый
Имя поля API: активы
Роль актива: ASSET_ROLE_MAIN
Обложка
Необходимый
Имя поля API: активы
Роль актива: ASSET_ROLE_COVER_IMAGE
Имя рекламодателя
Необходимый
Имя поля API: активы
Роль объекта: ASSET_ROLE_ADVERTISER_NAME
Заголовок
Необходимый
Имя поля API: активы
Роль актива: ASSET_ROLE_HEADLINE
Длинный заголовок
Необязательный
Имя поля API: активы
Роль актива: ASSET_ROLE_LONG_HEADLINE
Основной текст
Необходимый
Имя поля API: активы
Роль актива: ASSET_ROLE_BODY
Длинный основной текст
Необязательный
Имя поля API: активы
Роль актива: ASSET_ROLE_LONG_BODY
URL целевой страницы
Необходимый
Имя поля API: exitEvents[].url
Тип события выхода: EXIT_EVENT_TYPE_DEFAULT
URL подписи
Необходимый
Имя поля API: активы
Роль актива: ASSET_ROLE_CAPTION_URL
Призыв к действию
Необходимый
Имя поля API: активы
Роль актива: ASSET_ROLE_CALL_TO_ACTION
URL отслеживания показов 1
Необязательный
Имя поля API: trackUrls[]
URL отслеживания показов 2
Необязательный
Имя поля API: trackUrls[]
URL-адрес отслеживания JavaScript
Необязательный
Имя поля API: jsTrackerUrl
Код интеграции
Необязательный
Имя поля API: код интеграции.
Примечания
Необязательный
Имя поля API: примечания
Статус аудита
Только чтение
Имя поля API: reviewStatus