Фильтрация источников перед атрибуцией с использованием областей атрибуции

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

Области атрибуции — это необязательные поля, которые можно задать при регистрации источника и триггера. При атрибуции учитываются только источники, значения области атрибуции которых содержат хотя бы одно из значений области атрибуции триггера. Если область атрибуции в триггере не указана, будут учитываться все источники. Прежде чем продолжить, вам следует ознакомиться с API отчетности по атрибуции и фильтрами высокого уровня .

В процессе регистрации источника

В заголовок Attribution-Reporting-Register-Source добавляется необязательный параметр attribution_scopes , содержащий два обязательных параметра: values ​​и limit, и один необязательный параметр: max_event_states.

  • limit: Отображает общее количество разрешенных уникальных областей действия для каждого пункта назначения для источника, предоставляющего отчет. Все существующие зарегистрированные источники с тем же источником и пунктом назначения, но с меньшим лимитом, будут удалены.
  • Значения: Представляют собой список областей атрибуции для конкретного источника. Эти значения должны быть строками максимальной длиной 50 символов.
  • max_event_states (необязательно): Представляет максимальное количество состояний событий, которые вызывающий API-интерфейс планирует использовать во всех последующих регистрациях источников событий. Обратите внимание, что любые существующие зарегистрированные источники с тем же источником и назначением отчетов, но другим max_event_states value будут удалены. Значение по умолчанию для этого необязательного поля — 3.

Образец регистрации источника 

  Attribution-Reporting-Register-source: {
  //optional
  "attribution_scopes":{
  "limit": <int>,
  "values": <list of strings>,
  // optional
  "max_event_states": <int>
    },
  ...
  }

Во время регистрации триггера

В заголовок Attribution-Reporting-Register-Trigger при регистрации триггера добавляется необязательный параметр attribution_scopes . Убедитесь, что значение параметра представляет собой список строк, описывающих области действия триггера. Триггер будет соответствовать только тем источникам, параметр attribution_scopes которых содержит хотя бы одну из областей действия триггера (если таковая указана).

Образец регистрации триггера 

Attribution-Reporting-Register-Trigger: {
//optional
"attribution_scopes": <list of strings>,
...
}

Пример областей атрибуции

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

Регистрация источника № 1 

  Attribution-Reporting-Register-source: {
  "destination": "https://trigger.example",
  "attribution_scopes": {
  "limit": 2,
  "values": ["advertiser1"],
  "max_event_states": 3
  },
  ...
  }

Регистрация источника №2 

  Attribution-Reporting-Register-source: {
  "destination": "https://trigger.example",
  "attribution_scopes": {
  "limit": 2,
  "values": ["advertiser2"],
  "max_event_states": 3
  },
  ...
  }

Запустить регистрацию 

  Attribution-Reporting-Register-Trigger: {
  "attribution_scopes": ["advertiser1"],
  ...
  }

Когда происходит регистрация триггера, API выбирает источники для учета при атрибуции, значения параметра attribution_scopes которых пересекаются со значениями в регистрации триггера. Соответствующие регистрации источников будут продолжены в рамках остальной части процесса атрибуции. В этом примере вызывающий API получит отчет об атрибуции, в котором регистрация триггера будет отнесена к первой регистрации источника.

Области атрибуции против фильтров

Хотя функциональность областей атрибуции и фильтров может показаться схожей, отличительной чертой является место их применения в процессе регистрации триггера. Фильтрация областей атрибуции происходит до атрибуции. Это означает, что она уменьшает пул неистекших потенциальных источников, имеющих одинаковый целевой сайт и источник отчетности, на основе того, какие источники имеют области действия, пересекающиеся с областями действия, найденными в триггере. Фильтры верхнего уровня, однако, применяются после того, как триггер был привязан к одному источнику. Если фильтры источника и триггера не пересекаются, отчеты не генерируются.

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

Four boxes labelled source numbers 1 through 4 and a single box labelled 'Trigger #1'. The first source has the following attributes 'Attribution scope': 'activewear' and Priority: 2. The second source has the attributes 'Attribution scope': 'activewear' and Filter: 'outerwear'. The third source has the attributes 'Attribution scope': 'casualwear', Filter: 'outerwear'. The fourth source has the attributes 'Attribution scope': 'casualwear' and Filter: 'outerwear' and Priority: 1. The trigger has the attributes 'Attribution scope': 'casualwear' and Filter: 'outerwear'.
Пример работы атрибуции с использованием областей атрибуции и фильтров.

