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

Фильтрация рекламы, устанавливающей приложение, для защищенной аудитории

Установки новых мобильных приложений обычно обусловлены рекламой, ориентированной на установку приложения. Чтобы максимизировать рентабельность инвестиций в рекламу, рекомендуется не показывать рекламу об установке приложения на устройствах, на которых это же приложение уже установлено. В этом предложении мы называем эту практику «фильтрацией рекламы, ориентированной на установку приложения».

В этом предложении показано, как Защищенная аудитория на Android поддерживает фильтрацию контекстной рекламы, в частности фильтрацию рекламы при установке приложения, с сохранением конфиденциальности. Чтобы принять участие, приложению на устройстве необходимо явно разрешить фильтрацию рекламы, устанавливающей приложение. Во время выбора рекламы кандидаты на рекламу отфильтровываются на основе списка приложений, установленных на устройстве, известном рекламной технологии.

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

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

Шаг 1. Зарегистрируйте приложение для фильтрации рекламы, ориентированной на установку приложения.

Чтобы включить фильтрацию рекламы, ориентированной на установку приложения, разработчик приложения вызывает API регистрации приложения registerForAdFiltering из своего приложения или SDK рекламных технологий со списком eTLD+1 покупателей рекламных технологий. Это позволяет покупателям в списке и только этим покупателям фильтровать рекламу на основе статуса установки приложения напрямую или через SDK своей рекламной технологии. Регистрация дает разработчику приложения полный контроль над тем, должно ли его приложение участвовать или нет в фильтрации рекламы, устанавливающей приложение. java void registerForAdFiltering(List<AdTechIdentifier> buyers);

Шаг 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 above
                      .setAd(myAdData)
                      .build()))
    .build();
// Invoke ad services API to initiate ad selection workflow.
selectAds(myAdSelectionConfig);

Фильтрация обрабатывается в API selectAds . Защищенная аудитория отфильтровывает рекламу, если приложение, указанное в сообщении, соответствует приложению в конкретном списке установки приложений покупателей рекламных технологий. Возможны два исхода:

Приложение не найдено в этом списке, то есть оно не установлено и не открыто.
Приложение найдено в этом списке, то есть оно установлено и открыто. Если Защищенная аудитория обнаруживает, что приложение уже существует, то это объявление исключается из списка объявлений, которые аукцион использует для показа scoreAds .

Что следует учитывать при использовании контекстной рекламы

Благодаря фильтрации рекламы, ориентированной на установку приложения, API Protected Audience начинают поддерживать фильтрацию контекстной рекламы. Несколько вещей важно указать в ситуациях, когда аукцион представляет собой сочетание контекстной рекламы и рекламы ремаркетинга или полностью состоит только из контекстной рекламы.

При запуске аукциона selectAd покупатель имеет возможность передать список объектов ContextualAd . Эти объекты содержат eTLD+1 покупателя рекламы, ставку для рекламы, URL-адрес, указывающий на логику отчетности для рекламы, а также AdData , содержащий фактический URL-адрес содержания объявления, а также проверочную подпись, принадлежащую покупателю ( см. подписывание объявлений для получения более подробной информации. Обратите внимание, что формат AdData используется как в контекстной рекламе, так и в рекламе ремаркетинга.
В начале аукциона контекстная реклама и реклама ремаркетинга фильтруются с использованием набора названий пакетов, указанных в включенном в AdData.adFilters.appInstallFilters.packageNames . Затем определяются значения ставок для любых объявлений ремаркетинга, и как ремаркетинговые, так и контекстные объявления оцениваются с помощью предоставленной функции scoreAds . Побеждает объявление, набравшее наибольшее количество баллов. Обратите внимание, что этот процесс работает, даже если объявления ремаркетинга отсутствуют.
Если контекстное объявление выигрывает аукцион и приложение запускает отчет о показах, Защищенная аудитория загружает и выполняет функцию 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 получит эти ключи из конечной точки рекламных технологий, указанной при регистрации. Мы рекомендуем чаще обновлять ключи, но не позднее, чем каждые 6 месяцев.
Privacy Sandbox попросит рекламных специалистов подтвердить доступность конечной точки, предоставленной рекламной технологией, во время процесса регистрации. Более подробную информацию о действиях, требуемых действующими и вновь зарегистрированными специалистами по рекламе, см. в инструкциях по регистрации .
Руководство разработчика с более подробными инструкциями по реализации будет опубликовано в ближайшем будущем.

{% дословно %} {% дословно %}