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

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

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

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

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

Требования

  • Последняя версия SDK Google Mobile Ads
  • Unity 4 или выше
  • Развертывание на Android
    • Android API уровня 21 или выше
  • Развертывание на iOS
    • Цель развертывания iOS 12.0 или выше
  • Рабочий проект Unity , настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе «Начало работы» .
  • Пройдите руководство по началу работы с медиацией

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

注册或登录 Unity Ads。

创建项目

在 Unity Ads 信息中心内，前往 Projects，然后点击 Create Project。

填写表单，然后点击 Create Project（创建项目）以添加项目。

依次前往创收 > 开始，然后点击开始。

在项目设置模态窗口中，选择我打算使用中介，并针对中介合作伙伴选择 Google AdMob，然后点击下一步。

选择您的广告设置，然后点击下一步。

填写表单，然后点击添加项目。

记下游戏 ID。

创建广告单元

依次前往创收 > 广告单元，然后点击添加广告单元。

输入广告单元名称，然后选择平台和广告格式。

Android

iOS

最后，点击创建，保存您的广告单元。

添加展示位置

创建项目后，依次前往创收 > 展示位置。如需创建新的展示位置，请为您的广告单元点击添加展示位置。

填写必要的详细信息，然后点击添加展示位置。

记下展示位置 ID。

Android

iOS

检索凭据

除了游戏 ID 和展示位置 ID 之外，您还需要 Unity Ads API 密钥和组织核心 ID 来设置AdMob 广告单元 ID。

依次前往创收 > 设置 > API 管理，然后记下 Monetize Stats API 访问密钥。

然后，依次转到创收 > 组织设置，并记下组织核心 ID。

开启测试模式

您可以从 Unity Ads 信息中心启用测试模式。在项目的设置下，选择测试标签页。

您可以通过以下方式强制应用测试模式：点击每个平台的修改按钮，选中替换客户端测试模式，然后选择对所有设备强制开启测试模式（即使用测试广告）。

Android

iOS

或者，您也可以通过点击 Add Test Device 按钮为特定设备启用测试模式。

填写表单并点击保存。

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

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

Андроид

Инструкции см. в шаге 2 руководства дляAndroid .

iOS

Инструкции см. в шаге 2 руководства дляiOS .

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

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

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

Загрузите последнюю версию плагина-посредника Google Mobile Ads для Unity Ads по ссылке для скачивания в журнале изменений и извлеките пакет GoogleMobileAdsUnityAdsMediation.unitypackage из zip -файла.

В редакторе проекта Unity выберите «Активы» > «Импортировать пакет» > «Пользовательский пакет» и выберите загруженный вами файл GoogleMobileAdsUnityAdsMediation.unitypackage . Убедитесь, что все файлы выбраны, и нажмите «Импортировать» .

Затем выберите «Ресурсы» > «Сопоставитель служб Play» > «Сопоставитель Android» > «Принудительное разрешение» . Библиотека Unity Play Services Resolver выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android вашего приложения Unity.

Использование адаптера Unity с Unity Ads Services

Если вы интегрируетесь с Unity Ads SDK через панель «Службы», диспетчер пакетов или хранилище ресурсов, у вас уже есть копия Unity Ads Android SDK в вашем приложении. Чтобы избежать проблем с повторяющимися символами при сборке для Android, вам необходимо удалить ссылку на Unity Ads SDK.

Обновите файл Assets/GoogleMobileAds/Editor/UnityMediationDependencies.xml и удалите зависимость Unity Ads SDK:

<!-- If using the Unity Ads Service from Unity3D, comment out this dependency to
avoid including the Unity Ads Android SDK twice. -->
<androidPackage spec="com.unity3d.ads:unity-ads:x.y.z">
  <repositories>
    <repository>https://repo.maven.apache.org/maven2/</repository>
  </repositories>
</androidPackage>

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

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

Плагин посредничества Google Mobile Ads для Unity Adsверсии 3.3.0включает методUnityAds.SetConsentMetaData(). В следующем примере кода показано, как передать информацию о согласии в Unity Ads SDK. Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы через Google Mobile Ads SDK.

using GoogleMobileAds.Api.Mediation.UnityAds;
// ...

UnityAds.SetConsentMetaData("gdpr.consent", true);

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

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

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

Плагин медиации Google Mobile Ads для Unity Adsверсии 3.3.0включает методUnityAds.SetConsentMetaData(). В следующем примере кода показано, как передать информацию о согласии в Unity Ads SDK. Если вы решите вызвать этот метод, рекомендуется сделать это до запроса рекламы через Google Mobile Ads SDK.

