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

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

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

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

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

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

Требования

  • Последняя версия Google Mobile Ads SDK
  • 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 .

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

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

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

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

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

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

Андроид

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

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

Андроид

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

iOS

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

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

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

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

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

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

dependencies:
  gma_mediation_meta: ^

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

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

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

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

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

Обязательно зарегистрируйте свое тестовое устройство в AdMob и включите тестовый режим в пользовательском интерфейсе 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.

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

Версия 1.4.1

Версия 1.4.0

Версия 1.3.0

Версия 1.2.0

Версия 1.1.0

Версия 1.0.1

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

Версия 1.0.0

  • Первоначальный выпуск.
  • Создано и протестировано с помощью плагина Flutter для Google Mobile Ads версии 5.0.0.