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

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

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

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

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

Требования

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

  • [Для торгов]: Чтобы интегрировать все поддерживаемые форматы рекламы в торги, используйте адаптер Unity 4.14.1.1 или выше ( рекомендуется последняя версия ).

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

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

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

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

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

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

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

Выберите параметр настроек рекламы, затем нажмите Далее .

Выберите настройку размещения, затем нажмите Далее .

Торги

Водопад

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

Запишите идентификатор игры .

Создание рекламных блоков и мест размещения

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

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

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

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

Выберите «Водопад» в разделе «Настройка» . В разделе «Размещение» введите имя места размещения , геотеги и цель .

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

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

Найдите ключ API Unity Ads Reporting

Торги

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

Водопад

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

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

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

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

Чтобы реализовать app-ads.txt для Unity Ads, см. раздел Настройка app-ads.txt в первый раз .

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

Тестовый режим можно включить на панели инструментов Unity Ads . Перейдите в раздел «Монетизация Unity Ads» > «Тестирование» .

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

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

Введите данные тестового устройства, затем нажмите «Сохранить» .

Шаг 2: Настройте спрос на Unity Ads в пользовательском интерфейсе Менеджера рекламы

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

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

Торги

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

Водопад

Перейдите в раздел «Администрирование» > «Компании» , затем нажмите кнопку «Новая компания» на вкладке «Все компании» . Выберите «Рекламная сеть» .

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

Имя пользователя и пароль вводить не нужно. Нажмите «Сохранить» по завершении.

Включить безопасный обмен сигналами

Торги

Перейдите в раздел «Администрирование» > «Глобальные настройки» . Перейдите на вкладку «Настройки аккаунта Ad Exchange» , проверьте и включите опцию «Безопасный обмен сигналами» . Нажмите «Сохранить» .

Водопад

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

Поделиться защищенным сигналом в запросах ставок

Торги

Перейдите в раздел «Инвентарь» > «Защищённые сигналы» . В разделе «Защищённые сигналы» найдите «Объявления Unity» и включите опцию «Включить интеграцию приложений» .

Нажмите «Сохранить» .

Водопад

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

Разрешить безопасный обмен сигналами для SDK Bidding

Торги

Перейдите в раздел «Доставка» > «Настройки канала спроса» . На вкладке «Настройки по умолчанию» включите опцию «Разрешить безопасный обмен сигналами для торгов SDK» .

Нажмите «Сохранить» .

Водопад

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

Настройка ставок Unity Ads

Торги

Перейдите в раздел Доставка > Участники торгов и нажмите Перейти к торгам SDK .

Нажмите кнопку «Новый участник торгов» .

Выберите Unity Ads в качестве участника торгов.

Нажмите «Продолжить» , чтобы включить функцию ставок SDK для этого участника торгов.

Нажмите Готово .

Водопад

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

Настроить сопоставление рекламных блоков

Торги

Перейдите в раздел Доставка > Участники торгов и нажмите Перейти к торгам SDK .

Выберите компанию для Unity Ads.

Перейдите на вкладку Сопоставление рекламного блока и нажмите Новое сопоставление рекламного блока .

Выберите конкретный рекламный блок . Выберите рекламный блок и формат, выберите «Мобильное приложение» в качестве типа инвентаря и ваше мобильное приложение . Затем введите идентификатор игры и идентификатор места размещения, полученные в предыдущем разделе. Нажмите « Сохранить» .

Водопад

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

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

Выберите компанию, созданную для Unity Ads в предыдущем разделе. Выберите Mobile SDK mediation в качестве типа интеграции , iOS в качестве платформы и Active в качестве статуса .

Введите идентификатор игры и идентификатор размещения, полученные в предыдущем разделе, а также значение CPM по умолчанию . Нажмите «Сохранить» .

Примечание: Автоматическому сбору данных требуется несколько дней, прежде чем он сможет точно рассчитать значение динамической цены за тысячу показов (CPM) для сети медиации. После того, как значение eCPM будет рассчитано, оно автоматически обновляется от вашего имени.

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

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

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

  • Добавьте следующую строку в Podfile вашего проекта:

    pod 'GoogleMobileAdsMediationUnity'
    
  • В командной строке выполните:

    pod install --repo-update

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

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

  • Загрузите последнюю версию адаптера Unity Ads по ссылке в журнале изменений и добавьте UnityAdapter.framework в свой проект.

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

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

Objective-C

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

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

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

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

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

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

Быстрый

import UnityAds
// ...

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

Objective-C

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

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

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

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

Интеграция SKAdNetwork

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

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

Быстрый

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

Objective-C

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

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

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

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

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

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

Коды ошибок

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

GADMAdapterUnity
GADMediationAdapterUnity

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

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

Журнал изменений адаптера медиации Unity Ads для iOS

Версия 4.16.2.0

  • Обновлены методы загрузки рекламы: теперь необходимо дождаться полной инициализации Unity Ads SDK перед попыткой загрузить рекламу.
  • Устранено состояние гонки, при котором обратные вызовы завершения потенциально могли быть сброшены, если выполняется несколько инициализаций.
  • Проверенная совместимость с Unity Ads SDK 4.16.2.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 12.12.0.
  • Unity Ads SDK версии 4.16.2.

Версия 4.16.1.0

  • Проверенная совместимость с Unity Ads SDK 4.16.1.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 12.9.0.
  • Unity Ads SDK версии 4.16.1.

Версия 4.16.0.0

  • Теперь требуется минимальная версия iOS 13.0 .
  • Проверенная совместимость с Unity Ads SDK 4.16.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 12.8.0.
  • Unity Ads SDK версии 4.16.0.

Версия 4.15.1.0

  • Проверенная совместимость с Unity Ads SDK 4.15.1.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 12.6.0.
  • Unity Ads SDK версии 4.15.1.

Версия 4.15.0.0

  • Добавлен код ошибки 111: Unsupported ad format .
  • Проверенная совместимость с Unity Ads SDK 4.15.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 12.5.0.
  • Unity Ads SDK версии 4.15.0.

Версия 4.14.2.0

  • Проверенная совместимость с Unity Ads SDK 4.14.2.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 12.3.0.
  • Unity Ads SDK версии 4.14.2.

Версия 4.14.1.1

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

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 12.2.0.
  • Unity Ads SDK версии 4.14.1.

Версия 4.14.1.0

  • Проверенная совместимость с Unity Ads SDK 4.14.1.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 12.2.0.
  • Unity Ads SDK версии 4.14.1.

Версия 4.14.0.0

  • Включены флаги -fobjc-arc и -fstack-protector-all .
  • Проверенная совместимость с Unity Ads SDK 4.14.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 12.2.0.
  • Unity Ads SDK версии 4.14.0.

Версия 4.13.2.0

  • Проверенная совместимость с Unity Ads SDK 4.13.2.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 12.1.0.
  • Unity Ads SDK версии 4.13.2.

Версия 4.13.1.1

  • Теперь требуется Google Mobile Ads SDK версии 12.0.0 или выше.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 12.0.0.
  • Unity Ads SDK версии 4.13.1.

Версия 4.13.1.0

  • Добавлено свойство GADMediationAdapterUnity.testMode , указывающее, следует ли инициализировать Unity Ads SDK в тестовом режиме. Этот флаг необходимо установить перед инициализацией Google Mobile Ads SDK.
  • Обновлено для сообщения кода ошибки Unity Ads SDK в случае, если реклама не загружается.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.13.0.
  • Unity Ads SDK версии 4.13.1.

Версия 4.13.0.0

  • Проверенная совместимость с Unity Ads SDK 4.13.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.13.0.
  • Unity Ads SDK версии 4.13.0.

Версия 4.12.5.0

  • Проверенная совместимость с Unity Ads SDK 4.12.5.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.12.0.
  • Unity Ads SDK версии 4.12.5.

Версия 4.12.4.0

  • Проверенная совместимость с Unity Ads SDK 4.12.4.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.12.0.
  • Unity Ads SDK версии 4.12.4.

Версия 4.12.3.1

  • Обновлен CFBundleShortVersionString теперь имеет три компонента вместо четырех.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.10.0.
  • Unity Ads SDK версии 4.12.3.

Версия 4.12.3.0

  • Проверенная совместимость с Unity Ads SDK 4.12.3.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.10.0.
  • Unity Ads SDK версии 4.12.3.

Версия 4.12.2.0

  • Проверенная совместимость с Unity Ads SDK 4.12.2.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.7.0.
  • Unity Ads SDK версии 4.12.2.

Версия 4.12.1.0

  • Проверенная совместимость с Unity Ads SDK 4.12.1.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.6.0.
  • Unity Ads SDK версии 4.12.1.

Версия 4.12.0.0

  • Проверенная совместимость с Unity Ads SDK 4.12.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.5.0.
  • Unity Ads SDK версии 4.12.0.

Версия 4.11.3.1

  • Добавлена ​​поддержка ставок для форматов баннерной, полноэкранной и вознагражденной рекламы.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.5.0.
  • Unity Ads SDK версии 4.11.3.

Версия 4.11.3.0

  • Проверенная совместимость с Unity Ads SDK 4.11.3.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.4.0.
  • Unity Ads SDK версии 4.11.3.

Версия 4.11.2.0

  • Проверенная совместимость с Unity Ads SDK 4.11.2.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.4.0.
  • Unity Ads SDK версии 4.11.2.

Версия 4.10.0.0

  • Проверенная совместимость с Unity Ads SDK 4.10.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.2.0.
  • Unity Ads SDK версии 4.10.0.

Версия 4.9.3.0

  • Проверенная совместимость с Unity Ads SDK 4.9.3.
  • Теперь требуется минимальная версия iOS 12.0.
  • Теперь требуется Google Mobile Ads SDK версии 11.0 или выше.
  • Включен Info.plist в фреймворки внутри UnityAdapter.xcframework .

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.0.1.
  • Unity Ads SDK версии 4.9.3.

Версия 4.9.2.0

  • Проверенная совместимость с Unity Ads SDK 4.9.2.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 10.13.0.
  • Unity Ads SDK версии 4.9.2.

Версия 4.9.1.0

  • Проверенная совместимость с Unity Ads SDK 4.9.1.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 10.12.0.
  • Unity Ads SDK версии 4.9.1.

Версия 4.9.0.0

  • Удалено соответствие и зависимость GADMAdNetworkAdapter от адаптера Unity.
  • Добавлен вызов метода показа отчета в методе делегата unityAdsShowStart .
  • Проверенная совместимость с Unity Ads SDK 4.9.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 10.12.0.
  • Unity Ads SDK версии 4.9.0.

Версия 4.8.0.0

  • Добавлена ​​поддержка событий показа для баннерной рекламы.
  • Проверенная совместимость с Unity Ads SDK 4.8.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 10.7.0.
  • Unity Ads SDK версии 4.8.0.

Версия 4.7.1.0

  • Проверенная совместимость с Unity Ads SDK 4.7.1.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 10.5.0.
  • Unity Ads SDK версии 4.7.1.

Версия 4.7.0.0

  • Проверенная совместимость с Unity Ads SDK 4.7.0.
  • Теперь требуется минимальная версия iOS 11.0.
  • Теперь требуется Google Mobile Ads SDK версии 10.4.0 или выше.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 10.4.0.
  • Unity Ads SDK версии 4.7.0.

Версия 4.6.1.0

  • Проверенная совместимость с Unity Ads SDK 4.6.1.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 10.2.0.
  • Unity Ads SDK версии 4.6.1.

Версия 4.6.0.0

  • Проверенная совместимость с Unity Ads SDK 4.6.0.
  • Добавлена ​​поддержка пересылки информации COPPA в Unity Ads SDK.
  • Удалена поддержка архитектуры armv7 .
  • Теперь требуется Google Mobile Ads SDK версии 10.0.0 или выше.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 10.2.0.
  • Unity Ads SDK версии 4.6.0.

