Примечания к выпуску песочницы конфиденциальности Android

Privacy Sandbox на Android предлагает программы предварительного просмотра и бета-тестирования для разработчиков. Со временем мы будем добавлять новые API и функции в Developer Preview и продвигать стабилизированные API в бета-программу. Обратная связь приветствуется .

Если вы новичок в Privacy Sandbox на Android, начните с обзора программы . Чтобы начать встраивать Privacy Sandbox в свой проект, настройте среду разработки и установите Privacy Sandbox для Android на тестовое устройство или эмулятор .

Текущие выпуски

Предварительный просмотр Android VanillaIceCream

API защищенной аудитории

  • Добавлена ​​возможность передавать аутентифицированную контекстную рекламу на защищенный аукцион. Сюда также входит отрицательная фильтрация для приложений, уже установленных на устройстве, а также ограничение частоты кликов, показов, просмотров или побед. Реализация отличается от предыдущих итераций, поскольку контекстная реклама должна быть подписана рекламным специалистом. О том, как это реализовать, читайте в руководстве разработчика .
  • ContextualAds переименован в SignedContextualAds вместе со связанными методами получения и установки в AdSelectionConfig; getPerBuyerSignedContextualAds, setPerBuyerSignedContextualAds
  • Если будет передано неаутентифицированное контекстное приложение, оно будет удалено с аукциона.

API отчетов по атрибуции

Privacy Sandbox для Android, бета-обновление, ноябрь 2023 г.

Этот выпуск Privacy Sandbox для бета-версии Android включает обновления API-интерфейсов Privacy Sandbox на общедоступных устройствах Android 14. SDK и образы устройств доступны для загрузки с помощью менеджера SDK Android Studio под названием Android API 34, уровень расширения 10 и функционально аналогичны [Developer Preview 9][b25] с несколькими ключевыми изменениями.

API защищенной аудитории

  • Рекламные специалисты теперь могут использовать [делегирование пользовательской аудитории][b26], чтобы присоединиться к индивидуальной аудитории от имени покупателя, который не присутствует на устройстве.
  • Android теперь поддерживает проведение аукционов в службах назначения ставок и аукционов.
  • Аукционы защищенной аудитории поддерживают оплату по цене за клик.
  • Аукционы и отчеты защищенной аудитории теперь поддерживают заголовки версий данных для надежных сигналов назначения ставок.
  • Аукционы защищенной аудитории поддерживают фильтрацию ограничения частоты показов для событий WIN.
  • Защищенная аудитория теперь поддерживает [интеграцию с API отчетов по атрибуции][b27].

API отчетов по атрибуции

  • API отчетов по атрибуции теперь поддерживает [интеграцию с защищенной аудиторией][b28]

Среда выполнения SDK

  • Возможность из SDK загружать другие SDK в среду выполнения SDK для поддержки сценариев использования посредничества.

Прошлые выпуски

Предварительная версия для разработчиков 10

Дата выхода: 19 декабря 2023 г.

Известные ограничения

  • Существует проблема, из-за которой сервисы Google Play аварийно завершают работу в фоновом режиме и неоднократно информируют пользователя:
    • Перезагрузка устройства может решить эту проблему.
    • Если во время тестирования у вас возникли проблемы с тайм-аутом асинхронных вызовов, попробуйте добавить следующую команду adb, чтобы увеличить порог до истечения времени ожидания:
    • adb shell device_config put adservices fledge_auction_server_overall_timeout_ms 60000;
  • Только физическое устройство: добавление учетной записи Google не поддерживается. Выполните следующие действия, чтобы вывести устройство на главный экран:
    • Установите изображение предварительного просмотра на телефон.
    • Пройдите мастер настройки без подключения к Wi-Fi или мобильной сети.
    • На главном экране подключитесь к Wi-Fi или мобильной сети.
    • Перезагрузите устройство.

