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

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

Published on Updated on

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

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

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

В результате изменений, внесенных в предложение 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-атрибуты

Устаревший кодНовый код
conversiondestinationattributiondestination
impressiondataattributionsourceeventid
impressionexpiryattributionexpiry
reportingoriginattributionreportto

Обновие аргументы 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 больше не используется.

Last updated: Improve article

We serve cookies on this site to analyze traffic, remember your preferences, and optimize your experience.