Версия 4.5.0.0

  • Проверенная совместимость с Unity Ads SDK 4.5.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 9.14.0.
  • Unity Ads SDK версии 4.5.0.

Версия 4.4.1.0

  • Проверенная совместимость с Unity Ads SDK 4.4.1.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 9.11.0.
  • Unity Ads SDK версии 4.4.1.

Версия 4.4.0.0

  • Обновлен адаптер для использования API didRewardUser .
  • Теперь требуется Google Mobile Ads SDK версии 9.8.0 или выше.
  • Проверенная совместимость с Unity Ads SDK 4.4.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 9.10.0.
  • Unity Ads SDK версии 4.4.0.

Версия 4.3.0.0

  • Проверенная совместимость с Unity Ads SDK 4.3.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 9.8.0.
  • Unity Ads SDK версии 4.3.0.

Версия 4.2.1.0

  • Проверенная совместимость с Unity Ads SDK 4.2.1.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 9.4.0.
  • Unity Ads SDK версии 4.2.1.

Версия 4.1.0.0

  • Проверенная совместимость с Unity Ads SDK 4.1.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 9.2.0.
  • Unity Ads SDK версии 4.1.0.

Версия 4.0.1.0

  • Проверенная совместимость с Unity Ads SDK 4.0.1.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 9.0.0.
  • Unity Ads SDK версии 4.0.1.

Версия 4.0.0.2

  • Добавлена ​​поддержка архитектуры симулятора arm64.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 9.0.0.
  • Unity Ads SDK версии 4.0.0.

Версия 4.0.0.1

  • Проверенная совместимость с Google Mobile Ads SDK версии 9.0.0.
  • Теперь требуется Google Mobile Ads SDK версии 9.0.0 или выше.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 9.0.0.
  • Unity Ads SDK версии 4.0.0.

Версия 4.0.0.0

  • Проверенная совместимость с Unity Ads SDK 4.0.0.
  • Теперь требуется минимальная версия iOS 10.0.

Создано и протестировано с

  • Google Mobile Ads SDK версии 8.13.0.
  • Unity Ads SDK версии 4.0.0.

Версия 3.7.5.0

  • Проверенная совместимость с Unity Ads SDK 3.7.5.

Создано и протестировано с

  • Google Mobile Ads SDK версии 8.8.0.
  • Unity Ads SDK версии 3.7.5.

Версия 3.7.4.0

  • Проверенная совместимость с Unity Ads SDK 3.7.4.

Создано и протестировано с

  • Google Mobile Ads SDK версии 8.7.0.
  • Unity Ads SDK версии 3.7.4.

Версия 3.7.2.0

  • Проверенная совместимость с Unity Ads SDK 3.7.2.
  • Снижена зависимость от Google Mobile Ads SDK версии 8.0.0 или выше.

Создано и протестировано с

  • Google Mobile Ads SDK версии 8.5.0.
  • Unity Ads SDK версии 3.7.2.

Версия 3.7.1.0

  • Проверенная совместимость с Unity Ads SDK 3.7.1.
  • Теперь требуется Google Mobile Ads SDK версии 8.4.0 или выше.

Создано и протестировано с

  • Google Mobile Ads SDK версии 8.4.0.
  • Unity Ads SDK версии 3.7.1.

Версия 3.6.2.0

  • Обновлен адаптер для использования формата .xcframework .
  • Проверенная совместимость с Unity Ads SDK 3.6.2.
  • Теперь требуется Google Mobile Ads SDK версии 8.2.0 или выше.

Создано и протестировано с

  • Google Mobile Ads SDK версии 8.2.0.
  • Unity Ads SDK версии 3.6.2.

Версия 3.6.0.0

  • Проверенная совместимость с Unity Ads SDK 3.6.0.
  • Теперь требуется Google Mobile Ads SDK версии 7.69.0 или выше.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.69.0.
  • Unity Ads SDK версии 3.6.0.

Версия 3.5.1.1

  • Исправлен сбой, который иногда возникал после завершения инициализации Unity Ads SDK.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.68.0.
  • Unity Ads SDK версии 3.5.1.

Версия 3.5.1.0

  • Проверенная совместимость с Unity Ads SDK 3.5.1.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.68.0.
  • Unity Ads SDK версии 3.5.1.

Версия 3.5.0.0

  • Проверенная совместимость с Unity Ads SDK 3.5.0.
  • Добавлена ​​поддержка адаптивной баннерной рекламы.
  • Теперь требуется Google Mobile Ads SDK версии 7.68.0 или выше.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.68.0.
  • Unity Ads SDK версии 3.5.0.

Версия 3.4.8.0

  • Проверенная совместимость с Unity Ads SDK 3.4.8.
  • Теперь требуется Google Mobile Ads SDK версии 7.63.0 или выше.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.63.0.
  • Unity Ads SDK версии 3.4.8.

Версия 3.4.6.0

  • Проверенная совместимость с Unity Ads SDK 3.4.6.
  • Теперь требуется Google Mobile Ads SDK версии 7.60.0 или выше.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.60.0.
  • Unity Ads SDK версии 3.4.6.

Версия 3.4.2.2

  • Добавлены стандартизированные коды ошибок адаптера и сообщения.
  • Обновлена ​​минимально требуемая версия Google Mobile Ads SDK до 7.59.0.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.59.0.
  • Unity Ads SDK версии 3.4.2.

Версия 3.4.2.1

  • Улучшена пересылка ошибок Unity для более раннего распознавания сбоев инициализации и загрузки рекламы, а также сокращения времени ожидания.
  • Удалена поддержка архитектуры i386.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.57.0.
  • Unity Ads SDK версии 3.4.2.

Версия 3.4.2.0

  • Проверенная совместимость с Unity Ads SDK 3.4.2.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.55.1.
  • Unity Ads SDK версии 3.4.2.

Версия 3.4.0.0

  • Проверенная совместимость с Unity Ads SDK 3.4.0.
  • Теперь поддерживается загрузка нескольких баннерных объявлений одновременно.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.53.0.
  • Unity Ads SDK версии 3.4.0.

Версия 3.3.0.0

  • Проверенная совместимость с Unity Ads SDK 3.3.0.
  • Теперь поддерживается загрузка нескольких баннерных объявлений одновременно.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.51.0.
  • Unity Ads SDK версии 3.3.0.

Версия 3.2.0.1

  • Проверенная совместимость с Unity Ads SDK 3.2.0.
  • Теперь требуется Google Mobile Ads SDK версии 7.46.0 или выше.
  • Исправлена ​​ошибка, из-за которой рекламные баннеры Unity не отображались при загрузке.
  • Исправлена ​​ошибка, из-за которой адаптер неправильно перенаправлял обратный вызов unityAdsReady .

Версия 3.2.0.0

  • Релиз был удален из-за регрессии в отношении незаполненных отчетов.

Версия 3.1.0.0

  • Проверенная совместимость с Unity Ads SDK 3.1.0.

Версия 3.0.3.0

  • Проверенная совместимость с Unity Ads SDK 3.0.3.
  • Теперь требуется Google Mobile Ads SDK версии 7.42.2 или выше.
  • Добавлена ​​поддержка гибких размеров баннерной рекламы.
  • Исправлена ​​ошибка, из-за которой рекламные баннеры Unity успешно загружались только один раз за сеанс.

Версия 3.0.1.0

  • Проверенная совместимость с Unity Ads SDK 3.0.1.
  • Исправлен сбой, возникавший при отмене вознаграждения за рекламу.

Версия 3.0.0.3

  • Обновление адаптера для использования нового API с вознаграждением.
  • Теперь требуется Google Mobile Ads SDK версии 7.41.0 или выше.

Версия 3.0.0.2

  • Добавлена ​​поддержка баннерной рекламы.

Версия 3.0.0.1

  • Исправлена ​​ошибка, из-за которой адаптер сохранял «placementId» предыдущего запроса.

Версия 3.0.0.0

  • Проверенная совместимость с Unity Ads SDK 3.0.0.

Версия 2.3.0.0

  • Проверенная совместимость с Unity Ads SDK 2.3.0.

Версия 2.2.1.1

  • Добавлен adapterDidCompletePlayingRewardBasedVideoAd: обратный вызов адаптеру.

Версия 2.2.1.0

  • Проверенная совместимость с Unity Ads SDK 2.2.1.

Версия 2.2.0.0

  • Проверенная совместимость с Unity Ads SDK 2.2.0.

Версия 2.1.2.0

  • Проверенная совместимость с Unity Ads SDK 2.1.2.
  • Удалена поддержка архитектуры «armv7s».

Версия 2.1.1.0

  • Проверенная совместимость с Unity Ads SDK 2.1.1.

Версия 2.1.0.0

  • Обновлен адаптер для совместимости с Unity Ads SDK 2.1.0.

Версия 2.0.8.0

  • Проверенная совместимость с Unity Ads SDK 2.0.8.

Версия 2.0.7.0

  • Адаптер теперь отслеживает клики по рекламе Unity Ads, поэтому статистика кликов по рекламе AdMob и Unity Ads может совпадать.
  • Приложения теперь получают обратные вызовы interstitialWillLeaveApplication: и rewardBasedVideoAdWillLeaveApplication: :.

Версия 2.0.6.0

  • Проверенная совместимость с Unity Ads SDK 2.0.6.

Версия 2.0.5.0

  • Проверенная совместимость с Unity Ads SDK 2.0.5.

Версия 2.0.4.0

  • Изменена система наименования версий на [версия Unity Ads SDK].[версия патча адаптера].
  • Минимально требуемый Unity Ads SDK обновлен до версии 2.0.4.
  • Минимально требуемый Google Mobile Ads SDK обновлен до версии 7.10.1.

Версия 1.0.2

  • Ключ к награде пользователя теперь ненулевой. Ключ награды всегда будет пустой или представлять собой допустимую строку.

Версия 1.0.1

  • Исправлена ​​ошибка, из-за которой не вызывался обратный вызов rewardBasedVideoAdDidOpen:

Версия 1.0.0

  • Поддерживает полноэкранную и платную видеорекламу.
,

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

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

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

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

Требования

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

  • [Для торгов]: Чтобы интегрировать все поддерживаемые форматы рекламы в торги, используйте адаптер Unity 4.14.1.1 или выше ( рекомендуется последняя версия ).

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

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

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

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

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

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

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

Выберите параметр настроек рекламы, затем нажмите Далее .

Выберите настройку размещения, затем нажмите Далее .

Торги

Водопад

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

Запишите идентификатор игры .

Создание рекламных блоков и мест размещения

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

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

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

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

Выберите «Водопад» в разделе «Настройка» . В разделе «Размещение» введите имя места размещения , геотеги и цель .

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

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

Найдите ключ API Unity Ads Reporting

Торги

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

Водопад

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

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

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

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

Чтобы реализовать app-ads.txt для Unity Ads, см. раздел Настройка app-ads.txt в первый раз .

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

Тестовый режим можно включить на панели инструментов Unity Ads . Перейдите в раздел «Монетизация Unity Ads» > «Тестирование» .

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

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

Введите данные тестового устройства, затем нажмите «Сохранить» .

Шаг 2: Настройте спрос на Unity Ads в пользовательском интерфейсе Менеджера рекламы

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

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

Торги

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

Водопад

Перейдите в раздел «Администрирование» > «Компании» , затем нажмите кнопку «Новая компания» на вкладке «Все компании» . Выберите «Рекламная сеть» .

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

Имя пользователя и пароль вводить не нужно. Нажмите «Сохранить» по завершении.

Включить безопасный обмен сигналами

Торги

Перейдите в раздел «Администрирование» > «Глобальные настройки» . Перейдите на вкладку «Настройки аккаунта Ad Exchange» , проверьте и включите опцию «Безопасный обмен сигналами» . Нажмите «Сохранить» .

Водопад

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

Поделиться защищенным сигналом в запросах ставок

