Чтобы обсудить наши продукты и оставить отзыв о них, присоединяйтесь к официальному каналу Ad Manager Discord на сервере Google Advertising and Measurement Community .

Эта страница переведена с помощью Cloud Translation API.

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

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

Android iOS Unity Flutter

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

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

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

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

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

Требования

Новейшая версия SDK для мобильной рекламы от Google.
Пройдите руководство по началу процесса медиации.

Целевая версия iOS для развертывания — 10.0 или выше.
Адаптер Meta Audience Network версии 5.10.0.0 или выше ( рекомендуется последняя версия ).
Для работы последней версии SDK Meta Audience Network обычно требуется последняя версия Xcode.

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

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

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

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

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

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

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

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

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

Выберите 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.

Войдите в свой аккаунт в 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.

Используйте менеджер пакетов Swift.

Прежде чем продолжить, у вас должна быть установлена минимальная поддерживаемая версия адаптера 6.20.1.0.

Чтобы добавить зависимость пакета в ваш проект, выполните следующие действия:

В Xcode перейдите в меню Файл > Добавить зависимости пакета... .
В появившемся окне введите следующий URL-адрес пакета:
```
https://github.com/googleads/googleads-mobile-ios-mediation-meta.git
```
В разделе «Правило зависимости» выберите «Ветвь» .
В текстовом поле введите main .

Используйте CocoaPods

Добавьте следующую строку в файл Podfile вашего проекта:
```
pod 'GoogleMobileAdsMediationFacebook'
```
В командной строке выполните:
```
pod install --repo-update
```

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

Загрузите последнюю версию SDK Meta Audience Network для iOS и подключите файл FBAudienceNetwork.framework к своему проекту.
Загрузите последнюю версию адаптера Meta Audience Network по ссылке для скачивания в журнале изменений и подключите файл MetaAdapter.framework к вашему проекту.

Шаг 4: Внедрите настройки конфиденциальности в SDK Meta Audience Network.

Согласие ЕС и GDPR

В соответствии с Политикой Google по согласию пользователей в ЕС , вы должны предоставлять пользователям в Европейской экономической зоне (ЕЭЗ), Великобритании и Швейцарии определенную информацию и получать их согласие на использование файлов cookie или других локальных хранилищ, если это требуется по закону, а также на сбор, передачу и использование персональных данных для персонализации рекламы. Данная политика отражает требования Директивы ЕС о защите конфиденциальности в электронных коммуникациях (ePrivacy Directive) и Общего регламента по защите данных (GDPR). Вы несете ответственность за проверку того, что согласие передается каждому источнику рекламы в вашей цепочке посредничества. Google не может автоматически передавать выбор согласия пользователя таким сетям.

Meta не зарегистрирована в Глобальном списке поставщиков IAB Europe (GVL). Вместо этого вам необходимо использовать техническую спецификацию «Дополнительное согласие» . Подробнее см. в разделе «Компоненты дополнительного согласия» . Спецификация «Дополнительное согласие» работает совместно с IAB Europe Transparency & Consent Framework (TCF) версии 2. Эта спецификация позволяет вам, а также вашим платформам управления согласием (CMP) и партнерам, собирать и передавать сигналы дополнительного согласия для компаний, включенных в список поставщиков рекламных технологий Google (ATP), но еще не входящих в GVL IAB Europe.

Следуйте инструкциям в документации Meta по GDPR и рекламе на Meta.

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

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

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

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

Ошибки компиляции

Быстрый

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

Objective-C

Для адаптера Meta Audience Network версии 6.9.0.0 или выше необходимо выполнить следующие шаги, чтобы добавить пути Swift в параметры сборки целевого устройства и предотвратить ошибки компиляции.

Добавьте следующие пути в параметры сборки целевого объекта в разделе «Пути поиска библиотек» :

$(TOOLCHAIN_DIR)/usr/lib/swift/$(PLATFORM_NAME)
$(SDKROOT)/usr/lib/swift

Добавьте следующий путь в параметры сборки целевого объекта в разделе «Пути поиска пути выполнения» :

/usr/lib/swift

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

Если вы разрабатываете приложение для iOS 14 или более поздних версий, Meta Audience Network требует явного указания флага « Отслеживание рекламы включено» с помощью следующего кода:

Быстрый

// Set the flag as true
FBAdSettings.setAdvertiserTrackingEnabled(true)

Objective-C

// Set the flag as true.
[FBAdSettings setAdvertiserTrackingEnabled:YES];

Интеграция SKAdNetwork

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

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

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

Убедитесь, что вы зарегистрировали свое тестовое устройство в Ad Manager и включили тестовый режим в пользовательском интерфейсе Meta Audience Network.

Проверить тестовые объявления

