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

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

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

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

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

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

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

Требования

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

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

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

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

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

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

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

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

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

Новая форма заявки на добавление приложения

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

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

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

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

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

Как включить режим тестирования

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

В интерфейсе Chartboost местоположения объявлений можно найти на странице Основные настройки, нажав Расширенные настройки. Дополнительную информацию можно найти в руководстве Chartboost Named Locations.

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

Как добавить 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 не может применить эту настройку ко всем рекламным сетям в цепочке медиации. Поэтому вам необходимо определить, какие рекламные сети в вашей цепочке медиации могут участвовать в продаже личной информации, и следовать инструкциям каждой из этих сетей, чтобы обеспечить соблюдение требований.

В версии 8.2.0 SDK 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];

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

Шаг 5. Добавьте обязательный код

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

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

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

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

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

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

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

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

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

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

Коды ошибок

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

GADMAdapterChartboost
GADMediationAdapterChartboost

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

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