Как интегрировать Meta Audience Network с назначением ставок

Выберите платформу: Android iOS Unity Flutter Android (устаревшая версия)

В этом руководстве рассказывается, как использовать Google Mobile Ads Unity Plugin для загрузки и показа объявлений из Meta Audience Network с помощью медиации, включая интеграцию назначения ставок. В нем рассказывается, как добавить Meta Audience Network в конфигурацию медиации рекламного блока и как интегрировать Meta Audience Network и адаптер в приложение Unity.

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

Адаптер медиации Менеджера рекламы для Meta Audience Network поддерживает следующие функции:

Интеграция
Ставки
Водопад  1
Форматы
Баннер
Межстраничное объявление
Бонус предоставлен
Межстраничное объявление с вознаграждением

1 В 2021 г. Meta Audience Network стала поддерживать только назначение ставок.

Требования

Прежде чем продолжить, убедитесь, что:

  • Последняя версия Google Mobile Ads Unity Plugin.
  • Редактор Unity версии 5.6 или более поздней.
  • Плагин медиации Google Mobile Ads для Meta Audience Network 2.11.0 (рекомендуется последняя версия).
  • Чтобы развернуть приложение на устройстве Android:
    • Android API уровня 24 или более поздней версии.
  • Чтобы развернуть приложение на устройстве iOS:
    • Целевая платформа iOS 15.0 или более поздней версии.
    • Для работы с последней версией SDK Meta Audience Network обычно требуется последняя версия Xcode.
  • Рабочий проект Unity, настроенный с помощью Google Mobile Ads Unity Plugin. Подробная информация приведена в статье Как настроить Google Mobile Ads Unity Plugin.
  • Настройте медиацию.

Шаг 1. Настройте конфигурации в интерфейсе Meta Audience Network

Зарегистрируйтесь и войдите на стартовую страницу Менеджера компании.

Нажмите Начать, а затем Создать новый аккаунт.

Заполните обязательные поля с информацией о компании и нажмите Далее.

Создание ресурса

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

Затем выберите платформу, на которой хотите монетизировать контент.

Укажите информацию о приложении и нажмите Далее.

Android

iOS

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

Выберите Google Менеджер рекламы в качестве платформы медиации и нажмите Создать место размещения.

Выберите формат, заполните форму и нажмите Создать.

Запишите идентификатор места размещения.

Нажмите Готово.

Как обновить файл app-ads.txt

Authorized Sellers for Apps (Авторизованные продавцы приложений), или app-ads.txt, – это инициатива IAB Tech Lab, которая позволяет издателям указывать авторизованных продавцов своего рекламного инвентаря. Чтобы избежать значительного снижения дохода от рекламы, используйте файл app-ads.txt. Если вы ещё этого не сделали, создайте файл app-ads.txt для Менеджера рекламы.

Чтобы реализовать app-ads.txt для Meta Audience Network, ознакомьтесь с инструкциями по идентификации авторизованных продавцов с помощью файла app-ads.txt.

Как включить режим тестирования

Подробные инструкции по включению тестовых объявлений Meta Audience Network приведены в руководстве по тестированию реализации Audience Network.

Шаг 2. Настройте источник спроса Meta Audience Network в интерфейсе Менеджера рекламы

Как настроить медиацию для рекламного блока

Android

Инструкции приведены в разделе "Шаг 2" Android.

iOS

Инструкции приведены в разделе "Шаг 2" руководства для iOS.

Как добавить Meta в список рекламных партнеров для GDPR и законов штатов США

Чтобы добавить Meta в список рекламных партнеров для соблюдения европейских регламентов и законов штатов США, следуйте инструкциям в разделах Настройки, необходимые по европейским регламентам и Настройки, необходимые по законам штатов США.

Шаг 3. Импортируйте SDK и адаптер Meta Audience Network

OpenUPM-CLI

Если у вас установлен OpenUPM-CLI, вы можете добавить в проект плагин медиации Google Mobile Ads Meta Audience Network для Unity, выполнив следующую команду из корневого каталога проекта:

openupm add com.google.ads.mobile.mediation.metaaudiencenetwork

OpenUPM

В редакторе проекта Unity выберите Edit (Правка) > Project Settings (Настройки проекта) > Package Manager (Менеджер пакетов), чтобы открыть настройки менеджера пакетов Unity.

На вкладке Scoped Registries (Реестры с областью действия) добавьте OpenUPM в качестве реестра с областью действия, указав следующие сведения:

  • Название: OpenUPM
  • URL: https://package.openupm.com
  • Области действия: com.google

Подробности OpenUPM

Затем выберите Window (Окно) > Package Manager (Менеджер пакетов), чтобы открыть Unity Package Manager (Менеджер пакетов Unity), и в раскрывающемся меню выберите My Registries (Мои реестры).

Реестры Unity

Выберите пакет Google Mobile Ads MetaAudienceNetwork Mediation и нажмите Install (Установить).

Установка из OpenUPM

Пакет Unity

Скачайте последнюю версию плагина медиации Google Mobile Ads для Meta Audience Network по ссылке в журнале изменений и извлеките файл GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage из ZIP-архива.

В редакторе проекта Unity выберите Assets (Объекты) > Import Package (Импортировать пакет) > Custom Package (Специальный пакет) и найдите скачанный файл GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage. Убедитесь, что выбраны все файлы, и нажмите Импортировать.