API защищенной аудитории

  • Мы представляем новые возможности [Защищенные сигналы приложений][dp98] для поддержки показа релевантной рекламы, ориентированной на установку приложения. В рамках этого DP мы выпускаем API, которые позволят специалистам по рекламе:
    • Управляйте сигналами, сохраняя события приложения в защищенном хранилище на устройстве, которое используется для показа релевантной рекламы, ориентированной на установку приложения.
    • Запустите защищенный аукцион по ставкам и службам аукционов, работающим в доверенных средах исполнения, где они могут получить доступ к своим соответствующим сигналам, помогающим выбирать рекламу и назначать ставки.

API отчетов по атрибуции

  • Эта версия API отчетов по атрибуции:
    • Добавляет интеграцию с защищенной аудиторией, которая позволяет настраивать параметры аудитории в сводных сводных отчетах.
    • Поддерживает поставщика Google Cloud в качестве TEE для службы агрегации.
    • Добавляет полеshared_debug_key для поддержки отладки межсетевой атрибуции без перенаправлений.
    • Добавляет заголовки версий в запросы подробного отчета об отладке.

Персонализация на устройстве

  • Первоначальный выпуск для исследователей и ранних разработок.
  • Персонализация на устройстве представляет инновационный способ настройки продуктов и услуг, обеспечивая при этом улучшенную защиту конфиденциальности конечных пользователей. Персонализация на устройстве предоставляет набор сервисов и алгоритмов в качестве строительных блоков для достижения этой цели, включая, помимо прочего:
    • Федеративные вычисления (FC), которые позволяют обучать, оценивать и персонализировать модели с помощью федеративного обучения. Использование Federated Compute в рамках персонализации на устройстве будет основано на обучении модели и (необязательно, если необходимо) умозаключении.
    • Сопоставление и перекрестное сопоставление данных, расположенных в разных местах, на основе фильтра кукушки.
    • Дифференциально частное (DP) обучение разреженных моделей с использованием новых методов, таких как чередующаяся минимизация DP (для обучения на несопоставимо расположенных данных) и персонализация модели под рекламным щитом DP. ### Предварительная версия для разработчиков 9

Дата выхода: 15 августа 2023 г.

Известные ограничения

  • Данные аукциона, созданные при вызове API ставок и аукционов, не удаляются автоматически в DP9.
  • Вызов getAdSelectionData и persistAdSelectionResult при отзыве согласия приводит к сбою процесса.
  • Функция отрицательной фильтрации не работает с getAdSelectionData и persistAdSelectionResult .

API защищенной аудитории

  • Рекламные специалисты теперь могут использовать делегирование индивидуальной аудитории , чтобы присоединить пользовательскую аудиторию к звонящему на устройстве.
  • Android теперь поддерживает проведение аукционов в службах назначения ставок и аукционов . Аукционы с защищенной аудиторией поддерживают выставление счетов по цене за клик.
  • API взаимодействия с отчетами теперь называется reportEvent .
  • Метод ограничения частоты показов и типы счетчиков переименованы .
  • Отчеты об отладке доступны для получения информации о том, почему аукцион был проигран, или для выявления проблем в логике JavaScript.

API отчетов по атрибуции

  • В этом выпуске улучшены отчеты об отладке API отчетов об атрибуции за счет:
    • Поддержка подробных отчетов об отладке, которые поддерживаются в Интернете .
    • Включение отчетов об отладке межсетевой атрибуции и атрибуции приложений (требуется AdId как при регистрации в Интернете, так и в приложении).
  • Специалисты по рекламе могут настраивать параметры шума для различных сценариев отчетности.
  • В этом выпуске используется атрибуция на основе происхождения, что означает:
    • Origin используется для регистрации.
    • На одном сайте принимаются несколько источников.
    • Новое ограничение скорости: один источник для каждого исходного приложения или регистрации.
  • Специалисты по рекламе теперь могут отключить регистрацию для локального тестирования сценариев использования отчетов об атрибуции.

