Чтобы обсудить наши продукты и оставить отзыв, присоединяйтесь к официальному каналу AdMob Discord на сервере Google Advertising and Measurement Community .

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

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

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

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

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

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

Требования

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

Последняя версия Google Mobile Ads SDK
Завершить посредничество . Руководство по началу работы.

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

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

Панель инструментов приложений Chartboost

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

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

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

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

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

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

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

Панель управления посредничеством Chartboost

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

Chartboost API Explorer

Обновите файл app-ads.txt

Файл app-ads.txt для авторизованных продавцов приложений — это инициатива IAB Tech Lab, которая помогает гарантировать, что рекламный инвентарь вашего приложения будет продаваться только через каналы, которые вы указали как авторизованные. Чтобы предотвратить значительную потерю дохода от рекламы, вам необходимо внедрить файл app-ads.txt . Если вы ещё этого не сделали, настройте файл app-ads.txt для своего приложения .

Чтобы реализовать app-ads.txt для Chartboost, см. app-ads.txt .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

В интерфейсе Chartboost места размещения рекламы можно посмотреть на странице «Основные настройки» , нажав «Дополнительные настройки» . Подробнее см. в руководстве Chartboost по [Именованным местам размещения](//docs.chartboost.com/en/monetization/publishing/ad-locations/).
Наконец, нажмите «Готово» , чтобы добавить Chartboost в качестве источника рекламы, а затем нажмите « Сохранить» .

Примечание : Оптимизация источника объявлений может занять несколько дней, чтобы собрать достаточно данных для точного расчёта eCPM для медиационной сети. В настоящее время оптимизация источника объявлений имеет статус PENDING , поэтому вам необходимо вручную задать значение eCPM для сети. После того, как eCPM будет рассчитан, источник объявлений автоматически начнёт обновлять eCPM от вашего имени.

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

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

Шаг 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:24.4.0")
    implementation("com.google.ads.mediation:chartboost:9.9.0.0")
}

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

Загрузите файл .aar последней версии Chartboost SDK из Maven Central и добавьте его в свой проект.
Перейдите к артефактам адаптера Chartboost в репозитории Maven от Google. Выберите последнюю версию, скачайте .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.xml , которое показывает рекламу Chartboost и поддерживает различные ориентации:

android:configChanges="keyboardHidden|orientation|screenSize"

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

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

Обязательно зарегистрируйте свое тестовое устройство в AdMob и включите тестовый режим в пользовательском интерфейсе 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 может загружать только одно объявление в каждом местоположении одновременно.
103	Параметры сервера Chartboost, настроенные в пользовательском интерфейсе AdMob, отсутствуют или недействительны.
104	Рекламное объявление или реклама с вознаграждением Chartboost не готовы к показу.