Элементы фида MRSS для Решений для видеорекламы

В таблице ниже перечислены все поля, которые можно (а в некоторых случаях – нужно) использовать в XML-файлах фидов Решений для видеорекламы. Этот список является полным, поэтому никакие другие элементы в таких фидах присутствовать не должны.

Ссылки на описания отдельных элементов

---

Обязательные элементы

<atom:link> <item> <dfpvideo:contentId> <dfpvideo:lastModifiedDate> <dfpvideo:version> <title>

Рекомендуемые и необязательные элементы

<dfpvideo:cuepoints> <dfpvideo:keyvalues> <dfpvideo:thirdPartyContentId>

<media:content> <media:status>

<media:thumbnail> <pubDate>

Динамическая вставка объявлений

_{Эти элементы применяются для динамической вставки объявлений, и их необходимо использовать в сочетании с элементами, перечисленными выше.}

<dfpvideo:ingestUrl> <dfpvideo:lastMediaModifiedDate> <dfpvideo:closedCaptionUrl> <dfpvideo:fw_caid>

---

С примером использования указанных элементов в контексте можно ознакомиться в нашем Справочном центре.

Теперь в идентификаторах контента учитывается регистр. Два идентификатора, которые различаются только регистром букв, отныне считаются разными. Это отражено в отчетах Менеджера рекламы.

Обязательные элементы

Элемент	Родительский элемент	Обязательный или нет
<atom:link>	<channel>	Обязательный
Описание Содержит данные о постраничной организации фида. Менеджер рекламы считывает этот элемент для двух атрибутов: rel и href. rel указывает, куда в наборе результатов фида ведет URL из атрибута href. rel='next' указывает на то, что URL href ведет на следующую страницу набора результатов фида. Если фид содержит тег <atom:link> с атрибутом rel='next', значит существуют и другие страницы с результатами. В противном случае текущая страница будет считаться последней в наборе. href содержит URL, который определяет ресурс в теге <atom:link>. Пример <atom:link rel='next' href='http://www.feedprovider.com/video/account/vids?page3'/ Важная информация Когда Менеджер рекламы создает источник контента, то предполагается, что набор URL из фида должен передать в этот источник контента первый набор записей в фиде. Желательно, чтобы количество элементов в наборе записей не превышало 100 (на страницу). Если на странице фида нет элемента <atom:link>, Менеджер рекламы считает ее последней.

Элемент	Родительский элемент	Обязательный или нет
<item>	<channel>	Обязательный
Описание Позволяет идентифицировать одно видео в фиде. Фид видео Менеджера рекламы может содержать один или несколько экземпляров элемента <item>. В каждом соответствующем фрагменте кода для правильного получения метаданных должно быть три элемента, указанных ниже: <dfpvideo:contentId>, <dfpvideo:lastModifiedDate> и <title>

Элемент	Родительский элемент	Обязательный или нет
<dfpvideo:contentId>	<item>	Обязательный
Описание Этот элемент хранится в Менеджере рекламы и используется как идентификатор контента в системе управления контентом. Идентификатор – очень важный параметр в запросах, позволяющий найти объявления, которые можно показывать в определенном видеоконтенте.   Значение идентификатора контента должно быть строкой. В нем учитывается регистр. Это значение подходит для параметра vid в запросе видеообъявления. Пример <dfpvideo:contentId>sdjfbadfb8w3489y</dfpvideo:contentId>

Элемент	Родительский элемент	Обязательный или нет
<dfpvideo:lastModifiedDate>	<item>	Обязательный
Описание Дата последнего изменения видео или его метаданных. Чтобы Менеджер рекламы мог извлекать измененный контент, необходимо указать элемент lastModifiedDate и упорядочить фид так, чтобы элементы с недавними изменениями были сверху. Все отметки времени должны соответствовать стандартам RFC 822 или IS0 8601. Если в строке отметки времени не указан часовой пояс, по умолчанию устанавливается стандартное тихоокеанское время. Примеры <dfpvideo:lastModifiedDate>2021-01-15T08:00:00+01:00</dfpvideo:lastModifiedDate> <dfpvideo:lastModifiedDate>Fri, 15 Jan 2021 08:00:00 EST </dfpvideo:lastModifiedDate> Примеры каждого формата Примеры RFC 822 Fri, 15 Jan 2021 08:00:00 EST Fri, 15 Jan 2021 13:00:00 GMT Fri, 15 Jan 2021 15:00:00 +0200 ISO 8601 2021-01-15T12:00:00Z 2021-01-15T08:00:00+01:00

