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

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

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

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

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

Требования

• Последняя версия Google Mobile Ads SDK

• Пройдите руководство по началу работы с медиацией

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

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

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

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

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

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

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

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

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

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

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

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

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

Шаг 2. Настройте запрос Chartboost в интерфейсе AdMob.

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

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

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

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

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

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

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

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

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

Под карточкой «Водопад» в разделе « Источники объявлений » выберите «Добавить источник объявлений» . Затем выберите Chartboost .

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

Примечание . Оптимизацию источника объявлений необходимо настроить только один раз для каждой сети.

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

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

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

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

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

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

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

Важно! Убедитесь, что у вас есть разрешение на управление учетной записью для завершения настройки согласия ЕС, GDPR, CPRA и платформы обмена сообщениями пользователей. Подробности см. в разделе Управление доступом пользователей к вашей учетной записи .

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

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

Примечание. Невозможность интеграции совместимых версий Chartboost и Google Mobile Ads 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.6.0")
    implementation("com.google.ads.mediation:chartboost:9.8.1.0")
}

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

1. Загрузите файл .aar последней версии Chartboost SDK из Maven Central и добавьте его в свой проект.

2. Перейдите к артефактам адаптера 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. Проверьте свою реализацию

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

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

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

Журнал изменений адаптера Chartboost Android Mediation

Версия 9.8.1.0

• Проверенная совместимость с Chartboost SDK версии 9.8.1.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 23.5.0.
• Chartboost SDK версии 9.8.1.

Версия 9.8.0.0

• Проверенная совместимость с Chartboost SDK версии 9.8.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 23.4.0.
• Chartboost SDK версии 9.8.0.

Версия 9.7.0.0

• Проверенная совместимость с Chartboost SDK версии 9.7.0.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 23.0.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 23.0.0.
• Chartboost SDK версии 9.7.0.

Версия 9.6.1.0

• Проверенная совместимость с Chartboost SDK версии 9.6.1.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 22.6.0.
• Chartboost SDK версии 9.6.1.

Версия 9.6.0.0

• Проверенная совместимость с Chartboost SDK версии 9.6.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 22.5.0.
• Chartboost SDK версии 9.6.0.

Версия 9.5.0.0

• Проверенная совместимость с Chartboost SDK версии 9.5.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 22.3.0.
• Chartboost SDK версии 9.5.0.

Версия 9.4.1.0

• Проверенная совместимость с Chartboost SDK версии 9.4.1.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 22.2.0.
• Chartboost SDK версии 9.4.1.

Версия 9.4.0.0

• Проверенная совместимость с Chartboost SDK версии 9.4.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 22.1.0.
• Chartboost SDK версии 9.4.0.

Версия 9.3.1.0

• Проверенная совместимость с Chartboost SDK версии 9.3.1.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 22.1.0.
• Chartboost SDK версии 9.3.1.

Версия 9.3.0.0

• Проверенная совместимость с Chartboost SDK версии 9.3.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 22.0.0.
• Chartboost SDK версии 9.3.0.

Версия 9.2.1.1

• Обновлен адаптер для использования нового класса VersionInfo .
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 22.0.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 22.0.0.
• Chartboost SDK версии 9.2.1.

Версия 9.2.1.0

• Проверенная совместимость с Chartboost SDK 9.2.1.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 21.5.0.
• Chartboost SDK версии 9.2.1.

Версия 9.2.0.0

• Проверенная совместимость с Chartboost SDK 9.2.0.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 21.5.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 21.5.0.
• Chartboost SDK версии 9.2.0.

Версия 9.1.1.0

• Добавлен метод ChartboostMediationAdapter.setAppParams(String, String) в качестве дополнительного способа жесткого указания идентификатора и подписи приложения, которые будут использоваться для инициализации Chartboost SDK.
• Проверенная совместимость с Chartboost SDK 9.1.1.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 21.3.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 21.3.0.
• Chartboost SDK версии 9.1.1.

Версия 8.4.3.1

• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 21.0.0.
• Минимально необходимый уровень Android API обновлен до 19.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 21.0.0.
• Chartboost SDK версии 8.4.3.

Версия 8.4.3.0

• Проверенная совместимость с Chartboost SDK 8.4.3.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 20.6.0.
• Chartboost SDK версии 8.4.3.

Версия 8.4.2.0

• Проверенная совместимость с Chartboost SDK 8.4.2.
• compileSdkVersion и targetSdkVersion обновлены до API 31.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 20.6.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 20.6.0.
• Chartboost SDK версии 8.4.2.

Версия 8.4.1.0

• Проверенная совместимость с Chartboost SDK 8.4.1.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 20.6.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 20.6.0.
• Chartboost SDK версии 8.4.1.

