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

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

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

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

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

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

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

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

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

Если вы использовали пробную версию Origin или реализовали демо-версию этого 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 удален.

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

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