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

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

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

This guide shows you how to use Google Mobile Ads SDK to load and display ads from LY Ads Network using AdMob Mediation , covering waterfall integrations. It covers how to add LY Ads Network to an ad unit's mediation configuration, and how to integrate the LY Ads Network SDK and adapter into an iOS app.

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

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

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

Предварительные требования

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Fill out the form for details about the slot. For Bidding Type , select Standard to configure this slot for waterfall mediation, or Google SDK Bidding to configure this slot for Bidding. Click Create once the form is filled.

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

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

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

After you create your first slot, click Review on your app's detail page to get approval from LY Ads Network. This may take some time. Contact your LY Ads Network representative if you have any questions.

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

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

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

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

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

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

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

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

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

Authorized Sellers for Apps app-ads.txt is an IAB Tech Lab initiative that helps ensure your app ad inventory is only sold through channels you've identified as authorized. To prevent a significant loss in ad revenue, you'll need to implement an app-ads.txt file. If you haven't done so already, set up an app-ads.txt file for your app .

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

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

Настройте параметры медиации для вашего рекламного блока.

Вам необходимо добавить рекламную сеть LY Ads Network в конфигурацию медиации для вашего рекламного блока.

First, sign in to your AdMob account . Next, navigate to the Mediation tab. If you have an existing mediation group you'd like to modify, click the name of that mediation group to edit it, and skip ahead to Add LY Ads Network as an ad source .

Чтобы создать новую группу медиации, выберите «Создать группу медиации» .

Укажите формат и платформу вашей рекламы, затем нажмите «Продолжить» .

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

Свяжите эту группу медиации с одним или несколькими существующими рекламными блоками AdMob. Затем нажмите «Готово» .

Теперь вы должны увидеть карточку рекламных блоков, заполненную выбранными вами рекламными блоками:

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

Торги

В разделе «Источники рекламы» найдите карточку «Торги» и выберите «Добавить источник рекламы» . Затем выберите рекламную сеть LY Ads Network .

Нажмите «Как заключить партнерское соглашение и настроить партнерство по размещению ставок с рекламной сетью LY Ads Network».

Нажмите «Подтвердить и согласиться» , затем нажмите «Продолжить» .

Если у вас уже есть сопоставление для рекламной сети LY Ads Network, вы можете его выбрать. В противном случае нажмите «Добавить сопоставление» .

Далее введите идентификатор приложения и идентификатор слота, полученные в предыдущем разделе. Затем нажмите «Готово» .

Водопад

В разделе «Источники рекламы » на вкладке « Водопад » выберите «Добавить источник рекламы» .

Select LY Ads Network and enable the Optimize switch. Enter the API Key ID and API Key Secret obtained in the previous section to set up ad source optimization for LY Ads Network. Then enter an eCPM value for LY Ads Network and click Continue .

Note : Ad source optimization takes a few days to gather enough data to accurately calculate eCPM for a mediation network. In the meantime, the ad source optimization status is PENDING , so you must manually set an eCPM value for the network. Once the eCPM can be calculated, the ad source automatically starts updating the eCPM on your behalf.

Шаг 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: Протестируйте свою реализацию.

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

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

The LY Ads Network adapter contains a helper method to enable test mode for LY Ads Network. You must set this option before you initialize Google Mobile Ads SDK to ensure they get forwarded properly to the LY Ads Network SDK.

Быстрый

import LineAdapter
// ...

GADMediationAdapterLine.testMode = true

Objective-C

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

GADMediationAdapterLine.testMode = YES;

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

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

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

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

The LY Ads Network adapter supports an additional request parameter which can be passed to the adapter using the GADMediationAdapterLineExtras class. This class includes the following properties:

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

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

Быстрый

import LineAdapter
// ...

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

Objective-C

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

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

Использование нативной рекламы

Отображение рекламы

Адаптер LY Ads Network заполняет следующие расширенные описания полей нативной рекламы для объекта 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	Не удалось загрузить изображение информационного значка в нативной рекламе.
104	com.google.ads.mediation.line	Не удалось собрать сигналы для участия в торгах.
105	com.google.ads.mediation.line	Не удалось инициализировать загрузчик рекламы LINE Ads SDK.