Версия 8.3.1.0

• Проверенная совместимость с Chartboost SDK 8.3.1.
• Обновлен адаптер для использования нового API AdError .

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 20.5.0.
• Chartboost SDK версии 8.3.1.

Версия 8.3.0.0

• Проверенная совместимость с Chartboost SDK 8.3.0.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 20.5.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 20.5.0.
• Chartboost SDK версии 8.3.0.

Версия 8.2.1.0

• Проверенная совместимость с Chartboost SDK 8.2.1.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 20.1.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 20.1.0.
• Chartboost SDK версии 8.2.1.

Версия 8.2.0.1

• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 20.0.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 20.0.0.
• Chartboost SDK версии 8.2.0.

Версия 8.2.0.0

• Проверенная совместимость с Chartboost SDK 8.2.0.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 19.5.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 19.5.0.
• Chartboost SDK версии 8.2.0.

Версия 8.1.0.0

• Проверенная совместимость с Chartboost SDK 8.1.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 19.2.0.
• Chartboost SDK версии 8.1.0.

Версия 8.0.3.2

• Добавлены описательные коды ошибок и причины сбоев загрузки/отображения адаптера.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 19.2.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 19.2.0.
• Chartboost SDK версии 8.0.3.

Версия 8.0.3.1

• Добавлена ​​поддержка баннерной рекламы Chartboost.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 19.1.0.
• Chartboost SDK версии 8.0.3.

Версия 8.0.3.0

• Проверенная совместимость с Chartboost SDK 8.0.3.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 19.1.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 19.1.0.
• Chartboost SDK версии 8.0.3.

Версия 8.0.2.0

• Проверенная совместимость с Chartboost SDK 8.0.2.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 19.0.1.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 19.0.1.
• Chartboost SDK версии 8.0.2.

Версия 8.0.1.0

• Проверенная совместимость с Chartboost SDK 8.0.1.
• Требуется Chartboost SDK 8.0.1 или более поздней версии.
• Контекст активности больше не требуется для загрузки рекламы.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 18.3.0.
• Chartboost SDK версии 8.0.1.

Версия 7.5.0.1

• Исправлена ​​ошибка, из-за которой адаптер Chartboost не мог вызвать рекламные события.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 18.3.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 18.3.0.
• Chartboost SDK версии 7.5.0.

Версия 7.5.0.0

• Проверенная совместимость с Chartboost SDK 7.5.0.
• Адаптер перенесен для использования зависимостей AndroidX.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 18.1.1.

Версия 7.3.1.1

• Обновлен адаптер для поддержки нового API Rewarded открытой бета-версии.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 17.2.0.

Версия 7.3.1.0

• Проверенная совместимость с Chartboost SDK 7.3.1.

Версия 7.3.0.0

• Проверенная совместимость с Chartboost SDK 7.3.0.

Версия 7.2.1.0

• Проверенная совместимость с Chartboost SDK 7.2.1.

Версия 7.2.0.1

• Обновлен адаптер для вызова рекламного события onRewardedVideoComplete() .

Версия 7.2.0.0

• Проверенная совместимость с Chartboost SDK 7.2.0.

Версия 7.1.0.0

• Проверенная совместимость с Chartboost SDK 7.1.0.

Версия 7.0.1.0

• Проверенная совместимость с Chartboost SDK 7.0.1.
• Добавлена ​​поддержка новых кодов ошибок Chartboost.
• Обновлен проект адаптера для Android Studio 3.0.

Версия 7.0.0.0

• Обновлен адаптер, чтобы он был совместим с Chartboost SDK 7.0.0.

Версия 6.6.3.0

• Проверенная совместимость с Chartboost SDK 6.6.3.

Версия 6.6.2.0

• Проверенная совместимость с Chartboost SDK 6.6.2.

Версия 6.6.1.0

• Проверенная совместимость с Chartboost SDK 6.6.1.

Версия 6.6.0.0

• Изменена система именования версий на [Версия Chartboost SDK].[Версия патча адаптера].
• Теперь адаптеры можно добавить в качестве зависимости компиляции, добавив в тег зависимостей файла build.gradle следующий код: compile 'com.google.ads.mediation:chartboost:6.6.0.0'
• Переход на распространение адаптера в виде aar-файла, а не jar-файла (дополнительные инструкции см. в README).

Версия 1.1.0

• Из дополнительных материалов Chartboost удалено местоположение объявления Chartboost. Местоположение объявления теперь указывается в консоли AdMob при настройке Chartboost для медиации.

Версия 1.0.0

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

,

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

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

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

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

Требования

