Эта страница переведена с помощью Cloud Translation API.

Класс: AdDisplayContainer

Google. Има . AdDisplayContainer

статический класс

Этот класс представляет собой контейнер для показа рекламы. SDK автоматически создаст структуры внутри параметра containerElement для размещения видеообъявлений и оверлеев.

Когда создается экземпляр этого класса, он создает IFRAME в containerElement и загружает ядро SDK. Этот IFRAME должен быть сохранен для правильной работы SDK. Когда все объявления будут воспроизведены и SDK больше не нужен, используйте метод destroy() для выгрузки SDK.

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

Примечание. Всегда необходимо вызывать метод initialize() в коде, который был непосредственно вызван действием пользователя (например, щелчком или касанием).

Конструктор

AdDisplayContainer

новый AdDisplayContainer (containerElement, videoElement, clickTrackingElement)

Параметр
контейнерЭлемент	Элемент для отображения рекламы. Этот элемент необходимо вставить в DOM перед созданием AdDisplayContainer. Значение не должно быть нулевым.
видеоЭлемент	Необязательный Задает альтернативный элемент воспроизведения видеорекламы. Мы рекомендуем всегда передавать ваш контент видеоплееру. Значение не должно быть нулевым.
clickTrackingElement	Необязательный Указывает альтернативный элемент клика по видеообъявлению. Оставьте это значение пустым, чтобы SDK мог обрабатывать клики. Даже если SDK предоставлен, он будет использовать настраиваемый элемент отслеживания кликов только в том случае, если креативы, отличные от AdSense/AdX, отображаются в средах, не поддерживающих элементы пользовательского интерфейса, накладывающиеся на видеопроигрыватель (например, iPhone или Android до версии 4.0). Пользовательский элемент отслеживания кликов никогда не должен отображаться поверх видеопроигрывателя, поскольку он может перехватывать клики по элементам пользовательского интерфейса, отображаемым SDK. Также обратите внимание, что SDK не изменит видимость пользовательского элемента отслеживания кликов. Это означает, что если предоставлен настраиваемый элемент отслеживания кликов, он должен правильно отображаться при воспроизведении линейного объявления. Вы можете проверить ima.AdsManager.isCustomClickTrackingUsed при запуске события ima.AdEvent.Type.STARTED, чтобы определить, отображать ли ваш пользовательский элемент отслеживания кликов. Если это подходит для вашего пользовательского интерфейса, вы должны скрыть элемент отслеживания кликов, когда срабатывает событие ima.AdEvent.Type.CONTENT_RESUME_REQUESTED. Значение не должно быть нулевым.

Параметр

контейнерЭлемент

Элемент для отображения рекламы. Этот элемент необходимо вставить в DOM перед созданием AdDisplayContainer.

Значение не должно быть нулевым.

видеоЭлемент

Необязательный

Задает альтернативный элемент воспроизведения видеорекламы. Мы рекомендуем всегда передавать ваш контент видеоплееру.

Значение не должно быть нулевым.

clickTrackingElement

Необязательный

Указывает альтернативный элемент клика по видеообъявлению. Оставьте это значение пустым, чтобы SDK мог обрабатывать клики. Даже если SDK предоставлен, он будет использовать настраиваемый элемент отслеживания кликов только в том случае, если креативы, отличные от AdSense/AdX, отображаются в средах, не поддерживающих элементы пользовательского интерфейса, накладывающиеся на видеопроигрыватель (например, iPhone или Android до версии 4.0). Пользовательский элемент отслеживания кликов никогда не должен отображаться поверх видеопроигрывателя, поскольку он может перехватывать клики по элементам пользовательского интерфейса, отображаемым SDK. Также обратите внимание, что SDK не изменит видимость пользовательского элемента отслеживания кликов. Это означает, что если предоставлен настраиваемый элемент отслеживания кликов, он должен правильно отображаться при воспроизведении линейного объявления. Вы можете проверить ima.AdsManager.isCustomClickTrackingUsed при запуске события ima.AdEvent.Type.STARTED, чтобы определить, отображать ли ваш пользовательский элемент отслеживания кликов. Если это подходит для вашего пользовательского интерфейса, вы должны скрыть элемент отслеживания кликов, когда срабатывает событие ima.AdEvent.Type.CONTENT_RESUME_REQUESTED.

Значение не должно быть нулевым.

Методы

разрушать

разрушать()

Уничтожает внутреннее состояние и ранее созданные элементы DOM. IMA SDK будет выгружен, и дальнейшие вызовы каких-либо API выполняться не будут.

инициализировать

инициализировать()

Инициализирует внутренние элементы видео для воспроизведения. Вы должны вызвать этот метод как прямой результат действия пользователя, чтобы браузер мог пометить элемент видео как инициированный пользователем.

Некоторые браузеры разрешают воспроизведение видео без взаимодействия с пользователем, если видео отключено. Для этого используйте AdsRequest.setAdWillPlayMuted(true) и вызовите этот метод перед AdsManager.start() .