Эта страница переведена с помощью Cloud Translation API.

Интегрируйте Chartboost с медиацией

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

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

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

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

Требования

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

Последняя версия Google Mobile Ads SDK
Пройдите руководство по началу работы с медиацией

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

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

Панель управления приложениями Chartboost

Нажмите кнопку «Добавить новое приложение», чтобы создать свое приложение.

Управление приложениями

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

Новая форма приложения

После создания вашего приложения вы будете перенаправлены на его панель управления. Запишите идентификатор и подпись вашего приложения.

Настройки приложения

Менеджеру рекламы требуется идентификатор пользователя Chartboost и подпись пользователя для настройки идентификатора рекламного блока Менеджера рекламы. Эти параметры можно найти, нажав «Медиация Chartboost» в пользовательском интерфейсе Chartboost.

Панель медиации Chartboost

Перейдите на вкладку «Ресурсы» > «Проводник API» и запишите свой идентификатор пользователя и подпись пользователя, расположенные в разделе «Аутентификация» .

API-проводник Chartboost

Включите тестовый режим

Вы можете включить тестовый режим в своем приложении, перейдя на вкладку «Управление приложениями» в пользовательском интерфейсе Chartboost, выбрав свое приложение из списка и нажав «Изменить настройки приложения» .

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

В настройках вашего приложения вы можете переключить тестовый режим в своем приложении.

Тестовый режим Chartboost

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

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

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

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

Войдите в свою учетную запись Менеджера рекламы .

Перейдите в раздел «Доставка» > «Группы доходности» и нажмите кнопку «Новая группа доходности» .

Введите уникальное имя для своей группы доходности, установите статус « Активно» , выберите формат объявления и установите тип инвентаря « Мобильное приложение» . В разделе «Таргетинг» > «Инвентарь» выберите рекламный блок в разделе «Инвентарь и мобильное приложение» , к которому вы хотите добавить агрегатор.

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

Если у вас уже есть партнер по доходности для Chartboost, вы можете выбрать его. В противном случае выберите Создать нового партнера по доходности .

Выберите Chartboost в качестве рекламной сети , введите уникальное имя и включите посредничество .

Включите Автоматический сбор данных и введите идентификатор пользователя и подпись пользователя, полученные в предыдущем разделе.

После выбора партнера по доходности выберите Mobile SDK Mediation в качестве типа интеграции , Android в качестве платформы и Активный в качестве статуса . Введите идентификатор приложения , подпись приложения и местоположение объявления, полученные в предыдущем разделе. Затем введите значение цены за тысячу показов по умолчанию .

Места размещения объявлений Chartboost ( Именованные местоположения ) — это простые названия, обозначающие место в вашем приложении, где вы хотите показывать рекламу. Менеджер рекламы отправляет запросы по адресу, указанному в настройках. После отправки запросов Chartboost добавит местоположение в свой пользовательский интерфейс для целей отчетности.

В пользовательском интерфейсе Chartboost места размещения ваших объявлений можно отобразить на странице «Основные настройки», нажав «Дополнительные настройки» . Дополнительную информацию см. в руководстве по именованным местоположениям Chartboost.

Когда закончите, нажмите «Сохранить» внизу страницы.

Добавьте Chartboost в список рекламных партнеров GDPR и государственных нормативов США.

Следуйте инструкциям в настройках GDPR и настройках законодательства штата США , чтобы добавить Chartboost в список рекламных партнеров GDPR и законодательства штата США в пользовательском интерфейсе Менеджера рекламы.

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

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

В файле settings.gradle.kts уровня проекта добавьте следующие репозитории:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://cboost.jfrog.io/artifactory/chartboost-ads/")
    }
  }
}

Затем в файл build.gradle.kts уровня приложения добавьте следующие зависимости и конфигурации реализации. Используйте последние версии Chartboost SDK и адаптера:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:chartboost:9.8.0.0")
}

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

Загрузите файл .aar последней версии Chartboost SDK из Maven Central и добавьте его в свой проект.
Перейдите к артефактам адаптера Chartboost в репозитории Google Maven. Выберите последнюю версию, загрузите файл .aar адаптера Chartboost и добавьте его в свой проект.

Шаг 4. Реализуйте настройки конфиденциальности в Chartboost SDK

Согласие ЕС и GDPR