• Последняя версия Google Mobile Ads SDK

• Пройдите руководство по началу работы с медиацией

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

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

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

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

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

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

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

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

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

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

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

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

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

Шаг 2. Настройте запрос Chartboost в интерфейсе AdMob.

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

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

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

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

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

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

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

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

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

Под карточкой «Водопад» в разделе « Источники объявлений » выберите «Добавить источник объявлений» . Затем выберите Chartboost .

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

Примечание . Оптимизацию источника объявлений необходимо настроить только один раз для каждой сети.

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

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

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

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

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

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

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

Важно! Убедитесь, что у вас есть разрешение на управление учетной записью для завершения настройки согласия ЕС, GDPR, CPRA и платформы обмена сообщениями пользователей. Подробности см. в разделе Управление доступом пользователей к вашей учетной записи .

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

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

Примечание. Невозможность интеграции совместимых версий Chartboost и Google Mobile Ads 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.6.0")
    implementation("com.google.ads.mediation:chartboost:9.8.1.0")
}

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

1. Загрузите файл .aar последней версии Chartboost SDK из Maven Central и добавьте его в свой проект.

2. Перейдите к артефактам адаптера 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. Проверьте свою реализацию

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

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

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

Журнал изменений адаптера Chartboost Android Mediation

Версия 9.8.1.0

• Проверенная совместимость с Chartboost SDK версии 9.8.1.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 23.5.0.
• Chartboost SDK версии 9.8.1.

Версия 9.8.0.0

• Проверенная совместимость с Chartboost SDK версии 9.8.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 23.4.0.
• Chartboost SDK версии 9.8.0.

Версия 9.7.0.0

• Проверенная совместимость с Chartboost SDK версии 9.7.0.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 23.0.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 23.0.0.
• Chartboost SDK версии 9.7.0.

Версия 9.6.1.0

• Проверенная совместимость с Chartboost SDK версии 9.6.1.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 22.6.0.
• Chartboost SDK версии 9.6.1.

Версия 9.6.0.0

• Проверенная совместимость с Chartboost SDK версии 9.6.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 22.5.0.
• Chartboost SDK версии 9.6.0.

Версия 9.5.0.0

• Проверенная совместимость с Chartboost SDK версии 9.5.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 22.3.0.
• Chartboost SDK версии 9.5.0.

Версия 9.4.1.0

• Проверенная совместимость с Chartboost SDK версии 9.4.1.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 22.2.0.
• Chartboost SDK версии 9.4.1.

Версия 9.4.0.0

• Проверенная совместимость с Chartboost SDK версии 9.4.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 22.1.0.
• Chartboost SDK версии 9.4.0.

Версия 9.3.1.0

• Проверенная совместимость с Chartboost SDK версии 9.3.1.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 22.1.0.
• Chartboost SDK версии 9.3.1.

Версия 9.3.0.0

• Проверенная совместимость с Chartboost SDK версии 9.3.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 22.0.0.
• Chartboost SDK версии 9.3.0.

Версия 9.2.1.1

• Обновлен адаптер для использования нового класса VersionInfo .
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 22.0.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 22.0.0.
• Chartboost SDK версии 9.2.1.

Версия 9.2.1.0

• Проверенная совместимость с Chartboost SDK 9.2.1.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 21.5.0.
• Chartboost SDK версии 9.2.1.

Версия 9.2.0.0

• Проверенная совместимость с Chartboost SDK 9.2.0.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 21.5.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 21.5.0.
• Chartboost SDK версии 9.2.0.

Версия 9.1.1.0

• Добавлен метод ChartboostMediationAdapter.setAppParams(String, String) в качестве дополнительного способа жесткого указания идентификатора и подписи приложения, которые будут использоваться для инициализации Chartboost SDK.
• Проверенная совместимость с Chartboost SDK 9.1.1.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 21.3.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 21.3.0.
• Chartboost SDK версии 9.1.1.

Версия 8.4.3.1

• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 21.0.0.
• Минимально необходимый уровень Android API обновлен до 19.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 21.0.0.
• Chartboost SDK версии 8.4.3.

Версия 8.4.3.0

• Проверенная совместимость с Chartboost SDK 8.4.3.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 20.6.0.
• Chartboost SDK версии 8.4.3.

Версия 8.4.2.0

• Проверенная совместимость с Chartboost SDK 8.4.2.
• compileSdkVersion и targetSdkVersion обновлены до API 31.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 20.6.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 20.6.0.
• Chartboost SDK версии 8.4.2.

Версия 8.4.1.0

• Проверенная совместимость с Chartboost SDK 8.4.1.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 20.6.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 20.6.0.
• Chartboost SDK версии 8.4.1.

