В этом руководстве показано, как использовать Google Mobile Ads SDK (Legacy) для загрузки и отображения объявлений из Meta Audience Network с помощью медиации , включая интеграцию с системой назначения ставок. В нем описано, как добавить Meta Audience Network в конфигурацию медиации рекламного блока, а также как интегрировать SDK и адаптер Meta Audience Network в приложение Android.
Поддерживаемые интеграции и форматы рекламы
Адаптер медиации для Meta Audience Network обладает следующими возможностями:
| Интеграция | |
|---|---|
| Торги | |
| Водопад 1 | |
| Форматы | |
| Баннер | |
| Интерстициальный | |
| Награжден | |
| Вознагражденный интерстициальный | |
| Родной | |
1. Meta Audience Network перешла на систему торгов только в 2021 году.
Предварительные требования
Прежде чем продолжить, проверьте следующее:
- Android API уровня 24 или более поздней версии.
- Адаптер Meta Audience Network версии 5.10.0.0 или более поздней ( рекомендуется последняя версия ).
Последняя версия Google Mobile Ads SDK (Legacy) .
Шаг 1: Настройка параметров в пользовательском интерфейсе Meta Audience Network.
Зарегистрируйтесь и войдите на стартовую страницу Business Manager .
Нажмите «Начать», затем «Создать новую учетную запись» .

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

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

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

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

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

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

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

Нажмите «Готово» .
Обновите файл 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.
Войдите в свой аккаунт в Ad Manager .
Включить безопасный обмен сигналами
Перейдите в раздел Администрирование > Глобальные настройки . Перейдите на вкладку настроек учетной записи Ad Exchange , просмотрите и включите параметр «Безопасный обмен сигналами» . Нажмите «Сохранить» .

Передайте защищенный сигнал в запросах на участие в торгах.
Перейдите в раздел «Инвентарь» > «Защищенные сигналы» . В разделе «Защищенные сигналы» найдите Facebook и включите опцию «Включить интеграцию с приложением» .

Нажмите « Сохранить ».
Обеспечьте безопасный обмен сигналами для торгов с использованием SDK.
Перейдите в раздел «Доставка» > «Настройки канала спроса» . На вкладке «Настройки по умолчанию» включите параметр «Разрешить безопасный обмен сигналами для торгов SDK» .

Нажмите « Сохранить ».
Настройка мета-торгов
Перейдите в раздел «Доставка» > «Участники торгов» и нажмите « Перейти к торгам SDK» .

Нажмите «Новый участник торгов» .

Выберите компанию Meta в качестве участника торгов.

Нажмите «Продолжить» , чтобы включить функцию «SDK Bidding» для этого участника торгов.

Нажмите «Готово» .
Настройка сопоставления рекламных блоков
Перейдите в раздел «Доставка» > «Участники торгов» и нажмите « Перейти к торгам SDK» .

Выберите компанию для Meta Audience Network.

Перейдите на вкладку «Сопоставление рекламных блоков» и нажмите «Создать новое сопоставление рекламных блоков» .

Выберите «Конкретный рекламный блок» . Выберите рекламный блок и формат, тип инвентаря — «Мобильное приложение» , и ваше мобильное приложение . Затем введите идентификатор размещения, полученный в предыдущем разделе.
Если вы настраиваете сопоставление рекламных блоков для межстраничной рекламы с вознаграждением в пользовательском интерфейсе Ad Manager, выберите формат «С вознаграждением» и используйте идентификатор размещения межстраничной рекламы с вознаграждением.
Наконец, нажмите «Сохранить» .