Среда выполнения SDK

  • SDK может запускаться только из белого списка служб или привязываться к нему.
  • SDK имеет доступ только к подмножеству системного ContentProvider (например, com.android.providers.settings.SettingsProvider ), где полученные данные не имеют идентификаторов и не могут быть использованы для создания отпечатка пальца пользователя. Эти проверки также применимы к доступу к ContentProvider с помощью ContentResolver .
  • SDK имеет доступ только к подмножеству защищенных приемников широковещательной передачи (например, android.intent.action.AIRPLANE_MODE ).
  • SDK может запускать активность, принадлежащую другому приложению, но с ограничениями на то, что можно отправлять в намерении.

Privacy Sandbox для Android, бета-версия марта 2023 г.

Выпуск Privacy Sandbox для бета-версии Android от марта 2023 года включает обновления API-интерфейсов Privacy Sandbox на общедоступных устройствах Android 13. Этот выпуск включает API-интерфейсы Ad Services Extensions 5 и функционально аналогичен Developer Preview 6 с некоторыми ключевыми изменениями.

Известные ограничения

  • Задание фоновой выборки, которое периодически запускается для обновления пользовательских аудиторий FLEDGE, приводит к сбою процесса. Из-за этой проблемы FLEDGE по умолчанию отключен.

Общий

  • Начиная с этой версии, вы можете использовать API отчетов по атрибуции. API ранее был отключен. Если вы использовали API отчетов по атрибуции в предыдущей бета-версии, очистите данные приложения или устройства перед использованием этой бета-версии, выполнив одно из следующих действий:
    • На устройстве или эмуляторе перейдите в «Настройки» и очистите хранилище приложений (а не только кеш) для всех приложений, используемых для тестирования.
    • Выполните сброс настроек на физическом или эмулируемом устройстве.
    • Для эмулируемого устройства выполните функцию очистки данных .
  • Отчеты об атрибуции теперь поддерживают ключи отладки, что позволяет разработчикам получать неизмененные отчеты и отчеты с улучшенной конфиденциальностью из API атрибуции. Ключи отладки дают возможность лучше понять структуру отчетов при переходе в Privacy Sandbox.
  • В отчетах об атрибуции недавно возникла ошибка в рекламных службах, из-за которой registerSource и registerTrigger завершались сбоем с исключениями. Если вы столкнулись с этими проблемами во время разработки, значит, исправление уже выпущено, и эти проблемы должны исчезнуть со временем.
  • Функциональность предварительной версии API Topics теперь соответствует функции Privacy Sandbox в предварительной версии Android Developer Preview. Вызывающий API-интерфейс Topics может просматривать темы, не включая вызов извлечения темы в расчет еженедельной эпохи и не влияя на список наблюдаемых тем для вызывающего абонента. Подробности см. в поле shouldRecordObservation .

  • Чтобы включить тестирование в FLEDGE на Android, зарегистрируйтесь в бета-программе и используйте ту же учетную запись Google для входа на свои тестовые устройства. В противном случае попытки вызвать API вызывают исключение IllegalStateException с сообщением «Служба недоступна». FLEDGE должен быть восстановлен в следующей бета-версии.

    Тем временем тестирование с использованием предварительной версии для разработчиков может продолжаться и приветствуется, а FLEDGE можно включить на устройствах вручную со следующими оговорками:

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

    adb shell device_config set_sync_disabled_for_tests persistent
adb shell setprop debug.adservices.fledge_select_ads_kill_switch false
adb shell setprop debug.adservices.fledge_custom_audience_service_kill_switch false
adb shell device_config put adservices fledge_background_fetch_enabled true

Прошлые выпуски

Предварительный просмотр для разработчиков 8

Дата выхода: 23 мая 2023 г.

