Обновления отчетов об атрибуции в июне 2022 г.

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

Для кого эти обновления?

Эти обновления для вас, если:

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

Если вы только начинаете работать с этим API и/или еще не экспериментировали с ним, вместо этого перейдите непосредственно к введению в API .

Обновления API отчетов по атрибуции

Демонстрационная версия отчетов по атрибуции была обновлена ​​и отражает последние изменения в клиентском API отчетов по атрибуции.

Большинство изменений не требуют действий. Те, которые требуют обновлений для вашей реализации, выделены ниже.

(Требуется действие) унифицированные заголовки для регистрации

Заголовки были унифицированы. Теперь есть только один заголовок для источников и один для триггеров, отформатированных в формате JSON.

  • Чтобы зарегистрировать источники атрибуции, вы можете отвечать на запросы регистрации заголовком Attribution-Reporting-Register-Source .
  • Чтобы завершить регистрацию триггера, установите заголовок Attribution-Reporting-Register-Trigger .

Это изменение требует действий. Дополнительную информацию см. в руководстве разработчика API .

(Требуется действие) ключи агрегирования теперь являются словарем

Для регистрации источников атрибуции продолжайте использовать aggregation_keys , но теперь они хранятся в виде словаря JSON, а не списка.

Например:

"aggregation_keys": {
    // Generate a "0x159" key piece for the key named "campaignCounts".
    "campaignCounts": "0x159", // User saw ad from campaign 345 (out of 511)

    // Generates a "0x5" key piece (low order bits of the key) for 
    // the key named "geoValue".
    "geoValue": "0x5" // Source-side geo region = 5 (US), out of a possible ~100 regions
 }

Это изменение требует действий. Дополнительную информацию см. в руководстве по API .

Генерация отчета

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

Единая настройка ключа отладки

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

Регистрация источников атрибуции

Теги скриптов теперь можно использовать для регистрации источников атрибуции, аналогично поддержке тега <img> .

Больше обновлений API

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

  • Источники можно зарегистрировать с помощью API-интерфейсов запросов JavaScript.
  • window.registerSource был удален.
  • Теперь необязательно включать значение attributionsrc при регистрации источников.
  • Заголовок Attribution-Reporting-Eligible добавлен во входящие запросы на регистрацию источника.
  • В encodeURIComponent было внесено незначительное изменение.
  • Ключ бюджета конфиденциальности был удален из shared_info в агрегированных отчетах.

Поддержка службы агрегации

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

Мы собрали документ с практическими советами и стратегиями создания сводных отчетов . Есть ряд идей, в том числе:

  • Обзор шума при создании сводного отчета
  • Подробное объяснение размеров, ключей и значений.
  • Ключи агрегирования на практике, включая карту структуры ключей
  • Агрегированные значения на практике и последствия бюджета взносов
  • Руководство по экспериментам с эпсилоном

Подробнее об обновлениях

Изображение заголовка от Дианы Полехиной на Unsplash .