Добавить Meta в список рекламных партнеров, соответствующих GDPR и требованиям штатов США.
Чтобы добавить Meta в список рекламных партнеров, соответствующих европейским и американским государственным нормативным требованиям, в пользовательском интерфейсе Ad Manager, выполните действия, описанные в настройках европейских и американских нормативных требований .
Шаг 3: Импортируйте SDK и адаптер Meta Audience Network.
Интеграция с Android Studio (рекомендуется)
В файл gradle на уровне приложения добавьте следующие зависимости реализации:
Котлин
dependencies { implementation("com.google.android.gms:play-services-ads:25.5.0") implementation("com.google.ads.mediation:facebook:6.22.0.0") }
Классный
dependencies { implementation 'com.google.android.gms:play-services-ads:25.5.0' implementation 'com.google.ads.mediation:facebook:6.22.0.0' }
Ручная интеграция
Загрузите последнюю версию SDK Meta Audience Network для Android . Распакуйте файл
AudienceNetwork.aarв папкуAudienceNetwork/binи добавьте его в свой проект.Перейдите к артефактам адаптера Meta Audience Network в репозитории Maven Google. Выберите последнюю версию, загрузите файл
.aarадаптера Meta Audience Network и добавьте его в свой проект.
Шаг 4: Внедрите настройки конфиденциальности в SDK Meta Audience Network.
Согласие ЕС и GDPR
В соответствии с Политикой Google по согласию пользователей в ЕС , вы должны предоставлять пользователям в Европейской экономической зоне (ЕЭЗ), Великобритании и Швейцарии определенную информацию и получать их согласие на использование файлов cookie или других локальных хранилищ, если это требуется по закону, а также на сбор, передачу и использование персональных данных для персонализации рекламы. Данная политика отражает требования Директивы ЕС о защите конфиденциальности в электронных коммуникациях (ePrivacy Directive) и Общего регламента по защите данных (GDPR). Вы несете ответственность за проверку того, что согласие передано каждому источнику рекламы в вашей цепочке медиации.
Meta не зарегистрирована в Глобальном списке поставщиков IAB Europe (GVL). Вместо этого вам необходимо использовать техническую спецификацию «Дополнительное согласие» . Подробнее см. в разделе «Компоненты дополнительного согласия» . Спецификация «Дополнительное согласие» работает совместно с IAB Europe Transparency & Consent Framework (TCF) версии 2. Эта спецификация позволяет вам, а также вашим платформам управления согласием (CMP) и партнерам, собирать и передавать сигналы дополнительного согласия для компаний, включенных в список поставщиков рекламных технологий Google (ATP), но еще не входящих в IAB Europe GVL.
Следуйте инструкциям в документации Meta по GDPR и рекламе на Meta.
Законы штатов США о защите частной жизни
Законы США о защите конфиденциальности требуют предоставления пользователям права отказаться от «продажи» их «личной информации» (как это определено в законе), при этом отказ предлагается через заметную ссылку «Не продавать мою личную информацию» на главной странице «продающей» стороны. Руководство по соблюдению законов США о защите конфиденциальности предлагает возможность включения ограниченной обработки данных для показа рекламы Google, но Google не может применить эту настройку к каждой рекламной сети в вашей цепочке посредничества. Поэтому вы должны определить каждую рекламную сеть в вашей цепочке посредничества, которая может участвовать в продаже личной информации, и следовать указаниям каждой из этих сетей для обеспечения соответствия требованиям.
Для получения информации о вариантах обработки данных для пользователей из Калифорнии следуйте инструкциям в документации Meta .
Шаг 5: Добавьте необходимый код
Для интеграции с Meta Audience Network дополнительный код не требуется.
Шаг 6: Протестируйте свою реализацию.
Включить тестовые объявления
Убедитесь, что вы зарегистрировали свое тестовое устройство в Ad Manager и включили тестовый режим в пользовательском интерфейсе Meta Audience Network.
Проверить тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от Meta Audience Network, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений Meta Audience Network (для торгов ).
Дополнительные шаги
Нативная реклама
Некоторые рекламные ресурсы Meta Audience Network не соответствуют напрямую рекламным ресурсам Google. Такие ресурсы передаются издателю в пакете через метод getExtras() в NativeAd . Адаптер поддерживает передачу следующих ресурсов:
| Запрос параметров и значений | |
|---|---|
FacebookMediationAdapter.KEY_ID | Строка . Уникальный идентификатор нативной рекламы. |
FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET | Строка . Социальный контекст рекламы. |
Вот пример кода, демонстрирующий, как извлечь эти ресурсы:
Пример:
Java
Bundle extras = nativeAd.getExtras();
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
String socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET);
// ...
}
Котлин
val extras = nativeAd.getExtras()
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
val socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)
// ...
}
Использование нативной рекламы Meta Audience Network без MediaView
Для отображения нативной рекламы в Meta Audience Network требуется использовать ресурс MediaView . Если вы планируете отображать нативную рекламу без этого ресурса, обязательно используйте формат нативной баннерной рекламы Meta Audience Network.
Чтобы использовать нативные баннерные объявления Meta Audience Network, необходимо выбрать формат Native Banner при настройке Meta Audience Network , и адаптер автоматически загрузит соответствующий формат нативной рекламы.
Отображение рекламы
Адаптер Audience Network возвращает свои нативные объявления в виде объектов NativeAd . Он заполняет следующие поля для объекта NativeAd .
| Поле | Заполняется адаптером Meta Audience Network. |
|---|---|
| Заголовок | |
| Изображение | 1 |
| Тело | |
| значок приложения | |
| Призыв к действию | |
| Название рекламодателя | |
| Звездный рейтинг | |
| Магазин | |
| Цена |
1. Адаптер Meta Audience Network не предоставляет прямого доступа к основному графическому ресурсу для своих нативных объявлений. Вместо этого адаптер заполняет MediaView видео или изображением.
Отслеживание показов и кликов
В таблице ниже показано, когда показы и клики по нативной рекламе регистрируются с помощью Google Mobile Ads SDK (Legacy) .
| Запись впечатлений | Запись щелчка |
|---|---|
| 1 пиксель нативного рекламного элемента Meta Audience Network на экране + требования к рендерингу элемента | Обратный вызов SDK Meta Audience Network |
В Meta Audience Network существуют определенные требования к отображению контента для того, чтобы показ считался действительным, в зависимости от того, выбрали ли вы формат Native или Native Banner при настройке Meta Audience Network .
| собственный формат Meta Audience Network | Необходимый актив | Требуемый класс рендеринга |
|---|---|---|
| Родной | Просмотр медиафайлов | MediaView |
| Родной баннер | значок приложения | ImageView |
Кэширование на Android 9
Начиная с Android 9 (уровень API 28), поддержка открытого текста отключена по умолчанию , что повлияет на функциональность кэширования медиафайлов в SDK Meta Audience Network и может сказаться на удобстве использования и доходе от рекламы. Следуйте документации Meta , чтобы обновить конфигурацию сетевой безопасности в вашем приложении.
коды ошибок
Если адаптер не получает объявление от Audience Network, вы можете проверить основную причину ошибки в ответе на объявление, используя ResponseInfo.getAdapterResponses() из следующих классов:
com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter
Вот коды и соответствующие сообщения, которые выдает адаптер Audience Network, когда реклама не загружается:
| Код ошибки | Причина |
|---|---|
| 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. |
Список изменений адаптера Meta Audience Network для Android.
Версия 6.22.0.1 (в разработке)
- Зафиксируйте зависимость адаптера от Kotlin на версии 1.9.0 (минимальная версия Kotlin, поддерживаемая GMA NextGen SDK).
- Обновлено: теперь при регистрации показов нативной рекламы Meta отображает именно этот контент.
Версия 6.22.0.0
- Подтверждена совместимость с Meta Audience Network SDK версии 6.22.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 25.4.0.
- Google Mobile Ads Next-Gen SDK версии 1.3.0.
- Версия SDK Meta Audience Network: 6.22.0.
Версия 6.21.0.4
- Сопоставляет параметр
AgeRestrictedTreatmentс настройками смешанной аудитории Meta Audience Network. - Исправлена проблема утечки памяти в межстраничной рекламе.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 25.4.0.
- Google Mobile Ads Next-Gen SDK версии 1.2.1.
- Версия SDK Meta Audience Network: 6.21.0.
Версия 6.21.0.3
- Обновлена реализация нативной рекламы для использования обновленного API
NativeAdMapper. - При вызове
untrackViewдля освобождения ресурсов необходимо уничтожитьNativeAdBaseиMediaView.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 25.2.0.
- Google Mobile Ads Next-Gen SDK версия 0.25.0-beta01.
- Версия SDK Meta Audience Network: 6.21.0.
Версия 6.21.0.2
- Добавлено свойство для сборки адаптера с зависимостью от GMA Next-Gen SDK.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 25.1.0.
- Версия SDK Meta Audience Network: 6.21.0.
Версия 6.21.0.1
- Добавлена поддержка пересылки параметра
tagForUnderAgeOfConsentиз Google Mobile Ads SDK в Meta Audience Network SDK.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 24.9.0.
- Версия SDK Meta Audience Network: 6.21.0.
Версия 6.21.0.0
- Подтверждена совместимость с Meta Audience Network SDK версии 6.21.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 24.7.0.
- Версия SDK Meta Audience Network: 6.21.0.
Версия 6.20.0.2
- Удалены ссылки на объекты
Contextна уровне класса для решения проблем с утечками памяти.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 24.7.0.
- Версия SDK Meta Audience Network: 6.20.0.
Версия 6.20.0.1
- Удалена проверка, из-за которой инициализация завершалась неудачей, если отсутствовали идентификаторы размещения. Это сделано для обеспечения работы RTB даже в том случае, если издатель не определяет сопоставление рекламных блоков.
- Подтверждена совместимость с Meta Audience Network SDK версии 6.20.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 24.6.0.
- Версия SDK Meta Audience Network: 6.20.0.
Версия 6.20.0.0
- Подтверждена совместимость с Meta Audience Network SDK версии 6.20.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 24.2.0.
- Версия SDK Meta Audience Network: 6.20.0.
Версия 6.19.0.1
- Обновлен минимально необходимый уровень Android API до 23.
- Обновлена минимально необходимая версия Google Mobile Ads SDK до 24.0.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 24.0.0.
- Версия SDK Meta Audience Network: 6.19.0.
Версия 6.19.0.0
- Подтверждена совместимость с Meta Audience Network SDK версии 6.19.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 23.6.0.
- Версия SDK Meta Audience Network: 6.19.0.
Версия 6.18.0.0
- Подтверждена совместимость с Meta Audience Network SDK версии 6.18.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 23.3.0.
- Версия SDK Meta Audience Network: 6.18.0.
Версия 6.17.0.0
- Обновлена минимально необходимая версия Google Mobile Ads SDK до 23.0.0.
- Подтверждена совместимость с Meta Audience Network SDK версии 6.17.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 23.0.0.
- Версия SDK Meta Audience Network: 6.17.0.
Версия 6.16.0.0
- В адаптер внесены изменения, позволяющие вызывать метод MediationInterstitialAdCallback#onAdFailedToShow(), когда Meta SDK сообщает о неудачной попытке показа межстраничной рекламы.
- Подтверждена совместимость с Meta Audience Network SDK версии 6.16.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 22.3.0.
- Версия SDK Meta Audience Network: 6.16.0.
Версия 6.15.0.0
- Подтверждена совместимость с Meta Audience Network SDK версии 6.15.0.
- Обновлена минимально необходимая версия Google Mobile Ads SDK до 22.2.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 22.2.0.
- Версия SDK Meta Audience Network: 6.15.0.
Версия 6.14.0.0
- Подтверждена совместимость с Meta Audience Network SDK версии 6.14.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 22.0.0.
- Версия SDK Meta Audience Network: 6.14.0.
Версия 6.13.7.1
- Адаптер обновлен для использования нового класса
VersionInfo. - Обновлена минимально необходимая версия Google Mobile Ads SDK до 22.0.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 22.0.0.
- Версия SDK Meta Audience Network: 6.13.7.
Версия 6.13.7.0
- Подтверждена совместимость с Meta Audience Network SDK версии 6.13.7.
- Обновлена минимально необходимая версия Google Mobile Ads SDK до 21.5.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 21.5.0.
- Версия SDK Meta Audience Network: 6.13.7.
Версия 6.12.0.0
- Подтверждена совместимость с Meta Audience Network SDK версии 6.12.0.
- Обновлена минимально необходимая версия Google Mobile Ads SDK до 21.2.0.
- Переименование адаптера в "Meta Audience Network".
- Интеграция с водопадной диаграммой удалена.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 21.2.0.
- Версия SDK Meta Audience Network: 6.12.0.
Версия 6.11.0.1
- Обновлены
compileSdkVersionиtargetSdkVersionдо API 31. - Обновлена минимально необходимая версия Google Mobile Ads SDK до 21.0.0.
- Обновлен минимально необходимый уровень Android API до 19.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 21.0.0.
- Версия Facebook SDK: 6.11.0.
Версия 6.11.0.0
- Подтверждена совместимость с Facebook SDK версии 6.11.0.
- Добавлены предупреждающие сообщения об устаревании каскадной модели обработки событий. Подробнее см. в блоге Meta .
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 20.6.0.
- Версия Facebook SDK: 6.11.0.
Версия 6.10.0.0
- Подтверждена совместимость с Facebook SDK версии 6.10.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 20.6.0.
- Версия Facebook SDK: 6.10.0.
Версия 6.8.0.1
- Добавлена поддержка переадресации кликов и показов в объявлениях, участвующих в торгах.
- Добавлена поддержка переадресации вызова
onAdFailedToShow()в случае неудачной демонстрации межстраничных объявлений. - Обновлена минимально необходимая версия Google Mobile Ads SDK до 20.6.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 20.6.0.
- Версия SDK Facebook: 6.8.0.
Версия 6.8.0.0
- Подтверждена совместимость с Facebook SDK версии 6.8.0.
- Обновлена минимально необходимая версия Google Mobile Ads SDK до 20.4.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 20.4.0.
- Версия SDK Facebook: 6.8.0.
Версия 6.7.0.0
- Подтверждена совместимость с Facebook SDK версии 6.7.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 20.3.0.
- Версия Facebook SDK 6.7.0.
Версия 6.6.0.0
- Подтверждена совместимость с Facebook SDK версии 6.6.0.
- Обновлена минимально необходимая версия Google Mobile Ads SDK до 20.3.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 20.3.0.
- Версия Facebook SDK 6.6.0.
Версия 6.5.1.1
- Исправлена ошибка, появившаяся в версии 6.5.1.0, из-за которой вместо реальных объявлений отображались тестовые.
- Адаптер обновлен для использования нового API
AdError.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 20.2.0.
- Версия Facebook SDK 6.5.1.
Версия 6.5.1.0 (устарела)
- Обнаружена и подтверждена проблема в версии 6.5.1.0. Рекомендуется обновиться до версии 6.5.1.1.
- Подтверждена совместимость с Facebook SDK версии 6.5.1.
- Обновлена минимально необходимая версия Google Mobile Ads SDK до 20.2.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 20.2.0.
- Версия Facebook SDK 6.5.1.
Версия 6.5.0.0
- Подтверждена совместимость с Facebook SDK версии 6.5.0.
- Исправлена ошибка, из-за которой в нативных объявлениях отсутствовало изображение обложки Facebook.
- Обновлена минимально необходимая версия Google Mobile Ads SDK до 20.1.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 20.1.0.
- Версия SDK Facebook: 6.5.0.
Версия 6.4.0.0
- Подтверждена совместимость с Facebook SDK версии 6.4.0.
- Обновлена минимально необходимая версия Google Mobile Ads SDK до 20.0.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 20.0.0.
- Версия SDK Facebook: 6.4.0.
Версия 6.3.0.1
- Исправлена ошибка, из-за которой возникало исключение
ClassCastExceptionпри отображении нативной рекламы в приложениях, которые не используютImageViewдля отображения графических ресурсов.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 19.7.0.
- Версия SDK Facebook: 6.3.0.
Версия 6.3.0.0
- Подтверждена совместимость с Facebook SDK версии 6.3.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 19.7.0.
- Версия SDK Facebook: 6.3.0.
Версия 6.2.1.0
- Подтверждена совместимость с Facebook SDK версии 6.2.1.
- Обновлена минимально необходимая версия Google Mobile Ads SDK до 19.7.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 19.7.0.
- Версия Facebook SDK 6.2.1.
Версия 6.2.0.1
- Удалена поддержка устаревшего формата
NativeAppInstallAd. Приложениям следует запрашивать унифицированную нативную рекламу. - Обновлена минимально необходимая версия Google Mobile Ads SDK до 19.6.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 19.6.0.
- Версия Facebook SDK 6.2.0.
Версия 6.2.0.0
- Подтверждена совместимость с Facebook SDK версии 6.2.0.
- Обновлена минимально необходимая версия Google Mobile Ads SDK до 19.5.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 19.5.0.
- Версия Facebook SDK 6.2.0.
Версия 6.1.0.0
- Подтверждена совместимость с Facebook SDK версии 6.1.0.
- Обновлена минимально необходимая версия Google Mobile Ads SDK до 19.4.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 19.4.0.
- Версия Facebook SDK 6.1.0.
Версия 6.0.0.0
- Подтверждена совместимость с Facebook SDK версии 6.0.0.
- Обновлена минимально необходимая версия Google Mobile Ads SDK до 19.3.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 19.3.0.
- Версия Facebook SDK 6.0.0.
Версия 5.11.0.0
- Подтверждена совместимость с Facebook SDK версии 5.11.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 19.2.0.
- Версия Facebook SDK: 5.11.0.
Версия 5.10.1.0
- Подтверждена совместимость с Facebook SDK версии 5.10.1.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 19.2.0.
- Версия Facebook SDK: 5.10.1.
Версия 5.10.0.0
- Подтверждена совместимость с Facebook SDK версии 5.10.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 19.2.0.
- Версия Facebook SDK: 5.10.0.
Версия 5.9.1.0
- Подтверждена совместимость с Facebook SDK версии 5.9.1.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 19.2.0.
- Версия Facebook SDK: 5.9.1.
Версия 5.9.0.2
- Добавлена поддержка рекламного объявления с вознаграждением.
- Обновлен адаптер для поддержки запросов на адаптивные баннеры, отображаемые непосредственно в тексте.
- Исправлена ошибка, из-за которой баннерная реклама, на которую начислялись ставки, всегда отображалась во всю ширину экрана.
- Обновлена минимально необходимая версия Google Mobile Ads SDK до 19.2.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 19.2.0.
- Версия Facebook SDK: 5.9.0.
Версия 5.9.0.1
- Теперь адаптер отправляет сообщение об ошибке, если SDK FAN обнаруживает ошибку при показе межстраничной/вознаграждаемой рекламы.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 19.1.0.
- Версия Facebook SDK: 5.9.0.
Версия 5.9.0.0
- Подтверждена совместимость с Facebook SDK версии 5.9.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 19.1.0.
- Версия Facebook SDK: 5.9.0.
Версия 5.8.0.2
- Исправлена некорректная ссылка на переменную, которая приводила к сбою в некоторых сценариях при загрузке нативной рекламы.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 19.1.0.
- Версия Facebook SDK: 5.8.0.
Версия 5.8.0.1
- Добавлены дополнительные описательные коды ошибок и причины сбоев при загрузке/отображении адаптера.
- Обновлена минимально необходимая версия Google Mobile Ads SDK до 19.1.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 19.1.0.
- Версия Facebook SDK: 5.8.0.
Версия 5.8.0.0
- Подтверждена совместимость с Facebook SDK версии 5.8.0.
- Обновлена минимально необходимая версия Google Mobile Ads SDK до 19.0.1.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 19.0.1.
- Версия Facebook SDK: 5.8.0.
Версия 5.7.1.1
- Добавлена поддержка обработки ошибок адаптера Facebook Audience Network.
- Добавлены описательные коды ошибок и причины сбоев при загрузке/отображении адаптера.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 18.3.0.
- Версия Facebook SDK: 5.7.1.
Версия 5.7.1.0
- Подтверждена совместимость с Facebook SDK версии 5.7.1.
- Добавлена поддержка нативных баннерных объявлений Facebook при использовании системы назначения ставок.
- В нативной рекламе теперь для значка используется ресурс "Drawable".
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 18.3.0.
- Версия Facebook SDK: 5.7.1.
Версия 5.7.0.0
- Подтверждена совместимость с Facebook SDK версии 5.7.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 18.3.0.
- Версия Facebook SDK: 5.7.0.
Версия 5.6.1.0
- Подтверждена совместимость с Facebook SDK версии 5.6.1.
- Обновлена минимально необходимая версия Google Mobile Ads SDK до 18.3.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 18.3.0.
- Версия Facebook SDK: 5.6.1.
Версия 5.6.0.0
- Подтверждена совместимость с Facebook SDK версии 5.6.0.
- Обновлен адаптер Facebook для использования
AdChoicesView.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 18.2.0.
- Версия Facebook SDK: 5.6.0.
Версия 5.5.0.0
- Подтверждена совместимость с Facebook SDK версии 5.5.0.
Версия 5.4.1.1
- Исправлена ошибка, приводившая к сбою программы при удалении нативной рекламы.
Версия 5.4.1.0
- Подтверждена совместимость с Facebook SDK версии 5.4.1.
- Добавлена поддержка нативных баннерных объявлений Facebook для каскадной медиации.
- Используйте
setNativeBanner()из классаFacebookExtras, чтобы запросить показ нативных баннерных объявлений.
- Используйте
- Исправлена ошибка, из-за которой запросы на показ умных баннерных объявлений завершались с ошибкой.
- Исправлена ошибка, из-за которой в некоторых случаях, когда приложение находилось в фоновом режиме во время воспроизведения видео, рекламные ролики с вознаграждением не перенаправляли событие
onAdClosed(). - Перевел адаптер на
AndroidX. - Обновлена минимально необходимая версия Google Mobile Ads SDK до 18.1.1.
Версия 5.4.0.0
- Подтверждена совместимость с Facebook SDK версии 5.4.0.
Версия 5.3.1.2
- Исправлена ошибка, из-за которой инициализация торгов в Facebook завершалась с ошибкой «Идентификаторы размещения не найдены».
Версия 5.3.1.1
- Обновлено отслеживание показов нативных RTB-объявлений.
- Обновлена минимально необходимая версия Google Mobile Ads SDK до 17.2.1.
Версия 5.3.1.0
- В адаптер добавлена возможность назначения ставок для баннерной, межстраничной, рекламной и нативной рекламы.
- Подтверждена совместимость с Facebook SDK версии 5.3.1.
Версия 5.3.0.0
- Обновлено название службы медиации для мобильной рекламы Google.
- В вызов инициализации добавлена версия адаптера.
- Подтверждена совместимость с Facebook SDK версии 5.3.0.
Версия 5.2.0.2
- Добавлена поддержка гибких размеров баннерной рекламы.
Версия 5.2.0.1
- Обновлен адаптер для поддержки нового API с системой вознаграждений, находящегося в стадии открытого бета-тестирования.
- Обновлена минимально необходимая версия Google Mobile Ads SDK до 17.2.0.
Версия 5.2.0.0
- Подтверждена совместимость с Facebook SDK версии 5.2.0.
Версия 5.1.1.1
- В адаптер внесены изменения, позволяющие заполнять поле «Имя рекламодателя» для унифицированных нативных объявлений.
Версия 5.1.1.0
- Заменили представление AdChoices на представление AdOptions.
- Подтверждена совместимость с Facebook SDK версии 5.1.1.
Версия 5.1.0.1
- Исправлена ошибка ANR, вызванная функцией 'getGMSVersionCode()'.
Версия 5.1.0.0
- Инициализируйте SDK Facebook для каждого формата рекламы.
Версия 5.0.1.0
- Подтверждена совместимость с Facebook SDK версии 5.0.1.
Версия 5.0.0.1
- В адаптер внесены изменения, позволяющие создавать объект объявления с вознаграждением во время запроса объявления.
Версия 5.0.0.0
- Подтверждена совместимость с Facebook SDK версии 5.0.0.
Версия 4.99.3.0
- Подтверждена совместимость с Facebook SDK версии 4.99.3.
Версия 4.99.1.1
- Исправлена ошибка, из-за которой значок «Выбор рекламы» не отображался для объединенной нативной рекламы.
- Исправлена ошибка, из-за которой адаптер выдавал исключение при попытке загрузки изображений.
Версия 4.99.1.0
- Подтверждена совместимость с Facebook SDK версии 4.99.1.
Версия 4.28.2.1
- В адаптер внесены изменения, позволяющие вызывать событие
onRewardedVideoComplete()для показа рекламы.
Версия 4.28.2.0
- Подтверждена совместимость с Facebook SDK версии 4.28.2.
Версия 4.28.1.1
- Исправлена ошибка, из-за которой клики не регистрировались для унифицированных нативных объявлений.
Версия 4.28.1.0
- Подтверждена совместимость с Facebook SDK версии 4.28.1.
Версия 4.28.0.0
- Подтверждена совместимость с Facebook SDK версии 4.28.0.
Версия 4.27.1.0
- Подтверждена совместимость с Facebook SDK версии 4.27.1.
Версия 4.27.0.0
- Подтверждена совместимость с Facebook SDK версии 4.27.0.
Версия 4.26.1.0
- Подтверждена совместимость с Facebook SDK версии 4.26.1.
- Обновлен проект адаптера для Android Studio 3.0.
Версия 4.26.0.0
- Добавлена поддержка видеорекламы с вознаграждением.
- Добавлена поддержка нативной видеорекламы.
- Подтверждена совместимость с Facebook SDK версии 4.26.0.
Версия 4.25.0.0
- Исправлена ошибка, из-за которой возвращались баннеры неправильного размера.
- Обновлена функция отслеживания просмотров в адаптере для нативной рекламы: теперь в SDK Facebook регистрируются просмотры отдельных элементов, а не всего объявления целиком. Это означает, что клики по фоновому изображению (или «пустому пространству») больше не будут приводить к переходу по ссылке.
- Подтверждена совместимость с Facebook SDK версии 4.25.0.
Версия 4.24.0.0
- Подтверждена совместимость с Facebook SDK версии 4.24.0.
Версия 4.23.0.0
- Подтверждена совместимость с Facebook SDK версии 4.23.0.
Версия 4.22.1.0
- Подтверждена совместимость с Facebook SDK версии 4.22.1.
Версия 4.22.0.0
- Обновил адаптер, чтобы обеспечить его совместимость с Facebook SDK версии 4.22.0.
Версия 4.21.1.0
- Подтверждена совместимость с Facebook SDK версии 4.21.1.
Версия 4.21.0.0
- Подтверждена совместимость с Facebook SDK версии 4.21.0.
Версия 4.20.0.0
- Обновлен минимальный поддерживаемый уровень Android API до 14+.
- Подтверждена совместимость с Facebook SDK версии 4.20.0.
Версия 4.19.0.0
- Подтверждена совместимость с Facebook SDK версии 4.19.0.
Версия 4.18.0.0
- Подтверждена совместимость с Facebook SDK версии 4.18.0.
Версия 4.17.0.0
- Добавлена поддержка нативной рекламы.
Версия 4.15.0.0
- Изменена система именования версий на [Версия FAN SDK].[Версия патча адаптера].
- Обновлена минимально необходимая версия FAN SDK до v4.15.0.
- Обновлена минимально необходимая версия Google Mobile Ads SDK до v9.2.0.
- Исправлена ошибка, из-за которой обработчики кликов Facebook для межстраничной рекламы некорректно перенаправлялись.
- Теперь адаптер также перенаправляет вызов функции onAdLeftApplication при нажатии на объявление.
Версия 1.2.0
- Исправлена ошибка, из-за которой AdSize.SMART_BANNER теперь является допустимым размером.
Версия 1.1.0
- Добавлена поддержка формата полной ширины x 250 при запросе AdSize.MEDIUM_RECTANGLE.
Версия 1.0.1
- Добавлена поддержка AdSize.SMART_BANNER
Версия 1.0.0
- Первый релиз
В этом руководстве показано, как использовать Google Mobile Ads SDK (Legacy) для загрузки и отображения объявлений из Meta Audience Network с помощью медиации , включая интеграцию с системой назначения ставок. В нем описано, как добавить Meta Audience Network в конфигурацию медиации рекламного блока, а также как интегрировать SDK и адаптер Meta Audience Network в приложение Android.
Поддерживаемые интеграции и форматы рекламы
Адаптер медиации для Meta Audience Network обладает следующими возможностями:
| Интеграция | |
|---|---|
| Торги | |
| Водопад 1 | |
| Форматы | |
| Баннер | |
| Интерстициальный | |
| Награжден | |
| Вознагражденный интерстициальный | |
| Родной | |
1. Meta Audience Network перешла на систему торгов только в 2021 году.
Предварительные требования
Прежде чем продолжить, проверьте следующее:
- Android API уровня 24 или более поздней версии.
- Адаптер Meta Audience Network версии 5.10.0.0 или более поздней ( рекомендуется последняя версия ).
Последняя версия Google Mobile Ads SDK (Legacy) .
Шаг 1: Настройка параметров в пользовательском интерфейсе Meta Audience Network.
Зарегистрируйтесь и войдите на стартовую страницу Business Manager .
Нажмите «Начать», затем «Создать новую учетную запись» .

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

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

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

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

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

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

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

