Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

Как интегрировать Chartboost с Mediation

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

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

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

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

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

Требования

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

Целевая версия iOS для развертывания – 13.0 или более поздняя.

Последняя версия Google Mobile Ads SDK.
Настройте медиацию.

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

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

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

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

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

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

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

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

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

Чтобы настроить идентификатор рекламного блока Менеджера рекламы, вам потребуются идентификатор пользователя и подпись пользователя 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 (Изменить настройки приложения).

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

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

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

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

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

Шаг 2. Настройте спрос Chartboost в интерфейсе Менеджера рекламы

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

Войдите в аккаунт Менеджера рекламы.

Перейдите в раздел Выполнение > Группы доходности и нажмите кнопку Новая группа доходности.

Укажите уникальное название группы доходности, установите для нее статус Активно, выберите формат объявлений и задайте тип инвентаря Мобильное приложение. В разделе Таргетинг > Инвентарь выберите рекламный блок в разделах Инвентарь и Мобильное приложение, для которого нужно настроить медиацию.

Нажмите кнопку Добавить партнера по группе доходности.

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

Выберите Chartboost в качестве рекламной сети, введите уникальное название и включите медиацию.

Включите Автоматический сбор данных и введите идентификатор пользователя и подпись пользователя, полученные в предыдущем разделе.

Выбрав партнера по группе доходности, укажите Медиация с использованием Mobile SDK в качестве типа интеграции, iOS в качестве платформы и Активно в качестве статуса. Укажите идентификатор приложения, подпись приложения и место размещения объявления, полученные в предыдущем разделе. Затем укажите значение в поле Цена за тысячу показов по умолчанию.

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

В интерфейсе Chartboost места размещения рекламы можно посмотреть на странице Basic Settings (Основные настройки), нажав Advanced Settings (Расширенные настройки). Дополнительную информацию можно найти в руководстве Chartboost по именованным местоположениям.

Нажмите Сохранить внизу страницы.

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

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

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

Используйте Swift Package Manager

Прежде чем продолжить, убедитесь, что у вас установлена минимальная поддерживаемая версия адаптера – 9.11.0.1.

Чтобы добавить зависимость пакета в проект, выполните следующие действия:

В Xcode выберите File (Файл) > Add Package Dependencies (Добавить зависимости пакетов).
В появившемся окне найдите следующий URL пакета:
```
https://github.com/googleads/googleads-mobile-ios-mediation-chartboost.git
```
В разделе Правило зависимости выберите Ветвь.
В текстовом поле введите main.

Через CocoaPods

Добавьте в Podfile проекта следующую строку:
```
pod 'GoogleMobileAdsMediationChartboost'
```
В командной строке выполните следующую команду:
```
pod install --repo-update
```

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

Скачайте последнюю версию Chartboost SDK и свяжите Chartboost.framework и CHAMoatMobileAppKit.framework в своем проекте.
Скачайте последнюю версию адаптера Chartboost по ссылке для скачивания в журнале изменений и свяжите ChartboostAdapter.framework со своим проектом.
Добавьте в проект следующие фреймворки:
- StoreKit
- Foundation
- CoreGraphics
- WebKit
- AVFoundation
- UIKit

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

Согласие пользователей из ЕС и GDPR

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

Адаптер Chartboost для iOS версии 9.13.0.0 и более поздних автоматически передает в Chartboost SDK согласие по GDPR, заданное с помощью UMP SDK и платформ для запросов согласия, которые поддерживают спецификацию Google по получению дополнительного согласия. Дополнительную информацию можно найти в разделе Методы обеспечения конфиденциальности в SDK.

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

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

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

Swift

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

Objective-C

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

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

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

Как реализовать SKAdNetwork

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

Настройки проекта

В разделе Build Settings (Настройки сборки) целевого объекта задайте для параметра Allow Non-modular Includes in Framework Modules (Разрешить немодульные включения в модулях фреймворка) значение YES.

Добавьте значение -ObjC в поле Other Linker Flags (Другие флаги компоновщика) в разделе Build Settings (Настройки сборки) проекта для Debug (Отладка) и Release (Выпуск).

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

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

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

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

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

Коды ошибок

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

GADMAdapterChartboost
GADMediationAdapterChartboost

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

Код ошибки	Причина
101	Параметры сервера Chartboost, настроенные в интерфейсе Менеджера рекламы, отсутствуют или недействительны.
102	Chartboost SDK вернул ошибку инициализации.
103	Объявление Chartboost не кешируется во время показа.
104	Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому Chartboost.
105	Версия ОС на устройстве ниже минимальной поддерживаемой версии ОС Chartboost SDK.
200-299	Ошибки кеша Chartboost SDK. Подробную информацию можно найти в коде.
300-399	Ошибки показа Chartboost SDK. Подробную информацию можно найти в коде.
400-499	Ошибки кликов в Chartboost SDK. Подробную информацию можно найти в коде.