Включить отслеживание конверсий

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

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

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

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

Типичные сценарии измерения конверсии

В этом разделе мы рассмотрим два распространенных сценария измерения конверсии.

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

Рекламодатель хочет отслеживать конверсии в рекламном инвентаре с помощью стороннего поставщика услуг по измерению эффективности, а компания, размещающая рекламные креативы, хочет отслеживать конверсии в этом рекламном инвентаре. Это распространенная ситуация для DSP или рекламных серверов рекламодателей (сторонних рекламных серверов — 3PAS), которые предоставляют разметку для рекламных креативов, выполняют собственные отчеты по атрибуции и работают с рекламодателями, интегрирующимися со сторонними поставщиками услуг по измерению эффективности или аналитике.

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

Типичная настройка рекламной кампании может выглядеть следующим образом:

1. Рекламный сервер рекламодателя (3PAS) предоставляет DSP разметку для рекламного креатива, которая включает пиксели отслеживания показов и кликов от стороннего поставщика услуг измерения. Рекламный сервер должен убедиться, что attributionsrc включен в разметку рекламного креатива.

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

Сценарий 2: Только сторонний поставщик услуг по измерению эффективности должен получать отчеты из API отчетов по атрибуции.

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

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

В типичном примере настройки кампании из Сценария 1, серверу рекламы издателя, SSP или самому издателю может потребоваться лишь убедиться, что атрибут attributionsrc , предоставленный DSP, отображается на странице издателя.

Детали реализации

В таблице ниже в общих чертах описаны этапы внедрения API для формирования отчетов по атрибуции:

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

Шаг 1: Включите указание источника для существующих креативов и кода измерения.

На первом этапе активируются источники атрибуции.

Как работает атрибут attributionsrc

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

Для событий клика, использующих перенаправления, атрибут attributionsrc следует добавить к навигации. Любые перенаправления 302 после навигации не требуют добавления атрибута attributionsrc и будут соответствовать требованиям ARA, если в исходной навигации attributionsrc уже добавлен.

Если атрибут attributionsrc пуст, запросы ARA будут отправляться на URL, определенный в атрибуте href тега якоря (URL перехода по ссылке). Если атрибут attributionsrc определен, запросы ARA будут отправляться на URL, определенный в атрибуте attributionsrc . URL перехода по ссылке также может использоваться для регистрации источников.

Как правило, следует использовать пустой атрибут attributionsrc если сервер, на котором размещен URL-адрес перехода по ссылке, может принимать и обрабатывать запросы к API отчетов об атрибуции. Если вы хотите, чтобы запросы к API отчетов об атрибуции направлялись на другой сервер, укажите собственный URL-адрес attributionsrc

Пример пустого атрибута attributionsrc :

Если атрибут attributionsrc пуст, запросы к API Attribution Reporting будут отправляться на URL-адрес, определенный атрибутом href тега привязки.

Пример непустого атрибута attributionsrc:

Если параметр attributionsrc не пуст, запросы к API Attribution Reporting будут отправляться на URL-адрес, определенный тегом attributionsrc . URL-адрес клика также может использоваться для регистрации источников.

Добавьте attributionsrc для событий клика и показа.

• События клика:
  • За добавление атрибута attributionsrc обычно отвечает компания, предоставляющая рекламные услуги.
  • К тегам якоря, обрабатывающим события клика, следует добавить атрибут attributionsrc .
  • При использовании window.open для кликов следует указывать источник атрибуции в аргументе windowFeatures вызова window.open .
• События, вызывающие впечатления:
  • За добавление атрибута attributionsrc обычно отвечает компания, предоставляющая рекламные технологии, и поставщик(и) услуг по измерению эффективности.
  • События показа, запускаемые из тега <img> или <script> , должны содержать атрибут attributionsrc .
  • В событиях показа, обрабатываемых с помощью Fetch API, в аргументе options , передаваемом в вызов Fetch API, должен содержаться объект attributionReporting .

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

Включите регистрацию источника атрибуции в аукционе защищенной аудитории.

Для измерения конверсий в аукционах с защищенной аудиторией вместо использования attributionsrc можно использовать registerAdBeacon / registerAdMacro и setReportEventDataForAutomaticBeacons / reportEvent , чтобы включить регистрацию источников атрибуции.

Для формирования отчетов по сигналам защищенной аудитории функция registerAdBeacon доступна внутри рабочих модулей отчетности, а registerAdMacro — внутри рабочего модуля отчетности по выигрышу покупателя. Затем данные события внутри рекламного фрейма можно добавить к зарегистрированным маякам и макросам с помощью функций reportEvent и setReportEventDataForAutomaticBeacons из API отчетности по рекламе в закрытых фреймах . Это позволяет связать сигналы рабочих модулей отчетности по защищенной аудитории и полезную нагрузку события рекламного фрейма друг с другом.

HTTP-заголовок Attribution-Reporting-Eligible добавляется к запросу, когда маяки и макросы запускаются вызовом reportEvent из фрейма, или когда автоматические маяки запускаются браузером. Вы можете использовать ответ маяка для регистрации источника атрибуции. Запросы маяков могут быть перенаправлены для разрешения сторонних измерений.

Для более подробной информации см. раздел «Поддержка отчетов по атрибуции» в пояснении к API отчетов по рекламе в рамках огражденных рамок.

Включите отчетность по атрибуции для форматов VAST.

