Зарегистрируйтесь в Privacy Sandbox

Чтобы получить доступ к API-интерфейсам релевантности и измерения Privacy Sandbox в Chrome и Android, разработчикам необходимо зарегистрироваться в Privacy Sandbox. Сюда входят отчеты об атрибуции, защищенная аудитория, темы, частное агрегирование и общее хранилище. Регистрация разработчиков проверяет объекты, которые вызывают эти API, и собирает данные, необходимые для правильной настройки и использования API. Регистрация добавляет дополнительный уровень защиты и прозрачности в отношении того, кто собирает данные, а также предотвращает попытки злоупотребления API для сбора несущественных данных. Чтобы обеспечить проверяемую прозрачность, информация о регистрации компании публикуется. Компании должны запланировать как минимум пять недель для завершения процесса регистрации. Это включает в себя время для решения любых непредвиденных проблем с отправкой на консоль или других проблем, которые могут возникнуть. Сюда не входит дополнительное время, которое может потребоваться компаниям для внутренней подготовки перед отправкой формы.

Прежде чем начать

Прежде чем начать регистрацию, создайте учетную запись с помощью консоли Privacy Sandbox . Узнайте больше о создании учетной записи .

Как записаться

Для регистрации разработчикам необходимо использовать консоль Privacy Sandbox . Вы должны предоставить следующую информацию:

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

Зарегистрируйте свой сайт, Android SDK или приложение Android.

Во время регистрации вам необходимо предоставить сайт или SDK (или и то, и другое), которые вы будете использовать для вызова API.
Способ регистрации зависит от того, как называются API Privacy Sandbox:

• Если вы веб-разработчик и ваш сайт напрямую вызывает API Privacy Sandbox, вам следует предоставить свой сайт для регистрации.
• Если вы разработчик Android SDK, укажите свое имя SDK при регистрации. Если ваш SDK использует отчеты по атрибуции, защищенную аудиторию или оба API, также укажите свой сайт для регистрации. Приложениям, использующим ваш SDK, не требуется отдельная регистрация, если только они не вызывают API-интерфейсы Privacy Sandbox непосредственно из своего собственного кода. Если вы немедленно тестируете API отчетов по атрибуции на Android в большом масштабе, вам необходимо будет указать все источники, которые вы используете.
• Если вы разработчик приложения и ваше приложение напрямую вызывает API отчетов об атрибуции, Защищенную аудиторию или оба API, вам следует указать свой сайт во время регистрации.
• Если вы разработчик приложения и полностью делегируете свои рекламные функции SDK, вам не нужно проходить процедуру регистрации.

Каждый сайт или SDK, вызывающий API Privacy Sandbox, требует уникальной регистрации и индивидуального подтверждения. Приложения, которые напрямую вызывают API-интерфейсы Privacy Sandbox, могут быть включены в одну регистрацию. Если вы планируете вызывать несколько API, укажите каждый из них в процессе регистрации. Примечание. Сайт, на котором вы регистрируетесь, — это тот же сайт, который будет использоваться для получения ключей шифрования для использования тем на Android и ключа подписи для использования вами Защищенной аудитории на Android. Дополнительная информация о конечной точке шифрования для Topics на Android и дополнительная информация о подписании ключей для Защищенной аудитории .

Обновить информацию о регистрации

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

Если какая-либо из следующих данных изменится, вам потребуется повторно загрузить новую версию файла аттестации:

• Ссылки на политику конфиденциальности
• Информация о сайте
• API выбраны

Статусы регистрации

После подачи заявки на регистрацию вы можете увидеть следующие этапы прогресса:

• Обзор
  • Мы проверяем вашу регистрацию. Никаких действий не требуется.
• Настроить файл подтверждения
  • Ваша регистрация была одобрена. Для сайтов файл подтверждения должен быть создан в течение 30 дней.
• Регистрация завершена
  • Вы успешно зарегистрировались и настроили файл аттестации (при необходимости). Никаких дальнейших действий не требуется.
• Ошибки с файлами аттестации
  • Файл подтверждения находится в неправильном месте
    • В течение 30 дней нам не удалось найти файл подтверждения вашего сайта.
  • Регистрация приостановлена
    • Файл аттестации не был правильно настроен в течение первых 30 дней или его невозможно найти после предыдущей успешной регистрации. Для получения дополнительной информации свяжитесь с нами по адресу [e-mail] .

График регистрации

После того как ваша заявка будет отправлена, мы рассмотрим и обработаем вашу заявку. После завершения проверки вы увидите подтверждение в консоли и сможете получить доступ к файлу аттестации для настройки. Файл должен стать общедоступным по пути /.well-known на сайте, для которого он был зарегистрирован, в течение 30 дней с момента утверждения регистрации. Разработчики Android могут предоставить идентификатор регистрации разработчикам приложений, чтобы приложения могли настроить детальный контроль доступа. Дополнительную информацию см. в документации по настройке рекламных служб API для Android. Примечание. Ввод правильной информации в исходной отправке и своевременный ответ на любые запросы службы технической поддержки Google помогают ускорить процесс.

Регистрация для различных сред разработки

