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

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

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

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

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

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

Требования

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

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

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

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

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

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

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

Новая форма заявки

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

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

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

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

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

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, вы можете его выбрать. В противном случае нажмите «Добавить сопоставление» .

Далее введите идентификатор приложения (App ID) , подпись приложения (App Signature) и местоположение рекламы (Ad Location) , полученные в предыдущем разделе. Затем нажмите «Готово» .

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

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

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

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

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

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

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

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

Котлин 

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:chartboost:9.11.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")
}

Классный 

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:chartboost:9.11.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'
}

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

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

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

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

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

В версии SDK 8.1.0 Chartboost добавил метод addDataUseConsent() . Приведенный ниже пример кода устанавливает значение параметра согласия на использование данных в NON_BEHAVIORAL . Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы через GMA Next-Gen SDK .

Java 

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

Java 

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)

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

Шаг 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.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 пока не готова к показу.