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

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

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

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

Адаптер медиации Ad Manager для Meta Audience Network обладает следующими возможностями:

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

1. Meta Audience Network перешла на систему торгов только в 2021 году.

Требования

  • Новейший SDK для мобильной рекламы Google
  • Flutter 3.7.0 или выше
  • Для развертывания на Android
    • Android API уровня 23 или выше
  • Для развертывания на iOS
    • Целевая версия iOS для развертывания — 10.0 или выше.
    • Для работы последней версии Meta Audience Network SDK обычно требуется последняя версия Xcode.
  • Рабочий проект Flutter, настроенный с использованием Google Mobile Ads SDK. Подробности см. в разделе «Начало работы» .
  • Заполните руководство по началу медиации.

Шаг 1: Настройка параметров в пользовательском интерфейсе Meta Audience Network.

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

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

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

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

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

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

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

Android

iOS

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

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

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

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

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

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

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

Для интеграции файла app-ads.txt с Meta Audience Network см. раздел «Идентификация авторизованных продавцов с помощью app-ads.txt» .

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

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

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

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

Android

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

iOS

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

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

Чтобы добавить Meta в список рекламных партнеров, соответствующих европейским и американским государственным нормативным требованиям, в пользовательском интерфейсе Ad Manager, выполните действия, описанные в настройках европейских и американских нормативных требований .

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

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

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

dependencies:
  gma_mediation_meta: ^1.5.0

Ручная интеграция

Загрузите последнюю версию плагина медиации 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 или других локальных хранилищ, если это требуется по закону, а также на сбор, передачу и использование персональных данных для персонализации рекламы. Данная политика отражает требования Директивы ЕС о защите конфиденциальности в электронных коммуникациях (ePrivacy Directive) и Общего регламента по защите данных (GDPR). Вы несете ответственность за проверку того, что согласие передается каждому источнику рекламы в вашей цепочке посредничества. Google не может автоматически передавать выбор согласия пользователя таким сетям.

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

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

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

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

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

Android

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

iOS

Интеграция SKAdNetwork

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

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

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

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

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

Убедитесь, что вы зарегистрировали свое тестовое устройство в Ad Manager и включили тестовый режим в пользовательском интерфейсе 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 Издатель не запрашивал размещение нативной рекламы 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.

Список изменений адаптера Flutter Mediation для Meta Audience Network

Версия 1.4.2 (в разработке)

Версия 1.4.1

Версия 1.4.0

Версия 1.3.0

Версия 1.2.0

Версия 1.1.0

Версия 1.0.1

  • Добавлен класс Dart для корректного анализа совместимости с хост-платформами.
  • Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 5.1.0.

Версия 1.0.0

  • Первый релиз.
  • Разработано и протестировано с использованием плагина Google Mobile Ads Flutter версии 5.0.0.