Импорт из Unity

Затем выберите Assets (Ресурсы) > External Dependency Manager (Менеджер внешних зависимостей) > Android Resolver (Решатель Android) > Force Resolve (Принудительное разрешение). Библиотека External Dependency Manager выполнит разрешение зависимостей с нуля и скопирует объявленные зависимости в каталог Assets/Plugins/Android приложения Unity.

Принудительное разрешение

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

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

Ознакомьтесь с рекомендациями Meta, чтобы узнать больше о GDPR и рекламе в Meta.

Законы штатов США о конфиденциальности

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

Для пользователей из Калифорнии ознакомьтесь с вариантами обработки данных от Meta.

Шаг 5. Добавьте обязательный код

Android

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

iOS

Интеграция с SKAdNetwork

Следуйте инструкциям Meta Audience Network, чтобы добавить идентификаторы SKAdNetwork в файл Info.plist проекта.

Отслеживание рекламы включено

Если вы разрабатываете приложение для iOS 14 или более поздней версии, ознакомьтесь с инструкциями по настройке флага отслеживания рекламы в сети Meta Audience Network.

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

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

Зарегистрируйте тестовое устройство в Менеджере рекламы и включите тестовый режим в интерфейсе Meta Audience Network.

Как проверить тестовые объявления

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

Необязательные действия

Кеширование в Android 9

Android

В Android 9 (уровень API 28) и более поздних версиях поддержка открытого текста отключена по умолчанию. Это повлияет на работу кеширования медиаконтента в SDK Meta Audience Network и может сказаться на удобстве использования приложения и доходе от рекламы. Чтобы изменить конфигурацию безопасности сети в приложении, следуйте инструкциям Meta.

iOS

Неприменимо к интеграциям с iOS.

Коды ошибок

Если адаптеру не удается получить объявление из Audience Network, вы можете проверить основную ошибку в ответе на запрос объявления с помощью ResponseInfo в следующих классах:

Android

com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter

iOS

GADMAdapterFacebook
GADMediationAdapterFacebook

Ниже приведены коды и сообщения, которые адаптер Meta Audience Network возвращает, когда не удается загрузить объявление:

Android

Код ошибки Причина
101 Недопустимые параметры сервера (например, отсутствует идентификатор места размещения).
102 Запрошенный размер объявления не соответствует поддерживаемому размеру баннера в Meta Audience Network.
103 Издатель должен запрашивать объявления в контексте Activity.
104 Не удалось инициализировать SDK Meta Audience Network.
105 Издатель не запросил объединенные нативные объявления.
106 Загруженное нативное объявление отличается от ожидаемого.
107 Используемый объект Context недопустим.
108 В загруженном объявлении отсутствуют необходимые объекты нативного объявления.
109 Не удалось создать нативное объявление на основе полезной нагрузки ставки.
110 Не удалось показать межстраничное объявление или объявление с вознаграждением из Meta Audience Network SDK.
111 Исключение, возникшее при создании объекта Meta Audience Network AdView.
1000-9999 Meta Audience Network вернула ошибку, связанную с SDK. Подробная информация приведена в документации Meta Audience Network.

iOS

Код ошибки Причина
101 Недопустимые параметры сервера (например, отсутствует идентификатор места размещения).
102 Запрошенный размер объявления не соответствует поддерживаемому размеру баннера в Meta Audience Network.
103 Не удалось инициализировать объект объявления Meta Audience Network.
104 Не удалось показать межстраничное объявление или объявление с вознаграждением из Meta Audience Network SDK.
105 Корневой контроллер представления баннера – nil.
106 Не удалось инициализировать SDK Meta Audience Network.
1000-9999 Meta Audience Network вернула ошибку, связанную с SDK. Подробная информация приведена в документации Meta Audience Network.

Журнал изменений плагина медиации Meta Audience Network для Unity

Версия 3.20.1

Версия 3.20.0

Версия 3.19.0

Версия 3.18.7

Версия 3.18.6

Версия 3.18.5

Версия 3.18.4

Версия 3.18.3

Версия 3.18.2

Версия 3.18.1

Версия 3.18.0

Версия 3.17.3

Версия 3.17.2

Версия 3.17.1

Версия 3.17.0

Версия 3.16.0

Версия 3.15.0

Версия 3.14.0

Версия 3.13.1

Версия 3.13.0

Версия 3.12.2

Версия 3.12.1

Версия 3.12.0

Версия 3.11.0

Версия 3.10.0

Версия 3.9.1

Версия 3.9.0

Версия 3.8.0

Версия 3.7.0

Версия 3.6.1

Версия 3.6.0

Версия 3.5.0

Версия 3.4.0

Версия 3.3.2

Версия 3.3.1

Версия 3.3.0

Версия 3.2.0

Версия 3.1.0

Версия 3.0.0

Версия 2.12.0

Версия 2.11.1

Версия 2.11.0

Версия 2.10.0

Версия 2.9.2

Версия 2.9.1

Версия 2.9.0

Версия 2.8.1

Версия 2.8.0

Версия 2.7.1 (устаревшая, используйте версию 2.8.0 или более новую)

Версия 2.7.0 (устаревшая, используйте версию 2.8.0 или более новую)

Версия 2.6.1 (устаревшая, используйте версию 2.8.0 или более новую)

Версия 2.6.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

  • Обновлен плагин для поддержки нового 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.

Версия 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.