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

Выберите платформу: AndroidНовый Android iOS Unity Flutter

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

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

The Ad Manager mediation adapter for Meta Audience Network has the following capabilities:

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

1 Meta Audience Network became bidding only in 2021.
2. Meta Audience Network не поддерживает адаптивные баннеры с привязкой к определенной точке и встроенные баннеры.

Требования

  • Новейший Google Mobile Ads Unity Plugin
  • Unity 5.6 или выше
  • Google Mobile Ads mediation plugin for Meta Audience Network 2.11.0 ( latest version recommended )
  • Для развертывания на Android
    • Android API уровня 23 или выше
  • Для развертывания на iOS
    • Целевая версия iOS для развертывания — 10.0 или выше.
    • The latest Meta Audience Network SDK usually requires the latest version of Xcode.
  • A working Unity project configured with Google Mobile Ads Unity Plugin . See Set up Google Mobile Ads Unity Plugin for details.
  • Организуйте посредничество .

Step 1: Set up configurations in Meta Audience Network UI

Sign up and log in to the Business Manager Start page .

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

Fill out the required fields with your business details and click Next .

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

After you've filled out the required information, you're prompted to create a property for your app. Enter the desired name of the property for your app and click Next .

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

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

Android

iOS

Set up your payment account by clicking Add a new payment account . You will be redirected to a new page to enter your payment information. Fill out the necessary details, then click Next .

Select Google Ad Manager as the Mediation platform , then click Create placement .

Select a format, fill out the form and click Create .

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

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

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

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

To implement app-ads.txt for Meta Audience Network, see Identifying Authorized Sellers with app-ads.txt .

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

See the Testing Audience Network Implementation guide for detailed instructions on how to enable Meta Audience Network test ads.

Step 2: Set up Meta Audience Network demand in Ad Manager UI

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

Android

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

iOS

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

Add Meta to GDPR and US state regulations ad partners list

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.

Step 3: Import the Meta Audience Network SDK and adapter

OpenUPM-CLI

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

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

OpenUPM

In your Unity project editor, select Edit > Project Settings > Package Manager to open the Unity Package Manager Settings .

Under the Scoped Registries tab, add OpenUPM as a scoped registry with the following details:

  • Имя: OpenUPM
  • URL: https://package.openupm.com
  • Область применения: com.google

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

Then, navigate to Window > Package Manager to open the Unity Package Manager and select My Registries from the drop-down menu.

Реестры единства

Select the Google Mobile Ads MetaAudienceNetwork Mediation package and click Install .

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

Пакет Unity

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

В редакторе проекта Unity выберите Assets > Import Package > Custom Package и найдите загруженный файл GoogleMobileAdsMetaAudienceNetworkMediation.unitypackage . Убедитесь, что все файлы выбраны, и нажмите Import .

Импорт из Unity

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

Силовое разрешение

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

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

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

Законы штатов США о защите частной жизни

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

For users in California, review Meta's data processing options .

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

Android

No additional code required for Meta Audience Network integration.

iOS

Интеграция SKAdNetwork

Follow Meta Audience Network's documentation to add the SKAdNetwork identifiers to your project's Info.plist file.

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

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

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

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

Make sure you register your test device for Ad Manager and enable test mode in Meta Audience Network UI.

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

Чтобы убедиться, что вы получаете тестовые объявления от 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 Издатель не запрашивал размещение нативной рекламы Unified.
106 Загруженная нативная реклама представляет собой объект, отличающийся от ожидаемого.
107 Используемый объект Context недействителен.
108 В загруженном объявлении отсутствуют необходимые элементы нативной рекламы.
109 Не удалось создать нативную рекламу на основе данных, полученных в результате размещения ставки.
110 SDK Meta Audience Network не смог отобразить их межстраничную/вознаграждаемую рекламу.
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 SDK Meta Audience Network не смог отобразить их межстраничную/вознаграждаемую рекламу.
105 Корневой контроллер представления баннерной рекламы равен nil .
106 Не удалось инициализировать SDK Meta Audience Network.
1000-9999 Сеть Meta Audience Network вернула ошибку, специфичную для SDK. Для получения более подробной информации см. документацию Meta Audience Network.

Список изменений плагина Meta Audience Network Unity Mediation

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