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

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

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

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

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

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

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

¹ Интеграция торгов находится в стадии открытого бета-тестирования.

Требования

Android API уровня 23 или выше

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

Последняя версия Google Mobile Ads SDK
Завершить посредничество . Руководство по началу работы.

Шаг 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» > «Тестирование» .

Вы можете принудительно включить тестовый режим для своего приложения, нажав кнопку редактирования рядом с Google Play 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 в качестве типа интеграции , Android в качестве платформы и Active в качестве статуса .

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

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

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

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

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

Интеграция с Android Studio (рекомендуется)

В файл build.gradle.kts уровня приложения добавьте следующие зависимости и конфигурации реализации. Используйте последние версии Unity Ads SDK и адаптера:

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.5.0")
    implementation("com.unity3d.ads:unity-ads:4.16.1")
    implementation("com.google.ads.mediation:unity:4.16.1.0")
}

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

Загрузите последнюю версию Unity Ads SDK ( unity-ads.aar ) из репозитория GitHub и добавьте ее в свой проект.
Перейдите к артефактам адаптера Unity Ads в репозитории Maven от Google. Выберите последнюю версию, скачайте .aar файл адаптера Unity Ads и добавьте его в свой проект.

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

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

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

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

Ява

import com.unity3d.ads.metadata.MetaData;
// ...

MetaData gdprMetaData = new MetaData(this);
gdprMetaData.set("gdpr.consent", true);
gdprMetaData.commit();

Котлин

import com.unity3d.ads.metadata.MetaData
// ...

val gdprMetaData = MetaData(this)
gdprMetaData["gdpr.consent"] = true
gdprMetaData.commit()

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

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

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

Ява

import com.unity3d.ads.metadata.MetaData;
// ...

MetaData ccpaMetaData = new MetaData(this);
ccpaMetaData.set("privacy.consent", true);
ccpaMetaData.commit();

Котлин

import com.unity3d.ads.metadata.MetaData
// ...

val ccpaMetaData = MetaData(this)
ccpaMetaData["privacy.consent"] = true
ccpaMetaData.commit()

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

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

Загрузить объявление с контекстом активности

Передача контекста Activity при загрузке форматов баннерной, полноэкранной и нативной рекламы. Без контекста активности загрузка рекламы невозможна.

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

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

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

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

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

Коды ошибок

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

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

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

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