В соответствии с Политикой согласия пользователей Google из ЕС вы должны гарантировать, что пользователям в Европейской экономической зоне (ЕЭЗ) будет предоставлена определенная информация и получено от них согласие на использование идентификаторов устройств и личных данных. Эта политика отражает требования Директивы ЕС об электронной конфиденциальности и Общего регламента защиты данных (GDPR). При запросе согласия вы должны указать каждую рекламную сеть в вашей цепочке посредничества, которая может собирать, получать или использовать персональные данные, а также предоставлять информацию об использовании каждой сети. В настоящее время Google не может автоматически передавать выбор согласия пользователя в такие сети.

В SDK версии 8.1.0 в Chartboost добавлен метод addDataUseConsent() . В следующем примере кода для согласия на использование данных устанавливается NON_BEHAVIORAL . Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы через Google Mobile Ads SDK.

Ява

DataUseConsent dataUseConsent = new GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL);
Chartboost.addDataUseConsent(context, dataUseConsent);

Котлин

val dataUseConsent = GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL)
Chartboost.addDataUseConsent(context, dataUseConsent)

См. статью Chartboost о GDPR и ееМетоды конфиденциальности Androidдля получения более подробной информации и значений, которые могут быть предоставлены в каждом методе.

Законы о конфиденциальности штатов США

Законы о конфиденциальности штатов США требуют предоставления пользователям права отказаться от «продажи» их «личной информации» (согласно определению этих условий в законе), причем отказ предлагается через заметную ссылку «Не продавать мою личную информацию». на домашней странице «продающей» стороны. Руководство по соблюдению законов о конфиденциальности штатов США предлагает возможность включить ограниченную обработку данных для показа рекламы Google, но Google не может применить этот параметр к каждой рекламной сети в вашей цепочке медиации. Поэтому вы должны определить каждую рекламную сеть в вашей цепочке посредничества, которая может участвовать в продаже личной информации, и следовать указаниям каждой из этих сетей, чтобы обеспечить соблюдение требований.

В SDK версии 8.1.0 в Chartboost добавлен метод addDataUseConsent() . В следующем примере кода для согласия на использование данных устанавливается OPT_IN_SALE . Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы через Google Mobile Ads SDK.

Ява

DataUseConsent dataUseConsent = new CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE);
Chartboost.addDataUseConsent(context, dataUseConsent);

Котлин

val dataUseConsent = CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE)
Chartboost.addDataUseConsent(context, dataUseConsent)

См. статью Chartboost CCPA и ееМетоды конфиденциальности Androidдля получения более подробной информации и значений, которые могут быть предоставлены в каждом методе.

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

Изменить AndroidManifest

Другие элементы

Добавьте следующий атрибут к каждому действию в файле AndroidManifest.xml , который будет показывать рекламу Chartboost и поддерживает различные ориентации:

android:configChanges="keyboardHidden|orientation|screenSize"

События жизненного цикла

Согласно рекомендации Chartboost, добавьте следующий код во все события жизненного цикла вашей активности, которые будут показывать рекламу Chartboost.

Ява

import com.chartboost.sdk.Chartboost;
// ...

@Override
public void onBackPressed() {
    // If an interstitial is on screen, close it.
    if (Chartboost.onBackPressed()) {
        return;
    } else {
        super.onBackPressed();
    }
}

Котлин

import com.chartboost.sdk.Chartboost
// ...

@Override
fun onBackPressed() {
    // If an interstitial is on screen, close it.
    if (Chartboost.onBackPressed())
        return
    else
        super.onBackPressed()
}

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

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

Убедитесь, что вы зарегистрировали свое тестовое устройство в Менеджере рекламы и включили тестовый режим в пользовательском интерфейсе Chartboost.

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

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

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

Разрешения

Для оптимальной производительности Chartboost рекомендует добавить следующие дополнительные разрешения в файл AndroidManifest.xml вашего приложения:

<uses-permission android:name="android.permission.READ_PHONE_STATE" />

Коды ошибок

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

com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter

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

Код ошибки	Причина
0-99	Chartboost SDK возвратил ошибку. Дополнительную информацию см. в документации Chartboost.
101	Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому Chartboost.
102	Chartboost может одновременно загружать только 1 объявление для каждого местоположения.
103	Параметры сервера Chartboost, настроенные в Ad Manager Пользовательский интерфейс отсутствует/недействителен.
104	Межстраничное объявление или объявление с вознаграждением Chartboost не готово к показу.