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

Интегрируйте Unity Ads с медиацией
Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

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

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

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

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

Требования

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

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

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

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

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

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

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

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

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

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

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

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

Торги

Водопад

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

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

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

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

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

Торги

Выберите Торги для Настройки . В разделе Размещение введите название Размещение .

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

Водопад

Выберите Waterfall для настройки . В разделе Placement введите название Placement , GEO Tagging и Target .

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

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

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

Торги

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

Водопад

Перейдите в Unity Ads Monetization > API management и запомните API Key в Monetization Stats API Access .

Затем перейдите в раздел «Монетизация 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 Monetization > Testing .

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

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

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

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

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

Вам необходимо добавить Unity Ads в конфигурацию медиации для вашего рекламного блока.

Сначала войдите в свою учетную запись AdMob . Затем перейдите на вкладку Mediation . Если у вас есть существующая группа медиации, которую вы хотите изменить, щелкните имя этой группы медиации, чтобы отредактировать ее, и перейдите к Add Unity Ads as an ad source .

Чтобы создать новую группу посредничества, выберите «Создать группу посредничества» .

Введите формат и платформу рекламы, затем нажмите «Продолжить» .

Дайте название вашей группе посредничества и выберите местоположения для таргетинга. Затем установите статус группы посредничества на Включено , а затем нажмите Добавить рекламные блоки .

Свяжите эту группу медиации с одним или несколькими существующими рекламными блоками AdMob. Затем нажмите Готово .

Теперь вы должны увидеть карточку рекламных блоков, заполненную выбранными вами рекламными блоками:

Добавьте Unity Ads в качестве источника рекламы

Торги

Под карточкой «Торги» в разделе «Источники рекламы» выберите «Добавить источник рекламы» . Затем выберите Unity Ads .

Нажмите «Как подписать соглашение о партнерстве» и настроить партнерство по торгам с Unity Ads.

Нажмите «Принять и согласиться» , затем нажмите «Продолжить» .

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

Далее введите Game ID и Placement ID, полученные в предыдущем разделе. Затем нажмите Done .

Водопад

Под карточкой Waterfall в разделе Ad Sources выберите Add Ad Source . Затем выберите Unity Ads .

Выберите Unity Ads и включите переключатель Optimize . Введите API Key и Organization core ID, полученные в предыдущем разделе, чтобы настроить оптимизацию источника рекламы для Unity Ads. Затем введите значение eCPM для Unity Ads и нажмите Continue .

Далее введите Game ID и Placement ID, полученные в предыдущем разделе. Затем нажмите Done .

Примечание : Оптимизации источника рекламы требуется несколько дней, чтобы собрать достаточно данных для точного расчета eCPM для сети посредничества. В то же время статус оптимизации источника рекламы — PENDING , поэтому вам необходимо вручную задать значение eCPM для сети. Как только eCPM может быть рассчитан, источник рекламы автоматически начнет обновлять eCPM от вашего имени.

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

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

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

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

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.3.0")
    implementation("com.unity3d.ads:unity-ads:4.15.0")
    implementation("com.google.ads.mediation:unity:4.15.0.0")
}

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

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

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

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

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

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

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