using GoogleMobileAds.Api.Mediation.UnityAds;
// ...

UnityAds.SetConsentMetaData("privacy.consent", true);

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

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

Андроид

Для интеграции Unity Ads с Android дополнительный код не требуется.

iOS

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

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

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

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

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

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

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

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

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

Коды ошибок

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

Андроид

com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter

iOS

GADMAdapterUnity
GADMediationAdapterUnity

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

Андроид

Код ошибки Причина
0-10 UnityAds SDK возвратил ошибку. См. код для более подробной информации.
101 Параметры сервера UnityAds, настроенные в пользовательском интерфейсе Admob, отсутствуют/недействительны.
102 UnityAds вернул место размещения со статусом NO_FILL.
103 UnityAds вернул место размещения в состоянии ОТКЛЮЧЕНО.
104 UnityAds попыталась показать рекламу с нулевым контекстом.
105 Контекст, используемый для инициализации, загрузки и/или показа рекламы из Unity Ads, не является экземпляром Activity.
106 UnityAds попыталась показать рекламу, которая еще не готова к показу.
107 UnityAds не поддерживается на устройстве.
108 UnityAds может загружать только одно объявление на одно место размещения одновременно.
109 UnityAds завершил работу с состоянием ОШИБКА.
200-204 Баннер UnityAds: конкретная ошибка. Подробнее см. в коде .

iOS

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 не поддерживает загрузку нескольких объявлений для одного места размещения.

Журнал изменений плагина Unity Mediation для Unity Ads

Версия 3.10.0

Версия 3.9.1

Версия 3.9.0

Версия 3.8.0

Версия 3.7.1

Версия 3.7.0

Версия 3.6.1

Версия 3.6.0

Версия 3.5.0

Версия 3.4.1

Версия 3.4.0

Версия 3.3.0

Версия 3.2.1

Версия 3.2.0

Версия 3.1.0

Версия 3.0.1

Версия 3.0.0

Версия 2.7.2

Версия 2.7.1

Версия 2.7.0

Версия 2.6.0

Версия 2.5.1

Версия 2.5.0

Версия 2.4.7

Версия 2.4.6

Версия 2.4.5

Версия 2.4.4

Версия 2.4.3

Версия 2.4.2

Версия 2.4.1

Версия 2.4.0

Версия 2.3.0

Версия 2.2.0

Версия 2.1.0

  • Поддерживает адаптер Unity Ads для Android версии 3.1.0.0.
  • Поддерживает адаптер Unity Ads для iOS версии 3.1.0.0.

Версия 2.0.3

  • Обновлен плагин для поддержки новой открытой бета-версии Rewarded API.
  • Добавляет поддержку баннерной рекламы.
  • Поддерживает адаптер Unity Ads для Android версии 3.0.0.2.
  • Поддерживает адаптер Unity Ads для iOS версии 3.0.0.3.

Версия 2.0.2

  • Поддерживает адаптер Unity Ads для Android версии 3.0.0.0.
  • Поддерживает адаптер Unity Ads для iOS версии 3.0.0.1.

Версия 2.0.1

  • Исправлена ​​ошибка «несовместимого типа», которая вызывала проблемы при сборке для iOS.

Версия 2.0.0

  • Поддерживает адаптер Unity Ads для Android версии 3.0.0.0.
  • Поддерживает адаптер Unity Ads для iOS версии 3.0.0.0.

Версия 1.2.0

  • Поддерживает адаптер Unity Ads для Android версии 2.3.0.0.
  • Поддерживает адаптер Unity Ads для iOS версии 2.3.0.0.

Версия 1.1.3

  • Поддерживает адаптер Unity Ads для Android версии 2.2.1.0.
  • Поддерживает адаптер Unity Ads для iOS версии 2.2.1.0.

Версия 1.1.2

  • Поддерживает Unity Ads Android SDK версии 2.2.0.
  • Поддерживает Unity Ads iOS SDK версии 2.2.0.
  • Добавлен метод UnityAds.SetGdprConsentMetaData() для ручного запроса согласия пользователя на целевую рекламу.

Версия 1.1.1

  • Поддерживает Unity Ads Android SDK версии 2.2.0.
  • Поддерживает Unity Ads iOS SDK версии 2.2.1.

Версия 1.1.0

  • Поддерживает Unity Ads Android SDK версии 2.2.0.
  • Поддерживает Unity Ads iOS SDK версии 2.2.0.

Версия 1.0.0

  • Первый выпуск!
  • Поддерживает Unity Ads Android SDK версии 2.1.2.
  • Поддерживает Unity Ads iOS SDK версии 2.1.2.