Как страница слышит баннер

Рекламный формат часто работает внутри iframe, отдельной области страницы со своим документом. Между таким документом и страницей можно обмениваться сообщениями через postMessage. Например, формат сообщает, что пользователь попросил открыть подробности. Страница принимает сообщение и меняет состояние интерфейса. Этот обмен следует описать так же точно, как любое действие с рекламным размещением.

У сообщения есть origin, который отражает происхождение отправителя, и source, указывающий окно. Полезная нагрузка находится в data. MDN рекомендует проверять отправителя при приёме и ограничивать адресата при отправке. Для формы команды нужна отдельная проверка данных. Поле с именем события может прийти от другого окна, которое тоже умеет отправлять сообщения. MDN, Window.postMessage

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

Сначала назовите действие

Для приёмки запишите разрешённую команду обычными словами. Например, «открыть учебную карточку товара в том же демонстрационном блоке». Затем перечислите данные, которые действительно нужны для этого действия. В нашем демо это фиксированный тип команды и идентификатор тестовой карточки. Время, URL перехода и произвольный HTML для этой операции не нужны.

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

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

Что показывает учебное демо

Откройте демонстрацию обмена сообщениями. Кнопки запускают четыре собственных теста редакции. Они используют реальные сообщения между рамками браузера. Внешних рекламных SDK в примере нет. Вместо покупки или перехода результатом служит смена состояния учебной панели и запись о принятии либо отклонении.

В сценарии «Согласованная рамка» правильный отправитель передаёт ожидаемый объект. Панель получает команду. В сценарии «Другое окно» тот же объект приходит из соседней рамки. Адрес происхождения совпадает, а окно отличается. Получатель отклоняет сообщение. Это пример, в котором одной проверки домена недостаточно.

Третий сценарий отправляет сообщение из рамки с непрозрачным происхождением. В журнале браузер указывает origin как null. Это техническая строка, которую могут получить разные изолированные документы. Она не идентифицирует вашего подрядчика. В демонстрации такой отправитель отклоняется. Если реальная архитектура использует подобную среду, потребуется отдельно спроектировать согласованный способ обмена.

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

Почему сравнивают точное происхождение

Происхождение включает схему, хост и порт. Для согласованного HTTPS-адреса соседний порт или другой поддомен требуют отдельного решения. Поиск знакомой строки внутри адреса этого не обеспечивает. В техническом контракте укажите точные значения, которые допустимы для нужного режима. Если для тестового и рабочего окружений адреса разные, перечислите их явно.

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

OWASP описывает проверки происхождения и содержимого для web messaging. В рекламной приёмке эти рекомендации превращаются в конкретные ожидания для каждой команды. Полезно попросить разработчика показать участок приёма, точное сравнение адреса и проверку формы. Скриншот работающей анимации ничего не сообщает о том, что произойдёт при сообщении из другой рамки. OWASP HTML5 Security Cheat Sheet

Как связать событие с экземпляром рекламы

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

Проверьте, что случится после замены креатива. Старый документ может прислать сообщение с задержкой. Если состояние уже относится к новой рекламе, устаревшая команда не должна менять его. Для приёмки согласуйте момент, после которого сообщения прежнего экземпляра отклоняются. Сами правила зависят от устройства загрузчика. Общий номер кампании часто не позволяет различить отдельные баннеры.

Если вы используете маркер сессии, не считайте его заменой проверке происхождения. Он решает задачу связи с экземпляром. Перечень доверенных окон и допустимых команд остаётся отдельной частью договора. В тестовом журнале полезно сохранить причину отказа так, чтобы оператор видел различие между неизвестной рамкой, старой сессией и неверным типом поля.

Что проверить на компьютере и телефоне

Повторите каждый сценарий с чистого состояния. После первого принятия сбросьте панель и журнал. Иначе можно принять след предыдущей команды за результат нового теста. Сверьте, что заблокированные сообщения действительно не меняют состояние. Запись «отклонено» сама по себе ещё не гарантирует, что побочное действие не произошло до проверки.

На небольшом экране проверяйте доступность кнопок и читаемость результата. Клавиатура должна позволять пройти те же действия. Демо использует обычные кнопки, а сообщения журнала получают доступное текстовое описание. Реальный формат проверяйте внутри того способа встраивания, который выбрала площадка. Открытие HTML в отдельной вкладке не воспроизводит отношения между его окнами.

При локальном открытии через file адрес происхождения может отличаться от рабочего HTTPS. Для демонстрации используйте размещённую на сайте версию. В тестовом стенде подрядчика запишите адрес верхней страницы, адрес рамки и атрибуты её изоляции. Без этих сведений одинаковый файл может вести себя по-разному у двух проверяющих.

Пакет для приёмки подрядчика

Попросите разработчика перечислить команды, допустимые данные и ожидаемые изменения интерфейса. Для каждой команды проверьте успешное выполнение и два отдельных отказа. Один с недопустимым отправителем, другой с неверной структурой данных. Журнал должен позволять связать результат с конкретной сборкой формата и адресом стенда. Секреты и персональные сведения в такую выгрузку не включают.

Медийная команда задаёт, какое действие пользователя должно породить сообщение. Техническая команда подтверждает, какая рамка его отправила и какой компонент исполнил. Если измерительный счётчик считает все входящие сообщения без проверки, сравните его с числом принятых команд. Отдельно выясните, нужны ли метрике повторные нажатия или уникальные взаимодействия.

Критерий готовности прост: согласованный отправитель вызывает нужное действие, остальные сценарии оставляют интерфейс в исходном состоянии и дают понятную причину отказа. Для российского рекламного кабинета добавьте эту проверку к обычной приёмке переходов и размеров. Вопросы отображения на телефоне разобраны в материале о касании и наведении. Проверка содержимого фида есть в разборе границы текста и HTML. Термины собраны в глоссарии.