Торги

Перейдите в раздел «Инвентарь» > «Защищённые сигналы» . В разделе «Защищённые сигналы» найдите «Объявления Unity» и включите опцию «Включить интеграцию приложений» .

Нажмите «Сохранить» .

Водопад

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

Разрешить безопасный обмен сигналами для SDK Bidding

Торги

Перейдите в раздел «Доставка» > «Настройки канала спроса» . На вкладке «Настройки по умолчанию» включите опцию «Разрешить безопасный обмен сигналами для торгов SDK» .

Нажмите «Сохранить» .

Водопад

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

Настройка ставок Unity Ads

Торги

Перейдите в раздел Доставка > Участники торгов и нажмите Перейти к торгам SDK .

Нажмите кнопку «Новый участник торгов» .

Выберите Unity Ads в качестве участника торгов.

Нажмите «Продолжить» , чтобы включить функцию ставок SDK для этого участника торгов.

Нажмите Готово .

Водопад

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

Настроить сопоставление рекламных блоков

Торги

Перейдите в раздел Доставка > Участники торгов и нажмите Перейти к торгам SDK .

Выберите компанию для Unity Ads.

Перейдите на вкладку Сопоставление рекламного блока и нажмите Новое сопоставление рекламного блока .

Выберите конкретный рекламный блок . Выберите рекламный блок и формат, выберите «Мобильное приложение» в качестве типа инвентаря и ваше мобильное приложение . Затем введите идентификатор игры и идентификатор места размещения, полученные в предыдущем разделе. Нажмите « Сохранить» .

Водопад

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

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

Выберите компанию, созданную для Unity Ads в предыдущем разделе. Выберите Mobile SDK mediation в качестве типа интеграции , iOS в качестве платформы и Active в качестве статуса .

Введите идентификатор игры и идентификатор размещения, полученные в предыдущем разделе, а также значение CPM по умолчанию . Нажмите «Сохранить» .

Примечание: Автоматическому сбору данных требуется несколько дней, прежде чем он сможет точно рассчитать значение динамической цены за тысячу показов (CPM) для сети медиации. После того, как значение eCPM будет рассчитано, оно автоматически обновляется от вашего имени.

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

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

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

  • Добавьте следующую строку в Podfile вашего проекта:

    pod 'GoogleMobileAdsMediationUnity'
    
  • В командной строке выполните:

    pod install --repo-update

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

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

  • Загрузите последнюю версию адаптера Unity Ads по ссылке в журнале изменений и добавьте UnityAdapter.framework в свой проект.

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

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

Objective-C

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

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

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

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

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

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

Быстрый

import UnityAds
// ...

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

Objective-C

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

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

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

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

Интеграция SKAdNetwork

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

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

Быстрый

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

Objective-C

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

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

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

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

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

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

Коды ошибок

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

GADMAdapterUnity
GADMediationAdapterUnity

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

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

Журнал изменений адаптера медиации Unity Ads для iOS

Версия 4.16.2.0

  • Обновлены методы загрузки рекламы: теперь необходимо дождаться полной инициализации Unity Ads SDK перед попыткой загрузить рекламу.
  • Устранено состояние гонки, при котором обратные вызовы завершения потенциально могли быть сброшены, если выполняется несколько инициализаций.
  • Проверенная совместимость с Unity Ads SDK 4.16.2.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 12.12.0.
  • Unity Ads SDK версии 4.16.2.

Версия 4.16.1.0

  • Проверенная совместимость с Unity Ads SDK 4.16.1.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 12.9.0.
  • Unity Ads SDK версии 4.16.1.

Версия 4.16.0.0

  • Теперь требуется минимальная версия iOS 13.0 .
  • Проверенная совместимость с Unity Ads SDK 4.16.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 12.8.0.
  • Unity Ads SDK версии 4.16.0.

Версия 4.15.1.0

  • Проверенная совместимость с Unity Ads SDK 4.15.1.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 12.6.0.
  • Unity Ads SDK версии 4.15.1.

Версия 4.15.0.0

  • Добавлен код ошибки 111: Unsupported ad format .
  • Проверенная совместимость с Unity Ads SDK 4.15.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 12.5.0.
  • Unity Ads SDK версии 4.15.0.

Версия 4.14.2.0

  • Проверенная совместимость с Unity Ads SDK 4.14.2.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 12.3.0.
  • Unity Ads SDK версии 4.14.2.

Версия 4.14.1.1

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

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 12.2.0.
  • Unity Ads SDK версии 4.14.1.

Версия 4.14.1.0

  • Проверенная совместимость с Unity Ads SDK 4.14.1.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 12.2.0.
  • Unity Ads SDK версии 4.14.1.

Версия 4.14.0.0

  • Включены флаги -fobjc-arc и -fstack-protector-all .
  • Проверенная совместимость с Unity Ads SDK 4.14.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 12.2.0.
  • Unity Ads SDK версии 4.14.0.

Версия 4.13.2.0

  • Проверенная совместимость с Unity Ads SDK 4.13.2.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 12.1.0.
  • Unity Ads SDK версии 4.13.2.

Версия 4.13.1.1

  • Теперь требуется Google Mobile Ads SDK версии 12.0.0 или выше.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 12.0.0.
  • Unity Ads SDK версии 4.13.1.

Версия 4.13.1.0

  • Добавлено свойство GADMediationAdapterUnity.testMode , указывающее, следует ли инициализировать Unity Ads SDK в тестовом режиме. Этот флаг необходимо установить перед инициализацией Google Mobile Ads SDK.
  • Обновлено для сообщения кода ошибки Unity Ads SDK в случае, если реклама не загружается.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.13.0.
  • Unity Ads SDK версии 4.13.1.

Версия 4.13.0.0

  • Проверенная совместимость с Unity Ads SDK 4.13.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.13.0.
  • Unity Ads SDK версии 4.13.0.

Версия 4.12.5.0

  • Проверенная совместимость с Unity Ads SDK 4.12.5.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.12.0.
  • Unity Ads SDK версии 4.12.5.

Версия 4.12.4.0

  • Проверенная совместимость с Unity Ads SDK 4.12.4.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.12.0.
  • Unity Ads SDK версии 4.12.4.

Версия 4.12.3.1

  • Обновлен CFBundleShortVersionString теперь имеет три компонента вместо четырех.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.10.0.
  • Unity Ads SDK версии 4.12.3.

Версия 4.12.3.0

  • Проверенная совместимость с Unity Ads SDK 4.12.3.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.10.0.
  • Unity Ads SDK версии 4.12.3.

Версия 4.12.2.0

  • Проверенная совместимость с Unity Ads SDK 4.12.2.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.7.0.
  • Unity Ads SDK версии 4.12.2.

Версия 4.12.1.0

  • Проверенная совместимость с Unity Ads SDK 4.12.1.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.6.0.
  • Unity Ads SDK версии 4.12.1.

Версия 4.12.0.0

  • Проверенная совместимость с Unity Ads SDK 4.12.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.5.0.
  • Unity Ads SDK версии 4.12.0.

Версия 4.11.3.1

  • Добавлена ​​поддержка ставок для форматов баннерной, полноэкранной и вознагражденной рекламы.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.5.0.
  • Unity Ads SDK версии 4.11.3.

Версия 4.11.3.0

  • Проверенная совместимость с Unity Ads SDK 4.11.3.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.4.0.
  • Unity Ads SDK версии 4.11.3.

Версия 4.11.2.0

  • Проверенная совместимость с Unity Ads SDK 4.11.2.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.4.0.
  • Unity Ads SDK версии 4.11.2.

Версия 4.10.0.0

  • Проверенная совместимость с Unity Ads SDK 4.10.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.2.0.
  • Unity Ads SDK версии 4.10.0.

Версия 4.9.3.0

  • Проверенная совместимость с Unity Ads SDK 4.9.3.
  • Теперь требуется минимальная версия iOS 12.0.
  • Теперь требуется Google Mobile Ads SDK версии 11.0 или выше.
  • Включен Info.plist в фреймворки внутри UnityAdapter.xcframework .

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.0.1.
  • Unity Ads SDK версии 4.9.3.

Версия 4.9.2.0

  • Проверенная совместимость с Unity Ads SDK 4.9.2.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 10.13.0.
  • Unity Ads SDK версии 4.9.2.

Версия 4.9.1.0

  • Проверенная совместимость с Unity Ads SDK 4.9.1.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 10.12.0.
  • Unity Ads SDK версии 4.9.1.

Версия 4.9.0.0

  • Удалено соответствие и зависимость GADMAdNetworkAdapter от адаптера Unity.
  • Добавлен вызов метода показа отчета в методе делегата unityAdsShowStart .
  • Проверенная совместимость с Unity Ads SDK 4.9.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 10.12.0.
  • Unity Ads SDK версии 4.9.0.

Версия 4.8.0.0

  • Добавлена ​​поддержка событий показа для баннерной рекламы.
  • Проверенная совместимость с Unity Ads SDK 4.8.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 10.7.0.
  • Unity Ads SDK версии 4.8.0.

Версия 4.7.1.0

  • Проверенная совместимость с Unity Ads SDK 4.7.1.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 10.5.0.
  • Unity Ads SDK версии 4.7.1.

Версия 4.7.0.0

  • Проверенная совместимость с Unity Ads SDK 4.7.0.
  • Теперь требуется минимальная версия iOS 11.0.
  • Теперь требуется Google Mobile Ads SDK версии 10.4.0 или выше.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 10.4.0.
  • Unity Ads SDK версии 4.7.0.

Версия 4.6.1.0

  • Проверенная совместимость с Unity Ads SDK 4.6.1.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 10.2.0.
  • Unity Ads SDK версии 4.6.1.

Версия 4.6.0.0

  • Проверенная совместимость с Unity Ads SDK 4.6.0.
  • Добавлена ​​поддержка пересылки информации COPPA в Unity Ads SDK.
  • Удалена поддержка архитектуры armv7 .
  • Теперь требуется Google Mobile Ads SDK версии 10.0.0 или выше.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 10.2.0.
  • Unity Ads SDK версии 4.6.0.

Версия 4.5.0.0

  • Проверенная совместимость с Unity Ads SDK 4.5.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 9.14.0.
  • Unity Ads SDK версии 4.5.0.

Версия 4.4.1.0

  • Проверенная совместимость с Unity Ads SDK 4.4.1.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 9.11.0.
  • Unity Ads SDK версии 4.4.1.

Версия 4.4.0.0

  • Обновлен адаптер для использования API didRewardUser .
  • Теперь требуется Google Mobile Ads SDK версии 9.8.0 или выше.
  • Проверенная совместимость с Unity Ads SDK 4.4.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 9.10.0.
  • Unity Ads SDK версии 4.4.0.

Версия 4.3.0.0

  • Проверенная совместимость с Unity Ads SDK 4.3.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 9.8.0.
  • Unity Ads SDK версии 4.3.0.

Версия 4.2.1.0

  • Проверенная совместимость с Unity Ads SDK 4.2.1.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 9.4.0.
  • Unity Ads SDK версии 4.2.1.

Версия 4.1.0.0

  • Проверенная совместимость с Unity Ads SDK 4.1.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 9.2.0.
  • Unity Ads SDK версии 4.1.0.

Версия 4.0.1.0

  • Проверенная совместимость с Unity Ads SDK 4.0.1.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 9.0.0.
  • Unity Ads SDK версии 4.0.1.

Версия 4.0.0.2

  • Добавлена ​​поддержка архитектуры симулятора arm64.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 9.0.0.
  • Unity Ads SDK версии 4.0.0.

Версия 4.0.0.1

  • Проверенная совместимость с Google Mobile Ads SDK версии 9.0.0.
  • Теперь требуется Google Mobile Ads SDK версии 9.0.0 или выше.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 9.0.0.
  • Unity Ads SDK версии 4.0.0.

