В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и отображения рекламы из рекламной сети LINE с помощью медиации , включая каскадную интеграцию. В нем рассказывается о том, как добавить рекламную сеть LINE в конфигурацию медиации рекламного блока, а также как интегрировать SDK и адаптер LINE Ads Network в iOS-приложение.
В интерфейсе панели управления LINE Ads Network для надписей, кнопок и описаний используется японский текст. Скриншоты в этом руководстве не переведены. Однако в описаниях и инструкциях этого руководства надписи и кнопки переведены, а их английские эквиваленты указаны в скобках.
Поддерживаемые интеграции и форматы рекламы
Адаптер медиации для рекламной сети LINE обладает следующими возможностями:
| Интеграция | |
|---|---|
| Торги | |
| Водопад | |
| Форматы | |
| Баннер | |
| Интерстициальный | |
| Награжден | |
| Родной | 1 |
1. Нативная реклама (для назначения ставок) находится в закрытом бета-тестировании. Обратитесь к своему менеджеру по работе с клиентами, чтобы запросить доступ.
Требования
Целевая версия iOS для развертывания — 12.0 или выше.
[Для участия в торгах]: Чтобы интегрировать все поддерживаемые форматы объявлений в систему торгов, используйте адаптер LINE Ads Network версии 2.8.20240827.0 или выше ( рекомендуется последняя версия ).
Новейший SDK для мобильной рекламы Google
Заполните руководство по началу медиации.
Шаг 1: Настройка параметров в пользовательском интерфейсе рекламной сети LINE.
Зарегистрируйтесь и войдите в свой аккаунт в рекламной сети LINE.
Добавить новое приложение
Нажмите広告枠管理 (Управление рекламными местами) >メディア (Медиа) . Затем нажмите新規作成 (Создать новый) .

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

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

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

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

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

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

Обновите файл app-ads.txt.
Файл app-ads.txt, созданный в рамках инициативы IAB Tech Lab для авторизованных продавцов приложений , помогает гарантировать, что рекламный инвентарь вашего приложения продается только через авторизованные вами каналы. Чтобы предотвратить значительные потери дохода от рекламы, вам потребуется внедрить файл app-ads.txt . Если вы еще этого не сделали, создайте файл app-ads.txt для Ad Manager .
Чтобы внедрить файл app-ads.txt в рекламную сеть LINE, см. раздел «О файле app-ads.txt» .
Шаг 2: Настройте параметры рекламной сети LINE в пользовательском интерфейсе менеджера рекламы.
Войдите в свой аккаунт в Ad Manager .
Добавить рекламную сеть LINE в раздел «Компании».
Торги
Этот шаг не требуется для интеграции с системами торгов.
Водопад
Перейдите в раздел Администрирование > Компании , затем нажмите кнопку «Новая компания» на вкладке «Все компании» . Выберите «Рекламная сеть» .

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

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

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

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

Нажмите « Сохранить ».
Водопад
Этот шаг не требуется для интеграций с каскадной моделью распределения.
Настройка ставок в рекламной сети LINE
Торги
Перейдите в раздел «Доставка» > «Участники торгов» и нажмите « Перейти к торгам SDK» .

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

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

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

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

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

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

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

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

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

Выберите компанию, которую вы создали для рекламной сети LINE в предыдущем разделе. В качестве типа интеграции выберите «Посредничество мобильного SDK» , в качестве платформы — «iOS» , а в качестве статуса — «Активный» .
Введите идентификатор приложения и идентификатор слота, полученные в предыдущем разделе, а также значение CPM по умолчанию . Нажмите «Сохранить» .

Примечание: Автоматический сбор данных занимает несколько дней, прежде чем система сможет точно рассчитать значение динамического CPM для сети медиации. После того, как значение eCPM будет рассчитано, оно автоматически обновляется от вашего имени.
Шаг 3: Импортируйте SDK и адаптер рекламной сети LINE.
Использование CocoaPods (рекомендуется)
Добавьте следующую строку в файл 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: Протестируйте свою реализацию.
Включить тестовые объявления
Обязательно зарегистрируйте ваше тестовое устройство в Ad Manager.
Адаптер рекламной сети 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 = 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 заполняет следующие поля для 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.