Intent to Ship: Attribution Reporting Feature: Aggregate Debug Reporting

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

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

Hi Yoav,

The list of debugging signals is part of the spec:

https://wicg.github.io/attribution-reporting-api/#source-debug-data-type
https://wicg.github.io/attribution-reporting-api/#trigger-debug-data-type

Thanks,

Nan

Yoav Weiss (@Shopify)

unread,

Jun 12, 2024, 11:26:21 AMJun 12

to Nan Lin, blink-dev, Akash Nadan

LGTM1

On Wed, Jun 12, 2024 at 5:21 PM Nan Lin <lin...@chromium.org> wrote:

Hi Yoav,

The list of debugging signals is part of the spec:

https://wicg.github.io/attribution-reporting-api/#source-debug-data-type
https://wicg.github.io/attribution-reporting-api/#trigger-debug-data-type

Awesome, thanks!

Mike Taylor

unread,

Jun 12, 2024, 11:42:08 AMJun 12

to Yoav Weiss (@Shopify), Nan Lin, blink-dev, Akash Nadan

LGTM2

To view this discussion on the web visit https://groups.google.com/a/chromium.org/d/msgid/blink-dev/CAOmohSLJN2dez036m2CFhmC5VPNJ_X-FE%3Dh_DC6vSmKntKvirg%40mail.gmail.com.

Chris Harrelson

unread,

Jun 12, 2024, 11:42:47 AMJun 12

to Mike Taylor, Yoav Weiss (@Shopify), Nan Lin, blink-dev, Akash Nadan

LGTM3

To view this discussion on the web visit https://groups.google.com/a/chromium.org/d/msgid/blink-dev/49f545ab-82a0-4097-ba45-ef0c5124bb59%40chromium.org.

Reply all

Reply to author

Forward