Версия 4.0.0.0

  • Проверенная совместимость с Unity Ads SDK 4.0.0.
  • Теперь требуется минимальная версия iOS 10.0.

Создано и протестировано с

  • Google Mobile Ads SDK версии 8.13.0.
  • Unity Ads SDK версии 4.0.0.

Версия 3.7.5.0

  • Проверенная совместимость с Unity Ads SDK 3.7.5.

Создано и протестировано с

  • Google Mobile Ads SDK версии 8.8.0.
  • Unity Ads SDK версии 3.7.5.

Версия 3.7.4.0

  • Проверенная совместимость с Unity Ads SDK 3.7.4.

Создано и протестировано с

  • Google Mobile Ads SDK версии 8.7.0.
  • Unity Ads SDK версии 3.7.4.

Версия 3.7.2.0

  • Проверенная совместимость с Unity Ads SDK 3.7.2.
  • Снижена зависимость от Google Mobile Ads SDK версии 8.0.0 или выше.

Создано и протестировано с

  • Google Mobile Ads SDK версии 8.5.0.
  • Unity Ads SDK версии 3.7.2.

Версия 3.7.1.0

  • Проверенная совместимость с Unity Ads SDK 3.7.1.
  • Теперь требуется Google Mobile Ads SDK версии 8.4.0 или выше.

Создано и протестировано с

  • Google Mobile Ads SDK версии 8.4.0.
  • Unity Ads SDK версии 3.7.1.

Версия 3.6.2.0

  • Обновлен адаптер для использования формата .xcframework .
  • Проверенная совместимость с Unity Ads SDK 3.6.2.
  • Теперь требуется Google Mobile Ads SDK версии 8.2.0 или выше.

Создано и протестировано с

  • Google Mobile Ads SDK версии 8.2.0.
  • Unity Ads SDK версии 3.6.2.

Версия 3.6.0.0

  • Проверенная совместимость с Unity Ads SDK 3.6.0.
  • Теперь требуется Google Mobile Ads SDK версии 7.69.0 или выше.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.69.0.
  • Unity Ads SDK версии 3.6.0.

Версия 3.5.1.1

  • Исправлен сбой, который иногда возникал после завершения инициализации Unity Ads SDK.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.68.0.
  • Unity Ads SDK версии 3.5.1.

Версия 3.5.1.0

  • Проверенная совместимость с Unity Ads SDK 3.5.1.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.68.0.
  • Unity Ads SDK версии 3.5.1.

Версия 3.5.0.0

  • Проверенная совместимость с Unity Ads SDK 3.5.0.
  • Добавлена ​​поддержка адаптивной баннерной рекламы.
  • Теперь требуется Google Mobile Ads SDK версии 7.68.0 или выше.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.68.0.
  • Unity Ads SDK версии 3.5.0.

Версия 3.4.8.0

  • Проверенная совместимость с Unity Ads SDK 3.4.8.
  • Теперь требуется Google Mobile Ads SDK версии 7.63.0 или выше.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.63.0.
  • Unity Ads SDK версии 3.4.8.

Версия 3.4.6.0

  • Проверенная совместимость с Unity Ads SDK 3.4.6.
  • Теперь требуется Google Mobile Ads SDK версии 7.60.0 или выше.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.60.0.
  • Unity Ads SDK версии 3.4.6.

Версия 3.4.2.2

  • Добавлены стандартизированные коды ошибок адаптера и сообщения.
  • Обновлена ​​минимально требуемая версия Google Mobile Ads SDK до 7.59.0.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.59.0.
  • Unity Ads SDK версии 3.4.2.

Версия 3.4.2.1

  • Улучшена пересылка ошибок Unity для более раннего распознавания сбоев инициализации и загрузки рекламы, а также сокращения времени ожидания.
  • Удалена поддержка архитектуры i386.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.57.0.
  • Unity Ads SDK версии 3.4.2.

Версия 3.4.2.0

  • Проверенная совместимость с Unity Ads SDK 3.4.2.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.55.1.
  • Unity Ads SDK версии 3.4.2.

Версия 3.4.0.0

  • Проверенная совместимость с Unity Ads SDK 3.4.0.
  • Теперь поддерживается загрузка нескольких баннерных объявлений одновременно.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.53.0.
  • Unity Ads SDK версии 3.4.0.

Версия 3.3.0.0

  • Проверенная совместимость с Unity Ads SDK 3.3.0.
  • Теперь поддерживается загрузка нескольких баннерных объявлений одновременно.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.51.0.
  • Unity Ads SDK версии 3.3.0.

Версия 3.2.0.1

  • Проверенная совместимость с Unity Ads SDK 3.2.0.
  • Теперь требуется Google Mobile Ads SDK версии 7.46.0 или выше.
  • Исправлена ​​ошибка, из-за которой рекламные баннеры Unity не отображались при загрузке.
  • Исправлена ​​ошибка, из-за которой адаптер неправильно перенаправлял обратный вызов unityAdsReady .

Версия 3.2.0.0

  • Релиз был удален из-за регрессии в отношении незаполненных отчетов.

Версия 3.1.0.0

  • Проверенная совместимость с Unity Ads SDK 3.1.0.

Версия 3.0.3.0

  • Проверенная совместимость с Unity Ads SDK 3.0.3.
  • Теперь требуется Google Mobile Ads SDK версии 7.42.2 или выше.
  • Добавлена ​​поддержка гибких размеров баннерной рекламы.
  • Исправлена ​​ошибка, из-за которой рекламные баннеры Unity успешно загружались только один раз за сеанс.

Версия 3.0.1.0

  • Проверенная совместимость с Unity Ads SDK 3.0.1.
  • Исправлен сбой, возникавший при отмене вознаграждения за рекламу.

Версия 3.0.0.3

  • Обновление адаптера для использования нового API с вознаграждением.
  • Теперь требуется Google Mobile Ads SDK версии 7.41.0 или выше.

Версия 3.0.0.2

  • Добавлена ​​поддержка баннерной рекламы.

Версия 3.0.0.1

  • Исправлена ​​ошибка, из-за которой адаптер сохранял «placementId» предыдущего запроса.

Версия 3.0.0.0

  • Проверенная совместимость с Unity Ads SDK 3.0.0.

Версия 2.3.0.0

  • Verified compatibility with Unity Ads SDK 2.3.0.

Версия 2.2.1.1

  • Added adapterDidCompletePlayingRewardBasedVideoAd: callback to the adapter.

Версия 2.2.1.0

  • Verified compatibility with Unity Ads SDK 2.2.1.

Версия 2.2.0.0

  • Verified compatibility with Unity Ads SDK 2.2.0.

Версия 2.1.2.0

  • Verified compatibility with Unity Ads SDK 2.1.2.
  • Removed the support for 'armv7s' architecture.

Версия 2.1.1.0

  • Verified compatibility with Unity Ads SDK 2.1.1.

Версия 2.1.0.0

  • Updated the adapter to make it compatible with Unity Ads SDK 2.1.0.

Version 2.0.8.0

  • Verified compatibility with Unity Ads SDK 2.0.8.

Версия 2.0.7.0

  • Adapter now tracks Unity Ads clicks so the AdMob and the Unity Ads click statistics can match up.
  • Apps now get interstitialWillLeaveApplication: and rewardBasedVideoAdWillLeaveApplication: callbacks.

Версия 2.0.6.0

  • Verified compatibility with Unity Ads SDK 2.0.6.

Версия 2.0.5.0

  • Verified compatibility with Unity Ads SDK 2.0.5.

Версия 2.0.4.0

  • Changed the version naming system to [Unity Ads SDK version].[adapter patch version].
  • Updated the minimum required Unity Ads SDK to v2.0.4.
  • Updated the minimum required Google Mobile Ads SDK to v7.10.1.

Версия 1.0.2

  • Made the user reward item's key non nil. The reward key will always be an empty or a valid string.

Версия 1.0.1

  • Fixed bug where the rewardBasedVideoAdDidOpen: callback wasn't getting called.

Версия 1.0.0

  • Supports interstitial and reward-based video ads.
,

This guide shows you how to use Google Mobile Ads SDK to load and display ads from Unity Ads using mediation , covering waterfall integrations. It covers how to add Unity Ads to an ad unit's mediation configuration, and how to integrate the Unity Ads SDK and adapter into an iOS app.

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

The mediation adapter for Unity Ads has the following capabilities:

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

Требования

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

  • [For bidding]: To integrate all supported ad formats in bidding, use Unity adapter 4.14.1.1 or higher ( latest version recommended )

Step 1: Set up configurations in Unity Ads UI

Sign up or log in to Unity Ads.

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

On the Unity Ads dashboard , navigate to Projects and click New .

Fill out the form and click Create to add your project.

Navigate to Unity Ads Monetization , then click Get started .

In the New Project modal, select I will use Mediation and Google Admob for Mediation Partner , then click Next .

Select the option for ad settings, then click Next .

Select your placement setup, then click Next .

Торги

Водопад

Fill out the form, then click Add project .

Take note of the Game ID .

Create ad units and placements

Navigate to Unity Ads Monetization > Placements , then select your project and click Add ad unit .

Enter an Ad unit name , then select your Platform and Ad format .

Navigate to Monetization > Placements , then click Add Ad Unit .

Enter an Ad Unit Name , then select your Platform and Ad Format .

Select Waterfall for the Setup . Under Placement , enter the Placement name , GEO Tagging and Target .

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

Finally, click Add ad unit to save your ad unit and placement.

Locate Unity Ads Reporting API key

Торги

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

Водопад

Navigate to the Unity Ads Monetization > API management and take note of the API Key in Monetization Stats API Access .

Then, navigate to the Unity Ads Monetization > Organization Settings and take note of the Organization core ID .

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

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

To implement app-ads.txt for Unity Ads, see setting up app-ads.txt for the first time .

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

Test mode can be enabled from the Unity Ads dashboard . Navigate to Unity Ads Monetization > Testing .

You can force test mode for your app by clicking the edit button beside Apple App Store , enabling Override client test mode and selecting Force test mode ON (ie use test ads) for all devices .

Alternatively, you can enable test mode for specific devices by clicking Add Test Device .

Enter your test device details, then click Save .

Step 2: Set up Unity Ads demand in Ad Manager UI

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

Add Unity Ads in Companies

Торги

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

Водопад

Перейдите в раздел «Администрирование» > «Компании» , затем нажмите кнопку «Новая компания» на вкладке «Все компании» . Выберите «Рекламная сеть» .

Select Unity Ads as the Ad network , enter a unique Name and enable Mediation . Turn on Automatic data collection , and enter the API Key and Organization core ID obtained in the previous section.

Имя пользователя и пароль вводить не нужно. Нажмите «Сохранить» по завершении.

Включить безопасный обмен сигналами

Торги

Перейдите в раздел «Администрирование» > «Глобальные настройки» . Перейдите на вкладку «Настройки аккаунта Ad Exchange» , проверьте и включите опцию «Безопасный обмен сигналами» . Нажмите «Сохранить» .

Водопад

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

Поделиться защищенным сигналом в запросах ставок

Торги

Navigate to Inventory > Secure Signals . Under Secure signals , search for Unity Ads and toggle on Enable app integration .

Нажмите «Сохранить» .

Водопад

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

Разрешить безопасный обмен сигналами для SDK Bidding

Торги

Перейдите в раздел «Доставка» > «Настройки канала спроса» . На вкладке «Настройки по умолчанию» включите опцию «Разрешить безопасный обмен сигналами для торгов SDK» .

Нажмите «Сохранить» .

Водопад

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

Configure Unity Ads bidding

Торги

Перейдите в раздел Доставка > Участники торгов и нажмите Перейти к торгам SDK .

Нажмите кнопку «Новый участник торгов» .

Select Unity Ads as the bidder.

Нажмите «Продолжить» , чтобы включить функцию ставок SDK для этого участника торгов.

