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

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

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

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

Android iOS Unity Flutter

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

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

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

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

Требования

Целевая версия iOS для развертывания — 12.0 или выше.

Новейший SDK для мобильной рекламы Google
Заполните руководство по началу медиации.

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

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

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

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

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

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

Новая форма заявки

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

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

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

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

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

Chartboost API Explorer

Обновите файл app-ads.txt.

Файл app-ads.txt, созданный в рамках инициативы IAB Tech Lab для авторизованных продавцов приложений , помогает гарантировать, что рекламный инвентарь вашего приложения продается только через авторизованные вами каналы. Чтобы предотвратить значительные потери дохода от рекламы, вам потребуется внедрить файл app-ads.txt . Если вы еще этого не сделали, создайте файл app-ads.txt для Ad Manager .

Для интеграции файла app-ads.txt с Chartboost см. файл app-ads.txt .

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

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

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

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

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

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

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

Шаг 2: Настройте параметры спроса Chartboost в пользовательском интерфейсе Ad Manager.

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

Войдите в свой аккаунт в Ad Manager .

Перейдите в раздел «Доставка» > «Группы доходности» и нажмите кнопку «Создать новую группу доходности» .

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

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

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

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

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

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

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

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

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

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

Чтобы добавить Chartboost в список рекламных партнеров, соответствующих европейским и американским государственным нормативным требованиям, в пользовательском интерфейсе Ad Manager, выполните действия, описанные в настройках европейских и американских нормативных требований.

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

Использование CocoaPods (рекомендуется)

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

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

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

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

Согласие ЕС и GDPR

В соответствии с Политикой Google по согласию пользователей в ЕС , вы должны предоставлять пользователям в Европейской экономической зоне (ЕЭЗ), Великобритании и Швейцарии определенную информацию и получать их согласие на использование файлов cookie или других локальных хранилищ, если это требуется по закону, а также на сбор, передачу и использование персональных данных для персонализации рекламы. Данная политика отражает требования Директивы ЕС о защите конфиденциальности в электронных коммуникациях (ePrivacy Directive) и Общего регламента по защите данных (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];

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

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

Интеграция SKAdNetwork

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

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

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

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

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

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

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

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

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

коды ошибок

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

GADMAdapterChartboost
GADMediationAdapterChartboost

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

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