Элемент	Родительский элемент	Обязательный или нет
<dfpvideo:version>	<channel>	Обязательный
Описание Версия спецификации MRSS, используемой в фиде. Значение должно быть уникальным целым числом. В настоящее время единственное допустимое значение для этого поля – 2. Пример <dfpvideo:version>2</dfpvideo:version>

Элемент	Родительский элемент	Обязательный или нет
<title>	<item>	Обязательный
Описание Название видео. Пример <title>Мое видео</title>

Рекомендуемые и необязательные элементы

Элемент	Родительский элемент	Обязательный или нет
<dfpvideo:cuepoints>	<item>	См. примечание*
Описание *Элемент является обязательным, если видео содержит рекламные паузы в середине ролика. Определяет значения временных точек (в секундах). Они перечисляются через запятую. Временные точки обозначают моменты, когда объявление можно показывать в видеоролике. В дробных значениях можно использовать не более трех цифр после запятой (например, 55,532 секунды). Все цифры после третьего знака отбрасываются. В одном видео может быть не больше 1000 временных точек. После того как будет достигнуто ограничение, все временные точки будут обрезаться. Пример <dfpvideo:cuepoints>55.532,109</dfpvideo:cuepoints>

Элемент	Родительский элемент	Обязательный или нет
<dfpvideo:keyvalues>	<item>	Необязательный
Описание Определяет любые специальные метаданные видео и содержит следующие атрибуты: key, value и type (где можно использовать только данные типа string).   Нами установлены одинаковые требования в отношении формата пар "ключ-значение", как переданных с помощью вашего фида MRSS, так и заданных через интерфейс Менеджера рекламы. Примеры <dfpvideo:keyvalues key="episode" value="5" type="string"/> <dfpvideo:keyvalues key="season" value="2" type="string"/> <dfpvideo:keyvalues key="title" value="Пример заголовка" type="string"/> <dfpvideo:keyvalues key="recommended count" value="5" type="string"/> <dfpvideo:keyvalues key="description" value="Здесь много текста" type="string"/>

Элемент	Родительский элемент	Обязательный или нет
<dfpvideo:thirdPartyContentId>	<item>	Необязательный
Описание Эту функцию необходимо включить заранее. Обратитесь за помощью к менеджеру своего аккаунта. Этот элемент можно использовать, если у вас есть специальный фид MRSS с видео YouTube. Два источника контента MRSS в вашей сети не должны указывать на одно видео YouTube. Для этого элемента существует только один обязательный атрибут: id. Он должен быть связан с параметром contentId в источнике контента YouTube. Пример <dfpvideo:thirdPartyContentId cms="youtube" id='vNclnVLp_c0'/>

Элемент	Родительский элемент	Обязательный или нет
<media:content>	<item>	Рекомендуемый
Описание У этого элемента есть атрибуты, которые предоставляют важные метаданные, такие как URL источника и продолжительность. Он является необязательным дочерним элементом для элемента <item>. Менеджер рекламы может обрабатывать следующие атрибуты элемента <media:content>: Атрибут duration. При его использовании распознается только одна запись duration для элемента <item>. Если указано несколько записей, из них случайным образом выбирается одна. Это может привести к непредвиденным результатам. Значение должно быть указано в секундах (целым числом и без дробной части). Атрибут duration необходим для показа видеорекламы в середине ролика. Атрибут url – это прямой URL видеоресурса. Используется только для показа ссылки в сведениях о контенте в интерфейсе Менеджера рекламы. Пример <media:content url='http://www.feedprovider.com/video?8eqe7e' duration='39'/>