Чтобы убедиться, что вы получаете тестовые объявления от Meta Audience Network, включите тестирование одного источника объявлений в инспекторе объявлений, используя источники объявлений Meta Audience Network (для торгов ).

Дополнительные шаги

Нативная реклама

Некоторые рекламные ресурсы Meta Audience Network не соответствуют напрямую рекламным ресурсам Google. Такие ресурсы передаются издателю через свойство extraAssets адаптера GADNativeAd . Адаптер поддерживает передачу следующих ресурсов:

Запрос параметров и значений
`GADFBSubtitle`	Строка . Подзаголовок рекламы.
`GADFBSocialContext`	Строка . Социальный контекст рекламы.

Вот пример кода, демонстрирующий, как извлечь эти ресурсы:

Быстрый

let socialContext: String = nativeAd.extraAssets[GADFBSocialContext]

Objective-C

NSString *socialContext = nativeAd.extraAssets[GADFBSocialContext];

Использование нативной рекламы Meta Audience Network без MediaView

Для отображения нативной рекламы в Meta Audience Network требуется использовать ресурс GADMediaView . Если вы планируете отображать нативную рекламу без этого ресурса, обязательно используйте формат нативной баннерной рекламы Meta Audience Network.

Чтобы использовать нативные баннерные объявления Meta Audience Network, необходимо выбрать формат Native Banner при настройке Meta Audience Network , и адаптер автоматически загрузит соответствующий формат нативной рекламы.

Отображение рекламы

Адаптер Audience Network возвращает свои нативные объявления в виде объектов GADNativeAd . Он заполняет следующие поля для объекта GADNativeAd .

Поле	Заполняется адаптером Meta Audience Network.
Заголовок
Изображение	1
Тело
значок приложения
Призыв к действию
Название рекламодателя
Звездный рейтинг
Магазин
Цена

^1. Адаптер Meta Audience Network не предоставляет прямого доступа к основному графическому ресурсу для своих нативных объявлений. Вместо этого адаптер заполняет GADMediaView видео или изображением.

Отслеживание показов и кликов

В таблице ниже показано, когда Google Mobile Ads SDK регистрирует показы и клики по нативной рекламе.

Запись впечатлений	Запись щелчка
1 пиксель нативного рекламного элемента Meta Audience Network на экране + требования к рендерингу элемента	Обратный вызов SDK Meta Audience Network

В Meta Audience Network существуют определенные требования к отображению контента для того, чтобы показ считался действительным, в зависимости от того, выбрали ли вы формат Native или Native Banner при настройке Meta Audience Network .

собственный формат Meta Audience Network	Необходимый актив	Требуемый класс рендеринга
Родной	Просмотр медиафайлов	`GADMediaView`
Родной баннер	значок приложения	`UIImageView`

коды ошибок

Если адаптер не получает объявление от Audience Network, вы можете проверить основную причину ошибки в ответе на объявление, используя GADResponseInfo.adNetworkInfoArray из следующих классов:

GADMAdapterFacebook
GADMediationAdapterFacebook

Вот коды и соответствующие сообщения, которые выдает адаптер Audience Network, когда реклама не загружается:

Код ошибки	Причина
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.

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

Версия 6.21.0.0

Теперь требуется минимальная версия iOS 13.0 .
Подтверждена совместимость с Meta Audience Network SDK 6.21.0.

Разработано и протестировано с помощью:

Версия Google Mobile Ads SDK: 12.7.0.
Версия SDK Meta Audience Network: 6.21.0.

Версия 6.20.1.0

Подтверждена совместимость с Meta Audience Network SDK 6.20.1.

Разработано и протестировано с помощью:

Версия Google Mobile Ads SDK: 12.7.0.
Версия SDK Meta Audience Network: 6.20.1.

Версия 6.20.0.0

Подтверждена совместимость с Meta Audience Network SDK 6.20.0.

Разработано и протестировано с помощью:

Версия Google Mobile Ads SDK: 12.6.0.
Версия SDK Meta Audience Network: 6.20.0.

Версия 6.17.1.0

Подтверждена совместимость с Meta Audience Network SDK 6.17.1.

Разработано и протестировано с помощью:

Версия Google Mobile Ads SDK: 12.1.0.
Версия SDK Meta Audience Network: 6.17.1.

Версия 6.17.0.0

Подтверждена совместимость с Meta Audience Network SDK 6.17.0.

Разработано и протестировано с помощью:

Версия Google Mobile Ads SDK: 12.0.0.
Версия SDK Meta Audience Network: 6.17.0.

Версия 6.16.0.1

Теперь требуется Google Mobile Ads SDK версии 12.0.0 или выше.

Разработано и протестировано с помощью:

Версия Google Mobile Ads SDK: 12.0.0.
Версия SDK Meta Audience Network: 6.16.0.

Версия 6.16.0.0

