Работа с рекламой
Общий принцип взаимодействия с рекламными блоками.
Идентификаторы из личного кабинета
Идентификатор паблишера (publisher_id)
Для инициализации SDK вам потребуется идентификатор паблишера (publisher_id)
Ваш publisher_id находится в разделе "Настройки" в личном кабинете Yabbi.
Идентификатор рекламного блока (placement_name)
При использовании методов SDK вам потребуется идентификатор рекламного блока (placement_name) рекламного блока.
placement_name - это ID рекламного блока. Рекламные блоки создаются в личном кабинете Yabbi.
Тестовые идентификаторы
В процессе интеграции SDK для стабильного получения тестовой рекламы рекомендуем использовать специальные publisher_id и placement_name.
Publisher ID - 65057899-a16a-4877-989b-38c432a7fa15
Формат Interstitial
Yabbi Interstitial ID - b8359c60-9bde-47c9-85ff-3c7afd2bd982
Yandex Interstitial ID - cd1dff91-76d0-44c2-a6ca-fd3f446ef9b5
IronSource Interstitial ID - ec9decde-58c8-4d1b-885f-479b05f39dcb
Формат Rewarded Video
Yabbi Rewarded ID - eaac7a7f-b0b0-46d2-ac95-bd58578e9e29
Yandex Rewarded ID - 7e6334fc-ef08-45e9-9581-d18026a2fadb
IronSource Rewarded ID - 9b45ac1a-ca72-4d57-9f0f-7bab924ad1b4
Формат Banner
Yabbi Banner ID - 27668678-d138-4af4-84f4-891252086125
Форматы рекламы
Рекламная сеть Yabbi поддерживает 3 формата рекламы.
Полноэкранный баннер (Interstitial)
Реклама показывается на весь экран, содержит баннер, интерактивный баннер или видео. По тапу происходит переход по ссылке, указанной рекламодателем.
Пользователь может закрыть баннер через 3 секунды.
Такой формат обычно используется при запуске приложения, либо при переходах между экранами приложения.
Вот пример вызова действия для показа рекламы такого формата.
Видео с вознаграждением (rewarded video)
Реклама показывается на весь экран, содержит видео или интерактивный баннер. По тапу происходит переход по ссылке, указанной рекламодателем.
Пользователь может прекратить просмотр рекламы, однако в этом случае он увидит диалоговое окно, предупреждающее об отсутствии награды при закрытии видео до его завершения.
Для того, чтобы узнать, выдавать пользователю награду, или нет, используйте событие OnUserRewarded.
Подробнее работа с событиями описана ниже.
Баннер 320x50 (banner)
Реклама показывается в нижней части экрана, содержит интерактивный баннер. По тапу происходит переход по ссылке, указанной рекламодателем.
Вот пример вызова действия для показа рекламы такого формата.
Пользовательская настройка баннера 320x50
Автообновление рекламы в баннере
Для увеличения вашей прибыли мы разработали функцию автоматической смены контента в баннере.
Для настройки укажите интервал в секундах (минимум 10 секунд).
Место для показа баннера
По умолчанию баннер позиционируется в нижней части экрана, но вы можете изменить это поведение.
Показ кнопки закрытия
По умолчанию кнопка закрытия баннера не показывается, но вы можете влючить её.
Действия SDK
Работа с рекламой сводится к работе с действиями Yabbi SDK.
Initialize(обязательный). Инициализирует SDK. Достаточно один раз вызвать это действие при старте макета или перед первой загрузкой рекламы.LoadInterstitialAd / LoadRewardedAd / LoadBannerAd(обязательный). Загружает рекламу с сервера. Обычно этот метод вызывается заранее, чтобы к моменту показа контент был загружен. В таком случае время ожидания пользователем показа рекламы будет минимальным.ShowInterstitialAd / ShowRewardedAd / ShowBannerAd(обязательный). Вызывает показ рекламы при помощи плеера, встроенного в SDK.DestroyInterstitialAd / DestroyRewardedAd / DestroyBannerAd(необязательный). Уничтожает рекламный контейнер. Вы можете работать с несколькими рекламными блоками одновременно, однако мы настоятельно рекомендуем уничтожать ненужные во избежание проблем с памятью и других неприятностей.SetBannerCustomSettings(необязательный). Предназначен для установки пользовательских настроек для баннера 320x50.SetUserConsent(необязательный). Предназначен для передачи статуса согласия пользователя на сбор, обработку и использование персональных данных. По умолчанию -false, т.е. пользователь не дал согласия на использование его данных в рекламных и иных целях. Рекомендуем вам использовать это действие для повышения качества рекламной монетизации.
Использование нескольких рекламных блоков
Вы можете работать с несколькими рекламными блоками асинхронно, то есть вызывать действия с разными placement_name и форматами независимо друг от друга с помощью действий LoadInterstitialAd / LoadRewardedAd / LoadBannerAd асинхронно, то есть загружать несколько рекламных блоков одновременно.
Отслеживание рекламных событий
Yabbi SDK позволяет вам отслеживать события, происходящие с рекламой, чтобы использовать их для интеграции рекламы в логику вашего приложения.
Для отслеживания событий необходимо предоставить класс для работы.
Учтите, что рекламные события отрабатывают на любой рекламный блок.
Т.е. если вы вызываете загрузку 2 рекламных блоков одновременно, событие загрузки отработает 2 раза, для каждого блока.
Вот примеры установки существующих рекламных событий.
IsInterstitialAdReady- проверяет статус загрузки рекламного блока. Условие возвращаетtrueлибоfalse. При отрицательном ответе попытка показать рекламу ни к чему не приведёт.Несмотря на то, что использование этого метода необязательно, мы настоятельно рекомендуем проверять статус загрузки рекламы, прежде чем пытаться её показать.
OnInterstitialLoaded- вызывается когда реклама загружена и готова к показу.OnInterstitialLoadFailed- вызывается если в загрузке рекламы произошла ошибка.OnInterstitialShown- вызывается когда начался показ рекламы.OnInterstitialShowFailed- вызывается если в загрузке рекламы произошла ошибка.OnInterstitialClosed- вызывается когда реклама была закрыта пользователем.
Last updated
Was this helpful?