HTTP-заголовок Attribution-Reporting-Register-Trigger ответа регистрирует функцию страницы как триггер атрибуции. Этот заголовок включается в ответ на запрос, содержащий заголовок Attribution-Reporting-Eligible.

Подробнее см. в документации по API отчетов об атрибуции.

Синтаксис

Attribution-Reporting-Register-Trigger: <json-string>

Директивы

<json-string>

Строка JSON с данными, которые можно включить в создаваемые отчеты, например с идентификатором триггера и значениями приоритета и дедупликации. Доступны следующие поля:

"aggregatable_trigger_data"

Массив объектов, каждый из которых задает ключ агрегирования для применения к разным ключам источника. Каждый объект содержит следующие свойства:

"key_piece"

Шестнадцатеричное значение, представляющее ключ.

"source_keys"

Массив, содержащий одно или несколько значений ключей для данных.

"aggregatable_values"

Объект со свойствами, представляющими значение для каждой точки данных, определенной в "aggregatable_trigger_data". В каждом случае имя свойства совпадает с именем, определенным в "source_keys", а значением свойства может быть любое требуемое вам произвольное значение.

"debug_key" Необязательно

Число, представляющее ключ отладки. Укажите его, если хотите создать отчет отладки вместе с соответствующим отчетом об атрибуции.

"debug_reporting" Необязательно

Логическое значение. Если задан debug_key, установите это значение в true, чтобы указать, что создаваемый отчет отладки должен быть подробным.

"filters" Необязательно

Объект с пользовательскими данными, которые можно использовать для фильтрации триггеров, создающих отчеты. Подробнее см. в разделе Фильтры.

"event_trigger_data"

Объект с данными о триггере. Доступны следующие вложенные поля:

"trigger_data"

Строка с данными, описывающими триггер. Обычно она используется для обозначения таких событий, как «пользователь добавил товар в корзину» или «пользователь подписался на рассылку». Это значение будет включено в создаваемый отчет на уровне события, если он создается, но может быть изменено с учетом поля "trigger_data_matching" источника атрибуции.

Примечание: Значения, используемые для представления каждого события, и количество элементов в массиве полностью произвольны и задаются вами как разработчиком. Массив может содержать неиспользуемые значения, но для атрибуции источнику браузером при регистрации триггера соответствующие значения должны присутствовать в массиве.

"priority" Необязательно

Строка, представляющая приоритет триггера атрибуции. По умолчанию триггеры связываются с последним подходящим источником. Для отчетов как на уровне события, так и сводных отчетов задайте более высокое значение приоритета, чтобы триггер соответствовал более старым источникам. Например, значение 2 имеет приоритет над значением по умолчанию 1. Подробнее см. в разделе Приоритеты и ограничения отчетов.

"deduplication_key" Необязательно

Строка, представляющая уникальный ключ, который можно использовать для предотвращения дублирования атрибуций — например, если пользователь добавит один и тот же товар в корзину несколько раз. Подробнее см. в разделе Предотвращение дублирования в отчетах.

"filters" Необязательно

Объект с фильтрами, которые выполняют выборочную фильтрацию и задают "trigger_data", "priority" и "deduplication_key" на основе filter_data, заданного в соответствующем заголовке Attribution-Reporting-Register-Source. Подробнее см. в разделе Фильтры.

Примеры

Регистрация триггера для отчета на уровне события

Сервер Node.js может задать заголовок ответа Attribution-Reporting-Register-Trigger следующим образом, чтобы зарегистрировать триггер, предназначенный для сопоставления с источником атрибуции отчета на уровне события:

res.set(
  "Attribution-Reporting-Register-Trigger",
  JSON.stringify({
    event_trigger_data: [
      {
        trigger_data: "4",
        priority: "1000000000000",
        deduplication_key: "2345698765",
      },
    ],
    debug_key: "1115698977",
  }),
);

Регистрация триггера для сводного отчета

При регистрации триггера, предназначенного для сопоставления с источником атрибуции сводного отчета, необходимо включить следующие поля:

res.set(
  "Attribution-Reporting-Register-Trigger",
  JSON.stringify({
    aggregatable_trigger_data: [
      {
        key_piece: "0x400",
        source_keys: ["campaignCounts"],
      },
      {
        key_piece: "0xA80",
        source_keys: ["geoValue", "nonMatchingKeyIdsAreIgnored"],
      },
    ],
    aggregatable_values: {
      campaignCounts: 32768,
      geoValue: 1664,
    },
    debug_key: "1115698977",
  }),
);

Спецификации

Совместимость с браузерами

См. также

• Attribution-Reporting-Eligible
• Attribution-Reporting-Register-Source
• API отчетов об атрибуции