Отчеты об отладке для защищенной аудитории

Отчеты об отладке защищенной аудитории позволяют разработчикам рекламных технологий объявлять удаленные URL-адреса для получения запроса GET от устройств в случае выигрыша или проигрыша аукциона. Это позволяет реализовать следующие варианты использования:

  • Получайте отчеты о результатах выигранных и проигранных аукционов.
  • Поймите, почему аукционы проигрывают. Например: выясните, связана ли это с реализацией сценария назначения ставок или оценки или с основной логикой.
  • Обнаружение проблем при обновлении логики JavaScript

Отчеты об отладке на уровне событий доступны для тестирования в Privacy Sandbox Developer Preview 9. Отчеты об отладке поддерживаются на всех устройствах, где доступен AdId.

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

Узнайте больше об отчетах об отладке в исходном предложении Chrome по пробной версии FLEDGE origin .

Использование

Отчеты об отладке реализуются с использованием следующих API-интерфейсов JavaScript, оба из которых принимают строковый аргумент URL-адреса:

  • forDebuggingOnly.reportAdAuctionWin(String url)
  • forDebuggingOnly.reportAdAuctionLoss(String url)

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

let someDebuggableVariable = 123;
const url = "https://example.com/reportLoss?winningBid=${winningBid}&someDebuggableVariable=" + someDebuggableVariable;
forDebuggingOnly.reportAdAuctionLoss(url);

Шаблон ${winningBid} заменяется реальной стоимостью после завершения аукциона.

Продавцы могут при желании вернуть rejectReason из своей функции scoreAds :

function scoreAd(ad, bid, auction_config, seller_signals,
                 trusted_scoring_signals, contextual_signal,
                 custom_audience_signal) {
  let score = ...
  return {
    'status': 0,
    'score': score,
    'rejectReason': 'blocked-by-publisher'
  }
}

Если продавец не указывает причину отклонения, вместо этого отправляется сообщение not-available .

URL-переменные

Переменные, которые можно добавить в URL-адрес отладки , соответствуют своим аналогам в Chrome (хотя ${topLevelWinningBid} и ${topLevelMadeWinningBid} недоступны, поскольку в Android нет концепции аукционов компонентов).

Имя переменной Описание
winningBid Стоимость выигравшей ставки.
madeWinningBid Логическое значение, указывающее, сделал ли покупатель этой индивидуальной аудитории выигрышную ставку либо этой пользовательской аудиторией, либо другой особой аудиторией с тем же покупателем.
highestScoringOtherBid Значение ставки, которая была оценена как вторая по величине сценарием ScoreAd продавца. Обратите внимание, что это не может быть вторым по величине значением ставки, поскольку оценки и ставки могут быть независимыми.
madeHighestScoringOtherBid Логическое значение, показывающее, сделал ли покупатель этой особой аудитории ставку ${highestScoringOtherBid} либо этой особой аудиторией, либо другой особой аудиторией с тем же покупателем.
rejectReason Строка, опционально заданная продавцом и объясняющая, почему он отклонил ставку. Может быть любым из следующих значений:

  • not-available
  • invalid-bid
  • bid-below-auction-floor
  • pending-approval-by-exchange
  • disapproved-by-exchange
  • blocked-by-publisher
  • language-exclusions
  • category-exclusions

Ограничения

  • Хост URL-адреса должен соответствовать вашему зарегистрированному домену Privacy Sandbox.
  • URL-адрес не должен превышать 4096 символов, включая домен, префикс https:// и замененные данные аукциона.
  • В будущих выпусках отладочные запросы будут отправляться только при подключении к Wi-Fi.

Поведение на устройстве

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

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

  • fledge_event_level_debug_reporting_batching_rate
  • fledge_event_level_debug_reporting_batch_size

Ожидаемая задержка отчета об отладке составляет 15–60 минут после завершения аукциона.

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

Каждая рекламная технология имеет максимальный лимит в 75 зарегистрированных URL-адресов отладки на аукцион. URL-адреса, зарегистрированные после достижения этого предела, автоматически удаляются.

Наконец, если пользователь отключил AdId , отправляются отчеты об отладке. Это не реализовано в Developer Preview 9, но будет реализовано в будущих версиях.

Поведение сервера рекламных технологий

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

  • Устройство отправляет запросы GET на сервер, указанный вами с помощью API forDebuggingOnly.* .
  • Каждый запрос представляет собой один отчет об отладке на уровне события: один выигрыш на аукционе объявлений или проигрыш на аукционе.
  • Каждый запрос не имеет тела. Все данные находятся в параметрах запроса.
  • Большие полезные данные ответа могут отрицательно повлиять на производительность и использование данных и игнорируются.