Нажмите Готово .

Водопад

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

Настроить сопоставление рекламных блоков

Торги

Перейдите в раздел Доставка > Участники торгов и нажмите Перейти к торгам SDK .

Select the company for Unity Ads.

Перейдите на вкладку Сопоставление рекламного блока и нажмите Новое сопоставление рекламного блока .

Choose Specific ad unit . Select an ad unit and format, Mobile app as the Inventory type , and your Mobile application . Then, enter Game ID and Placement ID obtained in the previous section. Finally, click Save .

Водопад

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

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

Select the company you created for Unity Ads in the previous section. Choose Mobile SDK mediation as the Integration type , iOS as the Platform , and Active as the Status .

Enter the Game ID and Placement ID obtained in the previous section, and the Default CPM value. Click Save .

Примечание: Автоматическому сбору данных требуется несколько дней, прежде чем он сможет точно рассчитать значение динамической цены за тысячу показов (CPM) для сети медиации. После того, как значение eCPM будет рассчитано, оно автоматически обновляется от вашего имени.

Add Unity Ads to GDPR and US state regulations ad partners list

Follow the steps in European regulations settings and US state regulations settings to add Unity Ads to the European and US state regulations ad partners list in the Ad Manager UI.

Step 3: Import the Unity Ads SDK and adapter

  • Добавьте следующую строку в Podfile вашего проекта:

    pod 'GoogleMobileAdsMediationUnity'
    
  • В командной строке выполните:

    pod install --repo-update

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

  • Download the latest version of the Unity Ads SDK , and link UnityAds.framework in your project.

  • Download the latest version of the Unity Ads adapter from the download link in the Changelog and link UnityAdapter.framework in your project.

Step 4: Implement privacy settings on Unity Ads SDK

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

In SDK version 2.0.0, Unity Ads added an API to support privacy settings. The following sample code shows how to pass this consent information to the Unity Ads SDK. Should you choose to pass consent information to the Unity Ads SDK manually, it is recommended that this code is called prior to requesting ads through the Google Mobile Ads SDK.

Быстрый

import UnityAds
// ...

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

Objective-C

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

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

See Unity Ads' GDPR Compliance for more details and the values that can be provided in each method.

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

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

In SDK version 2.0.0, Unity Ads added an API to support privacy settings. The following sample code shows how to pass this consent information to the Unity Ads SDK. Should you choose to pass consent information to the Unity Ads SDK manually, it is recommended that this code is called prior to requesting ads through Google Mobile Ads SDK.

Быстрый

import UnityAds
// ...

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

Objective-C

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

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

See Unity Ads' Consumer privacy act compliance for more details and the values that can be provided in each method.

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

Интеграция SKAdNetwork

Follow Unity Ads' documentation to add the SKAdNetwork identifiers to your project's Info.plist file.

Compile errors

Быстрый

No additional code is required for Swift integrations.

Objective-C

For Unity Ads adapter 4.4.0.0 or higher, you must follow the integration steps in the Unity documentation .

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

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

Make sure you register your test device for Ad Manager and enable test mode in Unity Ads UI.

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

To verify that you are receiving test ads from Unity Ads, enable single ad source testing in ad inspector using the Unity Ads (Bidding) and Unity Ads (Waterfall) ad source(s).

Коды ошибок

If the adapter fails to receive an ad from Unity Ads, publishers can check the underlying error from the ad response using GADResponseInfo.adNetworkInfoArray under the following classes:

GADMAdapterUnity
GADMediationAdapterUnity

Here are the codes and accompanying messages thrown by the UnityAds adapter when an ad fails to load:

Код ошибки Причина
0-9 UnityAds SDK returned an error. See Unity's documentation for more details.
101 UnityAds server parameters configured in the Ad Manager UI are missing/invalid.
102 Device not supported by UnityAds.
103 UnityAds finished presenting with error state kUnityAdsFinishStateError .
104 The Unity ad object is nil after calling its initializer.
105 Failed to show Unity Ads due to ad not ready.
107 UnityAds called a placement changed callback with placement state kUnityAdsPlacementStateDisabled .
108 An ad was already loaded for this placement. UnityAds SDK does not support loading multiple ads for the same placement.
109 The banner ad returned by UnityAds does not match with the requested size.
110 UnityAds returned an initialization error.
111 Unsupported ad format.

Unity Ads iOS Mediation Adapter Changelog

Version 4.16.2.0

  • Updated ad loading methods to wait for the Unity Ads SDK to be fully initialized before attempting to load an ad.
  • Resolved a race condition where completion callbacks could potentially be dropped if multiple initializations are in progress.
  • Verified compatibility with Unity Ads SDK 4.16.2.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK version 12.12.0.
  • Unity Ads SDK version 4.16.2.

Version 4.16.1.0

  • Verified compatibility with Unity Ads SDK 4.16.1.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 12.9.0.
  • Unity Ads SDK version 4.16.1.

Version 4.16.0.0

  • Now requires minimum iOS version 13.0 .
  • Verified compatibility with Unity Ads SDK 4.16.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 12.8.0.
  • Unity Ads SDK version 4.16.0.

Version 4.15.1.0

  • Verified compatibility with Unity Ads SDK 4.15.1.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 12.6.0.
  • Unity Ads SDK version 4.15.1.

Версия 4.15.0.0

  • Added error code 111: Unsupported ad format .
  • Verified compatibility with Unity Ads SDK 4.15.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 12.5.0.
  • Unity Ads SDK version 4.15.0.

Version 4.14.2.0

  • Verified compatibility with Unity Ads SDK 4.14.2.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 12.3.0.
  • Unity Ads SDK version 4.14.2.

Version 4.14.1.1

  • For bidding, the adapter no longer checks the banner ad size.
  • For waterfall, the adapter now checks whether the loaded Unity Ads banner ad aspect ratio matches with the requested banner ad size.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 12.2.0.
  • Unity Ads SDK version 4.14.1.

Version 4.14.1.0

  • Verified compatibility with Unity Ads SDK 4.14.1.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 12.2.0.
  • Unity Ads SDK version 4.14.1.

Version 4.14.0.0

  • Включены флаги -fobjc-arc и -fstack-protector-all .
  • Verified compatibility with Unity Ads SDK 4.14.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 12.2.0.
  • Unity Ads SDK version 4.14.0.

Version 4.13.2.0

  • Verified compatibility with Unity Ads SDK 4.13.2.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK version 12.1.0.
  • Unity Ads SDK version 4.13.2.

Version 4.13.1.1

  • Теперь требуется Google Mobile Ads SDK версии 12.0.0 или выше.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 12.0.0.
  • Unity Ads SDK version 4.13.1.

Version 4.13.1.0

  • Added the GADMediationAdapterUnity.testMode property to indicate whether the Unity Ads SDK should be initialized in test mode. This flag must be set before initializing the Google Mobile Ads SDK.
  • Updated to report the Unity Ads SDK's error code when an ad fails to load.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.13.0.
  • Unity Ads SDK version 4.13.1.

Version 4.13.0.0

  • Verified compatibility with Unity Ads SDK 4.13.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.13.0.
  • Unity Ads SDK version 4.13.0.

Version 4.12.5.0

  • Verified compatibility with Unity Ads SDK 4.12.5.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK version 11.12.0.
  • Unity Ads SDK version 4.12.5.

Version 4.12.4.0

  • Verified compatibility with Unity Ads SDK 4.12.4.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK version 11.12.0.
  • Unity Ads SDK version 4.12.4.

Version 4.12.3.1

  • Обновлен CFBundleShortVersionString теперь имеет три компонента вместо четырех.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.10.0.
  • Unity Ads SDK version 4.12.3.

Version 4.12.3.0

  • Verified compatibility with Unity Ads SDK 4.12.3.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.10.0.
  • Unity Ads SDK version 4.12.3.

Version 4.12.2.0

  • Verified compatibility with Unity Ads SDK 4.12.2.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.7.0.
  • Unity Ads SDK version 4.12.2.

Version 4.12.1.0

  • Verified compatibility with Unity Ads SDK 4.12.1.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK version 11.6.0.
  • Unity Ads SDK version 4.12.1.

Версия 4.12.0.0

  • Verified compatibility with Unity Ads SDK 4.12.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.5.0.
  • Unity Ads SDK version 4.12.0.

Version 4.11.3.1

  • Добавлена ​​поддержка ставок для форматов баннерной, полноэкранной и вознагражденной рекламы.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.5.0.
  • Unity Ads SDK version 4.11.3.

Version 4.11.3.0

  • Verified compatibility with Unity Ads SDK 4.11.3.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.4.0.
  • Unity Ads SDK version 4.11.3.

Version 4.11.2.0

  • Verified compatibility with Unity Ads SDK 4.11.2.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.4.0.
  • Unity Ads SDK version 4.11.2.

Version 4.10.0.0

  • Verified compatibility with Unity Ads SDK 4.10.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.2.0.
  • Unity Ads SDK version 4.10.0.

Version 4.9.3.0

  • Verified compatibility with Unity Ads SDK 4.9.3.
  • Теперь требуется минимальная версия iOS 12.0.
  • Теперь требуется Google Mobile Ads SDK версии 11.0 или выше.
  • Included Info.plist in the frameworks within UnityAdapter.xcframework .

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.0.1.
  • Unity Ads SDK version 4.9.3.

Version 4.9.2.0

  • Verified compatibility with Unity Ads SDK 4.9.2.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK version 10.13.0.
  • Unity Ads SDK version 4.9.2.

Version 4.9.1.0

  • Verified compatibility with Unity Ads SDK 4.9.1.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 10.12.0.
  • Unity Ads SDK version 4.9.1.

Version 4.9.0.0

  • Removed GADMAdNetworkAdapter conformance and dependency from the Unity adapter.
  • Added report impression method invocation in unityAdsShowStart delegate method.
  • Verified compatibility with Unity Ads SDK 4.9.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 10.12.0.
  • Unity Ads SDK version 4.9.0.

Version 4.8.0.0

  • Added support for impression events for banner ads.
  • Verified compatibility with Unity Ads SDK 4.8.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK version 10.7.0.
  • Unity Ads SDK version 4.8.0.

Версия 4.7.1.0

  • Verified compatibility with Unity Ads SDK 4.7.1.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 10.5.0.
  • Unity Ads SDK version 4.7.1.

Версия 4.7.0.0

  • Verified compatibility with Unity Ads SDK 4.7.0.
  • Теперь требуется минимальная версия iOS 11.0.
  • Теперь требуется Google Mobile Ads SDK версии 10.4.0 или выше.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK version 10.4.0.
  • Unity Ads SDK version 4.7.0.

Версия 4.6.1.0

  • Verified compatibility with Unity Ads SDK 4.6.1.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 10.2.0.
  • Unity Ads SDK version 4.6.1.

Version 4.6.0.0

  • Verified compatibility with Unity Ads SDK 4.6.0.
  • Added support for forwarding COPPA information to the Unity Ads SDK.
  • Removed support for the armv7 architecture.
  • Теперь требуется Google Mobile Ads SDK версии 10.0.0 или выше.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 10.2.0.
  • Unity Ads SDK version 4.6.0.

Version 4.5.0.0

  • Verified compatibility with Unity Ads SDK 4.5.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 9.14.0.
  • Unity Ads SDK version 4.5.0.

Версия 4.4.1.0

  • Verified compatibility with Unity Ads SDK 4.4.1.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 9.11.0.
  • Unity Ads SDK version 4.4.1.

Версия 4.4.0.0

  • Обновлен адаптер для использования API didRewardUser .
  • Теперь требуется Google Mobile Ads SDK версии 9.8.0 или выше.
  • Verified compatibility with Unity Ads SDK 4.4.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK version 9.10.0.
  • Unity Ads SDK version 4.4.0.

Version 4.3.0.0

  • Verified compatibility with Unity Ads SDK 4.3.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK version 9.8.0.
  • Unity Ads SDK version 4.3.0.

