Как интегрировать LY Ads Network с медиацией

В этом руководстве описывается, как использовать Google Mobile Ads SDK для загрузки и показа объявлений из рекламной сети LY Ads Network с помощью медиации, а также рассматривается каскадная интеграция. В нем рассказывается, как добавить LY Ads Network в конфигурацию медиации рекламного блока и как интегрировать SDK и адаптер LY Ads Network в приложение для iOS.

Поддерживаемые интеграции и форматы объявлений

Адаптер медиации для рекламной сети LY Ads Network поддерживает следующие возможности:

Требования

Прежде чем продолжить, убедитесь, что:

• Целевая версия iOS – 13.0 или более поздняя.

• [Для назначения ставок] Чтобы интегрировать все поддерживаемые форматы объявлений в назначение ставок, используйте адаптер рекламной сети LY версии 2.8.20240827.0 или более поздней (рекомендуется последняя версия).

• Последняя версия Google Mobile Ads SDK.

• Настройте медиацию.

Шаг 1. Настройте конфигурации в интерфейсе LY Ads Network

Зарегистрируйтесь и войдите в аккаунт LY Ads Network.

Как добавить новое приложение

Перейдите на вкладку Приложение и нажмите кнопку Новая регистрация.

Заполните форму и нажмите Регистрация.

Запишите идентификатор приложения.

Как создать рекламное место

На вкладке Приложение выберите приложение, чтобы посмотреть сведения о нем. В разделе Слот нажмите Добавить.

Заполните форму, чтобы получить подробную информацию о слоте. В разделе Тип назначения ставок выберите Стандартный, чтобы настроить этот слот для медиации с использованием каскада, или Назначение ставок в Google SDK, чтобы настроить этот слот для назначения ставок. Заполнив форму, нажмите Создать.

Запишите идентификатор рекламного места.

После создания первого рекламного места нажмите Review (Проверить) на странице приложения, чтобы получить одобрение от LY Ads Network. Это может занять некоторое время. Если у вас возникнут вопросы, обратитесь к представителю LY Ads Network.

Как создать ключ Reporting API

Перейдите на вкладку Управление ключами Reporting API и нажмите кнопку Создать ключ API.

Заполните форму и нажмите Сохранить.

Запишите идентификатор ключа API и секретный ключ API.

Обновите файл app-ads.txt

Authorized Sellers for Apps (Авторизованные продавцы приложений), или app-ads.txt, – это инициатива IAB Tech Lab, которая позволяет издателям указывать авторизованных продавцов своего рекламного инвентаря. Чтобы избежать значительного снижения дохода от рекламы, используйте файл app-ads.txt. Если вы ещё не создали файл app-ads.txt для Менеджера рекламы, сделайте это.

Чтобы реализовать app-ads.txt для рекламной сети LY, ознакомьтесь со статьей О файле app-ads.txt.

Шаг 2. Настройте источник спроса LY Ads Network в интерфейсе Менеджера рекламы

Войдите в аккаунт Менеджера рекламы.

Добавьте LY Ads Network в разделе "Компании"

Как включить передачу защищенных сигналов

Передавать защищенные сигналы в запросах ставок

Как разрешить передачу защищенных сигналов для назначения ставок в SDK

Как настроить назначение ставок в LY Ads Network

Как настроить сопоставление рекламных блоков

Шаг 3. Импортируйте SDK и адаптер рекламной сети LY Ads

Используйте Swift Package Manager

Прежде чем продолжить, убедитесь, что у вас установлена минимальная поддерживаемая версия адаптера – 2.9.20251119.

Чтобы добавить зависимость пакета в проект, выполните следующие действия:

1. В Xcode выберите File (Файл) > Add Package Dependencies (Добавить зависимости пакетов).

2. В появившемся окне найдите следующий URL пакета:

   https://github.com/googleads/googleads-mobile-ios-mediation-line.git
   

3. В разделе Правило зависимости выберите Ветвь.

4. В текстовом поле введите main.

Через CocoaPods

Добавьте в Podfile проекта следующую строку:

pod 'GoogleMobileAdsMediationLine'

В командной строке выполните следующую команду:

pod install --repo-update

Интеграция вручную

• Скачайте последнюю версию LY Ads Network SDK и добавьте ссылку FiveAd.framework в свой проект.
• Скачайте последнюю версию адаптера рекламной сети LY Ads Network по ссылке для скачивания в журнале изменений и свяжите LineAdapter.framework в своем проекте.

Шаг 4. Добавьте необходимый код

Как реализовать SKAdNetwork

Добавьте идентификаторы SKAdNetwork в файл Info.plist проекта, следуя инструкциям LY Ads Network.

Шаг 5. Проверьте реализацию

Как включить тестовые объявления

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

Адаптер рекламной сети LY Ads Network содержит вспомогательный метод, позволяющий включить тестовый режим для рекламной сети LY Ads Network. Чтобы обеспечить правильную передачу данных в LY Ads Network SDK, задайте этот параметр до инициализации Google Mobile Ads SDK.

