[Устарело] Руководство по переходу (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 был удален.

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

См. Отчетность об атрибуции .