Version 4.2.1.0

  • Verified compatibility with Unity Ads SDK 4.2.1.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK version 9.4.0.
  • Unity Ads SDK version 4.2.1.

Версия 4.1.0.0

  • Verified compatibility with Unity Ads SDK 4.1.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 9.2.0.
  • Unity Ads SDK version 4.1.0.

Version 4.0.1.0

  • Verified compatibility with Unity Ads SDK 4.0.1.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 9.0.0.
  • Unity Ads SDK version 4.0.1.

Version 4.0.0.2

  • Added support for the arm64 simulator architecture.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 9.0.0.
  • Unity Ads SDK version 4.0.0.

Version 4.0.0.1

  • Проверенная совместимость с Google Mobile Ads SDK версии 9.0.0.
  • Теперь требуется Google Mobile Ads SDK версии 9.0.0 или выше.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 9.0.0.
  • Unity Ads SDK version 4.0.0.

Version 4.0.0.0

  • Verified compatibility with Unity Ads SDK 4.0.0.
  • Теперь требуется минимальная версия iOS 10.0.

Создано и протестировано с

  • Google Mobile Ads SDK версии 8.13.0.
  • Unity Ads SDK version 4.0.0.

Version 3.7.5.0

  • Verified compatibility with Unity Ads SDK 3.7.5.

Создано и протестировано с

  • Google Mobile Ads SDK версии 8.8.0.
  • Unity Ads SDK version 3.7.5.

Version 3.7.4.0

  • Verified compatibility with Unity Ads SDK 3.7.4.

Создано и протестировано с

  • Google Mobile Ads SDK версии 8.7.0.
  • Unity Ads SDK version 3.7.4.

Версия 3.7.2.0

  • Verified compatibility with Unity Ads SDK 3.7.2.
  • Снижена зависимость от Google Mobile Ads SDK версии 8.0.0 или выше.

Создано и протестировано с

  • Google Mobile Ads SDK версии 8.5.0.
  • Unity Ads SDK version 3.7.2.

Версия 3.7.1.0

  • Verified compatibility with Unity Ads SDK 3.7.1.
  • Теперь требуется Google Mobile Ads SDK версии 8.4.0 или выше.

Создано и протестировано с

  • Google Mobile Ads SDK версии 8.4.0.
  • Unity Ads SDK version 3.7.1.

Version 3.6.2.0

  • Обновлен адаптер для использования формата .xcframework .
  • Verified compatibility with Unity Ads SDK 3.6.2.
  • Теперь требуется Google Mobile Ads SDK версии 8.2.0 или выше.

Создано и протестировано с

  • Google Mobile Ads SDK версии 8.2.0.
  • Unity Ads SDK version 3.6.2.

Версия 3.6.0.0

  • Verified compatibility with Unity Ads SDK 3.6.0.
  • Теперь требуется Google Mobile Ads SDK версии 7.69.0 или выше.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.69.0.
  • Unity Ads SDK version 3.6.0.

Version 3.5.1.1

  • Fixed a crash that sometimes occurred when the Unity Ads SDK finished initializing.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.68.0.
  • Unity Ads SDK version 3.5.1.

Version 3.5.1.0

  • Verified compatibility with Unity Ads SDK 3.5.1.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.68.0.
  • Unity Ads SDK version 3.5.1.

Версия 3.5.0.0

  • Verified compatibility with Unity Ads SDK 3.5.0.
  • Added support for Adaptive Banner ads.
  • Теперь требуется Google Mobile Ads SDK версии 7.68.0 или выше.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.68.0.
  • Unity Ads SDK version 3.5.0.

Version 3.4.8.0

  • Verified compatibility with Unity Ads SDK 3.4.8.
  • Now requires Google Mobile Ads SDK version 7.63.0 or higher.

Создано и протестировано с

  • Google Mobile Ads SDK version 7.63.0.
  • Unity Ads SDK version 3.4.8.

Версия 3.4.6.0

  • Verified compatibility with Unity Ads SDK 3.4.6.
  • Теперь требуется Google Mobile Ads SDK версии 7.60.0 или выше.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.60.0.
  • Unity Ads SDK version 3.4.6.

Version 3.4.2.2

  • Добавлены стандартизированные коды ошибок адаптера и сообщения.
  • Обновлена ​​минимально требуемая версия Google Mobile Ads SDK до 7.59.0.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.59.0.
  • Unity Ads SDK version 3.4.2.

Version 3.4.2.1

  • Improved forwarding of Unity's errors to recognize initialization and ad load failures earlier and reduce timeouts.
  • Удалена поддержка архитектуры i386.

Создано и протестировано с

  • Google Mobile Ads SDK version 7.57.0.
  • Unity Ads SDK version 3.4.2.

Версия 3.4.2.0

  • Verified compatibility with Unity Ads SDK 3.4.2.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.55.1.
  • Unity Ads SDK version 3.4.2.

Версия 3.4.0.0

  • Verified compatibility with Unity Ads SDK 3.4.0.
  • Now supports loading multiple banner ads at once.

Создано и протестировано с

  • Google Mobile Ads SDK version 7.53.0.
  • Unity Ads SDK version 3.4.0.

Версия 3.3.0.0

  • Verified compatibility with Unity Ads SDK 3.3.0.
  • Now supports loading multiple banner ads at once.

Создано и протестировано с

  • Google Mobile Ads SDK version 7.51.0.
  • Unity Ads SDK version 3.3.0.

Version 3.2.0.1

  • Verified compatibility with Unity Ads SDK 3.2.0.
  • Теперь требуется Google Mobile Ads SDK версии 7.46.0 или выше.
  • Fixed an issue where Unity Banner ads would fail to show when loaded.
  • Fixed an issue where the adapter was not properly forwarding the unityAdsReady callback.

Version 3.2.0.0

  • Release was removed due to a regression on no-fill reporting.

Версия 3.1.0.0

  • Verified compatibility with Unity Ads SDK 3.1.0.

Version 3.0.3.0

  • Verified compatibility with Unity Ads SDK 3.0.3.
  • Now requires Google Mobile Ads SDK version 7.42.2 or higher.
  • Добавлена ​​поддержка гибких размеров баннерной рекламы.
  • Fixed an issue where Unity Banner ads would only successfully load once per session.

Version 3.0.1.0

  • Verified compatibility with Unity Ads SDK 3.0.1.
  • Fixed a crash that occurred when deallocating rewarded ads.

Версия 3.0.0.3

  • Updating adapter to use new rewarded API.
  • Теперь требуется Google Mobile Ads SDK версии 7.41.0 или выше.

Version 3.0.0.2

  • Добавлена ​​поддержка баннерной рекламы.

Version 3.0.0.1

  • Fixed an issue where the adapter stores the 'placementId' of previous request.

Version 3.0.0.0

  • Verified compatibility with Unity Ads SDK 3.0.0.

Версия 2.3.0.0

  • Verified compatibility with Unity Ads SDK 2.3.0.

Версия 2.2.1.1

  • Added adapterDidCompletePlayingRewardBasedVideoAd: callback to the adapter.

Версия 2.2.1.0

  • Verified compatibility with Unity Ads SDK 2.2.1.

Версия 2.2.0.0

  • Verified compatibility with Unity Ads SDK 2.2.0.

Версия 2.1.2.0

  • Verified compatibility with Unity Ads SDK 2.1.2.
  • Removed the support for 'armv7s' architecture.

Версия 2.1.1.0

  • Verified compatibility with Unity Ads SDK 2.1.1.

Версия 2.1.0.0

  • Updated the adapter to make it compatible with Unity Ads SDK 2.1.0.

Version 2.0.8.0

  • Verified compatibility with Unity Ads SDK 2.0.8.

Версия 2.0.7.0

  • Adapter now tracks Unity Ads clicks so the AdMob and the Unity Ads click statistics can match up.
  • Apps now get interstitialWillLeaveApplication: and rewardBasedVideoAdWillLeaveApplication: callbacks.

Версия 2.0.6.0

  • Verified compatibility with Unity Ads SDK 2.0.6.

Версия 2.0.5.0

  • Verified compatibility with Unity Ads SDK 2.0.5.

Версия 2.0.4.0

  • Changed the version naming system to [Unity Ads SDK version].[adapter patch version].
  • Updated the minimum required Unity Ads SDK to v2.0.4.
  • Updated the minimum required Google Mobile Ads SDK to v7.10.1.

Версия 1.0.2

  • Made the user reward item's key non nil. The reward key will always be an empty or a valid string.

Версия 1.0.1

  • Fixed bug where the rewardBasedVideoAdDidOpen: callback wasn't getting called.

Версия 1.0.0

  • Supports interstitial and reward-based video ads.
,

This guide shows you how to use Google Mobile Ads SDK to load and display ads from Unity Ads using mediation , covering waterfall integrations. It covers how to add Unity Ads to an ad unit's mediation configuration, and how to integrate the Unity Ads SDK and adapter into an iOS app.

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

The mediation adapter for Unity Ads has the following capabilities:

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

Требования

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

  • [For bidding]: To integrate all supported ad formats in bidding, use Unity adapter 4.14.1.1 or higher ( latest version recommended )

Step 1: Set up configurations in Unity Ads UI

Sign up or log in to Unity Ads.

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

On the Unity Ads dashboard , navigate to Projects and click New .

Fill out the form and click Create to add your project.

Navigate to Unity Ads Monetization , then click Get started .

In the New Project modal, select I will use Mediation and Google Admob for Mediation Partner , then click Next .

Select the option for ad settings, then click Next .

Select your placement setup, then click Next .

Торги

Водопад

Fill out the form, then click Add project .

Take note of the Game ID .

Create ad units and placements

Navigate to Unity Ads Monetization > Placements , then select your project and click Add ad unit .

Enter an Ad unit name , then select your Platform and Ad format .

Navigate to Monetization > Placements , then click Add Ad Unit .

Enter an Ad Unit Name , then select your Platform and Ad Format .

Select Waterfall for the Setup . Under Placement , enter the Placement name , GEO Tagging and Target .

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

Finally, click Add ad unit to save your ad unit and placement.

Locate Unity Ads Reporting API key

Торги

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

Водопад

Navigate to the Unity Ads Monetization > API management and take note of the API Key in Monetization Stats API Access .

Then, navigate to the Unity Ads Monetization > Organization Settings and take note of the Organization core ID .

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

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

To implement app-ads.txt for Unity Ads, see setting up app-ads.txt for the first time .

Turn on test mode

Test mode can be enabled from the Unity Ads dashboard . Navigate to Unity Ads Monetization > Testing .

You can force test mode for your app by clicking the edit button beside Apple App Store , enabling Override client test mode and selecting Force test mode ON (ie use test ads) for all devices .

Alternatively, you can enable test mode for specific devices by clicking Add Test Device .

Enter your test device details, then click Save .

Step 2: Set up Unity Ads demand in Ad Manager UI

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

Add Unity Ads in Companies

Торги

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

Водопад

Перейдите в раздел «Администрирование» > «Компании» , затем нажмите кнопку «Новая компания» на вкладке «Все компании» . Выберите «Рекламная сеть» .

Select Unity Ads as the Ad network , enter a unique Name and enable Mediation . Turn on Automatic data collection , and enter the API Key and Organization core ID obtained in the previous section.

Имя пользователя и пароль вводить не нужно. Нажмите «Сохранить» по завершении.

Включить безопасный обмен сигналами

Торги

Перейдите в раздел «Администрирование» > «Глобальные настройки» . Перейдите на вкладку «Настройки аккаунта Ad Exchange» , проверьте и включите опцию «Безопасный обмен сигналами» . Нажмите «Сохранить» .

Водопад

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

Поделиться защищенным сигналом в запросах ставок

Торги

Navigate to Inventory > Secure Signals . Under Secure signals , search for Unity Ads and toggle on Enable app integration .

