Показ креативов с помощью SafeFrame

С 24 января 2022 г. для более эффективной изоляции контента в SafeFrame и обеспечения более высокого уровня безопасности при его показе всегда будут использоваться случайные субдомены. Настройки безопасности SafeFrame с этого момента станут недоступны.

Если вы ранее выбрали вариант "Фиксированный", настройки безопасности SafeFrame будут обновлены.

SafeFrame – это окно iframe, унифицирующее взаимодействие между контентом рекламодателя и издателя через специальный API. Технология SafeFrame в Менеджере рекламы предусматривает показ объявлений в контейнере с помощью тега GPT. Она позволяет легко размещать объявления на веб-странице, поддерживает различные дополнительные функцие, обеспечивает защиту данных и дает возможность более точно подбирать креативы.

Согласно стандартам IAB, издатели должны определенным образом подготовить свои сайты, чтобы показывать рекламу в контейнерах SafeFrame. Тем не менее технология SafeFrame поддерживается в Google Менеджере рекламы и при использовании тегов GPT активируется по умолчанию.

Чтобы избежать показа вредоносных креативов, желательно всегда использовать SafeFrame и одновременно атрибут HTML5 sandbox. Это позволит предотвратить переходы из окна iframe в документ верхнего уровня. Подробнее об атрибуте sandbox…

Подробные сведения о технологии SafeFrame и всю необходимую документацию можно найти на сайте IAB.

SafeFrame и типы креативов

Технология SafeFrame по умолчанию включена или отключена в зависимости от типа медийного креатива, который вы используете.

Если включить SafeFrame для креатива, который будет показываться на странице, не поддерживающей SafeFrame (и наоборот), могут возникнуть проблемы с отображением креатива. Принимайте решение о включении SafeFrame с учетом того, где должен показываться креатив.

• Сторонние и собственные креативы. При добавлении стороннего или собственного креатива флажок "Показывать в SafeFrame" по умолчанию установлен.
• Стандартные и пользовательские шаблоны креативов. При добавлении стандартного или пользовательского шаблона креатива флажок "Показывать в SafeFrame" по умолчанию снят.

SafeFrame и тег Google Publisher Tag (GPT)

В Менеджере рекламы можно вручную выбрать, будут ли с помощью SafeFrame показываться креативы следующих типов:

• собственные;
• сторонние;
• созданные с использованием стандартного шаблона;
• созданные с помощью пользовательского шаблона.

Для этого при добавлении таких креативов установите или снимите флажок Показывать в SafeFrame.

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

В SafeFrame не поддерживается предварительный просмотр креативов.

Google Publisher Tag API позволяет настроить принудительный показ рекламы на всех или определенном рекламном месте на странице в контейнере SafeFrame, используя параметр setForceSafeFrame.

SafeFrame и AMP-страницы

SafeFrame API поддерживает любые рекламные материалы, которые демонстрируются на AMP-страницах с помощью тегов AMP-объявлений Менеджера рекламы, за исключением объявлений AMPHTML.

Контейнер SafeFrame может разворачиваться в пределах области просмотра. Размер рекламных мест, которые располагаются в окнах SafeFrame на AMP-страницах, изменять нельзя. Поэтому связанный с креативом запрос на изменение размера будет успешным, только если рекламное место находится вне области просмотра.

Какой бы вариант вы ни выбрали в настройках, на AMP-страницах стандартные HTML-креативы всегда будут показываться в окнах SafeFrame. Убедитесь, что код ваших креативов совместим с SafeFrame.

Объявления AMPHTML

Объявления AMPHTML не показываются в SafeFrame. Поскольку технология AMPHTML отличается высокой безопасностью, такие рекламные материалы по умолчанию демонстрируются в совместимых окнах iframe.

Если на вашем сайте реализованы правила защиты контента (CSP), связанные с ними ограничения будут также распространяться на объявления AMPHTML в совместимых окнах iframe. Чтобы объявление могло показываться в междоменном окне iframe без подобных ограничений, перед запросом объявления необходимо вызвать метод googletag.pubads().setForceSafeFrame(true).

Принцип работы SafeFrame

Для интеграции SafeFrame в GPT необходимы три компонента:

1. Сам iframe-контейнер SafeFrame, созданный тегом GPT при показе объявления.
2. Код, добавленный в креатив и обращающийся к странице размещения с помощью SafeFrame API (внешнего) через метод postMessage.
3. Код, работающий вне окна SafeFrame как элемент тега GPT и представляющий собой другую сторону канала postMessage. Этот код управляет раскрытием объявления и отвечает за определение границ его видимости.

В Менеджере рекламы поддерживаются креативы, в которых SafeFrame API используется для взаимодействия с сайтами, например для раскрытия рекламного места (вниз или с наложением на контент) при нажатии на объявление. Но такое взаимодействие нужно разрешить в рекламном теге, используя функцию setSafeFrameConfig.

Тег GPT не предполагает размещения кода API на сторонних серверах. Отображение SafeFrame осуществляется с помощью тега GPT. Вы можете и дальше использовать текущую версию GPT API для настройки объявлений. Изменять тег GPT не нужно.

Теги GPT реализуют внешний SafeFrame API, чтобы обеспечить взаимодействие креатива с сайтом.

Методы, поддерживаемые SafeFrame API

Полная спецификация SafeFrame API доступна на сайте IAB.

$sf.ext.register
$sf.ext.supports
$sf.ext.geom
$sf.ext.status
$sf.ext.inViewPercentage

/* поддерживается раскрытие вниз и с наложением;
не поддерживаются нативные объявления с гибкими размерами */
$sf.ext.expand

Методы, не поддерживаемые или частично поддерживаемые API

• $sf.ext.cookie не поддерживается, поскольку креативам не предоставляется доступ к файлам cookie издателя.
• $sf.ext.meta не поддерживается для объектов, определенных издателем, и используется только для следующих стандартных объектов:
  • {String} sf_ver – представляет текущую версию SafeFrame в виде строки.
  • {Number} ck_on – проверяет, разрешены ли файлы cookie в браузере. Значение 1 – да, 0 – нет.

Мультимедийная реклама и видимость объявлений при использовании SafeFrame

SafeFrame предоставляет издателю больший контроль и ограничивает взаимодействие между объявлениями и материалами издателя благодаря использованию только тех методов, которые доступны в API. Технология применяет стандартные форматы медийной рекламы, поэтому креативы, использующие API, смогут отображаться в любой сети, поддерживающей SafeFrame.

Видимость

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

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

Active View (решение Google для оценки показов в видимой области экрана) не входит в спецификацию видимости SafeFrame. Эта функция будет работать как и прежде.

Google Консоль для издателей

Узнать, используется ли в определенном рекламном месте SafeFrame, можно с помощью Google Консоли для издателей.