В этом руководстве описано, как использовать Google Mobile Ads SDK для загрузки и показа объявлений из рекламной сети LY Ads Network с помощью медиации, а также как настроить каскадную интеграцию. В ней рассказывается, как добавить рекламную сеть LY Ads в конфигурацию медиации рекламного блока, а также как интегрировать SDK и адаптер рекламной сети LY Ads в приложение для iOS.
Поддерживаемые интеграции и форматы объявлений
Адаптер медиации для рекламной сети LY Ads Network поддерживает следующие возможности:
| Интеграция | |
|---|---|
| Ставки | |
| Водопад | |
| Форматы | |
| Баннер | |
| Межстраничное объявление | |
| Бонус предоставлен | |
| Стандартное | |
Требования
Прежде чем продолжить, убедитесь, что:
iOS 13.0 или более поздней версии.
[Для назначения ставок] Чтобы интегрировать все поддерживаемые форматы объявлений в назначение ставок, используйте адаптер LY Ads Network 2.8.20240827.0 или более поздней версии (рекомендуется последняя версия).
Последняя версия Google Mobile Ads SDK.
Шаг 1. Задайте настройки в интерфейсе рекламной сети LY Ads Network
Зарегистрируйтесь и войдите в аккаунт LY рекламной сети.
Как добавить приложение
Перейдите на вкладку App (Приложение) и нажмите кнопку New registration (Новая регистрация).
Заполните форму и нажмите Регистрация.
Запишите идентификатор приложения.
Создайте рекламное место
На вкладке Приложение выберите приложение, чтобы посмотреть сведения о нем. В разделе Слот нажмите Добавить.
Заполните форму, чтобы получить подробную информацию о слоте. В разделе Тип назначения ставок выберите Стандартный, чтобы настроить этот рекламный блок для каскадной медиации, или Назначение ставок в SDK Google, чтобы настроить его для назначения ставок. Заполнив форму, нажмите Создать.
Запишите идентификатор рекламного места.
После создания первого рекламного места нажмите 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 в интерфейсе Менеджера рекламы
Войдите в аккаунт Менеджера рекламы.
Добавьте LY Ads Network в список компаний
Ставки
Этот шаг не требуется для интеграции с назначением ставок.
Водопад
Перейдите в раздел Администрирование > Компании и на вкладке Все компании нажмите кнопку Новая компания. Выберите Рекламная сеть.

В качестве рекламной сети выберите LY Ads Network, введите уникальное название и включите медиацию. Включите Автоматический сбор данных и введите идентификатор ключа API и секретный ключ API, полученные в предыдущем разделе.
Поля Имя пользователя и Пароль заполнять не нужно. Нажмите Сохранить.

Включить передачу защищенных сигналов
Ставки
Нажмите Администрирование > Глобальные настройки. Перейдите на вкладку Настройки аккаунта Ad Exchange, проверьте и включите Передача защищенных сигналов. Нажмите Save (Сохранить).

Водопад
Для интеграции каскада этот шаг не требуется.
Передавать защищенные сигналы в запросах ставок
Ставки
Нажмите Инвентарь > Защищенные сигналы. В разделе Защищенные сигналы найдите LY Ads Network и сдвиньте переключатель Включить интеграцию с приложениями вправо.

Нажмите Сохранить.
Водопад
Для интеграции каскада этот шаг не требуется.
Как разрешить передачу защищенных сигналов для назначения ставок в SDK
Ставки
Нажмите Выполнение > Настройки каналов спроса. На вкладке Настройки по умолчанию включите параметр Разрешить передачу защищенных сигналов для назначения ставок в SDK.

Нажмите Сохранить.
Водопад
Для интеграции каскада этот шаг не требуется.
Как настроить назначение ставок в LY Ads Network
Ставки
Перейдите в раздел Выполнение > Системы назначения ставок и нажмите Перейти к назначению ставок в SDK.

Нажмите Новая система назначения ставок.

Выберите LY Ads Network в качестве системы назначения ставок.

Нажмите Продолжить, чтобы включить назначение ставок в SDK для этой системы назначения ставок.