Известные ограничения

  • Хотя фильтры ограничения частоты с типом WIN можно добавлять в объявления для защищенной аудитории, тип WIN пока не поддерживается, и фильтры этого типа игнорируются.
  • Чтобы сообщать о выигрышных показах победителям аукционов защищенной аудитории, покупатели должны быть зарегистрированы в Privacy Sandbox. Это требование не может быть отменено.
  • Чтобы получить доступ к настройкам Privacy Sandbox на устройстве, на котором доступна Privacy Sandbox, выберите «Настройки» > Google > «Реклама» > «Privacy Sandbox» .
  • Невозможно развернуть проекты с помощью эмуляторов в Android Studio Giraffe. Другие версии Android Studio должны работать нормально. Исправление будет выпущено в Android Studio Giraffe 26 мая 2023 г.

API защищенной аудитории

API отчетов по атрибуции

  • Добавлены триггерные фильтры OR. Это означает, что фильтры теперь состоят из набора фильтров, который представляет собой список карт фильтров. Если ни одна из карт фильтров в наборе не соответствует данным фильтра источника, объект event_trigger_data игнорируется.
  • Окно истечения срока действия показов и отчетов для API агрегирования и уровня событий были отделены друг от друга.
  • Добавлена ​​поддержка ключей дедупликации в агрегированных отчетах.
  • В отчеты о событиях добавлен scheduled_report_time для обеспечения соответствия с Privacy Sandbox для Интернета .
  • Реализована межсетевая атрибуция без редиректов .

Среда выполнения SDK

Предварительный просмотр для разработчиков 7

Дата выхода: 26 января 2023 г.

FLEDGE на Android API

  • Параметр custom_audience_signals был переименован в следующих методах JavaScript:
    • generateBid() был переименован в custom_audience_bidding_signals .
    • scoreAd() был переименован в custom_audience_scoring_signals .
    • reportWin() был переименован в custom_audience_reporting_signals .
  • В этом выпуске добавлено новое переопределение selectAds , которое использует AdSelectionFromOutcomeConfig для сравнения результатов selectAds . Это позволяет SDK рекламных технологий, использующим этот API, запускать каскадную медиацию. Более подробная информация изложена в руководстве разработчика .
  • API selectAds() теперь поддерживает кэширование логики ставок и оценки JavaScript, получаемой в процессе выбора объявления.
    • Кэшем можно управлять с помощью заголовков Cache-Control , возвращаемых серверами во время вызова выборки JavaScript. Используйте no-cache или no-store чтобы предотвратить кэширование ответов JavaScript, и max-age, чтобы контролировать продолжительность кэширования.
    • По умолчанию max-age текущей записи кэша равен двум дням.

Отчеты по атрибуции в Android API

  • В этом выпуске добавлена ​​поддержка последовательного перенаправления для registerSource() и registerTrigger() . Потребитель API теперь может использовать перенаправление HTTP в качестве ответа сервера.

Первоначальная бета-версия, январь 2023 г.

Дата выхода: 9 января 2023 г.

Privacy Sandbox для Android Beta 1 представляет собой первую версию API-интерфейсов Privacy Sandbox на общедоступных устройствах и добавляет улучшения в перечисленные ниже области.

Общий

  • Privacy Sandbox на Android Beta 1 функционально эквивалентна Developer Preview 5 с некоторыми дополнительными функциями и ограничениями, перечисленными ниже.
  • Разработчики должны пройти процедуру регистрации , чтобы использовать API, связанные с рекламой (включая Topics, FLEDGE и отчеты об атрибуции). В процессе регистрации проверяется личность разработчика и собираются данные о разработчике, необходимые для API.
  • С выпуском Privacy Sandbox для Android Beta 1 разработчики, зарегистрировавшиеся и внесшие данные в белый список , могут получить возможность протестировать свою работу на своих физических устройствах. Для разработки с использованием стабильных API в выпуске загрузите новый SDK Ad Services Extensions 4 .

API тем

  • Android Topics Classifier Colab позволяет разработчикам лучше понять, как работает модель классификатора.