Элемент	Родительский элемент	Обязательный или нет
<media:status>	<media:content> или <item>	Необязательный
Описание Определяет, какой у видео статус в Менеджере рекламы (активно, неактивно или в архиве). Если такой элемент отсутствует, то назначается статус по умолчанию ("Активно"). Регистр символов не учитывается. Возможные значения: active (помечено в Менеджере рекламы как "Активно"); deleted ("Удалено", помечено в Менеджере рекламы как "В архиве", при этом метаданные вновь удаленных роликов не передаются); blocked ("Заблокировано" и помечено в Менеджере рекламы как "Неактивно"). Если пользователь изменяет статус видео в Менеджере рекламы, то будут игнорироваться все последующие изменения статуса, полученные из фида. Вы можете отказаться от переопределения, нажав Использовать настройку источника в интерфейсе Менеджера рекламы. В результате наш сервис снова станет учитывать обновления статуса из фида. Партнеры, использующие CMS, и издатели могут запретить Менеджеру рекламы повторно обрабатывать контент, который был загружен, но стал неактивным или устарел. Для подобного запрета необходимо выполнить одно из следующих действий: Реализовать поддержку элемента <media:status state="deleted"/> в фиде MRSS (рекомендуется). Оставить контент в фиде, но удалить из него все элементы, связанные с динамической вставкой объявлений. В этом случае станет невозможным прием контента с видео по запросу. Чтобы узнать, какие элементы необходимо удалить, изучите материалы из раздела, который посвящен элементам, служащим для динамической вставки объявлений. Статус показа при динамической вставке объявлений При определении статуса показа объявления с динамической вставкой учитываются и статус источника, и статус видео. Если указаны оба статуса, происходит следующее: Статус источника контента Статус контента Статус показа Активно Активно Контент показывается Активно Неактивно Контент показывается Активно В архиве Контент не показывается (ошибка 404) Неактивно Активно Контент не показывается (ошибка 404) Неактивно Неактивно Контент не показывается (ошибка 404) Неактивно В архиве Контент не показывается (ошибка 404) В архиве Активно Контент не показывается (ошибка 404) В архиве Неактивно Контент не показывается (ошибка 404) В архиве В архиве Контент не показывается (ошибка 404)   Активно: показ объявлений возможен. Неактивно: показ объявлений невозможен. В архиве: показ объявлений с таргетингом невозможен, но размещение на доступном инвентаре допустимо. Если источник контента имеет статус "Неактивно" или "В архиве" или сам контент имеет статус "В архиве", то выполнять показ таких материалов при помощи динамической вставки объявлений невозможно. Примеры <media:status state="blocked" reason="http://www.reasonforblocking.com"/> <media:status state="deleted"/> <media:status state="active"/> (Менеджер рекламы не добавляет атрибут reason.)

Элемент	Родительский элемент	Обязательный или нет
<media:thumbnail>	<media:content> или <item>	Рекомендуемый
Описание Обеспечивает показ значка видео в интерфейсе Менеджера рекламы. В настоящее время обязательным в Менеджере рекламы является только атрибут URL этого элемента, однако вы можете указать следующие дополнительные атрибуты: высоту, ширину и время (интервал, после которого в ролике будет показано изображение из значка видео). В Менеджере рекламы демонстрируются только значки видео, ширина которых не превышает 280 пикселей, а высота – 190 пикселей. Если по URL размещено более крупное изображение, Менеджер рекламы сможет использовать его, выполнив масштабирование с помощью CSS. Пример <media:thumbnail url='http://www.myfeed.com/account/sdjfbadfb8w3489y/bigtn.jpg' width='280' height='190'/>

Элемент	Родительский элемент	Обязательный или нет
<pubDate>	<item>	Необязательный
Описание Определяет дату публикации контента. Используется только с правилами для видеообъявлений Менеджера рекламы. Все отметки времени должны соответствовать стандартам RFC 822 или IS0 8601. Если в строке отметки времени не указан часовой пояс, по умолчанию устанавливается стандартное тихоокеанское время. Примеры <pubDate>2006-02-19T04:22:39+05:00</pubDate> <pubDate>Sun, 19 Feb 2006 09:22:39 +0000</pubDate> Примеры каждого формата Примеры RFC 822 Wed, 31 Oct 2016 08:00:00 EST Wed, 31 Oct 2016 13:00:00 GMT Wed, 31 Oct 2016 15:00:00 +0200 ISO 8601 20161031 2016-10-31 2016-10-31T08:00:00+01:00

Элементы для динамической вставки объявлений

