Для доступа к API анализа релевантности и измерения в Privacy Sandbox на Chrome и Android разработчикам необходимо зарегистрироваться в Privacy Sandbox. Это включает в себя отчетность по атрибуции, защищенную аудиторию, темы, частную агрегацию и общее хранилище. Регистрация разработчика проверяет сущности, которые вызывают эти API, и собирает данные, необходимые для правильной настройки и использования API. Регистрация добавляет дополнительный уровень защиты и прозрачности в отношении того, кто собирает данные, и предотвращает попытки неправомерного использования API для сбора несущественных данных. Для обеспечения прозрачности, подлежащей аудиту, информация о регистрации компании становится общедоступной. Компаниям следует запланировать не менее пяти недель на завершение процесса регистрации. Это включает время на устранение любых непредвиденных проблем с отправкой данных через консоль или других проблем, которые могут возникнуть. Это не включает дополнительное время, которое может потребоваться компаниям для внутренней подготовки перед отправкой формы.
Прежде чем начать
Перед началом регистрации создайте учетную запись в консоли «Песочницы конфиденциальности» . Подробнее о создании учетной записи можно узнать здесь.
Как записаться
Для регистрации разработчикам необходимо использовать консоль Privacy Sandbox . Необходимо предоставить следующую информацию:
- Информация о вашем бизнесе
- Это включает в себя контактный адрес электронной почты и ссылки на вашу политику конфиденциальности.
- API и сервисы, которые вы планируете использовать
- Для некоторых сервисов требуется дополнительная информация, например, сведения о вашем облачном провайдере.
- Сайт или название SDK, которые вы хотите зарегистрировать.
- Здесь вы будете вызывать API.
- Подтверждение использования вами API
- Если вы регистрируете сайт, вам потребуется загрузить файл подтверждения на свой сервер.
Зарегистрируйте свой сайт, Android SDK или Android-приложение.
В процессе регистрации вам необходимо указать сайт или SDK (или и то, и другое), которые вы будете использовать для вызова API.
Способ регистрации зависит от того, как вызываются API-интерфейсы «песочницы конфиденциальности»:
- Если вы веб-разработчик и ваш сайт напрямую обращается к API Privacy Sandbox, вам следует указать свой сайт при регистрации.
- Если вы разработчик Android SDK, укажите название вашего SDK при регистрации. Если ваш SDK использует API Attribution Reporting, Protected Audience или оба API, укажите также название вашего сайта при регистрации. Приложениям, использующим ваш SDK, не нужно регистрироваться отдельно, если только они не вызывают API Privacy Sandbox напрямую из своего кода. Если вы тестируете API Attribution Reporting на Android в больших масштабах, вам потребуется указать все используемые вами источники.
- Если вы являетесь разработчиком приложений и ваше приложение напрямую обращается к API Attribution Reporting, Protected Audience или к обоим API, вам следует указать свой сайт при регистрации.
- Если вы разработчик приложений и полностью делегируете функциональность рекламы SDK, вам не нужно проходить процесс регистрации.
Для каждого сайта или SDK, использующего API Privacy Sandbox, требуется уникальная регистрация и индивидуальное подтверждение. Приложения, напрямую обращающиеся к API Privacy Sandbox, могут быть включены в одну регистрацию. Если вы планируете использовать несколько API, укажите каждый из них в процессе регистрации. Примечание: Сайт, на котором вы регистрируетесь, будет тем же сайтом, который будет использоваться для получения ключей шифрования для использования Topics на Android и ключа подписи для использования Protected Audience на Android. Дополнительная информация о конечной точке шифрования для Topics на Android и дополнительная информация о ключах подписи для Protected Audience .
Обновить информацию о зачислении
После завершения процесса вы сможете обновить данные о своем зачислении через консоль. Ваше текущее зачисление останется активным, пока ваши изменения находятся на рассмотрении.
Если какая-либо из следующих сведений изменится, вам потребуется повторно загрузить новую версию файла подтверждения:
- ссылки на политику конфиденциальности
- Информация о сайте
- выбранные API
Статусы зачисления
После отправки заявки на зачисление вы можете увидеть следующие этапы обработки:
- Обзор
- Мы проверяем вашу регистрацию. Никаких действий не требуется.
- Создайте файл аттестации.
- Ваша регистрация одобрена. Для сайтов необходимо подготовить подтверждающий файл в течение 30 дней.
- Регистрация завершена.
- Вы успешно зарегистрировались и создали файл подтверждения (если необходимо). Дальнейших действий не требуется.
- Ошибки с файлами аттестации.
- Файл с подтверждением находится не в том месте.
- В течение 30 дней нам не удалось найти файл подтверждения вашей деятельности на вашем сайте.
- Приём заявок приостановлен
- Файл подтверждения не был корректно настроен в течение первых 30 дней или его больше не удается найти после ранее успешной регистрации. Для получения дополнительной информации обратитесь по адресу privacy-sandbox-enrollment@google.com .
- Файл с подтверждением находится не в том месте.
График зачисления
После отправки вашей заявки мы рассмотрим и обработаем её. После завершения проверки вы увидите подтверждение в консоли и сможете получить доступ к файлу подтверждения для настройки. Файл должен быть общедоступным по пути /.well-known на сайте, для которого была оформлена регистрация, в течение 30 дней с момента одобрения регистрации. Разработчики Android могут предоставить идентификатор регистрации разработчикам приложений, чтобы приложения могли устанавливать детальный контроль доступа. Для получения дополнительной информации см. документацию Android по настройке рекламных сервисов для конкретных API . Примечание: Ввод корректной информации в вашей первоначальной заявке и своевременный ответ на любые запросы службы технической поддержки Google помогут ускорить процесс.
Регистрация для работы с различными средами разработки
Ваши среды тестирования, бета-тестирования, контроля качества и тестирования будут автоматически подключены, если они используют тот же сайт, что и ваша производственная среда. Вы можете тестировать локально без подключения к системе. Для локального тестирования мы предоставляем возможность переопределения параметров разработчиками из Chrome 116 с помощью флага Chrome и параметра командной строки:
- Флаг:
chrome://flags/#privacy-sandbox-enrollment-overrides - CLI:
--privacy-sandbox-enrollment-overrides=https://example.com,https://example.co.uk,...
Ограничения
При определении структуры регистрации разработчиков в вашей организации обратите внимание на следующие ограничения:
- К одной регистрации можно привязать только один сайт.
- Одна регистрация включает только один участок.
- Ограничения, специфичные для SDK:
- Одна регистрация может содержать несколько SDK.
- Данный SDK может быть связан только с одной регистрацией.
- Дополнительные регистрации допускаются, но они должны касаться независимых продуктов или направлений бизнеса, которые четко определены и поддаются публичной проверке (то есть, существует соответствующий общедоступный веб-сайт, описывающий конкретный продукт). Нельзя регистрировать несколько продуктов одновременно. Подтверждения применяются к каждой регистрации отдельно.
- При регистрации на уровне сайта одна регистрация может охватывать неограниченное количество источников, если они находятся на одном сайте. Однако ограничение на количество источников, сообщающих о результатах, на один источник ( Chrome , Android ) означает, что вы, как правило, ограничены одним источником на одного издателя.
Множественная регистрация для одного субъекта
Более сложные организации, имеющие несколько уникальных продуктов, могут подать заявку на участие в программе более чем в одном проекте. Например, если ваша компания занимается как предоставлением услуг по поддержке поставщиков услуг (SSP), так и предоставлением услуг по управлению данными (DSP), вы можете претендовать на участие в программе в нескольких проектах.
Для каждого продукта необходимы отдельные сайты, с которых можно вызывать API. Вам потребуется предоставить общедоступную информацию о каждом продукте, который вы хотите зарегистрировать (например, ссылку на общедоступный веб-сайт, описывающий продукт).
Если вы хотите зарегистрировать более одного сайта или SDK, перейдите на вкладку «Регистрации» в навигации консоли. После одобрения первой регистрации вы можете выбрать «Запросить регистрации», чтобы запросить добавление новых. После отправки заявка будет рассмотрена, и вы получите электронное письмо и увидите статус в консоли после завершения процесса проверки.
Перенаправление с отчетами об атрибуции
Рассмотрим сценарий, когда сайт A не зарегистрирован, а сайт B зарегистрирован. ARA будет отправлять запросы на перенаправления на URL-адреса, даже если сайт A не зарегистрирован. В результате перенаправление с siteA.com на siteB.com будет работать. Однако источники и триггеры будут регистрироваться только от зарегистрированных рекламных технологий.
Подпишитесь на услугу агрегации
Регистрация сервиса агрегации является частью процесса регистрации в консоли. Каждая регистрация сервиса агрегации должна включать идентификатор учетной записи AWS или учетной записи сервиса Google Cloud, в которой будет развернут сервис агрегации. Специалисты по рекламным технологиям имеют возможность связывать несколько сайтов с одной учетной записью или несколько учетных записей с одним сайтом для различных целей тестирования, эксплуатации и повышения экономической эффективности.
Загрузите файл с подтверждением.
После регистрации и прохождения процесса верификации вы сможете получить доступ к своему аттестационному файлу в консоли. У вас будет 30-дневный период с момента получения аттестационного файла для его окончательного размещения. В течение этого времени вы можете продолжать использовать API, однако предполагается, что вы не будете регистрироваться, если не сможете соблюдать условия аттестации в течение 30-дневного периода.
Для завершения регистрации сделайте файл доступным по общедоступному пути .well-known на зарегистрированном сайте. Например, если вы регистрируете https://example.com , разместите файл подтверждения по адресу https://example.com/.well-known/privacy-sandbox-attestations.json . Вы также можете использовать HTTP-перенаправления только на поддомены вашего зарегистрированного сайта для предоставления доступа к файлу подтверждения.
Вы обязаны соблюдать требования аттестации и хранить файл аттестации на протяжении всего периода регистрации. Файлы аттестации регулярно проверяются, и длительное несоблюдение этого требования приведет к сбоям вызовов API до тех пор, пока файл не будет восстановлен.
Обратите внимание, что:
- В рамках задачи Privacy Sandbox будет запрашиваться файл подтверждения от зарегистрированных поставщиков рекламных услуг. Запрос файла будет выполняться не чаще одного раза в час. API-запросы не будут инициировать запрос на получение файла подтверждения.
- Предполагается, что файл подтверждения будет доступен публично. Разработчики рекламных технологий должны ожидать запросов на получение данных от внешних сторон, включая исследователей, регулирующие органы и пользователей (помимо запросов от инфраструктуры Privacy Sandbox). Разработчики рекламных технологий должны предоставлять им тот же файл, что и Google.
Что касается аттестаций Android, разработчикам приложений и SDK необходимо согласиться с аттестацией в форме регистрации в консоли, и им не нужно размещать файл аттестации на своем сервере, если они не используют другие API песочницы конфиденциальности.
Обновите аттестацию, чтобы добавить больше API.
Если вы решите добавить в свою регистрацию больше API позже, вам потребуется обновить регистрацию. В рамках этого процесса вы получите обновленный файл подтверждения, который необходимо разместить в папке .well-known на вашем сайте, прежде чем вы сможете вызывать новые API.
Обновите файл аттестации до последней версии.
Все зарегистрированные компании должны обновить полученный от Google файл подтверждения до последней версии.
Файлы аттестации не устаревают по истечении установленного периода времени. Новые или обновленные файлы аттестации могут периодически предоставляться по мере развития системы аттестации (например, добавляются новые аттестации, специфичные для API).
Сбои в проверке аттестации
Доступ будет отключен только в том случае, если сервер, проверяющий файл аттестации, неоднократно не сможет его подтвердить. Единичная ошибка или проблема с обработкой запроса не приведут к приостановке доступа.
Более подробную информацию можно найти на GitHub в разделе "Аттестации" .
данные разработчиков Android
Организации, которые планируют использовать API Privacy Sandbox на Android, могут получить доступ к своему идентификатору регистрации через пользовательский интерфейс консоли, который можно включить в конфигурацию AdServices приложения. Это позволяет разработчикам приложений осуществлять детальный контроль над рекламными технологиями, с которыми взаимодействуют их приложение или SDK.