Эта страница переведена с помощью Cloud Translation API.

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

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

This guide shows you how to use GMA Next-Gen SDK to load and display ads from Chartboost using AdMob Mediation , covering waterfall integrations. It covers how to add Chartboost to an ad unit's mediation configuration, and how to integrate the Chartboost SDK and adapter into an Android app.

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

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

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

Предварительные требования

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

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

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

Шаг 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 в конфигурацию медиации для вашего рекламного блока.

First, sign in to your AdMob account . Next, navigate to the Mediation tab. If you have an existing mediation group you'd like to modify, click the name of that mediation group to edit it, and skip ahead to Add Chartboost as an ad source .

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

Укажите формат и платформу вашей рекламы, затем нажмите «Продолжить» .

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

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

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

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

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

Select Chartboost and enable the Optimize switch. Enter the User ID and User Signature obtained in the previous section to set up ad source optimization for Chartboost. Then enter an eCPM value for Chartboost and click Continue .

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

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

Chartboost Ad Locations ( Named Locations ) are simple names representing a place in your app where you want to show an ad. AdMob sends requests to the location specified in the settings. Once requests are sent, Chartboost adds the location to its platform for reporting purposes. Users also have the ability to create new ad locations directly in the Chartboost platform before calling them in their games.

In the Chartboost UI, your Ad Locations can be revealed in the Basic Settings page by clicking Advanced Settings . See Chartboost's [Named Locations](//docs.chartboost.com/en/monetization/publishing/ad-locations/) guide for more details.
Наконец, нажмите «Готово» , чтобы добавить Chartboost в качестве источника рекламы, а затем нажмите «Сохранить» .

Note : Ad source optimization takes a few days to gather enough data to accurately calculate eCPM for a mediation network. In the meantime, the ad source optimization status is PENDING , so you must manually set an eCPM value for the network. Once the eCPM can be calculated, the ad source automatically starts updating the eCPM on your behalf.

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

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

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

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

В файле 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:1.4.0")
    implementation("com.google.ads.mediation:chartboost:9.14.0.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:1.4.0'
    implementation 'com.google.ads.mediation:chartboost:9.14.0.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 в репозитории Maven Google. Выберите последнюю версию, загрузите файл .aar адаптера Chartboost и добавьте его в свой проект.

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

Согласие ЕС и GDPR

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

Chartboost Android adapter version 9.13.0.0 and later automatically forwards to the Chartboost SDK the GDPR consent set by the UMP SDK and consent management platforms that support Google's Additional Consent specification . For more information, see SDK Privacy Methods .

Законы штатов США о защите частной жизни

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

In SDK version 8.1.0, Chartboost added the addDataUseConsent() method. The following sample code sets data use consent to OPT_IN_SALE . If you choose to call this method, it is recommended that you do so prior to requesting ads through 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 пока не готова к показу.

Список изменений адаптера Chartboost для посредничества в Android