Автоматизируйте плейлисты с рекламой

Выберите платформу: HTML5 Android iOS tvOS

Режимы работы SDK

SDK может работать в одном или нескольких режимах в зависимости от ответа на рекламу, который он получает от рекламного сервера.

Одиночное объявление
Рекламное объявление может быть воспроизведено в любой момент после отправки start сообщения в IMAAdsManager . Для воспроизведения одного рекламного объявления специальная инициализация не требуется.
Рекламный блок
Несколько рекламных блоков, которые воспроизводятся один за другим после отправки start сообщения в IMAAdsManager . Для воспроизведения одного рекламного блока специальная инициализация не требуется.
Правила рекламы
Плейлист с рекламными паузами, запланированными на определённое время для определённого контента. start сообщение игнорируется в режиме правил для рекламы. В одном плейлисте может быть запланировано несколько рекламных пауз (например, в начале, в середине или в конце ролика). Подробнее о реализации см. в разделе «Правила для рекламы» ниже.

Правила рекламы

IMA iOS SDK поддерживает полностью автоматизированные плейлисты с рекламой. Эта функция вставляет рекламные паузы в контент, как указано в Google Ad Manager при размещении рекламы. Она также значительно упрощает код видеоплеера, необходимый для поддержки рекламных пауз, включая прероллы, мидроллы и построллы.

  • При размещении рекламы в Менеджере объявлений можно указать различные правила для рекламы, например «всегда воспроизводить рекламную паузу в начале контента» или «воспроизводить минутную рекламную паузу каждые 30 минут контента».
  • При запросе рекламы рекламный сервер может вернуть плейлист с рекламой. SDK обрабатывает этот плейлист и автоматически планирует указанные рекламные паузы.
  • При инициализации AdsManager объект IMAContentPlayhead передаётся через вызов initializeWithContentPlayhead:adsRenderingSettings: :. Если вы используете AVPlayer для отображения контента, экземпляр IMAAVPlayerContentPlayhead передаётся в SDK при создании adDisplayContainer . Этот объект используется для отслеживания хода воспроизведения контента, чтобы рекламные паузы автоматически вставлялись в заданное в Ad Manager время.

    С помощью AVPlayer:

    IMAContentPlayhead *contentPlayhead =
    [[IMAAVPlayerContentPlayhead alloc] initWithAVPlayer:self.contentAVPlayer];
IMAAdsRequest *request = [[IMAAdsRequest alloc] initWithAdTagUrl:adTagUrl
                                              adDisplayContainer:adDisplayContainer
                                                 contentPlayhead:contentPlayhead
                                                     userContext:nil];

    Без AVPlayer:

    1. Реализуйте интерфейс IMAContentPlayhead .
    2. Реализуйте currentTime для возврата текущего времени вашего видеоплеера.
    3. Измените вызов инициализации IMAAdsManager на initializeWithContentPlayhead:self .
  • IMAAdsManagerDelegate используется для приостановки и возобновления воспроизведения контента во время рекламных пауз.

Примечание: После завершения воспроизведения контента или остановки пользователем воспроизведения обязательно вызовите contentComplete в IMAAdsLoader , чтобы сообщить SDK о завершении воспроизведения контента. Затем SDK воспроизводит рекламную паузу после показа, если она была запланирована. Событие ALL_ADS_COMPLETED генерируется после завершения всех рекламных пауз. Кроме того, обратите внимание, что отслеживание контента начинается с вызова метода initializeWithContentPlayhead:adsRenderingSettings объекта IMAAdsManager , и всегда следует вызывать initializeWithContentPlayhead:adsRenderingSettings перед воспроизведением контента.