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

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

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

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

Шаг 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 в интерфейсе AdMob

Как настроить медиацию для рекламного блока

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

Войдите в аккаунт AdMob. Затем перейдите на вкладку Медиация. Если у вас уже есть группа медиации, которую вы хотите изменить, нажмите на ее название и перейдите к разделу Добавление сети LY Ads в качестве источника объявлений.

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

Укажите формат и платформу объявления и нажмите Продолжить.

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

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

На карточке "Рекламные блоки" появятся выбранные вами рекламные блоки.

Как добавить LY Ads Network в качестве источника объявлений

Ставки

В разделе Источники объявлений найдите карточку Назначение ставок и нажмите Добавить источник объявлений. Затем выберите LY Ads Network.

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

Нажмите Подтвердить и принять, а затем – Продолжить.

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

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

Водопад

На карточке Каскад в разделе Источники объявлений выберите Добавить источник объявлений.

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

Примечание. Для оптимизации источников объявлений требуется несколько дней, чтобы собрать достаточно данных для точного расчета эффективной цены за тысячу показов для сети медиации. Пока оптимизация источника объявлений не завершена, ее статус – PENDING. Вам нужно вручную задать эффективную цену за тысячу показов для сети. После того как эффективная цена за тысячу показов будет рассчитана, источник объявлений начнет автоматически обновлять ее.

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

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

Зарегистрируйте тестовое устройство в AdMob.

Адаптер 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 = 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 заполняет следующие поля в разделе Расширенные описания полей расширенных нативных объявлений для 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.