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

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

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

В этом руководстве рассказывается, как использовать Google Mobile Ads SDK для загрузки и показа объявлений из рекламной сети LY Ads с помощью медиации, включая интеграцию каскада. В нем рассказывается, как добавить 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 Network

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

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

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

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

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

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

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

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

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

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

Добавить место

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

Добавление формы для места размещения

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

Сведения о слоте

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

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

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

Перейдите на вкладку Управление ключами 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 Ads Network, ознакомьтесь с информацией о файле app-ads.txt.

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

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

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

Ставки

Этот шаг не требуется для интеграции с системами назначения ставок.

Водопад

Нажмите Администрирование > Компании и выберите Новая компания на вкладке Все компании. Выберите Рекламная сеть.

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

Вводить имя пользователя или пароль не нужно. Когда все будет готово, нажмите Сохранить.

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

Ставки

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

Водопад

Этот шаг не требуется для интеграции с каскадной медиацией.

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

Ставки

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

Нажмите Сохранить.

Водопад

Этот шаг не требуется для интеграции с каскадной медиацией.

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

Ставки

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

Нажмите Сохранить.

Водопад

Этот шаг не требуется для интеграции с каскадной медиацией.

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

Ставки

Перейдите в раздел Выполнение > Системы назначения ставок и нажмите Перейти к назначению ставок в SDK.

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

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

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

Нажмите Готово.

Водопад

Этот шаг не требуется для интеграции с каскадной медиацией.

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

Ставки

Перейдите в раздел Выполнение > Системы назначения ставок и нажмите Перейти к назначению ставок в SDK.

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

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

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

Нажмите Сохранить.

Водопад

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

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

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

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

Шаг 3. Импортируйте SDK и адаптер LY Ads Network

Как использовать 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

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

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

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

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

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

Swift

import LineAdapter
// ...

GADMediationAdapterLine.testMode = true

Objective-C

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

GADMediationAdapterLine.testMode = YES;

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

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

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

Параметры, относящиеся к определенной сети

Адаптер LY Ads Network поддерживает дополнительный параметр запроса, который можно передать адаптеру с помощью класса 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 Network заполняет следующие поля для GADNativeAd.

Поле	Объекты, которые всегда добавляются адаптером LY Ads Network
Заголовок
Изображение
Body
Значок приложения	¹
Призыв к действию
Star rating
Магазин
Цена

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

Коды ошибок

Если адаптер не получает объявление от 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	Не удалось инициализировать загрузчик объявлений LINE Ads SDK.