Версия 8.3.1.0

• Проверенная совместимость с Chartboost SDK 8.3.1.
• Обновлен адаптер для использования нового API AdError .

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 20.5.0.
• Chartboost SDK версии 8.3.1.

Версия 8.3.0.0

• Проверенная совместимость с Chartboost SDK 8.3.0.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 20.5.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 20.5.0.
• Chartboost SDK версии 8.3.0.

Версия 8.2.1.0

• Проверенная совместимость с Chartboost SDK 8.2.1.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 20.1.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 20.1.0.
• Chartboost SDK версии 8.2.1.

Версия 8.2.0.1

• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 20.0.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 20.0.0.
• Chartboost SDK версии 8.2.0.

Версия 8.2.0.0

• Проверенная совместимость с Chartboost SDK 8.2.0.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 19.5.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 19.5.0.
• Chartboost SDK версии 8.2.0.

Версия 8.1.0.0

• Проверенная совместимость с Chartboost SDK 8.1.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 19.2.0.
• Chartboost SDK версии 8.1.0.

Версия 8.0.3.2

• Добавлены описательные коды ошибок и причины сбоев загрузки/отображения адаптера.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 19.2.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 19.2.0.
• Chartboost SDK версии 8.0.3.

Версия 8.0.3.1

• Добавлена ​​поддержка баннерной рекламы Chartboost.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 19.1.0.
• Chartboost SDK версии 8.0.3.

Версия 8.0.3.0

• Проверенная совместимость с Chartboost SDK 8.0.3.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 19.1.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 19.1.0.
• Chartboost SDK версии 8.0.3.

Версия 8.0.2.0

• Проверенная совместимость с Chartboost SDK 8.0.2.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 19.0.1.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 19.0.1.
• Chartboost SDK версии 8.0.2.

Версия 8.0.1.0

• Проверенная совместимость с Chartboost SDK 8.0.1.
• Требуется Chartboost SDK 8.0.1 или более поздней версии.
• Контекст активности больше не требуется для загрузки рекламы.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 18.3.0.
• Chartboost SDK версии 8.0.1.

Версия 7.5.0.1

• Исправлена ​​ошибка, из-за которой адаптер Chartboost не мог вызвать рекламные события.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 18.3.0.

Создан и протестирован с использованием:

• Google Mobile Ads SDK версии 18.3.0.
• Chartboost SDK версии 7.5.0.

Версия 7.5.0.0

• Проверенная совместимость с Chartboost SDK 7.5.0.
• Адаптер перенесен для использования зависимостей AndroidX.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 18.1.1.

Версия 7.3.1.1

• Обновлен адаптер для поддержки нового API Rewarded открытой бета-версии.
• Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 17.2.0.

Версия 7.3.1.0

• Проверенная совместимость с Chartboost SDK 7.3.1.

Версия 7.3.0.0

• Проверенная совместимость с Chartboost SDK 7.3.0.

Версия 7.2.1.0

• Проверенная совместимость с Chartboost SDK 7.2.1.

Версия 7.2.0.1

• Обновлен адаптер для вызова рекламного события onRewardedVideoComplete() .

Версия 7.2.0.0

• Проверенная совместимость с Chartboost SDK 7.2.0.

Версия 7.1.0.0

• Проверенная совместимость с Chartboost SDK 7.1.0.

Версия 7.0.1.0

• Проверенная совместимость с Chartboost SDK 7.0.1.
• Добавлена ​​поддержка новых кодов ошибок Chartboost.
• Обновлен проект адаптера для Android Studio 3.0.

Версия 7.0.0.0

• Обновлен адаптер, чтобы он был совместим с Chartboost SDK 7.0.0.

Версия 6.6.3.0

• Проверенная совместимость с Chartboost SDK 6.6.3.

Версия 6.6.2.0

• Проверенная совместимость с Chartboost SDK 6.6.2.

Версия 6.6.1.0

• Проверенная совместимость с Chartboost SDK 6.6.1.

Версия 6.6.0.0

• Изменена система именования версий на [Версия Chartboost SDK].[Версия патча адаптера].
• Теперь адаптеры можно добавить в качестве зависимости компиляции, добавив в тег зависимостей файла build.gradle следующий код: compile 'com.google.ads.mediation:chartboost:6.6.0.0'
• Переход на распространение адаптера в виде aar-файла, а не jar-файла (дополнительные инструкции см. в README).

Версия 1.1.0

• Из дополнительных материалов Chartboost удалено местоположение объявления Chartboost. Местоположение объявления теперь указывается в консоли AdMob при настройке Chartboost для медиации.

Версия 1.0.0

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