В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и показа рекламы из LINE Ads Network с помощью AdMob Mediation , включая каскадную интеграцию. В руководстве также рассказывается, как добавить 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 или выше ( рекомендуется последняя версия ).
Последняя версия Google Mobile Ads SDK
Завершить посредничество . Руководство по началу работы.
Шаг 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 в пользовательском интерфейсе AdMob
Настройте параметры медиации для вашего рекламного блока
Вам необходимо добавить LINE Ads Network в конфигурацию медиации для вашего рекламного блока.
Сначала войдите в свой аккаунт AdMob . Затем перейдите на вкладку «Медиация» . Если у вас есть группа медиации, которую вы хотите изменить, нажмите на её название, чтобы отредактировать её, и перейдите к разделу «Добавить рекламную сеть LINE в качестве источника рекламы» .
Чтобы создать новую группу посредничества, выберите Создать группу посредничества .
Введите формат и платформу рекламы, затем нажмите «Продолжить» .
Дайте название группе медиации и выберите местоположения для таргетинга. Затем установите для группы медиации статус « Включено» и нажмите «Добавить рекламные блоки» .
Свяжите эту группу медиации с одним или несколькими существующими рекламными блоками AdMob. Затем нажмите «Готово» .
Теперь вы должны увидеть карточку рекламных блоков, заполненную выбранными вами рекламными блоками:
Добавьте рекламную сеть LINE в качестве источника рекламы
Торги
В разделе «Источники рекламы» на вкладке « Торги » выберите «Добавить источник рекламы» . Затем выберите рекламную сеть LINE .Нажмите «Как подписать соглашение о партнерстве» и настроить партнерство по торгам с LINE Ads Network.

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

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

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

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

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

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

Шаг 3: Импортируйте LINE Ads Network SDK и адаптер
Использование CocoaPods (рекомендуется)
Добавьте следующую строку в 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: Проверьте свою реализацию
Включить тестовые объявления
Обязательно зарегистрируйте свое тестовое устройство в AdMob.
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от рекламной сети LINE, включите тестирование одного источника объявлений в инспекторе объявлений, используя источник(и) объявлений LINE Ads Network (Waterfall ).
Дополнительные шаги
Параметры, специфичные для сети
Адаптер LINE Ads Network поддерживает дополнительный параметр запроса, который можно передать адаптеру с помощью класса 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 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
Версия 2.9.20250825.0 (В разработке)
Версия 2.9.20250805.0 (В разработке)
- Теперь пытается зарегистрировать 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.