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

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

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

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

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

Требования

  • Цель развертывания iOS 12.0 или выше

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

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

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

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

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

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

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

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

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

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

Панель медиации Chartboost

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

API-проводник Chartboost

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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


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

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



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

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

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

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

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

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

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

  • Добавьте следующую строку в подфайл вашего проекта:

    pod 'GoogleMobileAdsMediationChartboost'
    
  • Из командной строки выполните:

    pod install --repo-update

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

  • Загрузите последнюю версию Chartboost SDK и свяжите Chartboost.framework и CHAMoatMobileAppKit.framework в своем проекте.

  • Загрузите последнюю версию адаптера Chartboost по ссылке для скачивания в журнале изменений и свяжите ChartboostAdapter.framework в своем проекте.

  • Добавьте в свой проект следующие фреймворки:

    • StoreKit
    • Foundation
    • CoreGraphics
    • WebKit
    • AVFoundation
    • UIKit

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

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

В SDK версии 8.2.0 в Chartboost добавлен метод addDataUseConsent . Следующий пример кода устанавливает согласие на использование данных для CHBGDPRConsentNonBehavioral . Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы через Google Mobile Ads SDK.

Быстрый

let dataUseConsent = CHBDataUseConsent.GDPR(CHBDataUseConsent.GDPR.Consent.nonBehavioral)
Chartboost.addDataUseConsent(dataUseConsent)

Цель-C

CHBGDPRDataUseConsent *dataUseConsent = [CHBGDPRDataUseConsent gdprConsent:CHBGDPRConsentNonBehavioral];
[Chartboost addDataUseConsent:dataUseConsent];

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

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

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

В SDK версии 8.2.0 в Chartboost добавлен метод addDataUseConsent . Следующий пример кода устанавливает согласие на использование данных для CHBCCPAConsentOptInSale . Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы через Google Mobile Ads SDK.

Быстрый

let dataUseConsent = CHBDataUseConsent.CCPA(CHBDataUseConsent.CCPA.Consent.optInSale)
Chartboost.addDataUseConsent(dataUseConsent)

Цель-C

CHBCCPADataUseConsent *dataUseConsent = [CHBCCPADataUseConsent ccpaConsent:CHBCCPAConsentOptInSale];
[Chartboost addDataUseConsent:dataUseConsent];

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

Коды ошибок

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

GADMAdapterChartboost
GADMediationAdapterChartboost

Вот коды и сопутствующие сообщения, выдаваемые адаптером Chartboost, когда объявление не загружается:

Код ошибки Причина
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 iOS Mediation

Версия 9.8.0.0

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

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

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

Версия 9.7.0.1

  • Обновлен CFBundleShortVersionString , чтобы иметь три компонента вместо четырех.

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

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

Версия 9.7.0.0

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

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

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

Версия 9.6.0.1

  • Теперь требуется минимальная версия iOS 12.0.
  • Теперь требуется Google Mobile Ads SDK версии 11.0 или выше.
  • Info.plist включен в рамки ChartboostAdapter.xcframework .

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

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

Версия 9.6.0.0

  • Проверенная совместимость с Chartboost SDK версии 9.6.0.
  • Устаревший метод GADMobileAds.sharedInstance.sdkVersion заменен на GADMobileAds.sharedInstance.versionNumber .
  • Добавлена ​​реализация GADMediationInterstitialAd .

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

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

Версия 9.5.1.0

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

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

  • Google Mobile Ads SDK версии 10.12.0.
  • Chartboost SDK версии 9.5.1.

Версия 9.4.0.0

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

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

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

Версия 9.3.1.0

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

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

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

Версия 9.3.0.0

  • Проверенная совместимость с Chartboost SDK версии 9.3.0.
  • Теперь требуется минимальная версия iOS 11.0.
  • Теперь требуется Google Mobile Ads SDK версии 10.4.0 или выше.

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

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

Версия 9.2.0.0

  • Удален импорт GADMChartboostExtras в заголовочном файле ChartboostAdapter .
  • Проверенная совместимость с Chartboost SDK версии 9.2.0.
  • Теперь требуется Google Mobile Ads SDK версии 10.0.0 или выше.
  • Удалена поддержка архитектуры armv7 .
  • Теперь требуется минимальная версия iOS 11.0.

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

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

Версия 9.1.0.0

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

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

  • Google Mobile Ads SDK версии 9.11.0.
  • Chartboost SDK версии 9.1.0.

Версия 9.0.0.0

  • Проверенная совместимость с Chartboost SDK версии 9.0.0.
  • Подтверждена совместимость с Google Mobile Ads SDK версии 9.10.0.
  • Обновлен адаптер для использования API didRewardUser .
  • Теперь требуется Google Mobile Ads SDK версии 9.8.0 или выше.

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

  • Google Mobile Ads SDK версии 9.10.0.
  • Chartboost SDK версии 9.0.0.

Версия 8.5.0.2

  • Подтверждена совместимость с Google Mobile Ads SDK версии 9.0.0.
  • Теперь требуется Google Mobile Ads SDK версии 9.0.0 или выше.

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

  • Google Mobile Ads SDK версии 9.0.0.
  • Chartboost SDK версии 8.5.0.

Версия 8.5.0.1.0

  • Проверенная совместимость с Chartboost SDK 8.5.0, который относится к версии 8.5.0.1 в CocoaPods.

Создан и протестирован с

  • Google Mobile Ads SDK версии 8.13.0.
  • Chartboost SDK версии 8.5.0.

Версия 8.5.0.0

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

Создан и протестирован с

  • Google Mobile Ads SDK версии 8.12.0.
  • Chartboost SDK версии 8.5.0.

Версия 8.4.2.0

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