Перед указанием авторства

  • Источник №1 отфильтровывается, поскольку область его атрибуции не соответствует области действия триггера, относящейся к категории casualwear . Наличие наивысшего приоритета среди всех доступных источников не предотвращает его отфильтровку, поскольку предварительная фильтрация по атрибуции происходит до проверки приоритетов.
  • Источник №2 также отфильтровывается, поскольку не имеет той же области действия, что и триггер. Этот источник также имеет тот же фильтр, что и триггер, но фильтры высокого уровня применяются только после указания авторства.

При указании авторства

  • Источник №3 не выбран для указания авторства, поскольку имеет более низкий приоритет, чем Источник №4.
  • Выбран источник №4, поскольку он имеет соответствующую область атрибуции с триггером и обладает наивысшим приоритетом. После атрибуции применяются фильтры высокого уровня, поэтому они не учитываются в процессе атрибуции.

Указание авторства

  • Отчет не создается, поскольку высокоуровневые фильтры для выбранного источника (источник №4) и триггер не пересекаются.

В предыдущем примере отчет не был сгенерирован. Однако, если полностью удалить четвертый источник:

The same four boxes labelled source numbers 1 through 4 and a single box labelled 'Trigger #1'. The difference in this image is that the box labelled 'Source #4' is crossed out with a red X.
Модифицированный пример работы атрибуции с использованием областей атрибуции и фильтров.

При указании авторства

  • Выбран источник №3, поскольку он имеет пересекающуюся область атрибуции с триггером.

Указание авторства

  • Источник №3 не отклоняется, поскольку его фильтр пересекается с фильтром в триггере. Затем атрибуция пройдет остальные проверки после атрибуции, и в случае успешного прохождения всех проверок будет сгенерирован отчет.

Функция определения источников сокращает количество источников, рассматриваемых для атрибуции. Затем оставшиеся этапы атрибуции применяются к этому меньшему пулу источников, что может привести к составлению отчета.

Место областей атрибуции в процессе атрибуции

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

A simplified version of the attribution flow with each step represented as a square linked to the next step by an arrow. The steps in order are 'Source registration', 'Trigger registration', 'Source matching', 'Attribution scopes check', 'Attribution', 'Filters check', 'Deactivation of other sources', 'Attribution checks' and 'Report generation.'
Упрощенный процесс атрибуции

Операции потока атрибуции

Ниже приводится краткий обзор различных операций, выполняемых в процессе атрибуции:

  • Регистрация источника: Когда пользователь взаимодействует с рекламой на сайте рекламодателя, регистрируется событие источника. Затем устройство отправляет запрос на конечную точку источника сообщения, которая отвечает заголовком, содержащим данные о событии источника.
  • Регистрация триггера: Когда на сайте рекламодателя происходит конверсия, регистрируется событие-триггер. Устройство отправляет еще один запрос источнику отчетов, который отвечает заголовком, содержащим данные о событии-триггере.
  • Сопоставление источников: Устройство сопоставляет источники и события-триггеры на основе таких критериев, как место назначения, источник сообщения и срок действия.
  • Проверка областей атрибуции: Источники фильтруются на основе пересечения значений attribution_scopes источника и триггера.
  • Атрибуция: Если несколько источников совпадают, устройство выбирает источник с наивысшим приоритетом для атрибуции. Если приоритеты равны, выбирается самый последний источник.
  • Проверка фильтров: устройство сравнивает фильтры источника и триггера, чтобы определить, совпадают ли они. Если фильтры не совпадают, то атрибуция отбрасывается.
  • Деактивация других источников: Если фильтры выбранного источника совпадают, устройство деактивирует источники, найденные на этапе сопоставления источников. В число деактивированных источников войдут источники, области атрибуции которых не совпадают с областями срабатывания триггеров.
  • Проверки после атрибуции: устройство выполняет дополнительные проверки выбранной атрибуции, такие как проверка на наличие ложных отчетов в источнике, проверка на наличие дублирующихся атрибуций с использованием ключей дедупликации, проверка на попадание триггера в окно отчета источника и проверка ограничений скорости запросов.
  • Формирование отчета: Если все проверки пройдены успешно, устройство генерирует и планирует отправку отчета об атрибуции на конечную точку источника отчета.

Следующие шаги