Интеграция рекламной сети LINE с медиацией (бета), Интеграция рекламной сети LINE с медиацией (бета)

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

Интерфейс информационной панели рекламной сети LINE использует текст на японском языке для меток, кнопок и описаний. Скриншоты в этом руководстве не переведены. Однако в описаниях и инструкциях данного руководства метки и кнопки переведены, а их английские эквиваленты указаны в скобках.

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

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

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

Требования

  • Цель развертывания iOS 12.0 или выше

Шаг 1. Настройте конфигурации в пользовательском интерфейсе сети LINE Ads.

Войдите в свою учетную запись LINE Ads Network.

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

Нажмите広告枠管理 (Управление рекламными местами) >メディア (Медиа) . Затем нажмите新規作成 (Создать новый) .

Заполните форму и нажмите登録 (Зарегистрироваться) .

Обратите внимание на идентификатор приложения.

Создать место размещения рекламы

Выполните те же действия, чтобы создать места размещения объявлений для интеграции ставок и водопада. Каждое место размещения рекламы можно использовать и для того, и для другого.

Нажмите на идентификатор приложения, в которое вы хотите добавить место размещения рекламы. Затем выберите詳細 (Детали) .

Нажмитеスロット 追加 (Добавить слот) .

Заполните форму и нажмите (登録) Зарегистрироваться .

Обратите внимание на идентификатор слота.

Шаг 2. Настройте спрос в рекламной сети LINE в пользовательском интерфейсе Менеджера рекламы.

Войдите в свою учетную запись Менеджера рекламы .

Добавьте рекламную сеть LINE в компании

Торги

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

Водопад

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

Выберите LINE Ads Network в качестве рекламной сети , введите уникальное имя и включите посредничество .

Вам не нужно вводить имя пользователя или пароль . Нажмите «Сохранить», когда закончите.

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

Торги

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

Водопад

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

Делитесь защищенным сигналом по запросам ставок

Торги

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

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

Водопад

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

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

Торги

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

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

Водопад

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

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

Торги

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

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

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

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

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

Водопад

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

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

Торги

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

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

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

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

Водопад

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

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

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

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

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

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

pod 'GoogleMobileAdsMediationLine'

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

pod install --repo-update

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

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

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

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

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

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

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

Обязательно зарегистрируйте тестовое устройство в Менеджере рекламы.

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

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

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

Сетевые параметры

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

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

Вот пример кода, как создать запрос объявления, в котором задаются эти параметры:

Быстрый

import LineAdapter
// ...

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

Цель-C

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

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

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

Рендеринг рекламы

Адаптер сети LINE Ads заполняет следующие поля для GADNativeAd .

Поле Ресурсы, всегда включенные в сетевой адаптер LINE Ads Network
Заголовок
Изображение
Тело
Значок приложения 1
Призыв к действию
Звездный рейтинг
Магазин
Цена

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

Коды ошибок

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

GADMediationAdapterLine

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

Код ошибки Домен Причина
1-10 Отправлено LINE Ads Network SDK SDK LINE Ads Network вернул ошибку, специфичную для SDK. Дополнительную информацию см. в документации LINE Ads Network.
101 com.google.ads.mediation.line Неверные параметры сервера (например, отсутствует идентификатор приложения или идентификатор слота).
102 com.google.ads.mediation.line Запрошенный размер объявления не соответствует размеру баннерной рекламы, поддерживаемому LINE Ads Network.
103 com.google.ads.mediation.line Не удалось загрузить изображение информационного значка в нативное объявление.

Журнал изменений адаптера LINE iOS Mediation

Следующая версия

  • Исправлена ​​проблема, из-за которой GADMediationAdapterLine.h не был общедоступным заголовком.

