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