Загружает из сети рекламный баннер. По завершению загрузки вызывается обработчик. После загрузки, при вызове метода УстановитьОтображениеРекламногоБаннера рекламный баннер будет отображен без задержки на загрузку. Вызов метода не обязателен для показа рекламы.
Синтаксис
НачатьЗагрузкуРекламногоБаннера(<ОписаниеОповещения>)Полное описание, параметры и ограничения
МенеджерОтображенияРекламы.НачатьЗагрузкуРекламногоБаннера (AdRepresentationManager.BeginAdBannerDownloading)
МенеджерОтображенияРекламы (AdRepresentationManager)
НачатьЗагрузкуРекламногоБаннера (BeginAdBannerDownloading)
Доступен, начиная с версии 8.3.14.
Синтаксис:
НачатьЗагрузкуРекламногоБаннера(<ОписаниеОповещения>)
Параметры:
<ОписаниеОповещения> (необязательный)
Тип: ОписаниеОповещения.
Ссылка на процедуру, которая будет вызвана после завершения загрузки рекламы из сети. Процедура должна иметь следующие параметры:
Статус (Status) – тип СтатусРекламы. Показывает статус рекламного блока по результатам загрузки.
Идентификатор (ID) – тип Строка. Рекламный идентификатор для которого закончилась загрузка.
<ДополнительныеПараметры> – Значение, которое было указано при создании объекта ОписаниеОповещения.
Описание:
Загружает из сети рекламный баннер. По завершению загрузки вызывается обработчик.
После загрузки, при вызове метода УстановитьОтображениеРекламногоБаннера рекламный баннер будет отображен без задержки на загрузку.
Вызов метода не обязателен для показа рекламы.
Доступность:
Мобильный клиент, мобильное приложение (клиент).
См. также:
МенеджерОтображенияРекламы, метод ЗагрузитьРекламныйБаннерАсинх
Использование в версии:
Доступен, начиная с версии 8.3.14.
Описание изменено в версии 8.3.18.
Методическая информация
Практические примеры
Загрузить баннер с обработчиком завершения
Обработчик получает статус, идентификатор блока и собственные дополнительные параметры.
Где и как запускать
Мобильное приложение Android/iOS или мобильный клиент, клиентский модуль управляемой формы. Требуется настройка магазина или рекламы; не серверный модуль.
Подготовка
Вставьте весь блок в модуль собственной управляемой формы. Создайте команду и кнопку; в клиентском обработчике команды вызовите первую процедуру без параметров. Обработчики с Экспорт вызывает платформа, вручную их не вызывайте.
Используйте учебное мобильное приложение с настроенной рекламой и тестовыми рекламными блоками. Показанные ca-app-pub-... — вымышленные образцы: замените их собственными тестовыми идентификаторами из рекламного сервиса.
До команды включите рекламу и задайте идентификатор баннера. Оба обработчика должны находиться в одной форме.
&НаКлиенте
Процедура ЗагрузитьБаннер()
Оповещение = Новый ОписаниеОповещения("БаннерЗагружен", ЭтотОбъект, "Главный экран");
ОтображениеРекламы.НачатьЗагрузкуРекламногоБаннера(Оповещение);
КонецПроцедуры
&НаКлиенте
Процедура БаннерЗагружен(Статус, Идентификатор, Дополнительно) Экспорт
Сообщить(Дополнительно + ": " + Идентификатор + ", " + Строка(Статус));
Если Статус = СтатусРекламы.ГотоваКОтображению Тогда
ОтображениеРекламы.УстановитьОтображениеРекламногоБаннера(ОтображениеРекламногоБаннера.Низ);
КонецЕсли;
КонецПроцедурыРазбор по шагам
Создайте ОписаниеОповещения с именем экспортного обработчика.
Начните загрузку без ручного вызова обработчика.
В обработчике покажите статус; только готовый баннер разместите внизу.
Как проверить результат
В обработчик приходит фактический рекламный идентификатор.
При статусе, отличном от готовности, положение баннера не меняется.
Ожидаемый результат
Платформа сообщает результат загрузки баннера в указанный обработчик.
На что обратить внимание
Метод начала загрузки не возвращает готовый баннер. Не имитируйте завершение прямым вызовом БаннерЗагружен.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.