В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и показа рекламы из Meta Audience Network с помощью медиации , включая интеграцию ставок. В нем рассказывается, как добавить сеть Meta Audience Network в конфигурацию медиации рекламного блока, а также как интегрировать сеть Meta Audience Network и адаптер в приложение Unity.
Поддерживаемые интеграции и форматы объявлений
Адаптер медиации Менеджера рекламы для Meta Audience Network имеет следующие возможности:
Интеграция | |
---|---|
Торги | |
Водопад 1 | |
Форматы | |
Баннер | |
Межстраничный | |
Награжден | |
Межстраничное объявление с вознаграждением |
1 Meta Audience Network стала предлагать торги только в 2021 году.
Требования
- Последняя версия Google Mobile Ads SDK
- Unity 5.6 или выше
- Плагин посредничества Google Mobile Ads для Meta Audience Network 2.11.0 ( рекомендуется последняя версия )
- Развертывание на Android
- Android API уровня 23 или выше
- Развертывание на iOS
- Цель развертывания iOS 10.0 или выше
- Для последней версии Meta Audience Network SDK обычно требуется последняя версия Xcode.
- Рабочий проект Unity, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе «Начало работы» .
- Пройдите руководство по началу работы с медиацией
Шаг 1. Настройте конфигурации в пользовательском интерфейсе Meta Audience Network.
Зарегистрируйтесь и войдите на стартовую страницу Бизнес-Менеджера .
Нажмите «Начать» , затем «Создать новую учетную запись» .
Заполните необходимые поля сведениями о своей компании и нажмите «Далее» .
Создать свойство
После того как вы заполнили необходимую информацию, вам будет предложено создать свойство для вашего приложения. Введите желаемое имя свойства для вашего приложения и нажмите «Далее» .
Затем выберите платформу для монетизации.
Добавьте сведения о своем приложении и нажмите «Далее» .
Андроид

iOS