Создан и протестирован с

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

Версия 8.4.1.1

  • Слабая зависимость от Google Mobile Ads SDK версии 8.0.0 или выше.

Создан и протестирован с

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

Версия 8.4.1.0

  • Проверенная совместимость с Chartboost SDK 8.4.1.
  • Теперь требуется Google Mobile Ads SDK версии 8.1.0 или выше.

Создан и протестирован с

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

Версия 8.4.0.1

  • Добавлены стандартизированные коды ошибок и сообщения адаптера.
  • Обновлен адаптер для использования формата .xcframework .
  • Теперь требуется Google Mobile Ads SDK версии 8.0.0 или выше.

Создан и протестирован с

  • Google Mobile Ads SDK версии 8.0.0.
  • Chartboost SDK версии 8.4.0.

Версия 8.4.0.0

  • Проверенная совместимость с Chartboost SDK 8.4.0.
  • Теперь требуется Google Mobile Ads SDK версии 7.68.0 или выше.

Создан и протестирован с

  • Google Mobile Ads SDK версии 7.68.0.
  • Chartboost SDK версии 8.4.0.

Версия 8.3.1.0

  • Проверенная совместимость с Chartboost SDK 8.3.1.
  • Теперь требуется Google Mobile Ads SDK версии 7.66.0 или выше.
  • Теперь требуется минимальная версия iOS 10.0.
  • Обновлен адаптер для поддержки запросов адаптивных баннеров.

Создан и протестирован с

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

Версия 8.2.1.0

  • Проверенная совместимость с Chartboost SDK 8.2.1.
  • Теперь требуется Google Mobile Ads SDK версии 7.64.0 или выше.
  • Теперь требуется минимальная версия iOS 9.0.

Создан и протестирован с

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

Версия 8.2.0.0

  • Проверенная совместимость с Chartboost SDK 8.2.0.
  • Теперь требуется Google Mobile Ads SDK версии 7.61.0 или выше.

Создан и протестирован с

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

Версия 8.1.0.1

  • Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 7.60.0.
  • Обновлен адаптер для использования нового API Chartboost и удалены устаревшие API.
  • Адаптер теперь поддерживает загрузку нескольких объявлений одного формата, используя одно и то же местоположение Chartboost.
  • Если вознаграждение не переопределено в пользовательском интерфейсе AdMob или Менеджера рекламы, значение вознаграждения для объявлений с вознаграждением теперь равно значению, указанному в пользовательском интерфейсе Chartboost, а не 0 .

Создан и протестирован с

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

Версия 8.1.0.0

  • Проверенная совместимость с Chartboost SDK 8.1.0.
  • Минимальная необходимая версия Google Mobile Ads SDK обновлена ​​до 7.59.0.
  • Удалена поддержка архитектуры i386.

Создан и протестирован с

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

Версия 8.0.4.0

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

Создан и протестирован с

  • Google Mobile Ads SDK версии 7.52.0.
  • Chartboost SDK версии 8.0.4.

Версия 8.0.1.1

  • Исправлена ​​проблема, из-за которой запрос баннерной рекламы не возвращал заполнений.

Версия 8.0.1.0

  • Проверенная совместимость с Chartboost SDK 8.0.1.
  • Добавлена ​​поддержка запроса баннерной рекламы.

Версия 7.5.0.1

  • Добавлен код для правильной инициализации Chartboost SDK.

Версия 7.5.0.0

  • Проверенная совместимость с Chartboost SDK 7.5.0.
  • Обновлен адаптер для использования нового API с вознаграждением.
  • Обновлен адаптер для обработки нескольких межстраничных запросов.
  • Теперь требуется Google Mobile Ads SDK версии 7.42.2 или выше.

Версия 7.3.0.0

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

Версия 7.2.0.1

  • Добавлен adapterDidCompletePlayingRewardBasedVideoAd: обратный вызов адаптеру.

Версия 7.2.0.0

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

Версия 7.1.2.0

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

Версия 7.1.1.0

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

Версия 7.1.0.0

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

Версия 7.0.4.0

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

Версия 7.0.3.0

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

Версия 7.0.2.0

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

Версия 7.0.1.0

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

Версия 7.0.0.0

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

Версия 6.6.3.0

  • Проверенная совместимость с Chartboost SDK 6.6.3.
  • Удалена поддержка архитектуры «armv7s».
  • Исправлена ​​ошибка, из-за которой издатели сталкивались с проблемой компиляции в Swift при импорте ChartboostAdapter.framework как модуля, который импортировал немодульный Chartboost SDK.

Версия 6.6.2.0

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

Версия 6.6.1.0

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

Версия 6.6.0.0

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

Версия 6.5.2.1

  • Включена поддержка биткода.
  • Сейчас распространяем адаптер Chartboost в качестве фреймворка.
  • Чтобы импортировать ChartboostAdapter.framework в свой проект, обязательно установите для параметра Allow Non-modular Includes in Framework Modules значение YES в настройках сборки вашей цели.

Версия 6.5.2.0

  • Изменена система именования версий на [Версия Chartboost SDK].[Версия патча адаптера].
  • Минимально необходимый Chartboost SDK обновлен до версии 6.5.1.
  • Минимально необходимый Google Mobile Ads SDK обновлен до версии 7.10.1.
  • Исправлена ​​ошибка поддержки нескольких мест размещения объявлений Chartboost.
  • Приложения теперь получают обратный вызов interstitialWillDismissScreen: когда межстраничное объявление собирается закрыться.
  • Приложения теперь получают обратный вызов rewardBasedVideoAdDidOpen: при открытии видеорекламы с вознаграждением.

Версия 1.1.0

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

Версия 1.0.0

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