Нажмите «Сохранить» .

Водопад

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

Разрешить безопасный обмен сигналами для SDK Bidding

Торги

Перейдите в раздел «Доставка» > «Настройки канала спроса» . На вкладке «Настройки по умолчанию» включите опцию «Разрешить безопасный обмен сигналами для торгов SDK» .

Нажмите «Сохранить» .

Водопад

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

Configure Unity Ads bidding

Торги

Перейдите в раздел Доставка > Участники торгов и нажмите Перейти к торгам SDK .

Нажмите кнопку «Новый участник торгов» .

Select Unity Ads as the bidder.

Нажмите «Продолжить» , чтобы включить функцию ставок SDK для этого участника торгов.

Нажмите Готово .

Водопад

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

Настроить сопоставление рекламных блоков

Торги

Перейдите в раздел Доставка > Участники торгов и нажмите Перейти к торгам SDK .

Select the company for Unity Ads.

Перейдите на вкладку Сопоставление рекламного блока и нажмите Новое сопоставление рекламного блока .

Choose Specific ad unit . Select an ad unit and format, Mobile app as the Inventory type , and your Mobile application . Then, enter Game ID and Placement ID obtained in the previous section. Finally, click Save .

Водопад

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

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

Select the company you created for Unity Ads in the previous section. Choose Mobile SDK mediation as the Integration type , iOS as the Platform , and Active as the Status .

Enter the Game ID and Placement ID obtained in the previous section, and the Default CPM value. Click Save .

Примечание: Автоматическому сбору данных требуется несколько дней, прежде чем он сможет точно рассчитать значение динамической цены за тысячу показов (CPM) для сети медиации. После того, как значение eCPM будет рассчитано, оно автоматически обновляется от вашего имени.

Add Unity Ads to GDPR and US state regulations ad partners list

Follow the steps in European regulations settings and US state regulations settings to add Unity Ads to the European and US state regulations ad partners list in the Ad Manager UI.

Step 3: Import the Unity Ads SDK and adapter

  • Добавьте следующую строку в Podfile вашего проекта:

    pod 'GoogleMobileAdsMediationUnity'
    
  • В командной строке выполните:

    pod install --repo-update

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

  • Download the latest version of the Unity Ads SDK , and link UnityAds.framework in your project.

  • Download the latest version of the Unity Ads adapter from the download link in the Changelog and link UnityAdapter.framework in your project.

Step 4: Implement privacy settings on Unity Ads SDK

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

In SDK version 2.0.0, Unity Ads added an API to support privacy settings. The following sample code shows how to pass this consent information to the Unity Ads SDK. Should you choose to pass consent information to the Unity Ads SDK manually, it is recommended that this code is called prior to requesting ads through the Google Mobile Ads SDK.

Быстрый

import UnityAds
// ...

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

Objective-C

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

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

See Unity Ads' GDPR Compliance for more details and the values that can be provided in each method.

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

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

In SDK version 2.0.0, Unity Ads added an API to support privacy settings. The following sample code shows how to pass this consent information to the Unity Ads SDK. Should you choose to pass consent information to the Unity Ads SDK manually, it is recommended that this code is called prior to requesting ads through Google Mobile Ads SDK.

Быстрый

import UnityAds
// ...

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

Objective-C

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

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

See Unity Ads' Consumer privacy act compliance for more details and the values that can be provided in each method.

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

Интеграция SKAdNetwork

Follow Unity Ads' documentation to add the SKAdNetwork identifiers to your project's Info.plist file.

Compile errors

Быстрый

No additional code is required for Swift integrations.

Objective-C

For Unity Ads adapter 4.4.0.0 or higher, you must follow the integration steps in the Unity documentation .

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

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

Make sure you register your test device for Ad Manager and enable test mode in Unity Ads UI.

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

To verify that you are receiving test ads from Unity Ads, enable single ad source testing in ad inspector using the Unity Ads (Bidding) and Unity Ads (Waterfall) ad source(s).

Коды ошибок

If the adapter fails to receive an ad from Unity Ads, publishers can check the underlying error from the ad response using GADResponseInfo.adNetworkInfoArray under the following classes:

GADMAdapterUnity
GADMediationAdapterUnity

Here are the codes and accompanying messages thrown by the UnityAds adapter when an ad fails to load:

Код ошибки Причина
0-9 UnityAds SDK returned an error. See Unity's documentation for more details.
101 UnityAds server parameters configured in the Ad Manager UI are missing/invalid.
102 Device not supported by UnityAds.
103 UnityAds finished presenting with error state kUnityAdsFinishStateError .
104 The Unity ad object is nil after calling its initializer.
105 Failed to show Unity Ads due to ad not ready.
107 UnityAds called a placement changed callback with placement state kUnityAdsPlacementStateDisabled .
108 An ad was already loaded for this placement. UnityAds SDK does not support loading multiple ads for the same placement.
109 The banner ad returned by UnityAds does not match with the requested size.
110 UnityAds returned an initialization error.
111 Unsupported ad format.

Unity Ads iOS Mediation Adapter Changelog

Version 4.16.2.0

  • Updated ad loading methods to wait for the Unity Ads SDK to be fully initialized before attempting to load an ad.
  • Resolved a race condition where completion callbacks could potentially be dropped if multiple initializations are in progress.
  • Verified compatibility with Unity Ads SDK 4.16.2.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK version 12.12.0.
  • Unity Ads SDK version 4.16.2.

Version 4.16.1.0

  • Verified compatibility with Unity Ads SDK 4.16.1.

Built and tested with:

  • Google Mobile Ads SDK версии 12.9.0.
  • Unity Ads SDK version 4.16.1.

Version 4.16.0.0

  • Now requires minimum iOS version 13.0 .
  • Verified compatibility with Unity Ads SDK 4.16.0.

Built and tested with:

  • Google Mobile Ads SDK версии 12.8.0.
  • Unity Ads SDK version 4.16.0.

Version 4.15.1.0

  • Verified compatibility with Unity Ads SDK 4.15.1.

Built and tested with:

  • Google Mobile Ads SDK версии 12.6.0.
  • Unity Ads SDK version 4.15.1.

Версия 4.15.0.0

  • Added error code 111: Unsupported ad format .
  • Verified compatibility with Unity Ads SDK 4.15.0.

Built and tested with:

  • Google Mobile Ads SDK версии 12.5.0.
  • Unity Ads SDK version 4.15.0.

Version 4.14.2.0

  • Verified compatibility with Unity Ads SDK 4.14.2.

Built and tested with:

  • Google Mobile Ads SDK версии 12.3.0.
  • Unity Ads SDK version 4.14.2.

Version 4.14.1.1

  • For bidding, the adapter no longer checks the banner ad size.
  • For waterfall, the adapter now checks whether the loaded Unity Ads banner ad aspect ratio matches with the requested banner ad size.

Built and tested with:

  • Google Mobile Ads SDK версии 12.2.0.
  • Unity Ads SDK version 4.14.1.

Version 4.14.1.0

  • Verified compatibility with Unity Ads SDK 4.14.1.

Built and tested with:

  • Google Mobile Ads SDK версии 12.2.0.
  • Unity Ads SDK version 4.14.1.

Version 4.14.0.0

  • Включены флаги -fobjc-arc и -fstack-protector-all .
  • Verified compatibility with Unity Ads SDK 4.14.0.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 12.2.0.
  • Unity Ads SDK version 4.14.0.

Version 4.13.2.0

  • Verified compatibility with Unity Ads SDK 4.13.2.

Built and tested with:

  • Google Mobile Ads SDK version 12.1.0.
  • Unity Ads SDK version 4.13.2.

Version 4.13.1.1

  • Теперь требуется Google Mobile Ads SDK версии 12.0.0 или выше.

Built and tested with:

  • Google Mobile Ads SDK версии 12.0.0.
  • Unity Ads SDK version 4.13.1.

Version 4.13.1.0

  • Added the GADMediationAdapterUnity.testMode property to indicate whether the Unity Ads SDK should be initialized in test mode. This flag must be set before initializing the Google Mobile Ads SDK.
  • Updated to report the Unity Ads SDK's error code when an ad fails to load.

Built and tested with:

  • Google Mobile Ads SDK версии 11.13.0.
  • Unity Ads SDK version 4.13.1.

Version 4.13.0.0

  • Verified compatibility with Unity Ads SDK 4.13.0.

Built and tested with:

  • Google Mobile Ads SDK версии 11.13.0.
  • Unity Ads SDK version 4.13.0.

Version 4.12.5.0

  • Verified compatibility with Unity Ads SDK 4.12.5.

Built and tested with:

  • Google Mobile Ads SDK version 11.12.0.
  • Unity Ads SDK version 4.12.5.

Version 4.12.4.0

  • Verified compatibility with Unity Ads SDK 4.12.4.

Built and tested with:

  • Google Mobile Ads SDK version 11.12.0.
  • Unity Ads SDK version 4.12.4.

Version 4.12.3.1

  • Обновлен CFBundleShortVersionString теперь имеет три компонента вместо четырех.

Built and tested with:

  • Google Mobile Ads SDK версии 11.10.0.
  • Unity Ads SDK version 4.12.3.

Version 4.12.3.0

  • Verified compatibility with Unity Ads SDK 4.12.3.

Создано и протестировано с помощью:

  • Google Mobile Ads SDK версии 11.10.0.
  • Unity Ads SDK version 4.12.3.

Version 4.12.2.0

  • Verified compatibility with Unity Ads SDK 4.12.2.

Built and tested with:

  • Google Mobile Ads SDK version 11.7.0.
  • Unity Ads SDK version 4.12.2.

Version 4.12.1.0

  • Verified compatibility with Unity Ads SDK 4.12.1.

Built and tested with:

  • Google Mobile Ads SDK version 11.6.0.
  • Unity Ads SDK version 4.12.1.

Версия 4.12.0.0

  • Verified compatibility with Unity Ads SDK 4.12.0.

Built and tested with:

  • Google Mobile Ads SDK версии 11.5.0.
  • Unity Ads SDK version 4.12.0.

Version 4.11.3.1

  • Добавлена ​​поддержка ставок для форматов баннерной, полноэкранной и вознагражденной рекламы.

Built and tested with:

  • Google Mobile Ads SDK версии 11.5.0.
  • Unity Ads SDK version 4.11.3.

Version 4.11.3.0

  • Verified compatibility with Unity Ads SDK 4.11.3.

Built and tested with:

  • Google Mobile Ads SDK версии 11.4.0.
  • Unity Ads SDK version 4.11.3.

Version 4.11.2.0

  • Verified compatibility with Unity Ads SDK 4.11.2.

Built and tested with:

  • Google Mobile Ads SDK версии 11.4.0.
  • Unity Ads SDK version 4.11.2.

Version 4.10.0.0

  • Verified compatibility with Unity Ads SDK 4.10.0.

Built and tested with:

  • Google Mobile Ads SDK версии 11.2.0.
  • Unity Ads SDK version 4.10.0.

Version 4.9.3.0

  • Verified compatibility with Unity Ads SDK 4.9.3.
  • Теперь требуется минимальная версия iOS 12.0.
  • Теперь требуется Google Mobile Ads SDK версии 11.0 или выше.
  • Included Info.plist in the frameworks within UnityAdapter.xcframework .

Built and tested with:

  • Google Mobile Ads SDK версии 11.0.1.
  • Unity Ads SDK version 4.9.3.

Version 4.9.2.0

  • Verified compatibility with Unity Ads SDK 4.9.2.

Built and tested with:

  • Google Mobile Ads SDK version 10.13.0.
  • Unity Ads SDK version 4.9.2.

Version 4.9.1.0

  • Verified compatibility with Unity Ads SDK 4.9.1.

Built and tested with:

  • Google Mobile Ads SDK версии 10.12.0.
  • Unity Ads SDK version 4.9.1.