API отчетов по атрибуции

  • Отчеты об атрибуции отключены и недоступны для использования в этой версии. Доступ к этому API должен быть снова включен в следующей бета-версии. Вам рекомендуется продолжить тестирование с помощью Developer Previews.

Среда выполнения SDK

Ожидается, что следующие ограничения будут исправлены в следующей основной версии платформы Android:

  • Отображение рекламы в прокручиваемом представлении, таком как RecyclerView в настоящее время не работает должным образом. Вы можете столкнуться с зависанием, если размер элемента будет изменен. События сенсорной прокрутки пользователя не передаются в среду выполнения должным образом.
  • Отрисовка WebView недоступна в процессе выполнения SDK.
  • Хранилище для каждого SDK недоступно.
  • Поддержка API getAdId и getAppSetId еще не активирована.

Предварительный просмотр для разработчиков 6

Дата выхода: 31 октября 2022 г.

Privacy Sandbox в Android Developer Preview 6 содержит улучшения в следующих областях:

Общий

  • При подготовке к выпуску рабочей версии в Developer Preview 6 появился флаг, отключающий доступ к API с сохранением конфиденциальности по умолчанию. В целях тестирования включите доступ к API с сохранением конфиденциальности в Developer Preview, выполнив следующую команду:

    adb shell device_config put adservices global_kill_switch false

  • Для API AdIdManager и AppSetIdManager требуются сервисы Google Play версии 22.36.16 или выше.

    • На устройстве под управлением Android убедитесь, что правильная версия указана в разделе «Настройки» > «Приложения» > «Сервисы Google Play» .
    • Если вам необходимо обновить службы Google Play до нужной версии, войдите в систему на своем тестовом устройстве или эмуляторе Android, используя учетную запись Google. Затем перейдите в Google Play Store > значок профиля > Настройки > О программе . Под заголовком «Версия Play Store» нажмите «Обновить Play Store» .
    • Этот шаг применим только для разработки и тестирования и не понадобится после того, как Privacy Sandbox станет доступен общедоступным пользователям.

API тем

FLEDGE на Android API

  • Если вы проводите тестирование на реальных серверах, включение API теперь обязательно. Пожалуйста, выполните следующие действия , чтобы настроить ваше устройство. Эти действия не требуются, если вы используете удаленные переопределения, присутствующие в примере приложения .
  • Критические изменения:
    • Заменил Url в параметрах на Uri . Это относится ко всем API FLEDGE и пользовательскому JavaScript для логики назначения ставок и оценки.
    • Удалено поле owner из входных данных API индивидуальной аудитории.
  • Неполные пользовательские аудитории теперь сразу же получают право на фоновое обновление.
  • Ограничение памяти JavaScript теперь установлено на уровне 10 МБ. Это относится к логике торгов и оценки.

API отчетов по атрибуции

  • Специалисты по рекламе должны зарегистрироваться, прежде чем они смогут использовать API отчетов об атрибуции в Developer Preview 6. Дополнительную информацию см. в разделе Регистрация учетной записи Privacy Sandbox .
  • В этом выпуске представлены ключи отладки, которые позволяют разработчикам получать неизмененные отчеты вместе с отчетами с улучшенной конфиденциальностью из API отчетов об атрибуции. Ключи отладки дают возможность лучше понять структуру отчетов при переходе на Privacy Sandbox.

Предварительный просмотр для разработчиков 5

Общий

  • Прежде чем вы сможете получить доступ к API Privacy Sandbox в Developer Preview 5, вам необходимо сначала включить API и настроить разрешения для конкретных API .
    • Проекты Privacy Sandbox на Android позволяют пользователям контролировать, активны ли на их устройстве API, обеспечивающие конфиденциальность, и среда выполнения SDK. Эти настройки отключены по умолчанию в Developer Preview 5. Вы можете включить доступ к API с помощью команды adb .
    • Вызывающее приложение должно указать разрешения для API в манифесте и связанных с ним конфигурациях AdServices , которые контролируют доступ для встроенных SDK.
  • Приложения должны вызывать API-интерфейсы, обеспечивающие конфиденциальность, при работе на переднем плане.
  • AdIdManager и AppSetIdManager в настоящее время не работают. Они будут включены в более поздней версии.