Нажмите Готово.
Водопад
Для интеграции каскада этот шаг не требуется.
Как настроить сопоставление рекламных блоков
Ставки
Перейдите в раздел Выполнение > Системы назначения ставок и нажмите Перейти к назначению ставок в SDK.

Выберите компанию для рекламной сети LY.

Перейдите на вкладку Сопоставление рекламных блоков и нажмите Новое сопоставление рекламных блоков.

Выберите Определенный рекламный блок. Выберите рекламный блок и формат, укажите Мобильное приложение в качестве типа инвентаря и выберите мобильное приложение. Затем введите идентификатор приложения и идентификатор рекламного места, полученные в предыдущем разделе.
Нажмите Сохранить.

Водопад
Нажмите Выполнение > Группы доходности > Новая группа доходности. Выберите Инвентарь и Приложение.

Прокрутите страницу до раздела Партнеры по группе доходности и нажмите Добавить партнера по медиации.

Выберите компанию, которую вы создали для рекламной сети LY Ads Network в предыдущем разделе. В качестве типа интеграции выберите Медиация с использованием Mobile SDK, в качестве платформы – iOS, а в качестве статуса – Активно.
Укажите идентификатор приложения и идентификатор рекламного места, полученные в предыдущем разделе, а также цену за тысячу показов по умолчанию. Нажмите Сохранить.

