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

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

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

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

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

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

¹ Meta Audience Network начала делать ставки только в 2021 году.

Требования

Последняя версия Google Mobile Ads SDK
Завершите посредничество . Руководство по началу работы.

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

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

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

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

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

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

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

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

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

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

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

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

Обратите внимание на идентификатор размещения .

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

Обновите свой app-ads.txt

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

Чтобы реализовать app-ads.txt для Meta Audience Network, см . раздел Определение авторизованных продавцов с помощью app-ads.txt .

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

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

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

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

Вам необходимо добавить Meta Audience Network в конфигурацию медиации для вашего рекламного блока.

Сначала войдите в свою учетную запись AdMob . Затем перейдите на вкладку Медиация . Если у вас есть существующая группа медиации, которую вы хотите изменить, щелкните имя этой группы медиации, чтобы отредактировать ее, и перейдите к разделу Добавить Meta Audience Network в качестве источника рекламы .

Чтобы создать новую группу посредничества, выберите «Создать группу посредничества» .

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

Дайте название вашей группе посредничества и выберите местоположения для таргетинга. Затем установите статус группы посредничества на Включено , а затем нажмите Добавить рекламные блоки .

Свяжите эту группу медиации с одним или несколькими существующими рекламными блоками AdMob. Затем нажмите Готово .

Теперь вы должны увидеть карточку рекламных блоков, заполненную выбранными вами рекламными блоками:

Добавить Meta Audience Network в качестве источника рекламы

Под карточкой «Торги» в разделе «Источники рекламы» выберите «Добавить источник рекламы» . Затем выберите «Сеть Meta Audience» .

Нажмите «Как подписать партнерское соглашение и настроить партнерство по торгам с Meta Audience Network».

Нажмите «Принять и согласиться» , затем нажмите «Продолжить» .

Если у вас уже есть сопоставление для Meta Audience Network, вы можете выбрать его. В противном случае нажмите Добавить сопоставление .

Далее введите Placement ID , полученный в предыдущем разделе. Затем нажмите Done .

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

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

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

Использование CocoaPods (рекомендуется)

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

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

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

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

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

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

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

Следуйте инструкциям в документации 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

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

/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

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

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

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

Обязательно зарегистрируйте свое тестовое устройство в AdMob и включите тестовый режим в пользовательском интерфейсе Meta Audience Network.

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

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

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

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

Некоторые нативные рекламные активы 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
Тело
Значок приложения
Призыв к действию
Имя рекламодателя
Рейтинг звезд
Магазин
Цена

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

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

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

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

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

Собственный формат Meta Audience Network	Требуемый актив	Требуемый класс рендеринга
Родной	Медиа-просмотр	`GADMediaView`
Родной баннер	Значок приложения	`UIImageView`

Коды ошибок

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

GADMAdapterFacebook
GADMediationAdapterFacebook

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

Код ошибки	Причина
101	Неверные параметры сервера (например, отсутствует идентификатор размещения).
102	Запрошенный размер объявления не соответствует поддерживаемому размеру баннера Meta Audience Network.
103	Не удалось инициализировать рекламный объект Meta Audience Network.
104	Meta Audience Network SDK не смог отобразить промежуточную/вознаграждаемую рекламу.
105	Корневой контроллер представления рекламного баннера равен `nil` .
106	Не удалось инициализировать Meta Audience Network SDK.
1000-9999	Meta Audience Network вернула ошибку, специфичную для SDK. Подробности см. в документации Meta Audience Network.

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