В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и отображения рекламы из Chartboost с помощью медиации , а также каскадной интеграции. В нем рассказывается, как добавить Chartboost в конфигурацию медиации рекламного блока и как интегрировать Chartboost SDK и адаптер в приложение Flutter.
Поддерживаемые интеграции и форматы объявлений
Адаптер медиации AdMob для Chartboost имеет следующие возможности:
Интеграция | |
---|---|
Торги | |
Водопад | |
Форматы | |
Баннер | |
Межстраничный | |
Награжден |
Требования
- Последняя версия Google Mobile Ads SDK
- Флаттер 3.7.0 или выше
- Развертывание на Android
- Android API уровня 21 или выше
- Развертывание на iOS
- Цель развертывания iOS 12.0 или выше
- Рабочий проект Flutter, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе « Начало работы ».
- Пройдите руководство по началу работы с медиацией
Шаг 1. Настройте конфигурации в пользовательском интерфейсе Chartboost.
Зарегистрируйте учетную запись Chartboost и войдите в систему, как только ваша учетная запись будет подтверждена. Затем перейдите на вкладку «Управление приложениями» .
Нажмите кнопку «Добавить новое приложение», чтобы создать свое приложение.
Заполните остальную часть формы и нажмите кнопку «Добавить приложение», чтобы завершить создание приложения.
После создания вашего приложения вы будете перенаправлены на его панель управления. Запишите идентификатор и подпись вашего приложения.
Андроид
iOS
AdMob требует идентификатор пользователя Chartboost и подпись пользователя для настройки идентификатора рекламного блока AdMob. Эти параметры можно найти, нажав «Медиация Chartboost» в пользовательском интерфейсе Chartboost.
Перейдите на вкладку «Ресурсы» > «Проводник API» и запишите свой идентификатор пользователя и подпись пользователя, расположенные в разделе «Аутентификация» .
Включите тестовый режим
Вы можете включить тестовый режим в своем приложении, перейдя на вкладку «Управление приложениями» в пользовательском интерфейсе Chartboost, выбрав свое приложение из списка и нажав «Изменить настройки приложения» .
Андроид
iOS
В настройках вашего приложения вы можете переключить тестовый режим в своем приложении.
После включения тестового режима вы можете запросить рекламу, используя идентификатор рекламного блока, созданный ранее, и получить тестовое объявление Chartboost.
После того как вы сможете получать тестовые объявления Chartboost, ваше приложение будет размещено на обзоре приложения издателя Chartboost. Чтобы монетизация на Chartboost работала, проверка приложения издателем должна быть одобрена Chartboost.
Шаг 2. Настройте запрос Chartboost в интерфейсе AdMob.
Настройте параметры медиации для своего рекламного блока
Андроид
Инструкции см. в шаге 2 руководства для Android .
iOS
Инструкции см. в шаге 2 руководства для iOS .
Добавьте Chartboost в список рекламных партнеров GDPR и государственных нормативов США.
Следуйте инструкциям в настройках GDPR и настройках законодательства штата США , чтобы добавить Chartboost в список рекламных партнеров GDPR и законодательства штата США в пользовательском интерфейсе AdMob.
Шаг 3. Импортируйте Chartboost SDK и адаптер.
Интеграция через pub.dev
Добавьте следующую зависимость с последними версиями Chartboost SDK и адаптера в файл pubspec.yaml
вашего пакета:
dependencies:
gma_mediation_chartboost: ^1.0.0
Ручная интеграция
Загрузите последнюю версию плагина-посредника Google Mobile Ads для Chartboost , извлеките загруженный файл и добавьте извлеченную папку плагина (и ее содержимое) в свой проект Flutter. Затем укажите ссылку на плагин в файле pubspec.yaml
, добавив следующую зависимость:
dependencies:
gma_mediation_chartboost:
path: path/to/local/package
Шаг 4. Реализуйте настройки конфиденциальности в Chartboost SDK
Согласие ЕС и GDPR
В соответствии с Политикой согласия пользователей Google из ЕС вы должны гарантировать, что пользователям в Европейской экономической зоне (ЕЭЗ) будет предоставлена определенная информация и получено от них согласие на использование идентификаторов устройств и личных данных. Эта политика отражает требования Директивы ЕС об электронной конфиденциальности и Общего регламента защиты данных (GDPR). При запросе согласия вы должны указать каждую рекламную сеть в вашей цепочке посредничества, которая может собирать, получать или использовать персональные данные, а также предоставлять информацию об использовании каждой сети. В настоящее время Google не может автоматически передавать выбор согласия пользователя в такие сети.
Плагин посредничества Google Mobile Ads для Chartboost версии 3.1.0 включает метод Chartboost.AddDataUseConsent()
. В следующем примере кода задается согласие на использование данных NonBehavioral
. Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы с помощью Google Mobile Ads SDK.
using GoogleMobileAds.Api.Mediation.Chartboost;
// ...
Chartboost.AddDataUseConsent(CBGDPRDataUseConsent.NonBehavioral);
Законы о конфиденциальности штатов США
Законы о конфиденциальности штатов США требуют предоставления пользователям права отказаться от «продажи» их «личной информации» (согласно определению этих условий в законе), при этом отказ предлагается через заметную ссылку «Не продавать мою личную информацию» на странице «продажа». " Домашняя страница партии. Руководство по соблюдению законов о конфиденциальности штатов США предлагает возможность включить ограниченную обработку данных для показа рекламы Google, но Google не может применить этот параметр к каждой рекламной сети в вашей цепочке медиации. Таким образом, вы должны определить каждую рекламную сеть в вашей цепочке посредничества, которая может участвовать в продаже личной информации, и следовать инструкциям каждой из этих сетей, чтобы обеспечить соблюдение требований.
Плагин посредничества Google Mobile Ads для Chartboost версии 3.1.0 включает метод Chartboost.AddDataUseConsent()
. В следующем примере кода задается согласие на использование данных для OptInSale
. Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы с помощью Google Mobile Ads SDK.
using GoogleMobileAds.Api.Mediation.Chartboost;
// ...
Chartboost.AddDataUseConsent(CBCCPADataUseConsent.OptInSale);
Шаг 5. Добавьте необходимый код
Андроид
Для интеграции Chartboost не требуется никакого дополнительного кода.
iOS
Интеграция со SKAdNetwork
Следуйте документации Chartboost , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist
вашего проекта.
Шаг 6. Проверьте свою реализацию
Включить тестовые объявления
Убедитесь, что вы зарегистрировали свое тестовое устройство в AdMob и включили тестовый режим в пользовательском интерфейсе Chartboost.
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от Chartboost, включите тестирование одного источника объявлений в Инспекторе объявлений, используя источники объявлений Chartboost (Waterfall) .
Дополнительные шаги
Андроид
Разрешения
Для оптимальной производительности Chartboost рекомендует добавить следующие дополнительные разрешения в файл AndroidManifest.xml
вашего приложения:
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
iOS
Для интеграции iOS не требуется никаких дополнительных действий.
Коды ошибок
Если адаптеру не удается получить объявление от Chartboost, издатели могут проверить основную ошибку из ответа на объявление, используя ResponseInfo
в следующих классах:
Андроид
com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter
iOS
GADMAdapterChartboost
GADMediationAdapterChartboost
Вот коды и сопутствующие сообщения, выдаваемые адаптером Chartboost, когда объявление не загружается:
Андроид
Код ошибки | Причина |
---|---|
0-99 | Chartboost SDK возвратил ошибку. |
101 | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому Chartboost. |
102 | Chartboost может одновременно загружать только 1 объявление для каждого местоположения. |
103 | Параметры сервера Chartboost, настроенные в пользовательском интерфейсе AdMob, отсутствуют/недействительны. |
104 | Межстраничная реклама или реклама с вознаграждением Chartboost не готова к показу. |
iOS
Код ошибки | Причина |
---|---|
101 | Параметры сервера Chartboost, настроенные в пользовательском интерфейсе AdMob, отсутствуют/недействительны. |
102 | Chartboost SDK возвратил ошибку инициализации. |
103 | Объявление Chartboost не кэшируется во время показа. |
104 | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому Chartboost. |
105 | Версия ОС устройства ниже минимальной поддерживаемой версии ОС Chartboost SDK. |
200-299 | Ошибки кэша Chartboost SDK. См. код для более подробной информации. |
300-399 | Chartboost SDK показывает ошибки. Подробнее см. в коде . |
400-499 | Ошибки щелчков Chartboost SDK. См. код для более подробной информации. |
Журнал изменений адаптера Chartboost Flutter Mediation
1.0.0
- Первоначальный выпуск.
- Проверенная совместимость с адаптером Chartboost Android версии 9.8.1.0.
- Проверенная совместимость с адаптером Chartboost iOS версии 9.8.0.0.
- Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.2.0.