Интеграция Facebook Audience Network со ставками

Это руководство предназначено для издателей, которые хотят использовать Google Mobile Ads SDK для загрузки и отображения рекламы из сети Facebook Audience Network посредством торгов. В нем рассказывается, как интегрировать SDK и адаптер Facebook Audience Network в приложение Unity.

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

Адаптер посредничества AdMob для Facebook Audience Network имеет следующие возможности:

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

Требования

  • Юнити 5.6 или выше
  • Последняя версия Google Mobile Ads SDK
  • Плагин посредничества Google Mobile Ads для Facebook 2.11.0 или выше
  • Для развертывания на Android
    • Android API уровня 16 или выше
  • Для развертывания на iOS
    • Цель развертывания iOS 10.0 или выше
    • Для последней версии Facebook Audience Network SDK обычно требуется последняя версия Xcode.
  • Рабочий проект Unity, настроенный с помощью Google Mobile Ads SDK. Подробнее см. в разделе Начало работы .

Шаг 1. Настройте аудиторную сеть Facebook.

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

Нажмите Создать новую учетную запись Business Manager и заполните необходимые поля информацией о своей компании.

Создать ресурс Facebook

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

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

Укажите, запущено ли ваше приложение, и нажмите «Отправить» .

Андроид

iOS

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

Выберите Banner для всех размеров баннеров, в том числе для 300x250. Facebook не поддерживает формат отображения Medium Rectangle при торгах, но поддерживает баннер с гибкой шириной и высотой 50, 90 или 250 при использовании формата отображения Banner .

Если вы планируете интегрировать формат межстраничной рекламы с вознаграждением, соответствующий формат Facebook — Rewarded Video с вознаграждением.

На следующем шаге представлен обзор созданного вами места размещения. Обратите внимание на идентификатор места размещения в разделе « Добавить идентификатор места размещения ».

Шаг 2. Настройте параметры агрегатора для рекламного блока AdMob.

Вам необходимо добавить Facebook в конфигурацию агрегатора для вашего рекламного блока. Сначала войдите в свой аккаунт AdMob .

Андроид

Перейдите на вкладку Медиация . Если у вас есть существующая группа медиации, которую вы хотите изменить, нажмите на название этой группы медиации, чтобы изменить ее, и перейдите к разделу Добавить Facebook Audience Network в качестве источника рекламы .

Чтобы создать новую группу медиации, выберите «Создать группу медиации» .

Укажите формат объявления и платформу, затем нажмите «Продолжить » .

Дайте вашей группе медиации имя и выберите местоположения для таргетинга. Затем установите для группы медиации статус Enabled . Затем нажмите « Добавить рекламные блоки » , чтобы открыть окно выбора рекламных блоков.

Свяжите эту группу медиации с существующим рекламным блоком AdMob. Затем нажмите Готово . Теперь вы должны увидеть карточку рекламных блоков, заполненную выбранными вами рекламными блоками.

Добавьте Facebook Audience Network в качестве источника рекламы

На карточке « Источники рекламы » выберите « Добавить рекламную сеть» . Выберите Сеть аудитории Facebook (торги) . Введите идентификатор размещения , полученный в предыдущем разделе, и нажмите « Готово » .

Наконец, нажмите Сохранить .

iOS

Перейдите на вкладку Медиация . Если у вас есть существующая группа медиации, которую вы хотите изменить, нажмите на название этой группы медиации, чтобы изменить ее, и перейдите к разделу Добавить Facebook Audience Network в качестве источника рекламы .

Чтобы создать новую группу медиации, выберите «Создать группу медиации» .

Укажите формат объявления и платформу, затем нажмите «Продолжить » .

Дайте вашей группе медиации имя и выберите местоположения для таргетинга. Затем установите для группы медиации статус Enabled . Затем нажмите « Добавить рекламные блоки » , чтобы открыть окно выбора рекламных блоков.

Свяжите эту группу медиации с существующим рекламным блоком AdMob. Затем нажмите Готово .

Теперь вы должны увидеть карточку рекламных блоков, заполненную выбранными вами рекламными блоками.

Добавьте Facebook Audience Network в качестве источника рекламы

На карточке « Источники рекламы » выберите « Добавить рекламную сеть» . Выберите Сеть аудитории Facebook (торги) . Введите идентификатор размещения , полученный в предыдущем разделе, и нажмите « Готово » .

Наконец, нажмите Сохранить .

Использование объявлений с вознаграждением

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

Если вы не примените этот параметр, адаптер Facebook по умолчанию использует вознаграждение типа "" (пустая строка) со значением 1 . Facebook SDK не предоставляет конкретных значений вознаграждения за рекламу с вознаграждением.

Дополнительную информацию о настройке значений вознаграждения для рекламных блоков AdMob см. в разделе Создание рекламного блока .

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

Загрузите последнюю версию подключаемого модуля посредничества Google Mobile Ads для Facebook по ссылке для скачивания в журнале изменений и извлеките GoogleMobileAdsFacebookMediation.unitypackage из ZIP-файла.

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

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

Шаг 4: Требуется дополнительный код

Андроид

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

iOS

Интеграция SKAdNetwork

Facebook просит вас добавить следующие идентификаторы SKAdNetwork в файл Info.plist вашего проекта:

<array>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>v9wttpbfk9.skadnetwork</string>
    </dict>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>n38lu8286q.skadnetwork</string>
    </dict>
</array>

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

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

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

Подробные инструкции о том, как включить тестовую рекламу Facebook, см. в руководстве по внедрению Testing Audience Network . Затем вы можете использовать Mediation Test Suite , чтобы проверить правильность реализации.

Вот и все! Теперь у вас есть работающая интеграция посредничества с Audience Network Facebook.

Дополнительные шаги

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

Пожалуйста, ознакомьтесь с руководством Facebook для получения информации о GDPR и рекламе на Facebook.

Добавьте Facebook в список рекламных партнеров GDPR

Следуйте инструкциям в настройках GDPR, чтобы добавить Facebook в список рекламных партнеров GDPR в пользовательском интерфейсе AdMob.

CCPA

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

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

Добавить Facebook в список рекламных партнеров CCPA

Следуйте инструкциям в настройках CCPA, чтобы добавить Facebook в список рекламных партнеров CCPA в пользовательском интерфейсе AdMob.

Коды ошибок

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

Андроид

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

iOS

GADMAdapterFacebook
GADMediationAdapterFacebook

Вот коды и сопутствующие сообщения, выдаваемые адаптером Facebook Audience Network, когда объявление не загружается:

Андроид

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

iOS

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

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

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