Интегрированная линия с посредничеством (бета),Интегрированная линия с посредничеством (бета)

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

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

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

Адаптер-посредник для Line имеет следующие возможности:

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

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

² Интеграция Waterfall находится в стадии открытого бета-тестирования.

³ Этот формат поддерживается только при каскадной интеграции.

Требования

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

• Последняя версия Google Mobile Ads SDK

• Пройдите руководство по началу работы с медиацией

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

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

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

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

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

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

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

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

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

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

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

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

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

Шаг 2. Настройте потребность в линии в AdMob пользовательский интерфейс

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

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

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

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

Введите формат объявления и платформу, затем нажмите «Продолжить» .

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

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

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

Добавлять Line как источник рекламы

Торги

В карточке «Ставки» в разделе « Источники объявлений » выберите «Добавить источник объявлений» . Затем выберите Линия.
Нажмите «Как подписать партнерское соглашение и организовать тендерное партнерство с Line».
Нажмите «Подтвердить и согласиться» , затем нажмите «Продолжить» .
Если у вас уже есть сопоставление для линии, вы можете выбрать его. В противном случае нажмите «Добавить сопоставление» .
Затем введите идентификатор приложения и идентификатор слота, полученные в предыдущем разделе. Затем нажмите Готово . Важно ! Идентификатор приложения должен быть связан с целевым приложением, как в пользовательском интерфейсе Line.

Водопад

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

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

Примечание . Оптимизацию источника объявлений необходимо настроить только один раз для каждой сети.

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

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

Важно ! Идентификатор приложения должен быть связан с целевым приложением, как в пользовательском интерфейсе Line.

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

Примечание. Невозможность интеграции совместимых версий Line и Google Mobile Ads SDK может привести к проблемам при сборке.

Использование CocoaPods (рекомендуется)

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

pod 'GoogleMobileAdsMediationLine'

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

pod install --repo-update

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

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

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

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

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

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

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

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

Следуйте инструкциям в документации Line о том, как включить тестовые объявления Line.

Важно: отключите тестовый режим для AdMob и Line перед выпуском приложения.

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

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

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

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

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

adAudio

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

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

Быстрый

import LineAdapter
// ...

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

Цель-C

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

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

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

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

Линейный адаптер заполняет следующиеРасширенные описания полей нативных объявленийдляGADNativeAd .

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

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

Коды ошибок

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

GADMediationAdapterLine

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

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

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

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