Skip to content

Commit 3e1a1d3

Browse files
Merge pull request #436 from w3c/timg-agg-svc-detail
Provide more detail on the nature of aggregation services
2 parents 33a26aa + e8f9856 commit 3e1a1d3

1 file changed

Lines changed: 25 additions & 2 deletions

File tree

api.bs

Lines changed: 25 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -315,6 +315,9 @@ path:images/overview.svg
315315
<figcaption>Overview of Attribution Operation</figcaption>
316316
</figure>
317317

318+
319+
## Recording Impressions ## {#overview-impression}
320+
318321
When an [=impression=] occurs,
319322
the <a method for=Attribution>saveImpression()</a> method can be used
320323
to request that the browser save information.
@@ -323,6 +326,9 @@ and some additional information about the impression.
323326
For instance, advertisers might use additional information
324327
to record whether the impression was an ad view or an ad click.
325328

329+
330+
## Conversions or Querying Impressions ## {#overview-conversion}
331+
326332
At [=conversion=] time, a [=conversion report=] is created.
327333
A <dfn>conversion report</dfn> is an encrypted histogram contribution
328334
that includes information from any [=impressions=] that the browser previously stored.
@@ -354,6 +360,9 @@ This minimally involves encryption of the histogram.
354360
<p class=note>A site that invokes this API will always receive a valid conversion report.
355361
As a result, sites learn nothing about what happened on other sites from this interaction.
356362

363+
364+
## Aggregation ## {#overview-aggregation}
365+
357366
The site can collect the encrypted histograms it receives from calls to this API
358367
and submit them to the aggregation service.
359368

@@ -369,7 +378,21 @@ Upon receiving a set of encrypted histograms from a site, the aggregation servic
369378

370379
3. returns the aggregate to the site.
371380

372-
We refer to the final output as an <dfn>attribution result</dfn>.
381+
We refer to the final output of the aggregation service as an <dfn>attribution result</dfn>.
382+
383+
Browser implementations need to have a set of aggregation services that are trusted
384+
to reliably perform the above functions.
385+
From the set of services that are offered,
386+
the [=conversion site=] needs to reach an agreement
387+
with their choice of service to perform aggregation.
388+
389+
Browsers might establish programs for registering aggregation services,
390+
similar in nature to the [root store program](https://www.ccadb.org/)
391+
used to authorize the certification authorities
392+
that browsers use in the validation
393+
of Web <abbr title="Public Key Infrastructure">PKI</abbr> certificates.
394+
The establishment of such a program
395+
is out of scope for this document.
373396

374397

375398
# API Usage # {#api}
@@ -528,7 +551,7 @@ The URL is passed as the {{AttributionConversionOptions/aggregationService}} par
528551
to <a method for=Attribution>measureConversion()</a> to select the identified aggregation service.
529552

530553
The <dfn enum>AttributionAggregationProtocol</dfn> describes the submission protocol
531-
used by different [=aggregation services=]. This document defines two protocols:
554+
used by different [=aggregation services=]. This document defines one protocol:
532555

533556
<dl dfn-for=AttributionAggregationProtocol dfn-type=enum-value>
534557
<dt><dfn>dap-18-histogram</dfn></dt>

0 commit comments

Comments
 (0)