Version 4.9.0.0

  • Removed GADMAdNetworkAdapter conformance and dependency from the Unity adapter.
  • Added report impression method invocation in unityAdsShowStart delegate method.
  • Verified compatibility with Unity Ads SDK 4.9.0.

Built and tested with:

  • Google Mobile Ads SDK версии 10.12.0.
  • Unity Ads SDK version 4.9.0.

Version 4.8.0.0

  • Added support for impression events for banner ads.
  • Verified compatibility with Unity Ads SDK 4.8.0.

Built and tested with:

  • Google Mobile Ads SDK version 10.7.0.
  • Unity Ads SDK version 4.8.0.

Версия 4.7.1.0

  • Verified compatibility with Unity Ads SDK 4.7.1.

Built and tested with:

  • Google Mobile Ads SDK версии 10.5.0.
  • Unity Ads SDK version 4.7.1.

Версия 4.7.0.0

  • Verified compatibility with Unity Ads SDK 4.7.0.
  • Now requires minimum iOS version 11.0.
  • Теперь требуется Google Mobile Ads SDK версии 10.4.0 или выше.

Built and tested with:

  • Google Mobile Ads SDK version 10.4.0.
  • Unity Ads SDK version 4.7.0.

Версия 4.6.1.0

  • Verified compatibility with Unity Ads SDK 4.6.1.

Built and tested with:

  • Google Mobile Ads SDK версии 10.2.0.
  • Unity Ads SDK version 4.6.1.

Version 4.6.0.0

  • Verified compatibility with Unity Ads SDK 4.6.0.
  • Added support for forwarding COPPA information to the Unity Ads SDK.
  • Removed support for the armv7 architecture.
  • Теперь требуется Google Mobile Ads SDK версии 10.0.0 или выше.

Built and tested with:

  • Google Mobile Ads SDK версии 10.2.0.
  • Unity Ads SDK version 4.6.0.

Version 4.5.0.0

  • Verified compatibility with Unity Ads SDK 4.5.0.

Built and tested with:

  • Google Mobile Ads SDK версии 9.14.0.
  • Unity Ads SDK version 4.5.0.

Версия 4.4.1.0

  • Verified compatibility with Unity Ads SDK 4.4.1.

Built and tested with:

  • Google Mobile Ads SDK версии 9.11.0.
  • Unity Ads SDK version 4.4.1.

Версия 4.4.0.0

  • Обновлен адаптер для использования API didRewardUser .
  • Теперь требуется Google Mobile Ads SDK версии 9.8.0 или выше.
  • Verified compatibility with Unity Ads SDK 4.4.0.

Built and tested with:

  • Google Mobile Ads SDK version 9.10.0.
  • Unity Ads SDK version 4.4.0.

Version 4.3.0.0

  • Verified compatibility with Unity Ads SDK 4.3.0.

Built and tested with:

  • Google Mobile Ads SDK version 9.8.0.
  • Unity Ads SDK version 4.3.0.

Version 4.2.1.0

  • Verified compatibility with Unity Ads SDK 4.2.1.

Built and tested with:

  • Google Mobile Ads SDK version 9.4.0.
  • Unity Ads SDK version 4.2.1.

Версия 4.1.0.0

  • Verified compatibility with Unity Ads SDK 4.1.0.

Built and tested with:

  • Google Mobile Ads SDK версии 9.2.0.
  • Unity Ads SDK version 4.1.0.

Version 4.0.1.0

  • Verified compatibility with Unity Ads SDK 4.0.1.

Built and tested with:

  • Google Mobile Ads SDK версии 9.0.0.
  • Unity Ads SDK version 4.0.1.

Version 4.0.0.2

  • Added support for the arm64 simulator architecture.

Built and tested with:

  • Google Mobile Ads SDK версии 9.0.0.
  • Unity Ads SDK version 4.0.0.

Version 4.0.0.1

  • Проверенная совместимость с Google Mobile Ads SDK версии 9.0.0.
  • Теперь требуется Google Mobile Ads SDK версии 9.0.0 или выше.

Built and tested with:

  • Google Mobile Ads SDK версии 9.0.0.
  • Unity Ads SDK version 4.0.0.

Version 4.0.0.0

  • Verified compatibility with Unity Ads SDK 4.0.0.
  • Теперь требуется минимальная версия iOS 10.0.

Создано и протестировано с

  • Google Mobile Ads SDK версии 8.13.0.
  • Unity Ads SDK version 4.0.0.

Version 3.7.5.0

  • Verified compatibility with Unity Ads SDK 3.7.5.

Создано и протестировано с

  • Google Mobile Ads SDK версии 8.8.0.
  • Unity Ads SDK version 3.7.5.

Version 3.7.4.0

  • Verified compatibility with Unity Ads SDK 3.7.4.

Создано и протестировано с

  • Google Mobile Ads SDK версии 8.7.0.
  • Unity Ads SDK version 3.7.4.

Версия 3.7.2.0

  • Verified compatibility with Unity Ads SDK 3.7.2.
  • Снижена зависимость от Google Mobile Ads SDK версии 8.0.0 или выше.

Создано и протестировано с

  • Google Mobile Ads SDK версии 8.5.0.
  • Unity Ads SDK version 3.7.2.

Версия 3.7.1.0

  • Verified compatibility with Unity Ads SDK 3.7.1.
  • Теперь требуется Google Mobile Ads SDK версии 8.4.0 или выше.

Создано и протестировано с

  • Google Mobile Ads SDK версии 8.4.0.
  • Unity Ads SDK version 3.7.1.

Version 3.6.2.0

  • Обновлен адаптер для использования формата .xcframework .
  • Verified compatibility with Unity Ads SDK 3.6.2.
  • Теперь требуется Google Mobile Ads SDK версии 8.2.0 или выше.

Создано и протестировано с

  • Google Mobile Ads SDK версии 8.2.0.
  • Unity Ads SDK version 3.6.2.

Версия 3.6.0.0

  • Verified compatibility with Unity Ads SDK 3.6.0.
  • Теперь требуется Google Mobile Ads SDK версии 7.69.0 или выше.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.69.0.
  • Unity Ads SDK version 3.6.0.

Version 3.5.1.1

  • Fixed a crash that sometimes occurred when the Unity Ads SDK finished initializing.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.68.0.
  • Unity Ads SDK version 3.5.1.

Version 3.5.1.0

  • Verified compatibility with Unity Ads SDK 3.5.1.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.68.0.
  • Unity Ads SDK version 3.5.1.

Версия 3.5.0.0

  • Verified compatibility with Unity Ads SDK 3.5.0.
  • Added support for Adaptive Banner ads.
  • Теперь требуется Google Mobile Ads SDK версии 7.68.0 или выше.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.68.0.
  • Unity Ads SDK version 3.5.0.

Version 3.4.8.0

  • Verified compatibility with Unity Ads SDK 3.4.8.
  • Now requires Google Mobile Ads SDK version 7.63.0 or higher.

Создано и протестировано с

  • Google Mobile Ads SDK version 7.63.0.
  • Unity Ads SDK version 3.4.8.

Версия 3.4.6.0

  • Verified compatibility with Unity Ads SDK 3.4.6.
  • Теперь требуется Google Mobile Ads SDK версии 7.60.0 или выше.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.60.0.
  • Unity Ads SDK version 3.4.6.

Version 3.4.2.2

  • Добавлены стандартизированные коды ошибок адаптера и сообщения.
  • Обновлена ​​минимально требуемая версия Google Mobile Ads SDK до 7.59.0.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.59.0.
  • Unity Ads SDK version 3.4.2.

Version 3.4.2.1

  • Improved forwarding of Unity's errors to recognize initialization and ad load failures earlier and reduce timeouts.
  • Удалена поддержка архитектуры i386.

Создано и протестировано с

  • Google Mobile Ads SDK version 7.57.0.
  • Unity Ads SDK version 3.4.2.

Версия 3.4.2.0

  • Verified compatibility with Unity Ads SDK 3.4.2.

Создано и протестировано с

  • Google Mobile Ads SDK версии 7.55.1.
  • Unity Ads SDK version 3.4.2.

Версия 3.4.0.0

  • Verified compatibility with Unity Ads SDK 3.4.0.
  • Now supports loading multiple banner ads at once.

Создано и протестировано с

  • Google Mobile Ads SDK version 7.53.0.
  • Unity Ads SDK version 3.4.0.

Версия 3.3.0.0

  • Verified compatibility with Unity Ads SDK 3.3.0.
  • Now supports loading multiple banner ads at once.

Создано и протестировано с

  • Google Mobile Ads SDK version 7.51.0.
  • Unity Ads SDK version 3.3.0.

Version 3.2.0.1

  • Verified compatibility with Unity Ads SDK 3.2.0.
  • Теперь требуется Google Mobile Ads SDK версии 7.46.0 или выше.
  • Fixed an issue where Unity Banner ads would fail to show when loaded.
  • Fixed an issue where the adapter was not properly forwarding the unityAdsReady callback.

Version 3.2.0.0

  • Release was removed due to a regression on no-fill reporting.

Версия 3.1.0.0

  • Verified compatibility with Unity Ads SDK 3.1.0.

Version 3.0.3.0

  • Verified compatibility with Unity Ads SDK 3.0.3.
  • Now requires Google Mobile Ads SDK version 7.42.2 or higher.
  • Добавлена ​​поддержка гибких размеров баннерной рекламы.
  • Fixed an issue where Unity Banner ads would only successfully load once per session.

Version 3.0.1.0

  • Verified compatibility with Unity Ads SDK 3.0.1.
  • Fixed a crash that occurred when deallocating rewarded ads.

Версия 3.0.0.3

  • Updating adapter to use new rewarded API.
  • Теперь требуется Google Mobile Ads SDK версии 7.41.0 или выше.

Version 3.0.0.2

  • Добавлена ​​поддержка баннерной рекламы.

Version 3.0.0.1

  • Fixed an issue where the adapter stores the 'placementId' of previous request.

Version 3.0.0.0

  • Verified compatibility with Unity Ads SDK 3.0.0.

Версия 2.3.0.0

  • Verified compatibility with Unity Ads SDK 2.3.0.

Версия 2.2.1.1

  • Added adapterDidCompletePlayingRewardBasedVideoAd: callback to the adapter.

Версия 2.2.1.0

  • Verified compatibility with Unity Ads SDK 2.2.1.

Версия 2.2.0.0

  • Verified compatibility with Unity Ads SDK 2.2.0.

Версия 2.1.2.0

  • Verified compatibility with Unity Ads SDK 2.1.2.
  • Removed the support for 'armv7s' architecture.

Версия 2.1.1.0

  • Verified compatibility with Unity Ads SDK 2.1.1.

Версия 2.1.0.0

  • Updated the adapter to make it compatible with Unity Ads SDK 2.1.0.

Version 2.0.8.0

  • Verified compatibility with Unity Ads SDK 2.0.8.

Версия 2.0.7.0

  • Adapter now tracks Unity Ads clicks so the AdMob and the Unity Ads click statistics can match up.
  • Apps now get interstitialWillLeaveApplication: and rewardBasedVideoAdWillLeaveApplication: callbacks.

Версия 2.0.6.0

  • Verified compatibility with Unity Ads SDK 2.0.6.

Версия 2.0.5.0

  • Verified compatibility with Unity Ads SDK 2.0.5.

Версия 2.0.4.0

  • Changed the version naming system to [Unity Ads SDK version].[adapter patch version].
  • Updated the minimum required Unity Ads SDK to v2.0.4.
  • Updated the minimum required Google Mobile Ads SDK to v7.10.1.

Версия 1.0.2

  • Made the user reward item's key non nil. The reward key will always be an empty or a valid string.

Версия 1.0.1

  • Fixed bug where the rewardBasedVideoAdDidOpen: callback wasn't getting called.

Версия 1.0.0

  • Supports interstitial and reward-based video ads.