Среда выполнения SDK

  • sendData() будет устаревшим в будущей версии.
  • loadSdk() теперь возвращает объект IBinder для облегчения двусторонней связи между SDK с поддержкой среды выполнения и приложениями, определенными в AIDL .
  • Приложения имеют доступ к дополнительным событиям жизненного цикла SDK, включенным во время выполнения, например, когда процесс SDK завершается.

API отчетов по атрибуции

В этом выпуске представлены дополнительные функции API отчетов по атрибуции, в том числе:

  • Поддержка зашифрованных агрегированных отчетов.
  • Поддержка перекрестных приложений и веб-измерений .
  • Консолидированные заголовки в ответах на регистрацию источника и триггера:
    • Источник: Attribution-Reporting-Register-Aggregatable-Source теперь является частью Attribution-Reporting-Register-Source
    • Триггер: Attribution-Reporting-Register-Event-Trigger, Attribution-Reporting-Register-Aggregatable-Trigger-Data и Attribution-Reporting-Register-Aggregatable-Values ​​объединены в один заголовок с именем Attribution-Reporting-Register-Event-Trigger
    • Attribution-Reporting-Redirects по-прежнему представляет собой отдельный заголовок.

FLEDGE на Android API

Этот выпуск включает в себя несколько новых функций и улучшений, а также критические изменения:

  • Критические изменения:
    • runAdSelection() был переименован в selectAds() .
    • Параметр AdSelectionConfig.Builder.setAdSelectionSignals() заменен на AdSelectionSignals , который представляет объект JSON.
    • Заменено использование String для представления покупателя/продавца рекламных технологий на объект AdTechIdentifier .
    • Добавлены классы TestCustomAudienceManager и TestAdSelectionManager для переопределения удаленной выборки JavaScript .
    • Владельцем пользовательской аудитории должно быть имя пакета вызывающего приложения.
  • API-интерфейсы FLEDGE теперь проверяют вызывающее приложение на соответствие набору ограничений и ограничений , описанных в руководстве разработчика . Ниже приведены некоторые примечательные примеры.
    • selectAds и reportImpression теперь имеют ограничения по времени выполнения, после чего вызов будет прекращен.
    • selectAds и reportImpression теперь имеют ограничение на объем памяти, потребляемой во время выполнения JavaScript. API-интерфейсы выдадут ошибку, если потребление памяти превысит настроенные пределы.
    • selectAds и reportImpression теперь проверяют объект AdSelectionConfig , чтобы гарантировать синтаксическую корректность полей и соответствие URL-адресов eTLD+1, используемому в поле продавца.
    • AdServices теперь проверяет пользовательские аудитории во время их создания. Часть этой проверки включает в себя проверку допустимости срока действия и применение ограничения на количество индивидуализированных аудиторий, которые может создать приложение, и на общий размер объявлений, предоставляемых в вызове joinCustomAudience . Проверка также гарантирует, что URI, предоставленные для сигналов, извлечения логики ставок и фоновой выборки, находятся в домене покупателя.
  • Метаданные пользовательской аудитории обновляются ежедневно с помощью процесса фоновой выборки .
  • Пользовательские аудитории удаляются при удалении приложения-владельца.
  • Добавлена ​​поддержка указания надежных сигналов оценки и надежных данных ставок при выборе объявлений. См. пример кода для формата ответа.
  • API-интерфейсы FLEDGE для Android зависят от версии WebView 105.0.5195.58 или выше. Подробности см. в информации по настройке в руководстве для разработчиков.

  • Известные вопросы:

    • При присоединении к пользовательской аудитории платформа в настоящее время не выполняет фоновые обновления немедленно, если какие-либо метаданные или значения AdData пусты или имеют null . Особая аудитория не сможет выбирать объявления, пока она не будет обновлена ​​через день. В будущем выпуске неполные пользовательские аудитории сразу же получат право на фоновую выборку обновлений. Текущий лимит памяти по умолчанию для выполнения JavaScript слишком низок и может привести к сбою JavascriptEngine на устройствах при обычных рабочих нагрузках. Выполнение вашего JavaScript может неожиданно прерваться с сообщением об ошибке "Fatal javascript OOM in CALL_AND_RETRY_LAST" .

      Вы можете решить эту проблему вручную, настроив правильный порог памяти с помощью следующей команды:

      adb shell "device_config put adservices fledge_js_isolate_enforce_max_heap_size 10485760"

    • Объявления для индивидуальной аудитории, которые не соответствуют требуемой структуре JSON, обновляются во время фоновой выборки.