Шаг 3. Импортируйте SDK и адаптер рекламной сети LY Ads
Рекомендуемый способ: Swift Package Manager
Прежде чем продолжить, убедитесь, что у вас установлена минимальная поддерживаемая версия адаптера – 2.9.20251119.
Чтобы добавить зависимость пакета в проект, выполните следующие действия:
В Xcode выберите File (Файл) > Add Package Dependencies (Добавить зависимости пакетов).
В появившемся окне найдите следующий URL пакета:
https://github.com/googleads/googleads-mobile-ios-mediation-line.gitВ разделе Правило зависимости выберите Ветвь.
В текстовом поле введите
main.
Интеграция вручную
- Скачайте последнюю версию LY Ads Network SDK и добавьте
FiveAd.frameworkв проект. - Скачайте последнюю версию адаптера рекламной сети LY Ads по ссылке для скачивания в журнале изменений и свяжите
LineAdapter.frameworkв своем проекте.
Через CocoaPods
Добавьте в файл Podfile проекта следующую строку:
pod 'GoogleMobileAdsMediationLine'
В командной строке выполните следующую команду:
pod install --repo-updateШаг 4. Добавьте необходимый код
Как реализовать SKAdNetwork
Добавьте идентификаторы SKAdNetwork в файл Info.plist проекта, следуя документации рекламной сети LY Ads Network.
Шаг 5. Протестируйте реализацию
Как включить тестовые объявления
Убедитесь, что вы зарегистрировали тестовое устройство в Менеджере рекламы.
Адаптер рекламной сети LY Ads содержит вспомогательный метод, позволяющий включить тестовый режим для рекламной сети LY Ads. Чтобы обеспечить правильную передачу данных в LY Ads Network SDK, задайте этот параметр до инициализации Google Mobile Ads SDK.
Swift
import LineAdapter
// ...
GADMediationAdapterLine.testMode = true
Objective-C
#import <LineAdapter/LineAdapter.h>
// ...
GADMediationAdapterLine.testMode = YES;
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления из рекламной сети LY Ads Network, включите тестирование отдельного источника объявлений в инспекторе объявлений, используя источники объявлений LY Ads Network.
Необязательные действия
Параметры для сетей
Адаптер рекламной сети LY Ads поддерживает дополнительный параметр запроса, который можно передать адаптеру с помощью класса GADMediationAdapterLineExtras. Этот класс включает следующие свойства:
adAudio- Указывает, включен ли по умолчанию звук в баннерах, межстраничных объявлениях и объявлениях с вознаграждением.
Ниже приведен пример кода, в котором показано, как создать запрос объявления с этими параметрами.
Swift
import LineAdapter
// ...
let request = GAMRequest()
let extras = GADMediationAdapterLineExtras()
extras.adAudio = GADMediationAdapterLineAdAudio.unmuted
// ...
request.register(extras)
Objective-C
#import <LineAdapter/LineAdapter.h>
// ...
GAMRequest *request = [GAMRequest request];
GADMediationAdapterLineExtras *extras = [[GADMediationAdapterLineExtras alloc] init];
extras.adAudio = GADMediationAdapterLineAdAudioUnmuted;
// ...
[request registerAdNetworkExtras:extras];
Использование нативных объявлений
Отображение объявлений
Адаптер рекламной сети LY Ads заполняет следующие поля для GADNativeAd.
| Поле | Объекты, которые всегда добавляются адаптером рекламной сети LY Ads |
|---|---|
| Заголовок | |
| Изображение | |
| Body | |
| Значок приложения | 1 |
| Призыв к действию | |
| Оценка | |
| Магазин | |
| Цена |
1 LY Ads Network SDK не предоставляет объект значка приложения для нативных объявлений. Вместо этого адаптер LY Ads Network заполняет значок приложения прозрачным изображением.
Коды ошибок
Если адаптер не получает объявление от рекламной сети LY Ads, вы можете проверить причину ошибки в ответе на запрос объявления, используя GADResponseInfo.adNetworkInfoArray в следующих классах:
GADMediationAdapterLine
Ниже приведены коды и сообщения, которые адаптер рекламной сети LY Ads генерирует, когда не удается загрузить объявление.
| Код ошибки | Поместье | Причина |
|---|---|---|
| 1-10 | Отправлено LY Ads Network SDK | SDK рекламной сети LY Ads вернул ошибку, связанную с SDK. Дополнительную информацию можно найти в документации рекламной сети LY Ads Network. |
| 101 | com.google.ads.mediation.line | Недопустимые параметры сервера (например, отсутствует идентификатор приложения или рекламного места). |
| 102 | com.google.ads.mediation.line | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому рекламной сетью LY Ads Network. |
| 103 | com.google.ads.mediation.line | Не удалось загрузить объект изображения значка "Информация" в нативном объявлении. |
| 104 | com.google.ads.mediation.line | Не удалось собрать сигналы для назначения ставок. |
| 105 | com.google.ads.mediation.line | Не удалось инициализировать загрузчик объявлений рекламного SDK LINE Ads. |
Журнал изменений адаптера медиации LINE для iOS
Версия 3.1.2.0
- Подтверждена совместимость с FiveAd SDK версии 3.1.2.
Создано и протестировано с помощью:
- Google Mobile Ads SDK версии 13.12.0.
- FiveAd SDK версии 3.1.2.
Версия 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
- Теперь адаптер передает флаг
ageRestrictedTreatmentGoogle Mobile Ads SDK в COPPA API FiveAd SDK.
Создано и протестировано с помощью:
- Google Mobile Ads SDK версии 13.3.0.
- FiveAd SDK версии 3.0.1.
Версия 3.0.1.0
- Подтверждена совместимость с FiveAd SDK версии 3.0.1.
Создано и протестировано с помощью:
- Google Mobile Ads SDK версии 13.1.0.
- FiveAd SDK версии 3.0.1.
Версия 3.0.0.1
- Зависимость Google Mobile Ads SDK обновлена до версии 13.0.0.
Создано и протестировано с помощью:
- Google Mobile Ads SDK версии 13.0.0.
- FiveAd SDK версии 3.0.0.
Версия 3.0.0.0
- Подтверждена совместимость с FiveAd SDK версии 3.0.0.0.
Создано и протестировано с помощью:
- Google Mobile Ads SDK версии 12.14.0.
- FiveAd SDK версии 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
- Подтверждена совместимость с FiveAd SDK версии 2.9.20251119.
Создано и протестировано с помощью:
- 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.
- FiveAd SDK версии 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.
- FiveAd SDK версии 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.
- FiveAd SDK версии 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.
- FiveAd SDK версии 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.
- FiveAd SDK версии 2.7.20240214.
Версия 2.7.20240214.0
- Подтверждена совместимость с FiveAd SDK версии 2.7.20240214.
Создано и протестировано с помощью:
- Google Mobile Ads SDK версии 11.0.1.
- FiveAd SDK версии 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.