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

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

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

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

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

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

¹ Интеграция назначения ставок находится на стадии закрытого бета-тестирования. Чтобы запросить доступ, обратитесь к менеджеру своего аккаунта.

Требования

Цель развертывания iOS 12.0 или выше
[Для назначения ставок]: чтобы интегрировать все поддерживаемые форматы объявлений в назначение ставок, используйте адаптер Unity 4.11.3.1 или более поздней версии ( рекомендуется последняя версия ).

Последняя версия Google Mobile Ads SDK
Пройдите руководство по началу работы с медиацией

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

Зарегистрируйтесь или войдите в Unity Ads.

Создать проект

На панели управления Unity Ads перейдите в раздел «Проекты» и нажмите «Создать проект» .

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

Перейдите в раздел «Монетизация» > «Начать» , затем нажмите «Начать» .

В модальном окне «Настройка проекта » выберите «Я планирую использовать Mediation и Google Admob для партнера-посредника» , затем нажмите «Далее» .

Выберите настройки рекламы и нажмите «Далее» .

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

Обратите внимание на идентификатор игры .

Создать рекламный блок

Перейдите в «Монетизация» > «Рекламные блоки» , затем нажмите «Добавить рекламный блок» .

Введите название рекламного блока , затем выберите платформу и формат объявления .

Наконец, нажмите «Создать» , чтобы сохранить рекламный блок.

Добавить место размещения

Торги

Свяжитесь с менеджером своего аккаунта Google, чтобы создать места размещения для ставок.

Водопад

После создания проекта перейдите в раздел «Монетизация» > «Плейсменты» . Чтобы создать новое место размещения, нажмите «Добавить место размещения» для своего рекламного блока.

Заполните необходимые данные и нажмите «Добавить место размещения» .

Обратите внимание на идентификатор места размещения .

Найдите ключ API отчетов Unity Ads.

Торги

Этот шаг не требуется для интеграции ставок.

Водопад

Помимо идентификатора игры и идентификатора места размещения , вам также понадобится ключ Unity Ads API и основной идентификатор организации для настройки идентификатора рекламного блока AdMob.

Перейдите в раздел «Монетизация» > «Настройка» > «Управление API» и запишите ключ доступа к API статистики монетизации .

Затем перейдите в раздел «Монетизация» > «Настройки организации» и запишите основной идентификатор организации .

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

Тестовый режим можно включить из панели управления Unity Ads . В настройках вашего проекта выберите вкладку «Тестирование» .

Вы можете принудительно включить тестовый режим для своего приложения, нажав кнопку «Изменить» рядом с Apple App Store , отметив «Переопределить тестовый режим клиента» и выбрав «Принудительно включить тестовый режим» (т. е. использовать тестовую рекламу) для всех устройств .

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

Заполните форму и нажмите Сохранить .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Примечание . Оптимизация источника объявлений требует нескольких дней, чтобы собрать достаточно данных для точного расчета эффективной цены за тысячу показов для сети медиации. В то же время статус оптимизации источника объявлений — PENDING , поэтому вам необходимо вручную установить значение эффективной цены за тысячу показов для сети. Как только эффективная цена за тысячу показов будет рассчитана, источник объявлений автоматически начнет обновлять ее от вашего имени.

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

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

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

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

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

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

Загрузите последнюю версию Unity Ads SDK и свяжите UnityAds.framework в своем проекте.
Загрузите последнюю версию адаптера Unity Ads по ссылке для скачивания в журнале изменений и свяжите UnityAdapter.framework в своем проекте.

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

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

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

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

Быстрый

import UnityAds
// ...

let gdprMetaData = UADSMetaData()
gdprMetaData.set("gdpr.consent", value: true)
gdprMetaData.commit()

Цель-C

#import <UnityAds/UnityAds.h>
// ...

UADSMetaData *gdprMetaData = [[UADSMetaData alloc] init];
[gdprMetaData set:@"gdpr.consent" value:@YES];
[gdprMetaData commit];

Дополнительные сведения и значения, которые можно предоставить в каждом методе, см. в руководствах Unity Ads « Согласие на конфиденциальность и API данных» и «Соблюдение GDPR» .

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

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

Быстрый

import UnityAds
// ...

let ccpaMetaData = UADSMetaData()
ccpaMetaData.set("privacy.consent", value: true)
ccpaMetaData.commit()

Цель-C

#import <UnityAds/UnityAds.h>
// ...

UADSMetaData *ccpaMetaData = [[UADSMetaData alloc] init];
[ccpaMetaData set:@"privacy.consent" value:@YES];
[ccpaMetaData commit];

Дополнительные сведения и значения, которые можно указать в каждом методе, см. в руководствах Unity Ads « Согласие на конфиденциальность и API данных» и «Соблюдение требований CCPA» .

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

Интеграция со SKAdNetwork

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

Ошибки компиляции

Быстрый

Для интеграции Swift не требуется никакого дополнительного кода.

Цель-C

Для адаптера Unity Ads 4.4.0.0 или выше необходимо выполнить действия по интеграции, описанные в документации Unity .

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

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

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

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

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

Коды ошибок

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

GADMAdapterUnity
GADMediationAdapterUnity

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

Код ошибки	Причина
0-9	UnityAds SDK возвратил ошибку. Дополнительную информацию см. в документации Unity.
101	Параметры сервера UnityAds, настроенные в пользовательском интерфейсе AdMob, отсутствуют/недействительны.
102	Устройство не поддерживается UnityAds.
103	UnityAds завершил представление с состоянием ошибки kUnityAdsFinishStateError.
104	Объект объявления Unity равен нулю после вызова его инициализатора.
105	Не удалось показать Unity Ads, поскольку объявление не готово.
106	UnityAds вызвал обратный вызов изменения места размещения с состоянием размещения kUnityAdsPlacementStateNoFill.
107	UnityAds вызвал обратный вызов изменения места размещения с состоянием размещения kUnityAdsPlacementStateDisabled.
108	Объявление для этого места размещения уже загружено. UnityAds SDK не поддерживает загрузку нескольких объявлений для одного места размещения.