Нажмите «Готово» .
Обновите файл 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.
Войдите в свой аккаунт в Ad Manager .
Включить безопасный обмен сигналами
Перейдите в раздел Администрирование > Глобальные настройки . Перейдите на вкладку настроек учетной записи Ad Exchange , просмотрите и включите параметр «Безопасный обмен сигналами» . Нажмите «Сохранить» .

Передайте защищенный сигнал в запросах на участие в торгах.
Перейдите в раздел «Инвентарь» > «Защищенные сигналы» . В разделе «Защищенные сигналы» найдите Facebook и включите опцию «Включить интеграцию с приложением» .

Нажмите « Сохранить ».
Обеспечьте безопасный обмен сигналами для торгов с использованием SDK.
Перейдите в раздел «Доставка» > «Настройки канала спроса» . На вкладке «Настройки по умолчанию» включите параметр «Разрешить безопасный обмен сигналами для торгов SDK» .

Нажмите « Сохранить ».
Настройка мета-торгов
Перейдите в раздел «Доставка» > «Участники торгов» и нажмите « Перейти к торгам SDK» .

Нажмите «Новый участник торгов» .

Выберите компанию Meta в качестве участника торгов.

Нажмите «Продолжить» , чтобы включить функцию «SDK Bidding» для этого участника торгов.

