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

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

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

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

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

Требования

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

  • Последняя версия Google Mobile Ads Flutter Plugin.
  • Фреймворк Flutter 3.7.0 или более поздней версии.
  • Чтобы развернуть приложение на Android:
    • Android API уровня 24 или более поздней версии.
  • Чтобы развернуть приложение на iOS:
    • Целевая версия iOS для развертывания – 13.0 или более поздняя.
  • Рабочий проект Flutter, настроенный с помощью Google Mobile Ads Flutter Plugin. Подробнее о том, как настроить Google Mobile Ads Flutter Plugin…
  • Настройте медиацию AdMob.

    • Шаг 1. Задайте настройки в интерфейсе Chartboost

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

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

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

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

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

    Форма для нового приложения

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

    Android

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

    iOS

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

    Чтобы настроить идентификатор рекламного блока AdMob, вам понадобятся идентификатор пользователя и подпись пользователя Chartboost. Чтобы найти эти параметры, нажмите Chartboost mediation (Медиация Chartboost) в интерфейсе Chartboost.

    Панель управления медиацией Chartboost

    Перейдите на вкладку Resources (Ресурсы) > API Explorer (API Explorer) и запишите User ID (Идентификатор пользователя) и User Signature (Подпись пользователя), которые находятся в разделе 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.

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

    Чтобы включить тестовый режим в приложении, перейдите на вкладку Apps management (Управление приложениями) в интерфейсе Chartboost, выберите приложение из списка и нажмите Edit app settings (Изменить настройки приложения).

    Android

    Изменить настройки приложения

    iOS

    Изменить настройки приложения

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

    Тестовый режим Chartboost

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

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

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

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

    Android

    Инструкции приведены в шаге 2 руководства для Android.

    iOS

    Инструкции приведены в шаге 2 руководства для iOS.

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

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

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

    Интеграция через pub.dev

    (Только для Android.) Добавьте следующие репозитории в файл build.gradle в каталоге android проекта:

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

    Добавьте в файл pubspec.yaml своего пакета следующую зависимость с последними версиями SDK и адаптера Chartboost:

    dependencies:
  gma_mediation_chartboost: ^1.8.1

    Интеграция вручную

    Скачайте последнюю версию плагина медиации Google Mobile Ads для Chartboost, распакуйте скачанный файл и добавьте распакованную папку плагина (и ее содержимое) в проект Flutter. Затем добавьте в файл pubspec.yaml следующую зависимость:

    dependencies:
  gma_mediation_chartboost:
    path: path/to/local/package

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

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

    Законы штатов США о конфиденциальности

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

    В следующем образце кода согласие на использование данных имеет значение OptInSale. Если вы решите вызвать этот метод, рекомендуем сделать это до запроса объявлений с помощью Google Mobile Ads Flutter Plugin.

    Шаг 5. Добавьте необходимый код

    Android

    Для интеграции с Chartboost не требуется дополнительный код.

    iOS

    Интеграция SKAdNetwork

    Добавьте идентификаторы SKAdNetwork в файл Info.plist проекта, следуя инструкциям Chartboost.

    Шаг 6. Проверьте реализацию

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

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

    Проверьте тестовые объявления

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

    Необязательные шаги

    Android

    Разрешения

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

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

    iOS

    Для интеграции с iOS дополнительных действий не требуется.

    Коды ошибок

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

    Android

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

    iOS

    GADMAdapterChartboost
GADMediationAdapterChartboost

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

    Android

    Код ошибки Причина
    0-99 Chartboost SDK вернул ошибку.
    101 Запрошенный размер объявления не соответствует поддерживаемому размеру баннера Chartboost.
    102 Chartboost может загружать только одно объявление для каждого местоположения за раз.
    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.8.1

    Версия 1.8.0

    Версия 1.7.1

    Версия 1.7.0

    Версия 1.6.0

    Версия 1.5.2

    Версия 1.5.1

    Версия 1.5.0

    Версия 1.4.2

    Версия 1.4.1

    Версия 1.4.0

    Версия 1.3.3

    Версия 1.3.2

    Версия 1.3.1

    Версия 1.3.0

    Версия 1.2.1

    Версия 1.2.0

    Версия 1.1.0

    Версия 1.0.2

    Версия 1.0.1

    Версия 1.0.0