Google Mobile Ads SDK находится в режиме технического обслуживания. Для получения последних обновлений и новых функций выполните миграцию и настройку GMA Next-Gen SDK .

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

Как интегрировать Chartboost с Mediation

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

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

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

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

Интеграция
Ставки
Водопад
Форматы
Баннер
Межстраничное объявление
Бонус предоставлен
Стандартное

Требования

Прежде чем продолжить, убедитесь, что:

Android API уровня 24 или более поздней версии.

Последняя версия Google Mobile Ads SDK (Legacy).
Настройте медиацию.

Шаг 1. Задайте настройки в интерфейсе Chartboost

Зарегистрируйте аккаунт Chartboost и войдите в него после подтверждения. Затем перейдите на вкладку Управление приложениями.

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

Нажмите кнопку Добавить приложение.

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

Заполните остальные поля и нажмите кнопку Добавить приложение.

Форма для нового приложения

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

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

Чтобы настроить идентификатор рекламного блока Менеджера рекламы, вам потребуются идентификатор пользователя и подпись пользователя Chartboost. Чтобы найти эти параметры, нажмите Chartboost mediation (Медиация Chartboost) в интерфейсе Chartboost.

Панель управления медиацией Chartboost

Перейдите на вкладку Resources (Ресурсы) > API Explorer (API Explorer) и запишите User ID (Идентификатор пользователя) и User Signature (Подпись пользователя), которые находятся в разделе Authentication (Аутентификация).

Chartboost API Explorer

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

Решение Authorized Sellers for Apps (app-ads.txt), разработанное IAB Tech Lab, позволяет издателям указывать авторизованных продавцов своего рекламного инвентаря. Чтобы избежать значительного снижения дохода от рекламы, используйте файл app-ads.txt. Если вы ещё этого не сделали, создайте файл app-ads.txt для Менеджера рекламы.

Чтобы реализовать app-ads.txt для Chartboost, ознакомьтесь с инструкциями по работе с файлом app-ads.txt.

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

Чтобы включить тестовый режим в приложении, перейдите на вкладку Apps management (Управление приложениями) в интерфейсе Chartboost, выберите приложение из списка и нажмите Edit app settings (Изменить настройки приложения).

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

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

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

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

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

Шаг 2. Настройте спрос Chartboost в интерфейсе Менеджера рекламы

Как настроить медиацию для рекламного блока

Войдите в аккаунт Менеджера рекламы.

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

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

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

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

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

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

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

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

В интерфейсе Chartboost места размещения рекламы можно посмотреть на странице Basic Settings (Основные настройки), нажав Advanced Settings (Расширенные настройки). Дополнительную информацию можно найти в руководстве Chartboost по именованным местоположениям.

Нажмите Сохранить внизу страницы.

Добавьте Chartboost в список рекламных партнеров, на которых распространяются требования GDPR и законов штатов США

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

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

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

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

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

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

Kotlin

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

Groovy

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.google.ads.mediation:chartboost:9.14.1.0'
}

Интеграция вручную

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

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

Согласие пользователей из ЕС и GDPR

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

Адаптер Chartboost для Android версии 9.13.0.0 и более поздних автоматически передает в Chartboost SDK согласие по GDPR, заданное с помощью UMP SDK и платформ для запросов согласия, которые поддерживают спецификацию Google Additional Consent. Дополнительную информацию можно найти в разделе Методы обеспечения конфиденциальности в SDK.

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

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

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

Java

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

Kotlin

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

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

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

Изменения в конфигурации действия обновления

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

android:configChanges="keyboardHidden|orientation|screenSize"

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

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

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

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

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

Необязательные действия

Разрешения

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