VAST — это распространенный формат для показа и измерения эффективности видеорекламы, и многие события, определенные в этом стандарте, следует рассматривать как потенциальные события-источники, подлежащие регистрации в API отчетов по атрибуции. В дополнении к VAST для поддержки отчетов по атрибуции это подробно описано, но вкратце, все события <Tracking> , <Impression> , <*ClickThrough> и <*ClickTracking> являются потенциальными событиями-источниками атрибуции. Все реализации VAST должны обеспечивать возможность регистрации этих событий.

В дополнении VAST определены новые атрибуты для этих элементов, позволяющие задавать дополнительный URL-адрес специально для регистрации атрибуции. Если событие содержит attributiontype="DOUBLE_PING" и attributionsrc="[URL]" , код, запускающий это событие, должен использовать [URL] в качестве значения атрибута attributionsrc при включении API для отчетов об атрибуции. В дополнении VAST приведены примеры для каждого сценария.

Для обеспечения максимального охвата, реализации VAST по умолчанию должны позволять регистрировать все перечисленные события при отправке запросов на регистрацию событий. Например, при отправке URL-адреса события <Impression> , атрибут attributionsrc (пустой) должен использоваться в элементе <img> , используемом для отправки запроса (или эквивалентный атрибут в вызове fetch), чтобы принимающая сторона всегда могла потенциально зарегистрировать это событие в API Attribution Reporting.

Шаг 2: Включите отчеты об атрибуции для источников третьих сторон.

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

Обработка сторонних источников в существующей цепочке перенаправлений

В типичном клике по рекламе может присутствовать множество трекеров кликов в виде цепочки перенаправлений 302 выполняемых в рамках навигации к конечной целевой странице. Каждый запрос в цепочке перенаправлений может быть зарегистрирован в API отчетов по атрибуции, если исходный целевой адрес клика был помечен аннотацией attributionsrc или зарегистрирован с помощью registerAdBeacon/registerAdMacro в API защищенной аудитории . Рекламная технология в цепочке перенаправлений также должна быть зарегистрирована .

Обратите внимание, что тело первоначального запроса не отправляется при перенаправлениях. Для аукционов с защищенной аудиторией, если eventData переданные в reportEvent и setReportEventDataForAutomaticBeacons , должны использоваться в рамках перенаправления, их необходимо явно передать в составе URL-адреса перенаправления.

В следующем примере мы будем использовать рекламную платформу ( serving-adtech.example ) и стороннего поставщика услуг по измерению эффективности ( 3p-measurement.example ) как две отдельные организации, которые хотят генерировать и получать отчеты по атрибуции. В этом примере рекламной платформой может быть DSP, которая отображает креативы на сайте издателя и имеет собственный продукт для отчетности. Сторонним поставщиком услуг по измерению эффективности может быть организация, которую рекламодатель использует для составления отчетов о конверсиях.

В момент регистрации источника происходят следующие шаги:

1. serving-adtech.example устанавливает атрибут attributionsrc в креативе. Пользователь переходит на страницу издателя, и браузер отправляет запрос на serving-adtech.example.
2. serving-adtech.example отвечает заголовками Attribution-Reporting-Register-Source и Location .
   1. serving-adtech.example использует заголовок Attribution-Reporting-Register-Source для отправки метаданных о регистрируемом источнике.
   2. serving-adtech.example использует заголовок Location для включения перенаправления на 3p-measurement.example . Обратите внимание, что заголовок Location , вероятно, уже используется в ваших существующих сценариях отслеживания кликов для поддержки перенаправлений 302 на сторонний ресурс.
3. Браузер получает ответ от serving-adtech.example и анализирует заголовок Attribution-Reporting-Register-Source . Браузер сохраняет событие источника, используя serving-adtech.example в качестве источника отчета.
4. Поскольку этот запрос представляет собой перенаправление, браузер также отправляет новый запрос к 3p-measurement.example .
5. 3p-measurement.example отправляет ответ, содержащий заголовок Attribution-Reporting-Register-Source .
6. Браузер получает этот ответ от 3p-measurement.example и считывает Attribution-Reporting-Register-Source . Браузер сохраняет событие-источник, используя 3p-measurement.example в качестве источника отчета.

Используйте attributionsrc для сторонних источников, не входящих в цепочку перенаправлений.

Если несколько источников хотят зарегистрировать источник в событии навигации, но по какой-либо причине не могут появиться в цепочке перенаправлений, в качестве альтернативного решения можно указать несколько сайтов в качестве источников атрибуции в attributionsrc .

В этом примере запросы, совместимые с API Attribution Reporting, будут отправлены как на REPORTING_URL_1 , так и на REPORTING_URL_2 . Запрос навигации, отправленный на URL-адрес перехода по ссылке, также может использоваться для регистрации источников атрибуции.

Шаг 3: Настройка ответов на запросы API для формирования отчетов об атрибуции.

Для всех источников, получающих запрос к API Attribution Reporting, убедитесь, что сервер отвечает соответствующим заголовком Attribution-Reporting-Register-Source . См. руководство по регистрации источников и пояснение , чтобы узнать, как должен формироваться ответ.

Зарегистрируйте несколько триггеров

Вы можете зарегистрировать несколько триггеров атрибуции, добавив несколько пиксельных элементов на стороне конверсии (по одному на каждый триггер). Элемент attributionsrc является необязательным для регистрации триггера .

Также можно зарегистрировать несколько триггеров из одного пиксельного элемента, используя запросы перенаправления или перечисляя несколько URL-адресов в элементе attributionsrc аналогично регистрации источника. Будут сопоставлены события источника и события триггера, сгенерированные одними и теми же источниками.