В этом руководстве показано, как использовать 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 году.
Требования
- Последняя версия Google Mobile Ads SDK
- Флаттер 3.7.0 или выше
- Развертывание на Android
- Android API уровня 21 или выше
- Развертывание на iOS
- Цель развертывания iOS 10.0 или выше
- Для последней версии Meta Audience Network SDK обычно требуется последняя версия Xcode.
- Рабочий Flutter проект, настроенный с помощью Google Mobile Ads SDK. Подробности см. в разделе « Начало работы ».
- Пройдите руководство по началу работы с медиацией
Шаг 1. Настройте конфигурации в пользовательском интерфейсе Meta Audience Network.
Зарегистрируйтесь и войдите на стартовую страницу Бизнес-Менеджера .
Нажмите «Начать», затем «Создать новую учетную запись» .
Заполните необходимые поля сведениями о своей компании и нажмите «Далее» .
Создать свойство
После того как вы заполнили необходимую информацию, вам будет предложено создать свойство для вашего приложения. Введите желаемое имя свойства для вашего приложения и нажмите «Далее» .
Затем выберите платформу для монетизации.
Добавьте сведения о своем приложении и нажмите «Далее» .
Андроид
iOS
Настройте свой платежный счет, нажав Добавить новый платежный счет . Вы будете перенаправлены на новую страницу для ввода платежной информации. Заполните необходимые данные, затем нажмите «Далее» .
Выберите Google AdMob в качестве платформы медиации , затем нажмите «Создать место размещения» .
Выберите формат, заполните форму и нажмите «Создать» .
Обратите внимание на идентификатор места размещения .
Нажмите Готово .
Включите тестовый режим
Подробные инструкции по включению тестовых объявлений Meta Audience Network см. в руководстве по внедрению Testing Audience Network .
Шаг 2. Настройте спрос Meta Audience Network в Ad Manager пользовательский интерфейс
Настройте параметры медиации для своего рекламного блока
Андроид
Инструкции см. в шаге 2 руководства поАндроид .
iOS
Инструкции см. в шаге 2 руководства поiOS .
Добавлять Facebook в соответствии с GDPR и списком рекламных партнеров США.
Следуйте инструкциям в настройках GDPR и настройках законодательства штата США , чтобы добавить Meta в список рекламных партнеров GDPR и законодательства штата США в пользовательском интерфейсе AdMob.
Шаг 3. Импортируйте SDK и адаптер Meta Audience Network.
Интеграция через pub.dev
Добавьте следующую зависимость с последними версиямиMeta Audience Network SDK и адаптер в файле pubspec.yaml вашего пакета:
dependencies:
gma_mediation_meta: ^1.0.0
Ручная интеграция
Загрузите последнюю версию плагина медиации Google Mobile Ads дляMeta Audience Network , извлеките загруженный файл и добавьте извлеченную папку плагина (и ее содержимое) в свой проект Flutter. Затем укажите ссылку на плагин в файле pubspec.yaml , добавив следующую зависимость:
dependencies:
gma_mediation_meta:
path: path/to/local/package
Шаг 4. Реализуйте настройки конфиденциальности в Meta Audience Network SDK.
Согласие ЕС и GDPR
В соответствии с Политикой согласия пользователей Google из ЕС вы должны гарантировать, что пользователям в Европейской экономической зоне (ЕЭЗ) будет предоставлена определенная информация и получено от них согласие на использование идентификаторов устройств и личных данных. Эта политика отражает требования Директивы ЕС об электронной конфиденциальности и Общего регламента защиты данных (GDPR). При запросе согласия вы должны указать каждую рекламную сеть в вашей цепочке посредничества, которая может собирать, получать или использовать персональные данные, а также предоставлять информацию об использовании каждой сети. В настоящее время Google не может автоматически передавать выбор согласия пользователя в такие сети.
Ознакомьтесь с руководством Meta для получения информации о GDPR и мета-рекламе.
Законы о конфиденциальности штатов США
Законы о конфиденциальности штатов США требуют предоставления пользователям права отказаться от «продажи» их «личной информации» (согласно определению этих условий в законе), при этом отказ предлагается через заметную ссылку «Не продавать мою личную информацию» на странице «продажа». " Домашняя страница партии. Руководство по соблюдению законов о конфиденциальности штатов США предлагает возможность включить ограниченную обработку данных для показа рекламы 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 | SDK Meta Audience Network не смог представить межстраничную рекламу или рекламу с вознаграждением. |
| 111 | Исключение, возникающее при создании объекта AdView Meta Audience Network. |
| 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 | Не удалось инициализировать Meta Audience Network SDK. |
| 1000-9999 | Сеть Meta Audience Network вернула ошибку, связанную с SDK. Дополнительную информацию см. в документации Meta Audience Network. |
Журнал изменений адаптера Flutter Mediation Meta Audience Network
Следующая версия
- Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.2.0.
1.1.0
- Проверенная совместимость с адаптером Meta Android версии 6.17.0.0.
- Проверенная совместимость с адаптером Meta iOS версии 6.15.2.0.
- Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.1.0.
1.0.1
- Добавлен класс dart, позволяющий правильно анализировать совместимость с хост-платформами.
- Проверенная совместимость с адаптером Meta Android версии 6.17.0.0.
- Проверенная совместимость с адаптером Meta iOS версии 6.15.0.0.
- Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.1.0.
1.0.0
- Первоначальный выпуск.
- Проверенная совместимость с адаптером Meta Android версии 6.17.0.0.
- Проверенная совместимость с адаптером Meta iOS версии 6.15.0.0.
- Создано и протестировано с помощью плагина Google Mobile Ads Flutter версии 5.0.0.