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

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

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

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

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

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

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

Требования

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

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

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

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

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

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

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

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

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

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

Android

iOS

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

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

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

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

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

Как обновить файл 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 в интерфейсе AdMob

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

Android

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

iOS

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

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

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

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

Интеграция через pub.dev

Добавьте в файл pubspec.yaml пакета следующую зависимость с последними версиями SDK и адаптера Meta Audience Network:

dependencies:
  gma_mediation_meta: ^1.7.1

Интеграция с настройкой вручную

Скачайте последнюю версию плагина медиации Google Mobile Ads для Meta Audience Network, извлеките скачанный файл и добавьте извлеченную папку плагина (и ее содержимое) в проект Flutter. Затем добавьте в файл pubspec.yaml следующую зависимость:

dependencies:
  gma_mediation_meta:
    path: path/to/local/package

Шаг 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. Проверьте реализацию

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

Зарегистрируйте тестовое устройство в AdMob и включите тестовый режим в интерфейсе 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 для Flutter

Версия 1.7.1

Версия 1.7.0

Версия 1.6.0

Версия 1.5.4

Версия 1.5.3

Версия 1.5.2

Версия 1.5.1

Версия 1.5.0

Версия 1.4.3

Версия 1.4.2

Версия 1.4.1

Версия 1.4.0

Версия 1.3.0

Версия 1.2.0

Версия 1.1.0

Версия 1.0.1

Версия 1.0.0