Версия 2.9.20241106.2

  • Добавлено свойство GADMediationAdapterLine.testMode , указывающее, следует ли инициализировать FiveAd SDK в тестовом режиме. Этот флаг необходимо установить перед инициализацией Google Mobile Ads SDK.
  • Удалена проверка состояния инициализации FiveAd SDK перед инициализацией FiveAd SDK.
  • Удалена устаревшая проверка состояния нативного объявления перед загрузкой ресурсов нативной рекламы.
  • Теперь требуется Google Mobile Ads SDK версии 12.0.0 или выше.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 12.0.0.
  • FiveAd SDK версии 2.9.20241106.

Версия 2.9.20241106.1

  • Обновлен адаптер, чтобы использовать новейший API загрузки рекламы для назначения ставок по баннерной рекламе.
  • Исправлена ​​проблема, из-за которой рекламные события не перенаправлялись правильно для межстраничных объявлений с назначением ставок.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 11.12.0.
  • FiveAd SDK версии 2.9.20241106.

Версия 2.9.20241106.0

  • Проверена совместимость с FiveAd SDK версии 2.9.20241106.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 11.12.0.
  • FiveAd SDK версии 2.9.20241106.

Версия 2.8.20240827.1

  • Обновлен CFBundleShortVersionString , чтобы иметь три компонента вместо четырех.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 11.10.0.
  • FiveAd SDK версии 2.8.20240827.

Версия 2.8.20240827.0

  • Проверена совместимость с FiveAd SDK версии 2.8.20240827.
  • Добавлена ​​поддержка ставок для форматов баннеров, межстраничных объявлений, объявлений с вознаграждением и нативной рекламы.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 11.8.0.
  • FiveAd SDK версии 2.8.20240827.

Версия 2.8.20240612.0

  • Добавлен контроль звука для встроенной рекламы через GADVideoOptions.
  • Проверенная совместимость с FiveAd SDK версии 2.8.20240612.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 11.5.0.
  • FiveAd SDK версии 2.8.20240612.

Версия 2.7.20240411.0

  • Подтверждена совместимость с FiveAd SDK версии 2.7.20240411.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 11.3.0.
  • FiveAd SDK версии 2.7.20240411.

Версия 2.7.20240318.0

  • Проверенная совместимость с FiveAd SDK версии 2.7.20240318.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 11.2.0.
  • FiveAd SDK версии 2.7.20240318.

Версия 2.7.20240214.1

  • Теперь требуется минимальная версия iOS 12.0.
  • Теперь требуется Google Mobile Ads SDK версии 11.0 или выше.
  • Info.plist включен в рамки LineAdapter.xcframework .

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 11.0.1.
  • FiveAd SDK версии 2.7.20240214.

Версия 2.7.20240214.0

  • Проверенная совместимость с FiveAd SDK версии 2.7.20240214.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 11.0.1.
  • FiveAd SDK версии 2.7.20240214.

Версия 2.7.20240126.0

  • Проверена совместимость с FiveAd SDK версии 2.7.20240126.
  • Обновлена ​​реализация адаптера с помощью новых протоколов делегирования FiveAd SDK.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 10.14.0.
  • FiveAd SDK версии 2.7.20240126.

Версия 2.7.20231115.0

  • Проверенная совместимость с FiveAd SDK версии 2.7.20231115.
  • Включен заголовок GADMediationAdapterLineExtras в карту модулей.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 10.14.0.
  • FiveAd SDK версии 2.7.20231115.

Версия 2.6.20230609.1

  • Добавлен GADMediationAdapterLineAudioState для управления исходным состоянием звука баннера, межстраничной рекламы и рекламы с вознаграждением при ее первом отображении.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 10.14.0.
  • FiveAd SDK версии 2.6.20230609.

Версия 2.6.20230609.0

  • Первый выпуск!
  • Добавлена ​​каскадная поддержка форматов баннеров, межстраничных объявлений, объявлений с вознаграждением и нативной рекламы.
  • Проверена совместимость с FiveAd SDK версии 2.6.20230609.

Создан и протестирован с использованием:

  • Google Mobile Ads SDK версии 10.9.0.
  • FiveAd SDK версии 2.6.20230609.