,

Отчеты об отладке защищенной аудитории позволяют разработчикам рекламных технологий объявлять удаленные URL-адреса для получения запроса GET от устройств в случае выигрыша или проигрыша аукциона. Это позволяет реализовать следующие варианты использования:

  • Получайте отчеты о результатах выигранных и проигранных аукционов.
  • Поймите, почему аукционы проигрывают. Например: выясните, связана ли эта проблема с реализацией сценария назначения ставок или оценки или с основной логикой.
  • Обнаружение проблем при обновлении логики JavaScript

Отчеты об отладке на уровне событий доступны для тестирования в Privacy Sandbox Developer Preview 9. Отчеты об отладке поддерживаются на всех устройствах, где доступен AdId.

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

Узнайте больше об отчетах об отладке в исходном предложении Chrome по пробной версии FLEDGE origin .

Использование

Отчеты об отладке реализуются с использованием следующих API-интерфейсов JavaScript, оба из которых принимают строковый аргумент URL-адреса:

  • forDebuggingOnly.reportAdAuctionWin(String url)
  • forDebuggingOnly.reportAdAuctionLoss(String url)

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

let someDebuggableVariable = 123;
const url = "https://example.com/reportLoss?winningBid=${winningBid}&someDebuggableVariable=" + someDebuggableVariable;
forDebuggingOnly.reportAdAuctionLoss(url);

Шаблон ${winningBid} заменяется реальной стоимостью после завершения аукциона.

Продавцы могут при желании вернуть rejectReason из своей функции scoreAds :

function scoreAd(ad, bid, auction_config, seller_signals,
                 trusted_scoring_signals, contextual_signal,
                 custom_audience_signal) {
  let score = ...
  return {
    'status': 0,
    'score': score,
    'rejectReason': 'blocked-by-publisher'
  }
}

Если продавец не указывает причину отклонения, вместо этого отправляется сообщение not-available .

URL-переменные

Переменные, которые можно добавить в URL-адрес отладки , соответствуют своим аналогам в Chrome (хотя ${topLevelWinningBid} и ${topLevelMadeWinningBid} недоступны, поскольку в Android нет концепции аукционов компонентов).

Имя переменной Описание
winningBid Стоимость выигравшей ставки.
madeWinningBid Логическое значение, указывающее, сделал ли покупатель этой индивидуальной аудитории выигрышную ставку либо этой пользовательской аудиторией, либо другой особой аудиторией с тем же покупателем.
highestScoringOtherBid Значение ставки, которая была оценена как вторая по величине сценарием ScoreAd продавца. Обратите внимание, что это не может быть вторым по величине значением ставки, поскольку оценки и ставки могут быть независимыми.
madeHighestScoringOtherBid Логическое значение, показывающее, сделал ли покупатель этой особой аудитории ставку ${highestScoringOtherBid} либо этой особой аудиторией, либо другой особой аудиторией с тем же покупателем.
rejectReason Строка, опционально заданная продавцом и объясняющая, почему он отклонил ставку. Может быть любым из следующих значений:

  • not-available
  • invalid-bid
  • bid-below-auction-floor
  • pending-approval-by-exchange
  • disapproved-by-exchange
  • blocked-by-publisher
  • language-exclusions
  • category-exclusions

Ограничения

  • Хост URL-адреса должен соответствовать вашему зарегистрированному домену Privacy Sandbox.
  • URL-адрес не должен превышать 4096 символов, включая домен, префикс https:// и замененные данные аукциона.
  • В будущих выпусках отладочные запросы будут отправляться только при подключении к Wi-Fi.

Поведение на устройстве

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

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

  • fledge_event_level_debug_reporting_batching_rate
  • fledge_event_level_debug_reporting_batch_size

Ожидаемая задержка отчета об отладке составляет 15–60 минут после завершения аукциона.

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

Каждая рекламная технология имеет максимальный лимит в 75 зарегистрированных URL-адресов отладки на аукцион. URL-адреса, зарегистрированные после достижения этого предела, автоматически удаляются.

Наконец, если пользователь отключил AdId , отправляются отчеты об отладке. Это не реализовано в Developer Preview 9, но будет реализовано в будущих версиях.

Поведение сервера рекламных технологий

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

  • Устройство отправляет запросы GET на сервер, указанный вами с помощью API forDebuggingOnly.* .
  • Каждый запрос представляет собой один отчет об отладке на уровне события: один выигрыш на аукционе объявлений или проигрыш на аукционе.
  • Каждый запрос не имеет тела. Все данные находятся в параметрах запроса.
  • Большие полезные данные ответа могут отрицательно повлиять на производительность и использование данных и игнорируются.