Чтобы обсудить наши продукты и оставить отзыв о них, присоединяйтесь к официальному каналу Ad Manager Discord на сервере Google Advertising and Measurement Community .

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

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

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

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

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

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

Требования

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

Последняя версия Google Mobile Ads SDK
Завершить посредничество . Руководство по началу работы.

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

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

Панель инструментов приложений Chartboost

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

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

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

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

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

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

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

Панель управления посредничеством Chartboost

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

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 в пользовательском интерфейсе Менеджера рекламы

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

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

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

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

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

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

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

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

После выбора партнера по Yield выберите Mobile SDK Mediation в качестве типа интеграции , iOS в качестве платформы и Active в качестве статуса . Введите идентификатор приложения , подпись приложения и местоположение объявления, полученные в предыдущем разделе. Затем введите значение CPM по умолчанию .

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

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

По завершении нажмите кнопку «Сохранить» внизу страницы.

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

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

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

Использование 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). Вы несёте ответственность за проверку распространения согласия на каждый источник рекламы в вашей цепочке посредников. Google не может автоматически передавать согласие пользователя таким сетям.

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

Быстрый

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

Objective-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)

Objective-C

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

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

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

Интеграция SKAdNetwork

Следуйте документации Chartboost , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist вашего проекта.

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

Установите для параметра Разрешить немодульные включения в модули фреймворка значение YES в разделе Параметры сборки вашей цели.

Добавьте значение -ObjC в Другие флаги компоновщика в Настройках сборки вашего проекта для отладки и выпуска.

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

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

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

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

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

Коды ошибок

Если адаптеру не удается получить рекламу от 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. Подробнее см. в коде .