Ваши промежуточные, бета-версии, среды контроля качества и тестовые среды будут автоматически зарегистрированы, если они используют тот же сайт, что и ваша производственная среда. Вы можете протестировать локально, не проходя регистрацию. Для локального тестирования мы предоставляем переопределения для разработчиков из Chrome 116 с флагом Chrome и переключателем CLI:

• Флаг: chrome://flags/#privacy-sandbox-enrollment-overrides
• CLI: --privacy-sandbox-enrollment-overrides=https://example.com,https://example.co.uk,...

Ограничения

При определении структуры регистрации в вашей организации обратите внимание на следующие ограничения регистрации разработчиков:

• Один сайт может быть связан только с одной регистрацией.
• Одна регистрация содержит только один сайт.
• Особые ограничения SDK:
  1. Одна регистрация может содержать несколько SDK.
  2. Данный SDK можно связать только с одной регистрацией.
• Дополнительная регистрация разрешена, но она должна быть для независимых продуктов или направлений бизнеса, которые четко установлены и публично проверяемы (т. е. существует соответствующий общедоступный веб-сайт, на котором объясняется конкретный продукт). Вы не можете иметь несколько регистраций для одного и того же продукта. Аттестаты применяются к каждому зачислению индивидуально.
• При регистрации на уровне сайта одна регистрация может охватывать неограниченное количество источников, если они принадлежат одному сайту. Однако ограничение по одному источнику отчетности для каждого источника ( Chrome , Android ) означает, что вы, как правило, ограничены одним источником для каждого издателя.

Несколько регистраций для одного объекта

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

Примечание. Privacy Sandbox не требует отдельной регистрации DSP и SSP, принадлежащего одной и той же организации.

Каждый продукт должен иметь отдельные сайты для вызова API. Вам необходимо будет предоставить публичное представление о каждом продукте, который вы запрашиваете для регистрации (например, ссылку на общедоступный веб-сайт с описанием продукта).

Если вы хотите зарегистрировать несколько сайтов или SDK, перейдите на вкладку «Регистрации» в навигации консоли. После того как ваша первая регистрация будет одобрена, вы можете выбрать «Запросить регистрацию», чтобы запросить добавление новых. После отправки заявка будет рассмотрена, и вы получите электронное письмо и увидите статус, отраженный в консоли, когда процесс рассмотрения будет завершен.

Примечание. Вы не можете запросить несколько регистраций для тестирования (например, для тестирования и производства, подготовки к производству и производства). Хотя специалисты по рекламе могут создавать несколько сред для тестирования API, регистрация позволяет зарегистрировать только один сайт для каждого продукта (а не одну регистрацию для каждой среды для каждого продукта).

Перенаправление с отчетами об атрибуции

Рассмотрим сценарий, в котором сайт A не зарегистрирован, но зарегистрирован сайт B. ARA будет проверять URL-адреса на предмет перенаправления, даже если он не зарегистрирован. В результате перенаправление с siteA.com на siteB.com будет работать. Однако источники и триггеры будут регистрироваться только у зарегистрированных рекламных специалистов.

Зарегистрируйтесь для услуги агрегирования

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

Загрузите файл подтверждения

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

Чтобы завершить регистрацию, сделайте файл доступным по .well-known пути на зарегистрированном сайте. Например, если вы регистрируете https://example.com , поместите файл подтверждения по адресу https://example.com/.well-known/privacy-sandbox-attestations.json . Вы также можете использовать перенаправление HTTP только на субдомены вашего зарегистрированного сайта для обслуживания файла аттестации.

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

Обратите внимание, что:

• Privacy Sandbox получит файл подтверждения от зарегистрированных специалистов по рекламе. Это задание будет получать файл не чаще одного раза в час. Вызовы API не инициируют запрос на получение файла подтверждения.
• Цель состоит в том, чтобы файл аттестации был доступен публично. Рекламным технологиям следует ожидать некоторых запросов на выборку от внешних сторон, включая исследователей, регулирующих органов и пользователей (за исключением запросов на выборку из Privacy Sandbox ниже). Рекламные специалисты должны предоставить им тот же файл, что и Google.

Для аттестаций Topics on Android разработчикам приложений и SDK необходимо согласиться с аттестацией в форме регистрации в консоли, и им не нужно размещать файл аттестации на своем сервере, если они не используют другие API Privacy Sandbox.

Обновите аттестацию, чтобы добавить больше API.

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

Обновите файл подтверждения до последней версии.

Всем зарегистрированным компаниям необходимо обновить файл подтверждения, полученный от Google, до последней версии.
Срок действия файлов аттестации не истекает по истечении заданного периода времени. Новые или обновленные файлы аттестации могут предоставляться время от времени по мере развития структуры аттестации (например, добавляются новые аттестации, специфичные для API).

Сбои проверки аттестации

Доступ будет прекращен только в том случае, если сервер, проверяющий файл аттестации, неоднократно не сможет его проверить. Единственная ошибка или проблема с обслуживанием не приведет к приостановке доступа.

Более подробную информацию можно найти на GitHub по аттестациям .

Данные разработчика Android

Организации, которые намерены использовать API-интерфейсы Privacy Sandbox на Android, могут получить доступ к своему идентификатору регистрации через пользовательский интерфейс консоли, который можно включить в конфигурацию AdServices приложения. Это позволяет разработчикам приложений иметь детальный контроль над рекламными технологиями, с которыми взаимодействуют их приложения или SDK.