API тем

Обновления инструментов

Android Studio Canary поддерживает создание APK-файлов SDK с новым типом модуля. Руководство разработчика среды выполнения SDK было обновлено, и это обновление отражено в примерах приложений Privacy Sandbox на GitHub .

Предварительный просмотр для разработчиков 4

Дата выхода: 14 июля 2022 г.

Privacy Sandbox в Android Developer Preview 4 содержит улучшения в следующих областях:

Среда выполнения SDK

  • Приложения теперь могут взаимодействовать с SDK с включенной средой выполнения (RE-SDK) посредством добавления sendData() .
  • Локальное хранилище теперь доступно в процессе выполнения SDK.
  • SDK также может отображать отдельные видеообъявления или контент в среде выполнения SDK.
  • Добавлены разъяснения по использованию отражения, чтобы включить возможность использования отражения при условии, что контент не находится в другом RE-SDK.

API отчетов по атрибуции

В этом выпуске представлены изменения, повышающие ясность использования API отчетов по атрибуции, такие как:

  • Изменения в формате сводного отчета для улучшения читабельности.
  • Обновлены поля заголовков для функций фильтрации конверсий и назначения ставок.
  • В справочник по API WebApp добавлены пояснения, поясняющие регистрацию источника и триггера, а также доступность API конфиденциальности и согласия.

FLEDGE на Android API

Этот выпуск включает в себя новые функции, помогающие в тестировании и отладке, а также внутренние улучшения:

  • Добавлена ​​поддержка переопределения удаленных URL-адресов для получения логики JavaScript во время разработки.
  • Улучшен отчет об ошибках при выборе объявления.
  • Неактивные пользовательские аудитории теперь отфильтровываются при выборе объявлений.

API тем

Этот выпуск включает в себя несколько существенных изменений API Topics, наиболее важные из которых:

  • Тип возвращаемого значения API getTopics() был изменен на новый тип объекта Topic , который инкапсулирует целочисленные идентификаторы, соответствующие темам в Таксономии, а также информацию о версиях классификатора и Таксономии. Вам следует обновить все существующие приложения, используя этот API.
  • API тем теперь требует нового обычного разрешения.
  • Внедрение системы «Классификатор на устройстве» для динамического назначения тем на основе общедоступной информации о приложении.

Известные вопросы

  • Первоначальный выпуск этих образов устройств (версия 6) не загружается в эмуляторе Android версии 31.2.10. Обновленные образы устройств, устраняющие проблему, доступны по состоянию на 27 июля 2022 г.

Предварительный просмотр для разработчиков 3

Дата выхода: 9 июня 2022 г.

Privacy Sandbox для Android Developer Preview 3 добавляет функциональность API отчетов по атрибуции и FLEDGE для Android.

API отчетов по атрибуции

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

