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

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

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

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

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

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

Требования

• Android API уровня 24 или выше

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

• Новейший GMA Next-Gen SDK

• Заполните руководство по началу медиации.

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

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

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

Перейдите на вкладкуアプリ (Приложение) и нажмите кнопку新規登録 (Новая регистрация) .

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

Обратите внимание наアプリID (идентификатор приложения) .

Создать рекламный блок

На вкладке «Приложение» выберите свое приложение, чтобы просмотреть его сведения. В разделеスロット (Слот) нажмите追加 (Добавить) .

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

Обратите внимание наスロットID (идентификатор слота) .

Обновите файл 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 в раздел «Компании».

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

Передайте защищенный сигнал в запросах на участие в торгах.

Обеспечьте безопасный обмен сигналами для торгов с использованием SDK.

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

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

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

Интеграция с Android Studio (рекомендуется)

В файл gradle на уровне приложения добавьте следующие зависимости реализации и конфигурации:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta03")
    implementation("com.google.ads.mediation:line:3.0.1.1")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta03'
    implementation 'com.google.ads.mediation:line:3.0.1.1'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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

1. Загрузите последнюю версию файла .aar SDK LINE Ads Network и добавьте его в свой проект.

2. Перейдите к файлам адаптера LINE Ads Network в репозитории Maven Google. Выберите последнюю версию, загрузите файл .aar адаптера LINE Ads Network и добавьте его в свой проект.

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

Для интеграции с рекламной сетью LINE дополнительный код не требуется.

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

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

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

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

LineMediationAdapter.Companion.setTestMode(true);
LineMediationSnippets.java

LineMediationAdapter.setTestMode(true)
LineMediationSnippets.kt

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

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

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

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

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

enableAdSound

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

Вот пример кода, демонстрирующий, как создать запрос на показ рекламы, который устанавливает эти параметры:

LineExtras lineExtras = new LineExtras(/* enableAdSound: */ true);
Bundle extras = lineExtras.build();

AdRequest request =
    new AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter.class, extras).build();
LineMediationSnippets.java

val lineExtras = LineExtras(enableAdSound = true)
val extras = lineExtras.build()

val request =
  AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter::class.java, extras).build()
LineMediationSnippets.kt

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

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

Адаптер рекламной сети LINE заполняет следующие поля для NativeAd .

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

коды ошибок

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

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

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