Intent to Ship: Attribution Reporting Feature: Aggregate Debug Reporting

284 views
Skip to first unread message

Akash Nadan

unread,
Jun 7, 2024, 2:13:01 PMJun 7
to blink-dev
Contact emails

akash...@google.com, lin...@chromium.org, john...@chromium.org


Explainer

Attribution Reporting with event-level reports

Attribution Reporting API with Aggregatable Reports

Aggregation Service for the Attribution Reporting API


Specification

https://wicg.github.io/attribution-reporting-api/


Blink component

Internals > AttributionReporting


TAG review

Still under review under the original I2S for the Attribution Reporting API


TAG review status

Pending


Summary

We are landing the following changes to the Attribution Reporting API focused on:

  • improving debugging capabilities


This change is based on ad-tech feedback and the need to support debugging capabilities after third-party cookie deprecation. 


Currently the API supports debug reports that are tied to third-party cookies. In order for an API caller to receive a debug report of any kind they need to make sure a specific third-party cookie (i.e. ar_debug) is properly set. The API will check to make sure this cookie is set before providing any kind of debug report. Once third-party cookies are deprecated these debug reports will no longer be available. 


This change is so the API can continue to provide debugging information after third-party cookie deprecation when the current debug reports that are tied to third-party cookies are no longer available. This is a new report type that is not tied to third-party cookies and provides similar debug information. This feature allows API callers to request and receive debug signals in aggregate form. This feature is very similar to current Aggregate Reports supported by the API, except these new reports will be specifically for debug signals. 


This new feature will allow API callers to continue receiving debugging information even after third-party cookie deprecation.


Explainer/Spec changes
  1. Explainer: https://github.com/WICG/attribution-reporting-api/blob/main/aggregate_debug_reporting.md

  2. Spec: 

    1. https://github.com/WICG/attribution-reporting-api/pull/1310

    2. https://github.com/WICG/attribution-reporting-api/pull/1292


Risks
Interoperability and Compatibility

This is an optional and fully backwards compatible change. This feature provides a new mechanism for receiving debugging information and does not break any pre-existing API or web functionality.


Gecko: No signal (Original request: https://github.com/mozilla/standards-positions/issues/791)


WebKit: No signal (Original request: https://github.com/WebKit/standards-positions/issues/180)


Web developers: https://github.com/WICG/attribution-reporting-api/issues/705



WebView application risks

Does this intent deprecate or change behavior of existing APIs, such that it has potentially high risk for Android WebView-based applications?

No


              

Will this feature be supported on all six Blink platforms (Windows, Mac, Linux, Chrome OS, Android, and Android WebView)?

The attribution reporting feature will be supported on all platforms with the exception of Android WebView


Is this feature fully tested by web-platform-tests?

Yes


Estimated milestones

This feature is anticipated to ship as part of Chrome 127


Link to entry on the Chrome Platform Status

https://chromestatus.com/feature/5086433709916160


Links to previous Intent discussions

Previous I2S: 

Intent to Ship: Attribution Reporting API

Intent to Ship: Attribution Reporting features M117

Intent to Ship: Attribution Reporting features M118

Intent to Ship: Attribution Reporting features M119

Intent to Ship: Attribution Reporting features M120

Intent to Ship: Attribution Reporting features M121

Intent to Ship: Attribution Reporting features M123

Intent to Ship: Attribution Reporting features M124

Intent to Ship: Attribution Reporting features M125

Intent to Ship: Attribution Reporting features M126


Thanks,
Akash

Yoav Weiss (@Shopify)

unread,
Jun 11, 2024, 1:02:08 AMJun 11
to Akash Nadan, blink-dev
On Fri, Jun 7, 2024 at 8:12 PM 'Akash Nadan' via blink-dev <blin...@chromium.org> wrote:
Contact emails

akash...@google.com, lin...@chromium.org, john...@chromium.org


Explainer

Attribution Reporting with event-level reports

Attribution Reporting API with Aggregatable Reports

Aggregation Service for the Attribution Reporting API


Specification

https://wicg.github.io/attribution-reporting-api/


Blink component

Internals > AttributionReporting


TAG review

Still under review under the original I2S for the Attribution Reporting API


TAG review status

Pending


Summary

We are landing the following changes to the Attribution Reporting API focused on:

  • improving debugging capabilities


This change is based on ad-tech feedback and the need to support debugging capabilities after third-party cookie deprecation. 


Currently the API supports debug reports that are tied to third-party cookies. In order for an API caller to receive a debug report of any kind they need to make sure a specific third-party cookie (i.e. ar_debug) is properly set. The API will check to make sure this cookie is set before providing any kind of debug report. Once third-party cookies are deprecated these debug reports will no longer be available. 


This change is so the API can continue to provide debugging information after third-party cookie deprecation when the current debug reports that are tied to third-party cookies are no longer available. This is a new report type that is not tied to third-party cookies and provides similar debug information. This feature allows API callers to request and receive debug signals in aggregate form. This feature is very similar to current Aggregate Reports supported by the API, except these new reports will be specifically for debug signals. 


Can you expand on what debug signals are being aggregated? Are they developer-defined somehow?
  
--
You received this message because you are subscribed to the Google Groups "blink-dev" group.
To unsubscribe from this group and stop receiving emails from it, send an email to blink-dev+...@chromium.org.
To view this discussion on the web visit https://groups.google.com/a/chromium.org/d/msgid/blink-dev/588cb91a-d7df-4796-8b6d-d1e406f64008n%40chromium.org.

Akash Nadan

unread,
Jun 11, 2024, 1:43:19 PMJun 11
to blink-dev, Yoav Weiss (@Shopify), blink-dev, Akash Nadan
Hi Yoav,

The debug signals that will be reported on are documented here: https://github.com/WICG/attribution-reporting-api/blob/main/verbose_debugging_reports.md

These are the same debug signals that current debug reports support. We plan to support the same set of debug signals in this new feature as well.

These debug signals are not developer defined, however a developer can specify which of the signals they want to track and can group certain signals together (more details here).

Thanks,
Akash

Yoav Weiss (@Shopify)

unread,
Jun 12, 2024, 4:27:41 AMJun 12
to Akash Nadan, blink-dev
On Tue, Jun 11, 2024 at 7:43 PM Akash Nadan <akash...@google.com> wrote:
Hi Yoav,

The debug signals that will be reported on are documented here: https://github.com/WICG/attribution-reporting-api/blob/main/verbose_debugging_reports.md

Thanks! Should that be part of the spec?

Nan Lin

unread,
Jun 12, 2024, 11:21:54 AMJun 12
to blink-dev, Yoav Weiss, blink-dev, Akash Nadan

Yoav Weiss (@Shopify)

unread,
Jun 12, 2024, 11:26:21 AMJun 12
to Nan Lin, blink-dev, Akash Nadan
LGTM1

Awesome, thanks!

Mike Taylor

unread,
Jun 12, 2024, 11:42:08 AMJun 12
to Yoav Weiss (@Shopify), Nan Lin, blink-dev, Akash Nadan

Chris Harrelson

unread,
Jun 12, 2024, 11:42:47 AMJun 12
to Mike Taylor, Yoav Weiss (@Shopify), Nan Lin, blink-dev, Akash Nadan
Reply all
Reply to author
Forward
0 new messages