Skip to content
This repository has been archived by the owner on Mar 14, 2024. It is now read-only.

Latest commit

 

History

History
139 lines (110 loc) · 8.16 KB

index.md

File metadata and controls

139 lines (110 loc) · 8.16 KB
Raw
layout title subhead date updated authors
layouts/doc-post.njk
Руководство по миграции (Chrome 92): с Conversion Measurement API на Attribution Reporting API
В Chrome 92 Conversion Measurement API изменится.
2021-06-22
2021-06-22
maudn

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

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

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

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

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

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

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

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

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

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

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