Этот выпуск включает ресурсы для разработчиков, которые помогут вам протестировать следующие функции API отчетов по атрибуции:

  • Регистрация источника атрибуции и триггерных событий
  • Используйте атрибуцию с приоритетом источника и атрибуцию после установки.
  • Получать отчеты о мероприятиях
  • Получайте сводные отчеты, которые в этой версии не зашифрованы.

Для облегчения тестирования предоставляются образец приложения и эталонный сервер рекламных технологий.

Известные вопросы:

ФЛЕДЖ на Android

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

Этот выпуск включает ресурсы для разработчиков, которые помогут вам протестировать следующие функции FLEDGE на Android:

  • Присоединяйтесь к индивидуально настроенной аудитории или покиньте ее и наблюдайте, как значения параметров могут повлиять на результаты аукциона.
  • Получение кода аукциона JavaScript с удаленных конечных точек
  • Настройте и инициируйте аукционы рекламы на устройстве.
  • Работа с отчетами о показах
  • Для облегчения тестирования предоставляются пример приложения и конфигурация фиктивного сервера.

Известные вопросы:

Предварительный просмотр для разработчиков 2

Дата выхода: 17 мая 2022 г.

Версия Developer Preview 2 включает ранние предварительные версии API отчетов по атрибуции MeasurementManager .

  • Вы можете вызвать registerSource() и registerTrigger() , чтобы зарегистрировать рекламные события приложения и получить отчетные данные на уровне событий для атрибуции между приложениями. В нашей текущей реализации используется атрибуция «последним касанием». Отчеты планируются к отправке в соответствии с окнами отчетов . Дополнительную информацию см. в справочнике по API MeasurementManager .

  • Фактическая загрузка отчета происходит в конце фиксированных интервалов времени, а не в точное запланированное время. По умолчанию интервал загрузки отчетов составляет 4 часа, но его можно изменить с помощью следующей команды adb:

    adb shell device_config put adservices measurement_main_reporting_job_period_ms <duration in milliseconds>

  • Пример приложения и эталонный сервер рекламных технологий для тестирования API будут опубликованы в будущем выпуске.

  • Другие функции API отчетов по атрибуции MeasurementManager , такие как сводные отчеты, атрибуция после установки и перенаправления, будут доступны в более поздней версии.

Предварительный просмотр разработчика 1

Дата выхода: 28 апреля 2022 г.

Версия Developer Preview 1 включает ранние предварительные версии API Topics и среды выполнения SDK . Функциональность FLEDGE для Android и API отчетов по атрибуции станут доступны в будущем выпуске.

  • API тем
    • API getTopics() в настоящее время возвращает тестовые значения на основе автономной классификации для ограниченного набора приложений. Классификация на устройстве еще не реализована.
    • Вы можете использовать команды adb для переопределения интервалов эпох и принудительного запуска вычислений эпох.
    • Подробности читайте в руководстве разработчика Topics .
  • Среда выполнения SDK
    • Вы можете упаковать и собрать SDK с поддержкой среды выполнения (RE SDK), используя новый элемент <sdk-library> в файле манифеста вашего приложения SDK. Установите RE SDK на поддерживаемое тестовое устройство или эмулятор так же, как вы обычно устанавливаете приложение во время разработки.
    • Вы можете интегрировать приложение с RE SDK, загрузить его в среду выполнения SDK и протестировать влияние ограниченного доступа на код SDK — разрешения, память и связь между приложением и SDK. API-интерфейсы хранилища для RE SDK еще не реализованы и станут доступны в будущем выпуске.
    • SDK может отображать рекламные баннеры или контент на основе WebView в среде выполнения SDK.
    • Дополнительные сведения см. в руководстве разработчика среды выполнения SDK .
  • Android-проверка ворса
    • Проверка Android lint может неправильно отображать предупреждения в проектах, скомпилированных с уровнем API TiramisuPrivacySandbox . Например, вы можете увидеть предупреждающее сообщение: «Для вызова требуется уровень API 33». Вы можете временно решить эту проблему, используя аннотацию @SuppressLint("NewApi") .