Подтверждена совместимость с Meta Audience Network SDK 6.16.0. ` Собрано и протестировано с использованием:
Версия Google Mobile Ads SDK: 11.11.0.
Версия SDK Meta Audience Network: 6.16.0.

Версия 6.15.2.1

Внесены изменения в CFBundleShortVersionString теперь он содержит три компонента вместо четырех.

Разработано и протестировано с помощью:

Версия Google Mobile Ads SDK: 11.10.0.
Версия SDK Meta Audience Network: 6.15.2.

Версия 6.15.2.0

Подтверждена совместимость с Meta Audience Network SDK 6.15.2.

Разработано и протестировано с помощью:

Версия Google Mobile Ads SDK: 11.8.0.
Версия SDK Meta Audience Network: 6.15.2.

Версия 6.15.1.0

Подтверждена совместимость с Meta Audience Network SDK 6.15.1.

Разработано и протестировано с помощью:

Версия Google Mobile Ads SDK: 11.2.0.
Версия SDK Meta Audience Network: 6.15.1.

Версия 6.15.0.0

Подтверждена совместимость с Meta Audience Network SDK 6.15.0.
Теперь требуется минимальная версия iOS 12.0.
Теперь требуется Google Mobile Ads SDK версии 11.0 или выше.
Info.plist включен в состав фреймворков внутри MetaAdapter.xcframework .
Удалены устаревшие методы делегата willBackgroundApplication из рендереров баннеров и промежуточных окон.
Заменен устаревший метод GADMobileAds.sharedInstance.sdkVersion на GADMobileAds.sharedInstance.versionNumber .

Разработано и протестировано с помощью:

Версия Google Mobile Ads SDK: 11.2.0.
Версия SDK Meta Audience Network: 6.15.0.

Версия 6.14.0.0

Подтверждена совместимость с Meta Audience Network SDK 6.14.0.

Разработано и протестировано с помощью:

Версия Google Mobile Ads SDK: 10.9.0.
Версия SDK Meta Audience Network: 6.14.0.

Версия 6.12.0.2

В адаптере удалены все проверки ставок.
Прекращена поддержка архитектуры armv7 .
Теперь требуется минимальная версия iOS 11.0.
Теперь требуется Google Mobile Ads SDK версии 10.4.0 или выше.

Разработано и протестировано с помощью:

Версия Google Mobile Ads SDK: 10.7.0.
Версия SDK Meta Audience Network: 6.12.0.

Версия 6.12.0.1

Теперь требуется Google Mobile Ads SDK версии 10.0.0 или выше.

Разработано и протестировано с помощью:

Версия Google Mobile Ads SDK: 10.0.0.
Версия SDK Meta Audience Network: 6.12.0.

Версия 6.12.0.0

Удалена поддержка водопадного эффекта из адаптера.
Адаптер обновлен для использования API didRewardUser .
Теперь требуется Google Mobile Ads SDK версии 9.8.0 или выше.
Подтверждена совместимость с Meta Audience Network SDK 6.12.0.

Разработано и протестировано с помощью:

Версия Google Mobile Ads SDK: 9.11.0.
Версия SDK Meta Audience Network: 6.12.0.

Версия 6.11.2.0

Подтверждена совместимость с Meta Audience Network SDK 6.11.2.

Разработано и протестировано с помощью:

Версия Google Mobile Ads SDK: 9.7.0.
Версия SDK Meta Audience Network: 6.11.2.

Версия 6.11.1.0

Подтверждена совместимость с Meta Audience Network SDK 6.11.1.
В журналах адаптера теперь он обозначается как "Meta Audience Network".

Разработано и протестировано с помощью:

Версия Google Mobile Ads SDK: 9.5.0.
Версия SDK Meta Audience Network: 6.11.1.

Версия 6.11.0.0

Подтверждена совместимость с FAN SDK 6.11.0.

Разработано и протестировано с помощью:

Версия Google Mobile Ads SDK: 9.4.0.
Версия FAN SDK 6.11.0.

Версия 6.10.0.0

Подтверждена совместимость с FAN SDK 6.10.0.
Добавлена поддержка переадресации кликов и показов в объявлениях, участвующих в торгах.
Добавлены предупреждающие сообщения об устаревании каскадной медиации. Подробнее см. в блоге Meta Audience Network .

Разработано и протестировано с помощью:

Версия Google Mobile Ads SDK: 9.3.0.
Версия FAN SDK 6.10.0.

Версия 6.9.0.1

Подтверждена совместимость с Google Mobile Ads SDK версии 9.0.0.
Теперь требуется Google Mobile Ads SDK версии 9.0.0 или выше.

Разработано и протестировано с помощью:

Версия Google Mobile Ads SDK: 9.0.0.
Версия FAN SDK 6.9.0.