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

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

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

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

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

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

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

Требования

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Торги

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

Водопад

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

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

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

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

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

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

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

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

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

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

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

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

Введите уникальное имя для своей группы доходности, установите статус « Активно» , выберите формат объявления и установите тип инвентаря « Мобильное приложение» . В разделе «Таргетинг» > «Инвентарь» выберите рекламный блок в разделе «Инвентарь и мобильное приложение» , к которому вы хотите добавить агрегатор.

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

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

Выберите Unity Ads в качестве рекламной сети , введите уникальное имя и включите посредничество .

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

После выбора партнера по доходности выберите Mobile SDK Mediation в качестве типа интеграции , Android в качестве платформы и Активный в качестве статуса . Введите идентификатор игры и идентификатор места размещения, полученные в предыдущем разделе. Затем введите значение цены за тысячу показов по умолчанию .

Когда закончите, нажмите «Сохранить» внизу страницы.

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

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

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

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

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.unity3d.ads:unity-ads:4.12.3")
    implementation("com.google.ads.mediation:unity:4.12.4.0")
}

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

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

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

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

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

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

Ява

import 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. Добавьте необходимый код.

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

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

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

Убедитесь, что вы зарегистрировали свое тестовое устройство в Менеджере рекламы и включили тестовый режим в пользовательском интерфейсе 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, настроенные в Ad Manager Пользовательский интерфейс отсутствует/недействителен.
102	UnityAds вернул место размещения со статусом NO_FILL.
103	UnityAds вернул место размещения в состоянии ОТКЛЮЧЕНО.
104	UnityAds попыталась показать рекламу с нулевым контекстом.
105	Контекст, используемый для инициализации, загрузки и/или показа рекламы из Unity Ads, не является экземпляром Activity.
106	UnityAds попыталась показать рекламу, которая еще не готова к показу.
107	UnityAds не поддерживается на устройстве.
108	UnityAds может загружать только одно объявление на одно место размещения одновременно.
109	UnityAds завершил работу с состоянием ОШИБКА.
200-204	Ошибка, связанная с баннером UnityAds. См. код для более подробной информации.