Руководство по миграции (Chrome 92): с Conversion Measurement API на Attribution Reporting API

В Chrome 92 Conversion Measurement API изменится.

Published on вторник, 22 июня 2021 г. • Updated on вторник, 22 июня 2021 г.

Translated to: English, Español, Português, 한국어, 中文, 日本語, Français, Deutsch

Developer Relations Engineer for security/privacy, Chrome and web

Если у вас есть вопросы или вам нужна помощь с миграцией, присоединяйтесь к рассылке и задайте свой вопрос.

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

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

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

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

Если вы хотите получать новости об испытании Origin Trial для этого API и будущих функций, подпишитесь на рассылку.

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

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

Что вы должны сделать?

В будущих версиях API появятся другие изменения. Они будут использовать новое именование, принятое в Chrome 92.

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

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

Миграция

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

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

Обновите код политики функций

Устаревший код	Новый код
`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-адреса.	Se Передаются в формате JSON в теле запроса. Данные отчета передаются в теле запроса в виде JSON-объекта со следующими элементами: `source_event_id`: ранее `impression-data`, 64-битный идентификатор события, задаваемый источником атрибуции. `trigger_data`: ранее `conversion-data`, 3-битное число, задаваемое в рамках переадресации, активирующей атрибуцию. ⚠️ `credit` больше не используется.

Updated on вторник, 22 июня 2021 г. • Improve article

Руководство по миграции (Chrome 92): с Conversion Measurement API на Attribution Reporting API

# Что изменится?

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

# Что вы должны сделать?

# Миграция

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

# Обновите код политики функций

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

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

# Обновие аргументы window.open()

# Обновите URL-адрес и параметры вызова, используемого для регистрации конверсии

# Обновите код конечной точки для отправки отчета