Эта страница переведена с помощью Cloud Translation API.

Интегрируйте рекламную сеть LY Ads с системой медиации.

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

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

Поддерживаемые интеграции и форматы рекламы

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

Интеграция
Торги
Водопад
Форматы
Баннер
Интерстициальный
Награжден
Родной

Требования

Целевая версия iOS для развертывания — 13.3 или выше.
[Для участия в торгах]: Для интеграции всех поддерживаемых форматов объявлений в систему торгов используйте адаптер LY Ads Network версии 2.8.20240827.0 или выше ( рекомендуется последняя версия ).

Новейший Google Mobile Ads SDK
Заполните руководство по началу медиации.

Шаг 1: Настройка параметров в пользовательском интерфейсе рекламной сети LY.

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

Добавить новое приложение

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

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

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

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

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

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

Создать рекламный блок

На вкладке «Приложение» выберите свое приложение, чтобы просмотреть его подробную информацию. В разделе «Слот» нажмите «Добавить ».

Добавить слот

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

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

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

Подробности слота

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

Запрос на рассмотрение

Создайте ключ API для создания отчетов.

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

Вкладка «Ключ API для отчетов»

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

Форма для ввода ключа API для создания отчетов

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

Форма для ввода ключа API для создания отчетов

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

Файл app-ads.txt, созданный в рамках инициативы IAB Tech Lab для авторизованных продавцов приложений , помогает гарантировать, что рекламный инвентарь вашего приложения продается только через авторизованные вами каналы. Чтобы предотвратить значительные потери дохода от рекламы, вам потребуется внедрить файл app-ads.txt . Если вы еще этого не сделали, создайте файл app-ads.txt для Ad Manager .

Для внедрения файла app-ads.txt в рекламную сеть LY см. раздел «О файле app-ads.txt» .

Шаг 2: Настройте параметры рекламной сети LY Ads Network в пользовательском интерфейсе Ad Manager.

Войдите в свой аккаунт в Ad Manager .

Добавить рекламную сеть LY в раздел «Компании»

Торги

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

Водопад

Перейдите в раздел Администрирование > Компании , затем нажмите кнопку «Новая компания» на вкладке «Все компании» . Выберите «Рекламная сеть» .

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

Вводить имя пользователя или пароль не требуется. После завершения нажмите «Сохранить» .

Включить безопасный обмен сигналами

Торги

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

Водопад

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

Передайте защищенный сигнал в запросах на участие в торгах.

Торги

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

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

Водопад

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

Обеспечьте безопасный обмен сигналами для торгов с использованием SDK.

Торги

Перейдите в раздел «Доставка» > «Настройки канала спроса» . На вкладке «Настройки по умолчанию» включите параметр «Разрешить безопасный обмен сигналами для торгов SDK» .

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

Водопад

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

Настройка ставок в рекламной сети LY Ads

Торги

Перейдите в раздел «Доставка» > «Участники торгов» и нажмите « Перейти к торгам SDK» .

Нажмите «Новый участник торгов» .

Выберите рекламную сеть LY Ads Network в качестве участника торгов.

Нажмите «Продолжить» , чтобы включить функцию «SDK Bidding» для этого участника торгов.

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

Водопад

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

Настройка сопоставления рекламных блоков

Торги

Перейдите в раздел «Доставка» > «Участники торгов» и нажмите « Перейти к торгам SDK» .

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

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

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

Наконец, нажмите «Сохранить» .

Водопад

Перейдите в раздел «Доставка» > «Группы доходности» и нажмите кнопку «Создать новую группу доходности» . Выберите свой склад и приложение .

Прокрутите страницу вниз и нажмите «Добавить партнера по медиации» .

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

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

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

Используйте менеджер пакетов Swift.

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

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

В Xcode перейдите в меню Файл > Добавить зависимости пакета... .
В появившемся окне введите следующий URL-адрес пакета:
```
https://github.com/googleads/googleads-mobile-ios-mediation-line.git
```
В разделе «Правило зависимости» выберите «Ветвь» .
В текстовом поле введите main .

Используйте CocoaPods

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

pod 'GoogleMobileAdsMediationLine'

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

pod install --repo-update

Ручная интеграция

Загрузите последнюю версию SDK LY Ads Network и подключите FiveAd.framework к своему проекту.
Загрузите последнюю версию адаптера LY Ads Network по ссылке для скачивания в Changelog и подключите файл LineAdapter.framework к вашему проекту.

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

Внедрить SKAdNetwork

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

Шаг 5: Протестируйте свою реализацию.

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

Обязательно зарегистрируйте ваше тестовое устройство в Ad Manager.

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

Быстрый

import LineAdapter
// ...

GADMediationAdapterLine.testMode = true

Objective-C

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

GADMediationAdapterLine.testMode = YES;

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

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

Дополнительные шаги

Параметры, специфичные для сети

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

adAudio: Задает состояние начала воспроизведения звука по умолчанию для баннерной, межстраничной и рекламной рекламы с вознаграждением.

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

Быстрый

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 заполняет следующие поля для GADNativeAd .

Поле	Ресурсы всегда включены адаптером рекламной сети LY.
Заголовок
Изображение
Тело
значок приложения	¹
Призыв к действию
Звездный рейтинг
Магазин
Цена

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

коды ошибок

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

GADMediationAdapterLine

Вот коды и соответствующие сообщения, которые выдает адаптер рекламной сети LY Ads Network, когда реклама не загружается:

Код ошибки	Домен	Причина
1-10	Отправлено с помощью SDK рекламной сети LY	SDK рекламной сети LY вернул ошибку, специфичную для 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	Не удалось загрузить изображение информационного значка в нативной рекламе.