Настройте свой платежный счет, нажав Добавить новый платежный счет . Вы будете перенаправлены на новую страницу для ввода платежной информации. Заполните необходимые данные, затем нажмите «Далее» .
Выберите Google AdMob в качестве платформы медиации , затем нажмите «Создать место размещения» .
Выберите формат, заполните форму и нажмите «Создать» .
Обратите внимание на идентификатор места размещения .
Нажмите Готово .
Включите тестовый режим
Подробные инструкции по включению тестовых объявлений Meta Audience Network см. в руководстве по внедрению Testing Audience Network.
Шаг 2. Настройте спрос Meta Audience Network в интерфейсе Менеджера рекламы.
Настройте параметры медиации для своего рекламного блока
Андроид
Инструкции см. в шаге 2 руководства для Android .
iOS
Инструкции см. в шаге 2 руководства для iOS .
Добавьте Meta в список рекламных партнеров GDPR и государственных правил США.
Follow the steps in European regulations settings and US state regulations settings to add Meta to the European and US state regulations ad partners list in the Ad Manager UI.
Шаг 3. Импортируйте SDK и адаптер Meta Audience Network.
OpenUPM-CLI
Если у вас установлен OpenUPM-CLI , вы можете установить плагин посредничества Meta Audience Network Google Mobile Ads для Unity в свой проект, выполнив следующую команду из корневого каталога вашего проекта:
openupm add com.google.ads.mobile.mediation.metaaudiencenetwork
ОпенУПМ
В редакторе проекта Unity выберите «Правка» > «Настройки проекта» > «Диспетчер пакетов» , чтобы открыть настройки диспетчера пакетов Unity .
На вкладке «Регистрации с ограниченной областью» добавьте OpenUPM в качестве реестра с ограниченной областью действия со следующими сведениями:
- Имя:
OpenUPM
- URL-адрес:
https://package.openupm.com
- Область применения:
com.google
Затем перейдите в «Окно» > «Диспетчер пакетов» , чтобы открыть диспетчер пакетов Unity , и выберите «Мои реестры» в раскрывающемся меню.
Выберите пакет Google Mobile Ads MetaAudienceNetwork Mediation и нажмите «Установить» .
Пакет Единства
Загрузите последнюю версию плагина посредничества Google Mobile Ads для Meta Audience Network по ссылке для скачивания в журнале изменений и извлеките пакет GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage
из zip-файла.
В редакторе проекта Unity выберите «Активы» > «Импортировать пакет» > «Пользовательский пакет» и найдите загруженный вами файл GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage
. Убедитесь, что все файлы выбраны, и нажмите «Импортировать» .
Затем выберите «Активы» > «Диспетчер внешних зависимостей» > «Android Resolver» > «Принудительное разрешение» . Библиотека диспетчера внешних зависимостей выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android
вашего приложения Unity.
Шаг 4. Реализуйте настройки конфиденциальности в Meta Audience Network SDK.
Согласие ЕС и GDPR
В соответствии с Политикой согласия пользователей Google из ЕС вы должны гарантировать, что пользователям в Европейской экономической зоне (ЕЭЗ) будет предоставлена определенная информация и получено от них согласие на использование идентификаторов устройств и личных данных. Эта политика отражает требования Директивы ЕС об электронной конфиденциальности и Общего регламента защиты данных (GDPR). При запросе согласия вы должны указать каждую рекламную сеть в вашей цепочке посредничества, которая может собирать, получать или использовать персональные данные, а также предоставлять информацию об использовании каждой сети. В настоящее время Google не может автоматически передавать выбор согласия пользователя в такие сети.
Ознакомьтесь с руководством Meta для получения информации о GDPR и мета-рекламе.
Законы о конфиденциальности штатов США
Законы о конфиденциальности штатов США требуют предоставления пользователям права отказаться от «продажи» их «личной информации» (согласно определению этих условий в законе), при этом отказ предлагается через заметную ссылку «Не продавать мою личную информацию» на домашней странице «продающей» стороны. Руководство по соблюдению законов о конфиденциальности штатов США предлагает возможность включить ограниченную обработку данных для показа рекламы Google, но Google не может применить этот параметр к каждой рекламной сети в вашей цепочке медиации. Таким образом, вы должны определить каждую рекламную сеть в вашей цепочке посредничества, которая может участвовать в продаже личной информации, и следовать инструкциям каждой из этих сетей, чтобы обеспечить соблюдение требований.
Для пользователей в Калифорнии ознакомьтесь с вариантами обработки данных Meta.
Шаг 5. Добавьте необходимый код.
Андроид
Для интеграции Meta Audience Network не требуется дополнительный код.
iOS
Интеграция со SKAdNetwork
Следуйте документации Meta Audience Network , чтобы добавить идентификаторы SKAdNetwork в файл Info.plist
вашего проекта.
Отслеживание рекламы включено
Если вы создаете приложение для iOS 14 или более поздней версии, ознакомьтесь с инструкциями Meta Audience Network о том, как установить флаг отслеживания рекламы .
Шаг 6. Проверьте свою реализацию
Включить тестовые объявления
Убедитесь, что вы зарегистрировали свое тестовое устройство в Менеджере рекламы и включили тестовый режим в пользовательском интерфейсе Meta Audience Network.
Проверьте тестовые объявления
To verify that you are receiving test ads from Meta Audience Network, enable single ad source testing in ad inspector using the Meta Audience Network (Bidding) ad source(s).
Дополнительные шаги
Кэширование на Android 9
Андроид
Начиная с Android 9 (уровень API 28), поддержка открытого текста по умолчанию отключена , что повлияет на функциональность кэширования мультимедиа Meta Audience Network SDK и может повлиять на взаимодействие с пользователем и доходы от рекламы. Следуйте документации Meta , чтобы обновить конфигурацию сетевой безопасности в вашем приложении.
iOS
Не применимо для интеграции iOS.
Коды ошибок
Если адаптеру не удается получить рекламу от Audience Network, вы можете проверить основную ошибку из ответа на объявление с помощью ResponseInfo
в следующих классах:
Андроид
com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter
iOS
GADMAdapterFacebook
GADMediationAdapterFacebook
Вот коды и сопутствующие сообщения, выдаваемые адаптером Meta Audience Network, когда реклама не загружается:
Андроид
Код ошибки | Причина |
---|---|
101 | Неверные параметры сервера (например, отсутствует идентификатор места размещения). |
102 | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому Meta Audience Network. |
103 | Издатель должен запрашивать объявления с контекстом Activity . |
104 | Не удалось инициализировать Meta Audience Network SDK. |
105 | Издатель не запрашивал унифицированную нативную рекламу. |
106 | Загруженное нативное объявление представляет собой объект, отличный от ожидаемого. |
107 | Используемый объект Context недействителен. |
108 | В загруженном объявлении отсутствуют необходимые ресурсы нативной рекламы. |
109 | Не удалось создать нативное объявление на основе полезных данных ставки. |
110 | SDK Meta Audience Network не смог представить межстраничную рекламу или рекламу с вознаграждением. |
111 | Исключение, возникающее при создании объекта AdView Meta Audience Network. |
1000-9999 | Сеть Meta Audience Network вернула ошибку, связанную с SDK. Дополнительную информацию см. в документации Meta Audience Network. |
iOS
Код ошибки | Причина |
---|---|
101 | Неверные параметры сервера (например, отсутствует идентификатор места размещения). |
102 | Запрошенный размер объявления не соответствует размеру баннера, поддерживаемому Meta Audience Network. |
103 | Не удалось инициализировать рекламный объект Meta Audience Network. |
104 | SDK Meta Audience Network не смог представить межстраничную рекламу или рекламу с вознаграждением. |
105 | Контроллер корневого представления рекламного баннера равен nil . |
106 | Не удалось инициализировать Meta Audience Network SDK. |
1000-9999 | Сеть Meta Audience Network вернула ошибку, связанную с SDK. Дополнительную информацию см. в документации Meta Audience Network. |
Журнал изменений плагина Meta Audience Network Unity Mediation
Версия 3.14.0
- Поддерживает адаптер Meta Audience Network Android версии 6.18.0.0 .
- Поддерживает адаптер Meta Audience Network iOS версии 6.16.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.3.0.
Версия 3.13.1
- Поддерживает адаптер Meta Audience Network Android версии 6.18.0.0 .
- Поддерживает адаптер Meta Audience Network iOS версии 6.15.2.1 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.3.0.
Версия 3.13.0
- Поддерживает адаптер Meta Audience Network Android версии 6.18.0.0 .
- Поддерживает адаптер Meta Audience Network iOS версии 6.15.2.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.2.0.
Версия 3.12.2
- Поддерживает адаптер Meta Audience Network Android версии 6.17.0.0 .
- Поддерживает адаптер Meta Audience Network iOS версии 6.15.2.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.2.0.
Версия 3.12.1
- Поддерживает адаптер Meta Audience Network Android версии 6.17.0.0 .
- Поддерживает адаптер Meta Audience Network iOS версии 6.15.1.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.1.0.
Версия 3.12.0
- Поддерживает адаптер Meta Audience Network Android версии 6.17.0.0 .
- Поддерживает адаптер Meta Audience Network iOS версии 6.15.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 9.0.0.
Версия 3.11.0
- Поддерживает адаптер Meta Audience Network Android версии 6.15.0.0 .
- Поддерживает адаптер Meta Audience Network iOS версии 6.14.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.5.1.
Версия 3.10.0
- Содержимое адаптера перенесено в
GoogleMobileAds/Mediation/MetaAudienceNetwork/
. - Поддерживает адаптер Meta Audience Network Android версии 6.14.0.0 .
- Поддерживает адаптер Meta Audience Network iOS версии 6.12.0.1 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 8.1.0.
Версия 3.9.1
- Поддерживает адаптер Meta Audience Network Android версии 6.12.0.0 .
- Поддерживает адаптер Meta Audience Network iOS версии 6.12.0.1 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.4.1.
Версия 3.9.0
- Поддерживает адаптер Meta Audience Network Android версии 6.12.0.0 .
- Поддерживает адаптер Meta Audience Network iOS версии 6.12.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.3.0.
Версия 3.8.0
- Название плагина-посредника Unity переименовано в «Meta Audience Network».
- Поддерживает адаптер Meta Audience Network Android версии 6.11.0.1 .
- Поддерживает адаптер Meta Audience Network iOS версии 6.11.1.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.0.2.
Версия 3.7.0
- Поддерживает адаптер Meta Audience Network Android версии 6.10.0.0 .
- Поддерживает адаптер Meta Audience Network iOS версии 6.10.0.0 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.0.0.
Версия 3.6.1
- Поддерживает адаптер Meta Audience Network Android версии 6.8.0.0 .
- Поддерживает адаптер Meta Audience Network iOS версии 6.9.0.1 .
- Создано и протестировано с помощью плагина Google Mobile Ads Unity версии 7.0.0.
Версия 3.6.0
- Поддерживает адаптер Meta Audience Network Android версии 6.8.0.0 .
- Поддерживает адаптер Meta Audience Network iOS версии 6.8.0.0 .
Версия 3.5.0
- Поддерживает адаптер Meta Audience Network Android версии 6.7.0.0 .
- Поддерживает адаптер Meta Audience Network iOS версии 6.7.0.0 .
Версия 3.4.0
- Поддерживает адаптер Meta Audience Network Android версии 6.6.0.0 .
- Поддерживает адаптер Meta Audience Network iOS версии 6.6.0.0 .
Версия 3.3.2
- Поддерживает адаптер Meta Audience Network Android версии 6.5.1.1 .
- Поддерживает адаптер Meta Audience Network iOS версии 6.5.1.0 .
Версия 3.3.1
- Поддерживает адаптер Meta Audience Network Android версии 6.5.1.0 .
- Поддерживает адаптер Meta Audience Network iOS версии 6.5.1.0 .
Версия 3.3.0
- Supports Meta Audience Network Android adapter version 6.4.0.0 .
- Поддерживает адаптер Meta Audience Network iOS версии 6.4.1.0 .
Версия 3.2.0
- Поддерживает адаптер Meta Audience Network Android версии 6.2.0.1 .
- Поддерживает адаптер Meta Audience Network iOS версии 6.2.1.0 .
Версия 3.1.0
- Поддерживает адаптер Meta Audience Network Android версии 6.2.0.0 .
- Поддерживает адаптер Meta Audience Network iOS версии 6.2.0.0 .
Версия 3.0.0
- Поддерживает адаптер Meta Audience Network Android версии 6.1.0.0 .
- Поддерживает адаптер Meta Audience Network iOS версии 6.0.0.0 .
Версия 2.12.0
- Поддерживает адаптер Meta Audience Network Android версии 5.11.0.0 .
- Поддерживает адаптер Meta Audience Network iOS версии 5.10.1.0 .
Версия 2.11.1
- Поддерживает адаптер Meta Audience Network Android версии 5.10.1.0 .
- Поддерживает адаптер Meta Audience Network iOS версии 5.10.1.0 .
Версия 2.11.0
- Поддерживает адаптер Meta Audience Network Android версии 5.10.0.0 .
- Поддерживает адаптер Meta Audience Network iOS версии 5.10.0.0 .
Версия 2.10.0
- Поддерживает адаптер Meta Audience Network Android версии 5.9.1.0 .
- Поддерживает адаптер Meta Audience Network iOS версии 5.9.0.1 .
Версия 2.9.2
- Поддерживает адаптер Meta Audience Network Android версии 5.9.0.2 .
- Поддерживает адаптер Meta Audience Network iOS версии 5.9.0.1 .
Версия 2.9.1
- Поддерживает адаптер Meta Audience Network Android версии 5.9.0.1 .
- Поддерживает адаптер Meta Audience Network iOS версии 5.9.0.1 .
Версия 2.9.0
- Поддерживает адаптер Meta Audience Network Android версии 5.9.0.0 .
- Поддерживает адаптер Meta Audience Network iOS версии 5.9.0.0 .
Версия 2.8.1
- Поддерживает адаптер Meta Audience Network Android версии 5.8.0.1 .
- Поддерживает адаптер Meta Audience Network iOS версии 5.8.0.2 .
Версия 2.8.0
- Поддерживает адаптер Meta Audience Network Android версии 5.8.0.0 .
- Поддерживает адаптер Meta Audience Network iOS версии 5.8.0.1 .
Версия 2.7.1 (устарела, используйте 2.8.0 или новее)
- Поддерживает адаптер Meta Audience Network Android версии 5.7.1.0 .
- Поддерживает адаптер Meta Audience Network iOS версии 5.7.1.1 .
Версия 2.7.0 (устарела, используйте 2.8.0 или новее)
- Поддерживает адаптер Meta Audience Network Android версии 5.7.0.0 .
- Поддерживает адаптер Meta Audience Network iOS версии 5.7.0.0 .
Версия 2.6.1 (устарела, используйте 2.8.0 или новее)
- Поддерживает адаптер Meta Audience Network Android версии 5.6.1.0 .
- Поддерживает адаптер Meta Audience Network iOS версии 5.6.1.0 .
Версия 2.6.0
- Поддерживает адаптер Meta Audience Network Android версии 5.6.0.0 .
- Поддерживает адаптер Meta Audience Network iOS версии 5.6.0.0 .
Версия 2.5.1
- Поддерживает адаптер Facebook Android версии 5.5.0.0.
- Поддерживает адаптер Facebook iOS версии 5.5.1.0.
Версия 2.5.0
- Поддерживает адаптер Facebook Android версии 5.5.0.0.
- Поддерживает адаптер Facebook iOS версии 5.5.0.0.
Версия 2.4.1
- Поддерживает адаптер Facebook Android версии 5.4.1.1.
- Поддерживает адаптер Facebook iOS версии 5.4.0.0.
Версия 2.4.0
- Поддерживает адаптер Facebook Android версии 5.4.0.0.
- Поддерживает адаптер Facebook iOS версии 5.4.0.0.
Версия 2.3.2
- Поддерживает адаптер Facebook Android версии 5.3.1.2.
- Поддерживает адаптер Facebook iOS версии 5.3.2.0.
Версия 2.3.1
- Поддерживает адаптер Facebook Android версии 5.3.1.0.
- Поддерживает адаптер Facebook iOS версии 5.3.2.0.
Версия 2.3.0
- Поддерживает адаптер Facebook Android версии 5.3.0.0.
- Поддерживает адаптер Facebook iOS версии 5.3.0.0.
Версия 2.2.0
- Обновлен плагин для поддержки новой открытой бета-версии Rewarded API.
- Поддерживает адаптер Facebook Android версии 5.2.0.1.
- Поддерживает адаптер Facebook iOS версии 5.2.0.1.
Версия 2.1.1
- Поддерживает адаптер Facebook Android версии 5.1.0.1.
- Поддерживает адаптер Facebook iOS версии 5.1.0.0.
Версия 2.1.0
- Поддерживает адаптер Facebook Android версии 5.1.0.0.
- Поддерживает адаптер Facebook iOS версии 5.1.0.0.
Версия 2.0.0
- Поддерживает адаптер Facebook Android версии 5.0.1.0.
- Поддерживает адаптер Facebook iOS версии 5.0.1.0.
Версия 1.2.1
- Поддерживает адаптер Facebook Android версии 4.99.3.0.
- Поддерживает адаптер Facebook iOS версии 4.99.3.0.
Версия 1.2.0
- Поддерживает адаптер Facebook Android версии 4.99.1.1.
- Поддерживает адаптер Facebook iOS версии 4.99.2.0.
Версия 1.1.3
- Поддерживает адаптер Facebook Android версии 4.28.2.1.
- Поддерживает адаптер Facebook iOS версии 4.28.1.2.
Версия 1.1.2
- Исправлен потенциальный конфликт с плагином-посредником Unity Ads Unity.
Версия 1.1.1
- Поддерживает адаптер Facebook Android версии 4.28.2.0.
- Поддерживает адаптер Facebook iOS версии 4.28.1.1.
Версия 1.1.0
- Поддерживает Facebook Android SDK версии 4.28.1.
- Поддерживает Facebook iOS SDK версии 4.28.1.
Версия 1.0.0
- Первый выпуск!
- Поддерживает Facebook Android SDK версии 4.27.0.
- Поддерживает Facebook iOS SDK версии 4.27.1.