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

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

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

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

Android iOS Unity Flutter

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

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

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

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

Требования

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

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

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

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

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

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

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

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

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

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

Выберите параметры размещения, затем нажмите «Далее» .

Торги

Водопад

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

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

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

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

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

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

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

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

Запишите идентификатор места прохождения практики .

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

Найдите ключ API для отчетов по рекламе в Unity.

Торги

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

Водопад

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

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

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

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

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

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

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

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

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

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

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

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

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

Торги

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

Водопад

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

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

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

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

Торги

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

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

Передайте защищенный сигнал в запросах на участие в торгах.

Торги

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

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

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

Обеспечьте безопасный обмен сигналами для торгов с использованием SDK.

Торги

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

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

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

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

Торги

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

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

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

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

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

Водопад

Этот шаг не требуется для интеграций с каскадной моделью распределения.

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

Торги

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

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

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

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

Водопад

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

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

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

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

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

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

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

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

Используйте менеджер пакетов Swift.

Прежде чем продолжить, у вас должна быть установлена минимальная поддерживаемая версия адаптера 4.16.0.0.

Чтобы добавить зависимость пакета в ваш проект, выполните следующие действия:

В Xcode перейдите в меню Файл > Добавить зависимости пакета... .
В появившемся окне введите следующий URL-адрес пакета:
```
https://github.com/googleads/googleads-mobile-ios-mediation-unity.git
```
В разделе «Правило зависимости» выберите «Ветвь» .
В текстовом поле введите main .

Используйте CocoaPods

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

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

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

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

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

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

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

Быстрый

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 , а также о значениях, которые можно указать в каждом методе, см. в разделе «Соответствие GDPR».

Законы штатов США о защите частной жизни

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

Быстрый

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

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

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

Быстрый

Для интеграции со 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	SDK UnityAds вернул ошибку. Дополнительные сведения см. в документации Unity.
101	Параметры сервера UnityAds, настроенные в пользовательском интерфейсе Ad Manager, отсутствуют/недействительны.
102	Устройство не поддерживается UnityAds.
103	Показ рекламы в UnityAds завершился с ошибкой `kUnityAdsFinishStateError` .
104	Объект рекламного объявления Unity становится равным нулю после вызова его инициализатора.
105	Не удалось показать рекламу Unity, так как она еще не готова.
107	UnityAds вызвал функцию обратного вызова при изменении состояния размещения с состоянием размещения `kUnityAdsPlacementStateDisabled` .
108	Реклама на этом месте уже загружена. SDK UnityAds не поддерживает загрузку нескольких объявлений на одном и том же месте.
109	Баннерное объявление, полученное от UnityAds, не соответствует запрошенному размеру.
110	UnityAds вернул ошибку инициализации.
111	Неподдерживаемый формат рекламы.