[Устарело] Руководство по переходу (Chrome 92): API измерения конверсий на API отчетов по атрибуции

В Chrome 92 происходят изменения в API измерения конверсий.

Что меняется?

После изменений, внесенных в предложение по API в первые месяцы 2021 года, реализация API в Chrome развивается. Вот что меняется:

Название API и название политики разрешений.
Названия HTML-атрибутов и URL-адреса .well-known .
Формат отчетов. Теперь отчеты отправляются в формате JSON в теле запроса.
Содержание отчетов: credit были удалены, как и отчеты, которые должны были иметь 0 кредитов.

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

Когда эти изменения вступят в силу?

Эти изменения вступают в силу начиная с Chrome 92 , стабильная версия которого была выпущена 20 июля 2021 года. Бета-версия Chrome 92 была выпущена 3 июня 2021 года.

Что вам следует сделать?

Если вы проводили пробное тестирование или реализовали демонстрационную версию этого API, у вас есть два варианта:

Вариант 1 (рекомендуемый) : перенесите свой код сейчас или в ближайшие недели, в идеале до середины июля 2021 года. Таким образом, ваша кодовая база будет готова к будущим изменениям и продолжит работать с более новыми версиями Chrome.
Вариант 2 : Дождитесь выхода новых обновлений и новых функций в будущих версиях Chrome и внесите все необходимые изменения в код сразу.

Мигрировать

Пример миграции

Пример миграции для небольшого демонстрационного приложения можно посмотреть в этом запросе на слияние (черновике) .

Обновите код политики разрешений.

Устаревший код	Новый код
`allow='conversion-measurement'`	`allow='attribution-reporting'`

Обновите код обнаружения функций.

Устаревший код	Новый код
`document.featurePolicy.features() .includes('conversion-measurement')`	`document.featurePolicy.features() .includes('attribution-reporting')`

Обновите HTML-атрибуты

Устаревший код	Новый код
`conversiondestination`	`attributiondestination`
`impressiondata`	`attributionsourceeventid`
`impressionexpiry`	`attributionexpiry`
`reportingorigin`	`attributionreportto`

Обновить аргументы функции `window.open()`

Источник атрибуции можно зарегистрировать для навигации, инициированной вызовом window.open() . Обновите эти вызовы, если вы используете window.open() для регистрации источников атрибуции.

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

window.open(
  'https://dest.example',
  '_blank',
  'attributionsourceeventid=1234,attributiondestination=https://dest.example,attributionreportto=https://reporter.example,attributionexpiry=604800000'
);

Обновите URL-адрес и параметры вашей регистрационной заявки.

Устаревший код	Новый код
`.well-known/register-conversion?conversion-data={DATA}`	`.well-known/attribution-reporting/trigger-attribution?trigger-data={DATA}`

Обновите код конечной точки для формирования отчетов.

	Устаревший код	Новый код
Запросы, которые следует ожидать от браузера	`.well-known/register-conversion?impression-data=&conversion-data={DATA}&attribution-credit=100`	`.well-known/attribution-reporting/trigger-attribution`
Входящие отчеты	Отправляется в качестве параметров URL.	Отправляется в формате JSON в теле запроса. Данные отчета включаются в тело запроса в виде объекта JSON со следующими ключами: `source_event_id` : ранее `impression-data` , 64-битный идентификатор события, установленный в источнике атрибуции. `trigger_data` : ранее `conversion-data` , 3-битный набор данных в триггере перенаправления атрибуции. ⚠️ `credit` удалено.

Отчеты об атрибуции: все ресурсы

См. Отчеты об атрибуции .