import LineAdapter
// ...

GADMediationAdapterLine.testMode = true

#import <LineAdapter/LineAdapter.h>
// ...

GADMediationAdapterLine.testMode = YES;

Проверьте тестовые объявления

Чтобы проверить, получаете ли вы тестовые объявления из сети LY Ads Network, включите тестирование отдельного источника объявлений в инспекторе объявлений, используя источник объявлений LY Ads Network.

Необязательные действия

Параметры для отдельных сетей

Адаптер рекламной сети LY Ads поддерживает дополнительный параметр запроса, который можно передать адаптеру с помощью класса GADMediationAdapterLineExtras. Этот класс включает следующие свойства:

adAudio

Указывает, включен ли по умолчанию звук в баннерах, межстраничных объявлениях и объявлениях с вознаграждением.

Ниже приведен пример кода, в котором показано, как создать запрос объявления с этими параметрами:

import LineAdapter
// ...

let request = GAMRequest()
let extras = GADMediationAdapterLineExtras()
extras.adAudio = GADMediationAdapterLineAdAudio.unmuted
// ...
request.register(extras)

#import <LineAdapter/LineAdapter.h>
// ...

GAMRequest *request = [GAMRequest request];
GADMediationAdapterLineExtras *extras = [[GADMediationAdapterLineExtras alloc] init];
extras.adAudio = GADMediationAdapterLineAdAudioUnmuted;
// ...
[request registerAdNetworkExtras:extras];

Использование нативных объявлений

Отображение объявлений

Адаптер LY Ads Network заполняет следующие поля для GADNativeAd.

¹ Для нативных объявлений SDK сети LY Ads не предоставляет объект значка приложения. Вместо этого адаптер LY Ads Network заполняет значок приложения прозрачным изображением.

Коды ошибок

Если адаптер не получает объявление от LY Ads Network, вы можете проверить основную ошибку в ответе на запрос объявления с помощью GADResponseInfo.adNetworkInfoArray в следующих классах:

GADMediationAdapterLine

Ниже приведены коды и сообщения, которые адаптер рекламной сети LY Ads Network выдает, когда не удается загрузить объявление.

Журнал изменений адаптера медиации LINE для iOS

Версия 3.1.1.0

• Подтверждена совместимость с FiveAd SDK версии 3.1.1.

Создано и протестировано с использованием:

• Google Mobile Ads SDK версии 13.9.0.
• FiveAd SDK версии 3.1.1.

Версия 3.1.0.0

• Теперь требуется iOS версии 15.0 или более поздней.
• Подтверждена совместимость с FiveAd SDK версии 3.1.0.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 13.8.0.
• FiveAd SDK версии 3.1.0.

Версия 3.0.1.2

• Обновите минимальную версию iOS, чтобы ослабить зависимость Google Mobile Ads SDK и разрешить промежуточные версии.
• Исправлена проблема, из-за которой значок "Выбор рекламы" в нативных объявлениях был слишком большим.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 13.4.0.
• FiveAd SDK версии 3.0.1.

Версия 3.0.1.1

• Теперь адаптер передает флаг ageRestrictedTreatment Google Mobile Ads SDK в COPPA API FiveAd SDK.

Создано и протестировано с использованием:

• Google Mobile Ads SDK версии 13.3.0.
• Версия 3.0.1 SDK FiveAd.

Версия 3.0.1.0

• Подтверждена совместимость с FiveAd SDK версии 3.0.1.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 13.1.0.
• Версия 3.0.1 SDK FiveAd.

Версия 3.0.0.1

• Зависимость Google Mobile Ads SDK обновлена до версии 13.0.0.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 13.0.0.
• Версия SDK FiveAd 3.0.0.

Версия 3.0.0.0

• Подтверждена совместимость с FiveAd SDK версии 3.0.0.0.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 12.14.0.
• Версия SDK FiveAd 3.0.0.

Версия 2.9.20251119.1

• Добавлена поддержка пересылки параметров tagForUnderAgeOfConsent Google Mobile Ads SDK в FiveAd SDK.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 12.14.0.
• FiveAd SDK версии 2.9.20251119.

Версия 2.9.20251119.0

• Подтверждена совместимость с версией 2.9.20251119 SDK FiveAd.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 12.14.0.
• FiveAd SDK версии 2.9.20251119.

Версия 2.9.20250930.0

• Подтверждена совместимость с FiveAd SDK версии 2.9.20250930.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 12.12.0.
• Версия SDK FiveAd 2.9.20250930.

Версия 2.9.20250912.0

• Теперь адаптер инициализирует FiveAd SDK перед каждым запросом объявления.
• Подтверждена совместимость с FiveAd SDK версии 2.9.20250912.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 12.11.0.
• FiveAd SDK версии 2.9.20250912.

Версия 2.9.20250512.0

• Теперь требуется iOS 13.0 или более поздней версии.
• Подтверждена совместимость с FiveAd SDK версии 2.9.20250512.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 12.4.0.
• Версия FiveAd SDK 2.9.20250512.

