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

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

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

Поддерживаемые интеграции и форматы объявлений

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

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

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

Требования

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

Android API уровня 21 или выше

Адаптер Meta Audience Network 5.10.0.0 или выше ( рекомендуется последняя версия )

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

Зарегистрируйтесь и войдите на стартовую страницу Бизнес-Менеджера .

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

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

Создать свойство

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

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

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

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

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

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

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

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

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

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

Шаг 2. Настройте спрос Meta Audience Network в интерфейсе Менеджера рекламы.

Войдите в свою учетную запись Менеджера рекламы .

Включить безопасный обмен сигналами

Перейдите в «Администратор» > «Глобальные настройки» . Перейдите на вкладку настроек аккаунта Ad Exchange , проверьте и включите параметр «Безопасный обмен сигналами» . Нажмите Сохранить .

Настроить мета-биддинг

Менеджер рекламы 360

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

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

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

Нажмите Продолжить .

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

Менеджер рекламы

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

Нажмите «Подключиться онлайн сейчас» . Затем нажмите «Да, я согласен» в диалоговом окне, которое будет перенаправлено на сайт Facebook, чтобы начать процесс регистрации.

Войдите в свою учетную запись Business Manager .

Выберите свой бизнес.

После выбора вашего бизнеса появится следующее диалоговое окно. Нажмите «Вернуться в Менеджер рекламы» .

Нажмите Продолжить .

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

Настройка сопоставления рекламных блоков

Перейдите в раздел Доставка > Участники торгов и выберите компанию для Meta на вкладке SDK Bidding .

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

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

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

Следуйте инструкциям в настройках GDPR и настройках законодательства штата США , чтобы добавить Meta в список рекламных партнеров GDPR и законодательства штата США в пользовательском интерфейсе Менеджера рекламы.

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

Интеграция с Android Studio (рекомендуется)

В файле build.gradle.kts уровня приложения добавьте следующие зависимости и конфигурации реализации. Используйте последние версии Meta Audience Network SDK и адаптера:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.6.0")
    implementation("com.google.ads.mediation:facebook:6.18.0.0")
}

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

Загрузите последнюю версию Meta Audience Network SDK для Android . Извлеките файл AudienceNetwork.aar из папки AudienceNetwork/bin и добавьте его в свой проект.
Перейдите к артефактам адаптера Meta Audience Network в репозитории Google Maven. Выберите последнюю версию, загрузите файл .aar адаптера Meta Audience Network и добавьте его в свой проект.

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

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

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

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

Законы о конфиденциальности штатов США

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

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

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

Для интеграции Meta Audience Network не требуется никакого дополнительного кода.

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

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

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

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

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

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

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

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

Параметры и значения запроса
`FacebookMediationAdapter.KEY_ID`	Нить . Уникальный идентификатор нативного объявления.
`FacebookMediationAdapter.KEY_SOCIAL_CONTEXT_ASSET`	Нить . Рекламный социальный контекст

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

Пример:

Ява

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

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

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

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

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

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

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

Кэширование на Android 9

Начиная с Android 9 (уровень API 28), поддержка открытого текста по умолчанию отключена , что повлияет на функциональность кэширования мультимедиа Meta Audience Network SDK и может повлиять на взаимодействие с пользователем и доходы от рекламы. Следуйте документации 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	Не удалось инициализировать Meta Audience Network SDK.
105	Издатель не запрашивал унифицированную нативную рекламу.
106	Загруженное нативное объявление представляет собой объект, отличный от ожидаемого.
107	Используемый объект `Context` недействителен.
108	В загруженном объявлении отсутствуют необходимые ресурсы нативной рекламы.
109	Не удалось создать нативное объявление на основе полезных данных ставки.
110	SDK Meta Audience Network не смог представить межстраничную рекламу или рекламу с вознаграждением.
111	Исключение, возникающее при создании объекта `AdView` Meta Audience Network.
1000-9999	Сеть Meta Audience Network вернула ошибку, связанную с SDK. Дополнительную информацию см. в документации Meta Audience Network.