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

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

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

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

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

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

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

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

Требования

Цель развертывания iOS 12.0 или выше
[Для торгов]: Чтобы интегрировать все поддерживаемые форматы рекламы в торги, используйте адаптер Unity 4.14.1.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» > «Тестирование» .

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

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

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

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

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

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

Сначала войдите в свою учётную запись AdMob . Затем перейдите на вкладку «Медиация» . Если у вас есть группа медиации, которую вы хотите изменить, нажмите на её название, чтобы отредактировать её, и перейдите к разделу «Добавить Unity Ads в качестве источника рекламы» .

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

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

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

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

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

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

Торги

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

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

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

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

Затем введите идентификатор игры и идентификатор места, полученные в предыдущем разделе. Затем нажмите «Готово» .

Водопад

На карточке «Водопад» в разделе «Источники рекламы» выберите «Добавить источник рекламы» .

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

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

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

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

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

CocoaPods (рекомендуется)

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

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

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

Шаг 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 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 « Согласие на конфиденциальность и API-интерфейсы данных» , а также «Соблюдение 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 « Согласие на конфиденциальность и API-интерфейсы данных» , а также «Соблюдение CCPA».

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

Интеграция SKAdNetwork

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

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

Быстрый

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

Objective-C

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

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

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

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

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

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

Коды ошибок

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

GADMAdapterUnity
GADMediationAdapterUnity

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

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