Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

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

Выберите платформу: Android iOS Unity Flutter Android (устаревшая версия)

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

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

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

Интеграция
Ставки
Водопад
Форматы
Баннер
Межстраничное объявление
Бонус предоставлен
Стандартное

Требования

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

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

Последняя версия Google Mobile Ads SDK.
Настройте медиацию.

Шаг 1. Задайте настройки в интерфейсе рекламной сети LY Ads

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

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

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

Регистрация нового участника

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

Новая регистрационная форма

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

Сведения о регистрации

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

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

Добавить рекламное место

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

Форма добавления рекламного места

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

Сведения о рекламном месте

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

Запросить проверку

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

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

Вкладка "Ключ Reporting API"

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

Форма для получения ключа Reporting API

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

Форма для получения ключа Reporting 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

Ставки

Перейдите в раздел Выполнение > Системы назначения ставок и нажмите Перейти к назначению ставок в 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.

Через 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.

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
Заголовок
Изображение
Body
Значок приложения	¹
Призыв к действию
Рейтинг
Магазин
Цена

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

Коды ошибок

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

GADMediationAdapterLine

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

Код ошибки	Поместье	Причина
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.