Интегрируйте сеть метааудитории со ставками

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

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

Адаптер медиации Ad Manager для 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

Зарегистрируйтесь и войдите на стартовую страницу Business Manager .

Нажмите «Начать», а затем «Создать новую учетную запись» .

Заполните обязательные поля данными о вашей компании и нажмите «Далее» .

Создать недвижимость

После заполнения необходимой информации вам будет предложено создать свойство для вашего приложения. Введите желаемое имя свойства для вашего приложения и нажмите «Далее» .

Далее выберите платформу для монетизации.

Добавьте данные о вашем приложении и нажмите «Далее» .

Андроид

iOS

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

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

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

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

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

Обновите файл app-ads.txt

Файл app-ads.txt для авторизованных продавцов приложений — это инициатива IAB Tech Lab, которая помогает гарантировать, что ваш рекламный инвентарь в приложении будет продаваться только через каналы, которые вы указали как авторизованные. Чтобы предотвратить значительную потерю дохода от рекламы, вам необходимо внедрить файл app-ads.txt . Если вы ещё этого не сделали, создайте файл app-ads.txt для Менеджера рекламы .

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

Включить тестовый режим

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

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

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

Андроид

Инструкции см. в шаге 2 руководства для Android .

iOS

Инструкции см. в шаге 2 руководства для iOS .

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

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

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

OpenUPM-CLI

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

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

OpenUPM

В редакторе проектов Unity выберите Правка > Настройки проекта > Менеджер пакетов , чтобы открыть настройки менеджера пакетов Unity .

На вкладке Scoped Registries добавьте OpenUPM как scoped registry со следующими данными:

  • Имя: OpenUPM
  • URL-адрес: https://package.openupm.com
  • Область(ы): com.google

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

Затем перейдите в Окно > Диспетчер пакетов , чтобы открыть диспетчер пакетов Unity, и выберите Мои реестры в раскрывающемся меню.

Реестры Unity

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

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

Пакет Unity

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

В редакторе проекта Unity выберите «Активы» > «Импорт пакета» > «Пользовательский пакет» и найдите загруженный вами файл GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage . Убедитесь, что выбраны все файлы, и нажмите «Импорт» .

Импорт из Unity

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

Сила Решения

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

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

Ознакомьтесь с руководством Meta для получения информации о GDPR и рекламе Meta.

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

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

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

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

Андроид

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

iOS

Интеграция SKAdNetwork

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

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

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

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

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

Обязательно зарегистрируйте свое тестовое устройство в Ad Manager и включите тестовый режим в пользовательском интерфейсе 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 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 Не удалось инициализировать Meta Audience Network SDK.
1000-9999 Meta Audience Network вернула ошибку, связанную с SDK. Подробнее см. в документации Meta Audience Network.

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

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

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

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