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

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

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

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

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

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

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

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

Требования

  • Целевая версия iOS для развертывания — 12.0 или выше.

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

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

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

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

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

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

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

Создать рекламное место

Щёлкните по идентификатору приложения, в которое хотите добавить рекламное место. Затем выберите «Подробности» .

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

Заполните форму, чтобы получить подробную информацию о слоте. В поле «Тип торгов» выберите «Стандартный» , чтобы настроить этот слот для каскадной медиации, или «Торги через 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 в пользовательском интерфейсе AdMob.

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

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

Сначала войдите в свою учетную запись AdMob . Затем перейдите на вкладку «Медиация» . Если у вас уже есть группа медиации, которую вы хотите изменить, щелкните по ее названию, чтобы отредактировать ее, и перейдите к разделу «Добавить рекламную сеть LINE в качестве источника рекламы» .

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

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

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

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

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

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

Торги

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

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



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



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



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



Водопад


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

Выберите рекламную сеть LINE и включите переключатель «Оптимизировать» . Введите имя пользователя и пароль, полученные в предыдущем разделе, чтобы настроить оптимизацию источника рекламы для рекламной сети LINE. Затем введите значение eCPM для рекламной сети LINE и нажмите «Продолжить» .



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

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


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

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

pod 'GoogleMobileAdsMediationLine'

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

pod install --repo-update

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

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

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

Интеграция SKAdNetwork

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

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

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

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

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

Быстрый

import LineAdapter
// ...

GADMediationAdapterLine.testMode = true

Objective-C

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

GADMediationAdapterLine.testMode = YES;

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

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

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

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

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

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];

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

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

Адаптер рекламной сети LINE заполняет следующие расширенные описания полей нативной рекламы для объекта GADNativeAd .

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

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

коды ошибок

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

GADMediationAdapterLine

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

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

Список изменений адаптера LINE для медиации на iOS

Версия 2.9.20251119.0

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

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

  • Версия Google Mobile Ads SDK: 12.14.0.
  • Версия FiveAd SDK 2.9.20251119.

Версия 2.9.20250930.0

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

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

  • Версия Google Mobile Ads SDK: 12.12.0.
  • Версия FiveAd SDK 2.9.20250930.

Версия 2.9.20250912.0

  • Теперь адаптер инициализирует SDK FiveAd перед каждым запросом рекламы.
  • Подтверждена совместимость с версией FiveAd SDK 2.9.20250912.

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

  • Версия Google Mobile Ads SDK: 12.11.0.
  • Версия FiveAd SDK 2.9.20250912.

Версия 2.9.20250512.0

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

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

  • Версия Google Mobile Ads SDK: 12.4.0.
  • Версия FiveAd SDK 2.9.20250512.

Версия 2.9.20241106.3

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

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

  • Версия Google Mobile Ads SDK: 12.2.0.
  • Версия FiveAd SDK 2.9.20241106.

Версия 2.9.20241106.2

  • Добавлено свойство GADMediationAdapterLine.testMode , указывающее, следует ли инициализировать SDK FiveAd в тестовом режиме. Этот флаг необходимо установить перед инициализацией SDK Google Mobile Ads.
  • Удалена проверка состояния инициализации 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.