Элемент	Родительский элемент	Обязательный или нет
<dfpvideo:ingestUrl>	<item>	Обязательный*
Описание *Элемент является обязательным при использовании динамической вставки объявлений. В этом элементе указывается URL извлечения видео в основной файл m3u8, который используется для подготовки и создания плейлиста. Атрибут type для HLS должен иметь значение application/x-mpegURL, а для DASH – application/dash+xml. Атрибут preconditioned должен иметь значение true, если элемент ingestURL, связанный с этим контентом, подготовлен для видеорекламы в середине ролика, т. е. сегменты уже разбиты в местах рекламных пауз. В противном случае нужно указать значение false. Также значение false задано по умолчанию. Контент считается подготовленным, если продолжительность сегментов в трансляции в точности соответствует временным точкам для вставки объявлений. Если контент подготовлен, в потоке HLS должен быть маркер #EXT-X-PLACEMENT-OPPORTUNITY, который сообщает Менеджеру рекламы, что в этом месте должна вставляться реклама. Подробнее о подготовке к вставке рекламы в середине ролика… Примеры Для HLS <dfpvideo:ingestUrl type="application/x-mpegURL" preconditioned="false">https://cdn.example.com/?v=123.m3u8</dfpvideo:ingestUrl> Для DASH <dfpvideo:ingestUrl type="application/dash+xml" preconditioned="true"> https://cdn.example.com//playlist.mpd </dfpvideo:ingestUrl> Значения HLS и DASH можно одновременно задавать для одного и того же фрагмента видеоконтента. При этом рекомендуется использовать для передачи защищенный URL (с протоколом https).

Элемент	Родительский элемент	Обязательный или нет
<dfpvideo:lastMediaModifiedDate>	<item>	Рекомендуемый
Описание Дата последнего изменения видеофайла, на который ссылается параметр <dfpvideo:ingestUrl>. Если это значение обновляется в фиде, то значение в поле lastModifiedDate также необходимо изменить. Все отметки времени должны соответствовать стандартам RFC 822 или IS0 8601. Если в строке отметки времени не указан часовой пояс, по умолчанию устанавливается стандартное тихоокеанское время. Примеры <dfpvideo:lastMediaModifiedDate>2006-02-19T04:22:39+05:00</dfpvideo:lastMediaModifiedDate> <dfpvideo:lastMediaModifiedDate>Sun, 19 Feb 2006 09:22:39 +0000</dfpvideo:lastMediaModifiedDate> Примеры каждого формата Примеры RFC 822 Wed, 31 Oct 2016 08:00:00 EST Wed, 31 Oct 2016 13:00:00 GMT Wed, 31 Oct 2016 15:00:00 +0200 ISO 8601 20161031 2016-10-31 2016-10-31T08:00:00+01:00

Элемент	Родительский элемент	Обязательный или нет
<dfpvideo:closedCaptionUrl>	<item>	См. примечание*
Описание *Обязателен, только если в интерфейсе включены субтитры. В этом элементе указывается URL файла с субтитрами. Все доступные файлы субтитров должны быть представлены в фиде несколькими элементами closedCaptionUrl – по одному файлу на каждый язык. Субтитры из манифеста HLS для видео по запросу Если этот элемент есть в фиде, добавляются только субтитры из фида, а субтитры, указанные в манифесте HLS, пропускаются. Субтитры из манифеста HLS добавляются только в случае, если аналогичных элементов нет в фиде. Поддерживаемые форматы: TTML/DXFP (application/ttaf+xml) и WebVTT (text/vtt). Обязательный атрибут language не может быть пустым. Указывайте в нем тот же язык, что и в файле субтитров. При этом язык должен соответствовать спецификации RFC5646и не может содержать строку $$$$$. Этот атрибут аналогичен атрибуту xml:lang, используемому в XML. Атрибут name не может содержать строку $$$$$. Атрибут type соответствует MIME-типу файла с субтитрами. Для атрибута characteristics следует задать одно из указанных ниже значений (также его можно оставить пустым)**. public.accessibility.transcribes-spoken-dialog public.accessibility.describes-music-and-sound public.easy-to-read **Если для атрибута characteristics не заданы перечисленные выше значения, появится предупреждение, однако атрибут по-прежнему будет работать. Комбинация атрибутов language и name, относящихся к одному источнику контента, должна быть уникальной для каждого файла субтитров. Например, могут использоваться варианты [language="en", name="English"] и [language="en", name="English (CC)"]. Примеры <dfpvideo:closedCaptionUrl language="en" name="English" type="text/vtt">http://cdn.com/subtitle.vtt</dfpvideo:closedCaptionUrl> <dfpvideo:closedCaptionUrl language="en" name="English (CC)" characteristics="public.accessibility.describes-music-and-sound" type="text/vtt">http://cdn.com/subtitle.vtt</dfpvideo:closedCaptionUrl

Элемент	Родительский элемент	Обязательный или нет
<dfpvideo:fw_caid>	<item>	См. примечание*
Описание *Обязателен только для пользователей Freewheel. В этом элементе указывается пользовательский идентификатор ресурса Freewheel, используемый для таргетинга. Пример <dfpvideo:fw_caid>621160003648<dfpvideo:fw-caid>

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