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

Как интегрировать Chartboost с медиацией

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

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

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

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

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

Требования

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

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

Последняя версия GMA Next-Gen SDK.
Настройте медиацию AdMob.

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

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

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

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

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

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

Новая форма заявки на добавление приложения

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

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

Для настройки идентификатора рекламного блока AdMob требуется идентификатор пользователя и подпись пользователя 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 в интерфейсе AdMob

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

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

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

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

Укажите формат и платформу объявления и нажмите Продолжить.

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

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

На карточке "Рекламные блоки" появятся выбранные вами рекламные блоки.

Как добавить Chartboost в качестве источника объявлений

На карточке Каскад в разделе Источники объявлений выберите Добавить источник объявлений.

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

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

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

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

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

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

Как добавить 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.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
    implementation("com.google.ads.mediation:chartboost:9.14.1.0")
}

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

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0'
    implementation 'com.google.ads.mediation:chartboost:9.14.1.0'
}

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

Настраиваемые вручную интеграции

Скачайте файл .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. Если вы решите вызвать этот метод, рекомендуем сделать это до запроса объявлений через GMA Next-Gen SDK.

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. Проверьте реализацию

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

Зарегистрируйте тестовое устройство в AdMob и включите тестовый режим в интерфейсе Chartboost.

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

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

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

Разрешения

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

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

Коды ошибок

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

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

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

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