Интегрируйте рекламную сеть LINE с медиацией

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

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

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

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

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

1 Интеграция торгов находится на стадии закрытого бета-тестирования. Обратитесь к своему менеджеру по работе с клиентами, чтобы запросить доступ.

Требования

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

  • [Для торгов]: Чтобы интегрировать все поддерживаемые форматы рекламы в торги, используйте сетевой адаптер LINE Ads версии 2.8.20240827.0 или выше ( рекомендуется последняя версия ).

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

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

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

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

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

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

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

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

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

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

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

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

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

Чтобы реализовать app-ads.txt для рекламной сети LINE, см. раздел «О файле app-ads.txt» .

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

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

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

Торги

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

Водопад

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

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

Имя пользователя и пароль вводить не нужно. Нажмите «Сохранить» по завершении.

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

Торги

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

Водопад

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

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

Торги

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

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

Водопад

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

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

Торги

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

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

Водопад

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

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

Торги

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

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

Выберите LINE Ads Network в качестве поставщика ставок.

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

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

Водопад

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

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

Торги

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

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

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

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

Водопад

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

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

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

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

Примечание: Автоматическому сбору данных требуется несколько дней, прежде чем он сможет точно рассчитать значение динамической цены за тысячу показов (CPM) для сети медиации. После того, как значение eCPM будет рассчитано, оно автоматически обновляется от вашего имени.

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

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

pod 'GoogleMobileAdsMediationLine'

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

pod install --repo-update

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

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

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

Интеграция SKAdNetwork

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Коды ошибок

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

GADMediationAdapterLine

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

Код ошибки Домен Причина
1-10 Отправлено LINE Ads Network SDK LINE Ads Network SDK вернул ошибку, специфичную для 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

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

  • Теперь пытается зарегистрировать FiveAd SDK перед каждым запросом рекламы.

Версия 2.9.20250512.0

  • Теперь требуется минимальная версия iOS 13.0.
  • Проверенная совместимость с FiveAd SDK версии 2.9.20250512.

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

  • Google Mobile Ads SDK версии 12.14.0.
  • FiveAd SDK версии 2.9.20250512.

Версия 2.9.20241106.3

  • Исправлена ошибка, из-за которой GADMediationAdapterLine.h не был публичным заголовком.
  • Включены флаги -fobjc-arc и -fstack-protector-all .
  • Убрана проверка размера баннерной рекламы для торгов после успешной загрузки.
    • После успешной загрузки баннерная реклама Waterfall продолжит проверять размеры баннерной рекламы.

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

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

Версия 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 в modulemap.

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

  • 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.