Нажмите «Готово» .
Настройка сопоставления рекламных блоков
Перейдите в раздел «Доставка» > «Участники торгов» и нажмите « Перейти к торгам SDK» .

Выберите компанию для Meta Audience Network.

Перейдите на вкладку «Сопоставление рекламных блоков» и нажмите «Создать новое сопоставление рекламных блоков» .

Выберите «Конкретный рекламный блок» . Выберите рекламный блок и формат, тип инвентаря — «Мобильное приложение» , и ваше мобильное приложение . Затем введите идентификатор размещения, полученный в предыдущем разделе.
Если вы настраиваете сопоставление рекламных блоков для межстраничной рекламы с вознаграждением в пользовательском интерфейсе Ad Manager, выберите формат «С вознаграждением» и используйте идентификатор размещения межстраничной рекламы с вознаграждением.
Наконец, нажмите «Сохранить» .

Добавить Meta в список рекламных партнеров, соответствующих GDPR и требованиям штатов США.
Чтобы добавить Meta в список рекламных партнеров, соответствующих европейским и американским государственным нормативным требованиям, в пользовательском интерфейсе Ad Manager, выполните действия, описанные в настройках европейских и американских нормативных требований .
Шаг 3: Импортируйте SDK и адаптер Meta Audience Network.
Интеграция с Android Studio (рекомендуется)
В файл gradle на уровне приложения добавьте следующие зависимости реализации:
Котлин
dependencies { implementation("com.google.android.gms:play-services-ads:25.5.0") implementation("com.google.ads.mediation:facebook:6.22.0.0") }
Классный
dependencies { implementation 'com.google.android.gms:play-services-ads:25.5.0' implementation 'com.google.ads.mediation:facebook:6.22.0.0' }
Ручная интеграция
Загрузите последнюю версию SDK Meta Audience Network для Android . Распакуйте файл
AudienceNetwork.aarв папкуAudienceNetwork/binи добавьте его в свой проект.Перейдите к артефактам адаптера Meta Audience Network в репозитории Maven Google. Выберите последнюю версию, загрузите файл
.aarадаптера Meta Audience Network и добавьте его в свой проект.
Шаг 4: Внедрите настройки конфиденциальности в SDK Meta Audience Network.
Согласие ЕС и GDPR
В соответствии с Политикой Google по согласию пользователей в ЕС , вы должны предоставлять пользователям в Европейской экономической зоне (ЕЭЗ), Великобритании и Швейцарии определенную информацию и получать их согласие на использование файлов cookie или других локальных хранилищ, если это требуется по закону, а также на сбор, передачу и использование персональных данных для персонализации рекламы. Данная политика отражает требования Директивы ЕС о защите конфиденциальности в электронных коммуникациях (ePrivacy Directive) и Общего регламента по защите данных (GDPR). Вы несете ответственность за проверку того, что согласие передано каждому источнику рекламы в вашей цепочке медиации.
Meta не зарегистрирована в Глобальном списке поставщиков IAB Europe (GVL). Вместо этого вам необходимо использовать техническую спецификацию «Дополнительное согласие» . Подробнее см. в разделе «Компоненты дополнительного согласия» . Спецификация «Дополнительное согласие» работает совместно с IAB Europe Transparency & Consent Framework (TCF) версии 2. Эта спецификация позволяет вам, а также вашим платформам управления согласием (CMP) и партнерам, собирать и передавать сигналы дополнительного согласия для компаний, включенных в список поставщиков рекламных технологий Google (ATP), но еще не входящих в IAB Europe GVL.
Следуйте инструкциям в документации Meta по GDPR и рекламе на Meta.
Законы штатов США о защите частной жизни
Законы США о защите конфиденциальности требуют предоставления пользователям права отказаться от «продажи» их «личной информации» (как это определено в законе), при этом отказ предлагается через заметную ссылку «Не продавать мою личную информацию» на главной странице «продающей» стороны. Руководство по соблюдению законов США о защите конфиденциальности предлагает возможность включения ограниченной обработки данных для показа рекламы Google, но Google не может применить эту настройку к каждой рекламной сети в вашей цепочке посредничества. Поэтому вы должны определить каждую рекламную сеть в вашей цепочке посредничества, которая может участвовать в продаже личной информации, и следовать указаниям каждой из этих сетей для обеспечения соответствия требованиям.
Для получения информации о вариантах обработки данных для пользователей из Калифорнии следуйте инструкциям в документации Meta .
Шаг 5: Добавьте необходимый код
Для интеграции с Meta Audience Network дополнительный код не требуется.
Шаг 6: Протестируйте свою реализацию.
Включить тестовые объявления
Убедитесь, что вы зарегистрировали свое тестовое устройство в Ad Manager и включили тестовый режим в пользовательском интерфейсе Meta Audience Network.
Проверить тестовые объявления
Чтобы убедиться, что вы получаете тестовые объявления от Meta Audience Network, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений Meta Audience Network (для торгов ).
Дополнительные шаги
Нативная реклама
Некоторые рекламные ресурсы Meta Audience Network не соответствуют напрямую рекламным ресурсам Google. Такие ресурсы передаются издателю в пакете через метод getExtras() в NativeAd . Адаптер поддерживает передачу следующих ресурсов:
| Запрос параметров и значений | |
|---|---|
FacebookMediationAdapter.KEY_ID | Строка . Уникальный идентификатор нативной рекламы. |
FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET | Строка . Социальный контекст рекламы. |
Вот пример кода, демонстрирующий, как извлечь эти ресурсы:
Пример:
Java
Bundle extras = nativeAd.getExtras();
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
String socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET);
// ...
}
Котлин
val extras = nativeAd.getExtras()
if (extras.containsKey(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)) {
val socialContext = extras.getString(FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET)
// ...
}
Использование нативной рекламы Meta Audience Network без MediaView
Для отображения нативной рекламы в Meta Audience Network требуется использовать ресурс MediaView . Если вы планируете отображать нативную рекламу без этого ресурса, обязательно используйте формат нативной баннерной рекламы Meta Audience Network.
Чтобы использовать нативные баннерные объявления Meta Audience Network, необходимо выбрать формат Native Banner при настройке Meta Audience Network , и адаптер автоматически загрузит соответствующий формат нативной рекламы.
Отображение рекламы
Адаптер Audience Network возвращает свои нативные объявления в виде объектов NativeAd . Он заполняет следующие поля для объекта NativeAd .
| Поле | Заполняется адаптером Meta Audience Network. |
|---|---|
| Заголовок | |
| Изображение | 1 |
| Тело | |
| значок приложения | |
| Призыв к действию | |
| Название рекламодателя | |
| Звездный рейтинг | |
| Магазин | |
| Цена |
1. Адаптер Meta Audience Network не предоставляет прямого доступа к основному графическому ресурсу для своих нативных объявлений. Вместо этого адаптер заполняет MediaView видео или изображением.
Отслеживание показов и кликов
В таблице ниже показано, когда показы и клики по нативной рекламе регистрируются с помощью Google Mobile Ads SDK (Legacy) .
| Запись впечатлений | Запись щелчка |
|---|---|
| 1 пиксель нативного рекламного элемента Meta Audience Network на экране + требования к рендерингу элемента | Обратный вызов SDK Meta Audience Network |
В Meta Audience Network существуют определенные требования к отображению контента для того, чтобы показ считался действительным, в зависимости от того, выбрали ли вы формат Native или Native Banner при настройке Meta Audience Network .
| собственный формат Meta Audience Network | Необходимый актив | Требуемый класс рендеринга |
|---|---|---|
| Родной | Просмотр медиафайлов | MediaView |
| Родной баннер | значок приложения | ImageView |
Кэширование на Android 9
Начиная с Android 9 (уровень API 28), поддержка открытого текста отключена по умолчанию , что повлияет на функциональность кэширования медиафайлов в SDK Meta Audience Network и может сказаться на удобстве использования и доходе от рекламы. Следуйте документации Meta , чтобы обновить конфигурацию сетевой безопасности в вашем приложении.
коды ошибок
Если адаптер не получает объявление от Audience Network, вы можете проверить основную причину ошибки в ответе на объявление, используя ResponseInfo.getAdapterResponses() из следующих классов:
com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter
Вот коды и соответствующие сообщения, которые выдает адаптер Audience Network, когда реклама не загружается:
| Код ошибки | Причина |
|---|---|
| 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. |
Список изменений адаптера Meta Audience Network для Android.
Версия 6.22.0.1 (в разработке)
- Зафиксируйте зависимость адаптера от Kotlin на версии 1.9.0 (минимальная версия Kotlin, поддерживаемая GMA NextGen SDK).
- Обновлено: теперь при регистрации показов нативной рекламы Meta отображает именно этот контент.
Версия 6.22.0.0
- Подтверждена совместимость с Meta Audience Network SDK версии 6.22.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 25.4.0.
- Google Mobile Ads Next-Gen SDK версии 1.3.0.
- Версия SDK Meta Audience Network: 6.22.0.
Версия 6.21.0.4
- Сопоставляет параметр
AgeRestrictedTreatmentс настройками смешанной аудитории Meta Audience Network. - Fixed a memory leak issue with interstitial ads.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 25.4.0.
- Google Mobile Ads Next-Gen SDK версии 1.2.1.
- Meta Audience Network SDK version 6.21.0.
Version 6.21.0.3
- Updated native ad implementation to use the updated
NativeAdMapperAPI. - Destroy
NativeAdBaseandMediaViewwhenuntrackViewis called to release resources.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 25.2.0.
- Google Mobile Ads Next-Gen SDK версия 0.25.0-beta01.
- Meta Audience Network SDK version 6.21.0.
Version 6.21.0.2
- Добавлено свойство для сборки адаптера с зависимостью от GMA Next-Gen SDK.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 25.1.0.
- Meta Audience Network SDK version 6.21.0.
Version 6.21.0.1
- Added support for forwarding the
tagForUnderAgeOfConsentGoogle Mobile Ads SDK parameter to the Meta Audience Network SDK.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 24.9.0.
- Meta Audience Network SDK version 6.21.0.
Version 6.21.0.0
- Verified compatibility with Meta Audience Network SDK v6.21.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 24.7.0.
- Meta Audience Network SDK version 6.21.0.
Version 6.20.0.2
- Удалены ссылки на объекты
Contextна уровне класса для решения проблем с утечками памяти.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 24.7.0.
- Meta Audience Network SDK version 6.20.0.
Version 6.20.0.1
- Removed the check that fails initialization if there are no placement IDs. Removed this to allow for RTB to work even if a publisher doesn't define ad unit mappings.
- Verified compatibility with Meta Audience Network SDK v6.20.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 24.6.0.
- Meta Audience Network SDK version 6.20.0.
Version 6.20.0.0
- Verified compatibility with Meta Audience Network SDK v6.20.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 24.2.0.
- Meta Audience Network SDK version 6.20.0.
Version 6.19.0.1
- Обновлен минимально необходимый уровень Android API до 23.
- Updated the minimum required Google Mobile Ads SDK version to 24.0.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 24.0.0.
- Meta Audience Network SDK version 6.19.0.
Version 6.19.0.0
- Verified compatibility with Meta Audience Network SDK v6.19.0.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 23.6.0.
- Meta Audience Network SDK version 6.19.0.
Version 6.18.0.0
- Verified compatibility with Meta Audience Network SDK v6.18.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 23.3.0.
- Meta Audience Network SDK version 6.18.0.
Version 6.17.0.0
- Updated the minimum required Google Mobile Ads SDK version to 23.0.0.
- Verified compatibility with Meta Audience Network SDK v6.17.0.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 23.0.0.
- Meta Audience Network SDK version 6.17.0.
Version 6.16.0.0
- Updated the adapter to call MediationInterstitialAdCallback#onAdFailedToShow() when Meta SDK reports that interstitial ad show failed.
- Verified compatibility with Meta Audience Network SDK v6.16.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 22.3.0.
- Meta Audience Network SDK version 6.16.0.
Версия 6.15.0.0
- Verified compatibility with Meta Audience Network SDK v6.15.0.
- Updated the minimum required Google Mobile Ads SDK version to 22.2.0.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 22.2.0.
- Meta Audience Network SDK version 6.15.0.
Version 6.14.0.0
- Verified compatibility with Meta Audience Network SDK v6.14.0.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 22.0.0.
- Meta Audience Network SDK version 6.14.0.
Version 6.13.7.1
- Updated adapter to use new
VersionInfoclass. - Updated the minimum required Google Mobile Ads SDK version to 22.0.0.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 22.0.0.
- Meta Audience Network SDK version 6.13.7.
Version 6.13.7.0
- Verified compatibility with Meta Audience Network SDK v6.13.7.
- Обновлена минимально необходимая версия Google Mobile Ads SDK до 21.5.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 21.5.0.
- Meta Audience Network SDK version 6.13.7.
Версия 6.12.0.0
- Verified compatibility with Meta Audience Network SDK v6.12.0.
- Updated the minimum required Google Mobile Ads SDK version to 21.2.0.
- Rebranded adapter name to "Meta Audience Network".
- Removed waterfall integration.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 21.2.0.
- Meta Audience Network SDK version 6.12.0.
Version 6.11.0.1
- Updated
compileSdkVersionandtargetSdkVersionto API 31. - Updated the minimum required Google Mobile Ads SDK version to 21.0.0.
- Updated the minimum required Android API level to 19.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 21.0.0.
- Facebook SDK version 6.11.0.
Version 6.11.0.0
- Verified compatibility with Facebook SDK v6.11.0.
- Added warning messages for waterfall mediation deprecation. See Meta's blog for more information.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 20.6.0.
- Facebook SDK version 6.11.0.
Version 6.10.0.0
- Verified compatibility with Facebook SDK v6.10.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 20.6.0.
- Facebook SDK version 6.10.0.
Version 6.8.0.1
- Added support for forwarding click and impression callbacks in bidding ads.
- Added support for forwarding the
onAdFailedToShow()callback when interstitial bidding ads fail to present. - Обновлена минимально необходимая версия Google Mobile Ads SDK до 20.6.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 20.6.0.
- Facebook SDK version 6.8.0.
Version 6.8.0.0
- Verified compatibility with Facebook SDK v6.8.0.
- Updated the minimum required Google Mobile Ads SDK version to 20.4.0.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 20.4.0.
- Facebook SDK version 6.8.0.
Version 6.7.0.0
- Verified compatibility with Facebook SDK v6.7.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 20.3.0.
- Facebook SDK version 6.7.0.
Version 6.6.0.0
- Verified compatibility with Facebook SDK v6.6.0.
- Обновлена минимально необходимая версия Google Mobile Ads SDK до 20.3.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 20.3.0.
- Facebook SDK version 6.6.0.
Version 6.5.1.1
- Fixed a bug introduced in 6.5.1.0 where test ads are returned instead of live ads.
- Updated the adapter to use the new
AdErrorAPI.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 20.2.0.
- Facebook SDK version 6.5.1.
Version 6.5.1.0 (Deprecated)
- An issue with version 6.5.1.0 has been detected and confirmed. It is recommended to upgrade to version 6.5.1.1.
- Verified compatibility with Facebook SDK v6.5.1.
- Updated the minimum required Google Mobile Ads SDK version to 20.2.0.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 20.2.0.
- Facebook SDK version 6.5.1.
Version 6.5.0.0
- Verified compatibility with Facebook SDK v6.5.0.
- Fixed an issue where native ads did not include Facebook's cover image.
- Обновлена минимально необходимая версия Google Mobile Ads SDK до 20.1.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 20.1.0.
- Facebook SDK version 6.5.0.
Version 6.4.0.0
- Verified compatibility with Facebook SDK v6.4.0.
- Updated the minimum required Google Mobile Ads SDK version to 20.0.0.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 20.0.0.
- Facebook SDK version 6.4.0.
Version 6.3.0.1
- Fixed an issue where a
ClassCastExceptionis thrown when rendering native ads on apps that don't useImageViewto render image assets.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 19.7.0.
- Facebook SDK version 6.3.0.
Версия 6.3.0.0
- Verified compatibility with Facebook SDK v6.3.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 19.7.0.
- Facebook SDK version 6.3.0.
Version 6.2.1.0
- Verified compatibility with Facebook SDK v6.2.1.
- Обновлена минимально необходимая версия Google Mobile Ads SDK до 19.7.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 19.7.0.
- Facebook SDK version 6.2.1.
Version 6.2.0.1
- Removed support for the deprecated
NativeAppInstallAdformat. Apps should request for unified native ads. - Updated the minimum required Google Mobile Ads SDK version to 19.6.0.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 19.6.0.
- Facebook SDK version 6.2.0.
Version 6.2.0.0
- Verified compatibility with Facebook SDK v6.2.0.
- Updated the minimum required Google Mobile Ads SDK version to 19.5.0.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 19.5.0.
- Facebook SDK version 6.2.0.
Version 6.1.0.0
- Verified compatibility with Facebook SDK v6.1.0.
- Updated the minimum required Google Mobile Ads SDK version to 19.4.0.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 19.4.0.
- Facebook SDK version 6.1.0.
Version 6.0.0.0
- Verified compatibility with Facebook SDK v6.0.0.
- Updated the minimum required Google Mobile Ads SDK version to 19.3.0.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 19.3.0.
- Facebook SDK version 6.0.0.
Version 5.11.0.0
- Verified compatibility with Facebook SDK v5.11.0.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 19.2.0.
- Facebook SDK version 5.11.0.
Version 5.10.1.0
- Verified compatibility with Facebook SDK v5.10.1.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 19.2.0.
- Facebook SDK version 5.10.1.
Version 5.10.0.0
- Verified compatibility with Facebook SDK v5.10.0.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 19.2.0.
- Facebook SDK version 5.10.0.
Version 5.9.1.0
- Verified compatibility with Facebook SDK v5.9.1.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 19.2.0.
- Facebook SDK version 5.9.1.
Version 5.9.0.2
- Added support for rewarded interstitial ads.
- Updated the adapter to support inline adaptive banner requests.
- Fixed an issue where bidding banner ads always render full-width.
- Updated the minimum required Google Mobile Ads SDK version to 19.2.0.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 19.2.0.
- Facebook SDK version 5.9.0.
Version 5.9.0.1
- Adapter now forwards an error if the FAN SDK encounters an error while presenting an interstitial/rewarded ad.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 19.1.0.
- Facebook SDK version 5.9.0.
Version 5.9.0.0
- Verified compatibility with Facebook SDK v5.9.0.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 19.1.0.
- Facebook SDK version 5.9.0.
Version 5.8.0.2
- Fixed incorrect variable reference which caused a crash in certain scenarios when loading native ads.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 19.1.0.
- Facebook SDK version 5.8.0.
Version 5.8.0.1
- Added additional descriptive error codes and reasons for adapter load/show failures.
- Updated the minimum required Google Mobile Ads SDK version to 19.1.0.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 19.1.0.
- Facebook SDK version 5.8.0.
Version 5.8.0.0
- Verified compatibility with Facebook SDK v5.8.0.
- Обновлена минимально необходимая версия Google Mobile Ads SDK до 19.0.1.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 19.0.1.
- Facebook SDK version 5.8.0.
Version 5.7.1.1
- Added support for Facebook Audience Network adapter errors.
- Added descriptive error codes and reasons for adapter load/show failures.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 18.3.0.
- Facebook SDK version 5.7.1.
Version 5.7.1.0
- Verified compatibility with Facebook SDK v5.7.1.
- Added support for Facebook Native Banner ads when using bidding.
- Native ads now use 'Drawable' for the icon asset.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 18.3.0.
- Facebook SDK version 5.7.1.
Version 5.7.0.0
- Verified compatibility with Facebook SDK v5.7.0.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 18.3.0.
- Facebook SDK version 5.7.0.
Version 5.6.1.0
- Verified compatibility with Facebook SDK v5.6.1.
- Updated the minimum required Google Mobile Ads SDK version to 18.3.0.
Разработано и протестировано с помощью:
- Google Mobile Ads SDK version 18.3.0.
- Facebook SDK version 5.6.1.
Version 5.6.0.0
- Verified compatibility with Facebook SDK v5.6.0.
- Updated Facebook Adapter to use
AdChoicesView.
Разработано и протестировано с помощью:
- Версия Google Mobile Ads SDK: 18.2.0.
- Facebook SDK version 5.6.0.
Version 5.5.0.0
- Verified compatibility with Facebook SDK v5.5.0.
Version 5.4.1.1
- Fixed an issue that causes a crash when Native Ads are removed.
Version 5.4.1.0
- Verified compatibility with Facebook SDK v5.4.1.
- Added support for Facebook Native Banner Ads for waterfall mediation.
- Use
setNativeBanner()from theFacebookExtrasclass to request for Native Banner Ads.
- Use
- Fixed an issue that caused Smart Banner Ad requests to fail.
- Fixed an issue where Rewarded Video Ads were not forwarding the
onAdClosed()event in some cases where the app was backgrounded while the video was in progress. - Migrated the adapter to
AndroidX. - Updated the minimum required Google Mobile Ads SDK version to 18.1.1.
Версия 5.4.0.0
- Verified compatibility with Facebook SDK v5.4.0.
Version 5.3.1.2
- Fixed a bug where Facebook bidding failed to initialize due to "No placement IDs found".
Version 5.3.1.1
- Updated native RTB ads impression tracking.
- Updated the minimum required Google Mobile Ads SDK version to 17.2.1.
Version 5.3.1.0
- Added bidding capability to the adapter for banner, interstitial, rewarded and native ads.
- Verified compatibility with Facebook SDK v5.3.1.
Версия 5.3.0.0
- Updated mediation service name for Google Mobile Ads.
- Added adapter version to the initialization call.
- Verified compatibility with Facebook SDK v5.3.0.
Version 5.2.0.2
- Добавлена поддержка гибких размеров баннерной рекламы.
Version 5.2.0.1
- Updated adapter to support new open-beta Rewarded API.
- Updated the minimum required Google Mobile Ads SDK version to 17.2.0.
Версия 5.2.0.0
- Verified compatibility with Facebook SDK v5.2.0.
Version 5.1.1.1
- Updated the adapter to populate Advertiser Name for Unified Native Ads.
Версия 5.1.1.0
- Replaced AdChoices View with AdOptions View.
- Verified compatibility with Facebook SDK v5.1.1
Version 5.1.0.1
- Fixed an ANR issue caused by 'getGMSVersionCode()'.
Version 5.1.0.0
- Initialize Facebook SDK for each ad format.
Версия 5.0.1.0
- Verified compatibility with Facebook SDK v5.0.1.
Версия 5.0.0.1
- Updated the adapter to create the rewarded ad object at ad request time.
Версия 5.0.0.0
- Verified compatibility with Facebook SDK v5.0.0.
Version 4.99.3.0
- Verified compatibility with Facebook SDK v4.99.3.
Version 4.99.1.1
- Fixed a bug where the Ad Choices icon is not shown for Unified Native Ads.
- Fixed a bug where the adapter would throw an exception when trying to download images.
Version 4.99.1.0
- Verified compatibility with Facebook SDK v4.99.1.
Version 4.28.2.1
- Updated the adapter to invoke the
onRewardedVideoComplete()ad event.
Version 4.28.2.0
- Verified compatibility with Facebook SDK v4.28.2.
Version 4.28.1.1
- Fixed an issue where clicks are not being registered for Unified Native Ads.
Version 4.28.1.0
- Verified compatibility with Facebook SDK v4.28.1.
Version 4.28.0.0
- Verified compatibility with Facebook SDK v4.28.0.
Version 4.27.1.0
- Verified compatibility with Facebook SDK v4.27.1.
Version 4.27.0.0
- Verified compatibility with Facebook SDK v4.27.0.
Version 4.26.1.0
- Verified compatibility with Facebook SDK v4.26.1.
- Updated the Adapter project for Android Studio 3.0
Version 4.26.0.0
- Добавлена поддержка видеорекламы с вознаграждением.
- Added support for native video ads.
- Verified compatibility with Facebook SDK v4.26.0.
Version 4.25.0.0
- Fixed an issue where incorrectly sized banners were being returned.
- Updated the adapter's view tracking for native ads to register individual asset views with the Facebook SDK rather than the entire ad view. This means that background (or "whitespace") clicks on the native ad will no longer result in clickthroughs.
- Verified compatibility with Facebook SDK v4.25.0.
Version 4.24.0.0
- Verified compatibility with Facebook SDK v4.24.0.
Version 4.23.0.0
- Verified compatibility with Facebook SDK v4.23.0.
Version 4.22.1.0
- Verified compatibility with Facebook SDK v4.22.1.
Version 4.22.0.0
- Updated the adapter to make it compatible with Facebook SDK v4.22.0.
Version 4.21.1.0
- Verified compatibility with Facebook SDK v4.21.1.
Version 4.21.0.0
- Verified compatibility with Facebook SDK v4.21.0.
Version 4.20.0.0
- Updated the minimum supported Android API level to 14+.
- Verified compatibility with Facebook SDK v4.20.0.
Version 4.19.0.0
- Verified compatibility with Facebook SDK v4.19.0.
Version 4.18.0.0
- Verified compatibility with Facebook SDK v4.18.0.
Version 4.17.0.0
- Added support for native ads.
Version 4.15.0.0
- Changed the version naming system to [FAN SDK version].[adapter patch version].
- Updated the minimum required FAN SDK to v4.15.0.
- Updated the minimum required Google Mobile Ads SDK to v9.2.0.
- Fixed a bug where Facebook's click callbacks for interstitial ads weren't forwarded correctly.
- The adapter now also forwards onAdLeftApplication when an ad is clicked.
Версия 1.2.0
- Fixed a bug that so that AdSize.SMART_BANNER is now a valid size.
Version 1.1.0
- Added support for full width x 250 format when request is for AdSize.MEDIUM_RECTANGLE
Версия 1.0.1
- Added support for AdSize.SMART_BANNER
Версия 1.0.0
- Первый релиз