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

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

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

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

В этом руководстве рассказывается, как загружать и показывать объявления из Chartboost с помощью Google Mobile Ads SDK (Legacy), используя медиацию, в том числе интеграцию с каскадной загрузкой. В этой статье рассказывается, как добавить Chartboost в конфигурацию медиации рекламного блока и как интегрировать Chartboost SDK и адаптер в приложение 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) и запишите идентификатор пользователя и подпись пользователя, указанные в разделе 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.

Как включить режим тестирования

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Как добавить 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. Выберите последнюю версию, скачайте файл адаптера Chartboost .aar и добавьте его в проект.

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

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

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

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

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

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

В версии 8.1.0 SDK 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)

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

Шаг 5. Добавьте обязательный код

Изменения в конфигурации функции "Обновления"

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