В этом руководстве показано, как использовать Google Mobile Ads SDK для загрузки и показа рекламы из Meta Audience Network с помощью медиации , включая интеграцию ставок. В нем рассказывается, как добавить сеть Meta Audience Network в конфигурацию медиации рекламного блока, а также как интегрировать сеть Meta Audience Network и адаптер в Unity приложение.
Поддерживаемые интеграции и форматы объявлений
AdMob адаптер-посредник для 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 уровня 21 или выше
- Развертывание на 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 в AdMob пользовательский интерфейс
Настройте параметры медиации для своего рекламного блока
Андроид
Инструкции см. в шаге 2 руководства для Android .
iOS
Инструкции см. в шаге 2 руководства для iOS .
Добавлять Facebook в соответствии с GDPR и списком рекламных партнеров США.
Следуйте инструкциям в настройках GDPR и настройках законодательства штата США , чтобы добавить Meta в список рекламных партнеров GDPR и законодательства штата США в пользовательском интерфейсе AdMob.
Шаг 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 Meta Audience Network 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. Проверьте свою реализацию
Включить тестовые объявления
Убедитесь, что вы зарегистрировали свое тестовое устройство для AdMob и включили тестовый режим в пользовательском интерфейсе Meta Audience Network.
Проверьте тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления из Meta Audience Network, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений Meta Audience Network (Bidding) .
Дополнительные шаги
Кэширование на 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
- Поддерживает адаптер Meta Audience Network Android версии 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.