Версия 2.9.20241106.3

• Исправлена проблема, из-за которой GADMediationAdapterLine.h не был общедоступным заголовком.
• Включены флаги -fobjc-arc и -fstack-protector-all.
• Удалена проверка размера баннера для назначения ставок после успешной загрузки.
  • При каскадной загрузке баннеров размеры баннеров будут проверяться и дальше.

Создано и протестировано с использованием:

• Google Mobile Ads SDK версии 12.2.0.
• Версия SDK FiveAd 2.9.20241106.

Версия 2.9.20241106.2

• Добавлено свойство GADMediationAdapterLine.testMode, указывающее, нужно ли инициализировать FiveAd SDK в тестовом режиме. Этот флаг необходимо задать до инициализации Google Mobile Ads SDK.
• Удалена проверка состояния инициализации FiveAd SDK перед инициализацией FiveAd SDK.
• Удалена устаревшая проверка статуса нативного объявления перед скачиванием его объектов.
• Теперь требуется Google Mobile Ads SDK версии 12.0.0 или более поздней.

Создано и протестировано с использованием:

• Google Mobile Ads SDK версии 12.0.0.
• FiveAd SDK версии 2.9.20241106.

Версия 2.9.20241106.1

• Обновлен адаптер, чтобы использовать последнюю версию API загрузки объявлений для назначения ставок на баннеры.
• Исправлена ошибка, из-за которой события объявлений не пересылались корректно для межстраничных объявлений с назначением ставок.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 11.12.0.
• FiveAd SDK версии 2.9.20241106.

Версия 2.9.20241106.0

• Подтверждена совместимость с FiveAd SDK версии 2.9.20241106.

Создано и протестировано с использованием:

• Google Mobile Ads SDK версии 11.12.0.
• Версия SDK FiveAd 2.9.20241106.

Версия 2.8.20240827.1

• В CFBundleShortVersionString теперь три компонента вместо четырех.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 11.10.0.
• FiveAd SDK версии 2.8.20240827.

Версия 2.8.20240827.0

• Подтверждена совместимость с FiveAd SDK версии 2.8.20240827.
• Добавлена поддержка назначения ставок для баннеров, межстраничных, нативных объявлений и объявлений с вознаграждением.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 11.8.0.
• FiveAd SDK версии 2.8.20240827.

Версия 2.8.20240612.0

• Добавлено управление аудио для нативных объявлений с помощью GADVideoOptions.
• Подтверждена совместимость с FiveAd SDK версии 2.8.20240612.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 11.5.0.
• FiveAd SDK версии 2.8.20240612.

Версия 2.7.20240411.0

• Подтверждена совместимость с FiveAd SDK версии 2.7.20240411.

Создано и протестировано с использованием:

• Google Mobile Ads SDK версии 11.3.0.
• FiveAd SDK версии 2.7.20240411.

Версия 2.7.20240318.0

• Подтверждена совместимость с FiveAd SDK версии 2.7.20240318.

Создано и протестировано с использованием:

• Google Mobile Ads SDK версии 11.2.0.
• Версия SDK FiveAd 2.7.20240318.

Версия 2.7.20240214.1

• Теперь требуется iOS версии 12.0 или более поздней.
• Теперь требуется Google Mobile Ads SDK версии 11.0 или более поздней.
• Включите Info.plist в фреймворки в LineAdapter.xcframework.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 11.0.1.
• Версия SDK FiveAd 2.7.20240214.

Версия 2.7.20240214.0

• Подтверждена совместимость с FiveAd SDK версии 2.7.20240214.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 11.0.1.
• Версия SDK FiveAd 2.7.20240214.

Версия 2.7.20240126.0

• Подтверждена совместимость с FiveAd SDK версии 2.7.20240126.
• Реализация адаптера обновлена с учетом новых протоколов делегатов FiveAd SDK.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 10.14.0.
• FiveAd SDK версии 2.7.20240126.

Версия 2.7.20231115.0

• Подтверждена совместимость с FiveAd SDK версии 2.7.20231115.
• В modulemap добавлен заголовок GADMediationAdapterLineExtras.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 10.14.0.
• FiveAd SDK версии 2.7.20231115.

Версия 2.6.20230609.1

• Добавлен метод GADMediationAdapterLineAudioState, позволяющий управлять начальным состоянием звука в баннерах, межстраничных объявлениях и объявлениях с вознаграждением при их первом показе.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 10.14.0.
• FiveAd SDK версии 2.6.20230609.

Версия 2.6.20230609.0

• Первый выпуск!
• Добавлена поддержка каскада для баннеров, межстраничных объявлений, объявлений с вознаграждением и форматов нативных объявлений.
• Подтверждена совместимость с FiveAd SDK версии 2.6.20230609.

Разработано и протестировано с помощью:

• Google Mobile Ads SDK версии 10.9.0.
• FiveAd SDK версии 2.6.20230609.