Новые установки мобильных приложений обычно стимулируются рекламой установки приложений. Чтобы максимизировать рентабельность инвестиций в рекламу, хорошей идеей будет не показывать рекламу установки приложения на устройствах, на которых уже установлено это же приложение. В этом предложении мы называем эту практику «фильтрацией рекламы установки приложений».
Это предложение знакомит с тем, как Protected Audience на Android поддерживает фильтрацию контекстной рекламы, в частности фильтрацию рекламы при установке приложений, сохраняя конфиденциальность. Для участия приложение на устройстве должно явно согласиться на фильтрацию рекламы при установке приложений. Во время выбора рекламы кандидаты на рекламу отфильтровываются на основе списка приложений, установленных на устройстве, известного рекламному технологу.
Список установленных приложений виден только в потоке выбора рекламы и полагается на платформу покупателя, чтобы сигнализировать о том, что конкретная реклама должна быть отфильтрована на основе наличия приложения на устройстве.
Чтобы настроить фильтрацию рекламы при установке приложений, выполните следующие действия:
Шаг 1: Зарегистрируйте приложение для фильтрации рекламы при установке приложения
Чтобы включить фильтрацию рекламы при установке приложения, разработчик приложения вызывает API регистрации приложения registerForAdFiltering
из своего приложения или SDK рекламных технологий со списком eTLD+1 покупателей рекламных технологий. Это позволяет покупателям из списка, и только этим покупателям, фильтровать рекламу на основе статуса установки приложения, как напрямую, так и с помощью SDK своих рекламных технологий. Регистрация дает разработчику приложения полный контроль над тем, должно ли его приложение участвовать в фильтрации рекламы при установке приложения. java void registerForAdFiltering(List<AdTechIdentifier> buyers);
Шаг 2: Запрос на фильтрацию рекламы установки приложений
Когда объявление рассматривается для торгов, покупатели могут выбрать, следует ли отфильтровывать объявление на основе статуса установки приложения. Это делается путем включения имени пакета приложения в метаданные объявления. Запрос на фильтрацию объявлений об установке приложения является частью данных объявлений, которые подаются в процесс аукциона Protected Audience. Эти данные объявлений создаются по-разному в зависимости от того, является ли это контекстным или ремаркетинговым объявлением.
- Для контекстной рекламы, которая является основным вариантом использования фильтрации рекламы установки приложений, информация фильтрации включена как часть данных рекламы, которые покупатели могут предоставить продавцам при ответе на контекстную ставку за пределами защищенной аудитории. Защищенная аудитория ожидает, что информация фильтрации будет возвращена как часть контекстного ответа, как и любые другие метаданные, специфичные для рекламы.
- Для варианта использования ремаркетинга Protected Audience ожидает, что информация фильтрации будет включена в пользовательскую аудиторию. Существует 2 возможности для этого включения: при присоединении к аудитории и при извлечении новых данных аудитории в рамках процесса обновления аудитории. Запрос на фильтрацию рекламы установки приложения должен выглядеть следующим образом в объекте
AdData
JSON:json { "render_uri": "https://..", "metadata": {..}, "filters": { "app_install": { "app_package_names": ["app1.package", "app2.package"] } } }
Шаг 3: Отфильтруйте рекламу установки приложений во время выбора рекламы
Во время запроса рекламы покупатель может передать несколько объявлений обратно продавцу с информацией о фильтрации, чтобы можно было отфильтровать рекламу установленных приложений. Сторона продавца должна передать информацию о фильтрации как часть конфигурации функции selectAds
в поле adData
. Android ожидает формат сообщения, похожий на этот.
AdData myAdData = new AdData.Builder()
.setRenderUri(Uri.parse("https://.."))
.setMetadata("{...}")
.setFilters(new AdFilters.Builder()
.setAppInstalledFilter(new AppInstalledFilter.Builder()
.setPackageNames(ImmutableList.of("app1.package", "app2.package"))
.build())
.build())
.build();
AdSelectionConfig myAdSelectionConfig = new AdSelectionConfig.Builder()
.setSeller(AdTechIdentifier.fromString("example-ssp1.com"))
.setDecisionLogicUri(Uri.parse("https://..."))
...
.setContextualAds(ImmutableList.of(new ContextualAd.Builder()
.setBuyer(AdTechIdentifier.fromString("example.com"))
.setReportingUri("https://example.com/reporting")
.setBid(20)
// myAdData could be taken from the JSON defined earlier
.setAd(myAdData)
.build()))
.build();
// Invoke ad services API to initiate ad selection workflow.
selectAds(myAdSelectionConfig);
Фильтрация обрабатывается в API selectAds
. Защищенная аудитория отфильтровывает рекламу, если указанное в сообщении приложение совпадает с приложением в списке установок конкретного приложения покупателя рекламных технологий. Возможны два результата:
- Приложение не найдено в этом списке, то есть оно не установлено и не открыто.
- Приложение найдено в этом списке, то есть установлено и открыто. Если Protected Audience обнаруживает, что приложение уже существует, то реклама исключается из списка объявлений, которые аукцион использует для запуска
scoreAds
.
Соображения, которые следует учитывать при использовании контекстной рекламы
С фильтрацией рекламы установки приложений API защищенной аудитории начинают поддерживать фильтрацию контекстной рекламы. Несколько вещей важно указать в ситуациях, когда аукцион представляет собой смесь контекстной и ремаркетинговой рекламы или полностью состоит только из контекстной рекламы.
- При запуске аукциона
selectAd
покупатель может передать список объектовContextualAd
. Эти объекты содержат eTLD+1 покупателя рекламы, ставку за рекламу, URL-адрес, указывающий на логику отчетности для рекламы, иAdData
, содержащий фактический URL-адрес контента рекламы, а также подпись проверки, принадлежащую покупателю (см. раздел Подписание контекстной рекламы для получения более подробной информации. Обратите внимание, что форматAdData
используется как в контекстной, так и в ремаркетинговой рекламе. - В начале процесса аукциона контекстные и ремаркетинговые объявления фильтруются с использованием набора имен пакетов, указанных в включенном в
AdData.adFilters.appInstallFilters.packageNames
. Затем определяются значения ставок для любых ремаркетинговых объявлений, и как ремаркетинговые, так и контекстные объявления оцениваются с помощью предоставленной функцииscoreAds
. Побеждает объявление с наивысшим баллом. Обратите внимание, что этот процесс работает даже при отсутствии ремаркетинговых объявлений. Если контекстная реклама выигрывает аукцион и приложение запускает отчет о показах, Protected Audience загружает и выполняет функцию JS с именем
reportWin()
из URL-адреса отчета, включенного в данные контекстной рекламы. Это похоже на то, как отчетность выполняется для объявления ремаркетинга, выигравшего аукцион.Пример функции создания отчета JavaScript:
function reportWin(ad_selection_signals, per_buyer_signals, signals_for_buyer, contextual_signals) { let reporting_address = 'https://reporting.example.com'; return {'status': 0, 'results': {'reporting_uri': reporting_address + '?some_signal=' + per_buyer_signals.some_signal} }; }
Контекстная реклама
Контекстные объявления, включающие фильтрацию установки приложений, должны быть подписаны покупателем. Платформа использует эту подпись для проверки рекламной технологии, которая предоставила рекламу, и какие фильтры установки приложений рекламной технологии следует применять к рекламе. Это делается для того, чтобы предотвратить использование вредоносной рекламной технологией идентификатора другой рекламной технологии для получения выгоды от регистрации фильтрации установки приложений другой рекламной технологии.
Privacy Sandbox извлечет эти ключи из конечной точки ad tech, предоставленной при регистрации. Мы рекомендуем, как наилучшую практику, обновлять ключи часто, но не позднее, чем каждые 6 месяцев.
Privacy Sandbox попросит, чтобы рекламные специалисты подтвердили доступность конечной точки, предоставленной рекламными специалистами, во время процесса регистрации. Для получения более подробной информации о действиях, необходимых для текущих и недавно зарегистрированных рекламных специалистов, см. Инструкции по регистрации .
Руководство разработчика с более подробными инструкциями по внедрению будет опубликовано в ближайшем будущем.
Рекомендовано для вас
- Примечание: текст ссылки отображается, когда JavaScript отключен.
- Руководство разработчика API защищенной аудитории на Android
- Заметки о выпуске
- Поддержка индивидуального таргетинга аудитории с помощью API защищенной аудитории {% дословно %}