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

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

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

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

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

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

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

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

Требования

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

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

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

Шаг 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 Network» .

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

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

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

Затем введите идентификатор размещения, полученный в предыдущем разделе, и нажмите «Готово» .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Обязательно зарегистрируйте свое тестовое устройство в AdMob и включите тестовый режим в пользовательском интерфейсе 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 предъявляет особые требования к визуализации ресурсов, чтобы показ считался действительным, в зависимости от того, какой формат вы выбрали — Native или Native Banner при настройке 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	Meta Audience Network SDK не смог отобразить промежуточную/вознаграждаемую рекламу.
111	Исключение возникло при создании объекта Meta Audience Network `AdView` .
1000-9999	Meta Audience Network вернула ошибку, связанную с SDK. Подробнее см. в документации Meta Audience Network.