Skip to content

Commit

Permalink
Add non-normative, and link to adAuctionHeaders.
Browse files Browse the repository at this point in the history
  • Loading branch information
Qingxin Wu committed Oct 17, 2023
1 parent 524aa7a commit e65dff8
Showing 1 changed file with 16 additions and 6 deletions.
22 changes: 16 additions & 6 deletions spec.bs
Original file line number Diff line number Diff line change
Expand Up @@ -125,7 +125,7 @@ spec: Shared Storage API; urlPrefix: https://wicg.github.io/shared-storage

# Introduction # {#intro}

<em>This section is non-normative</em>
*This section is non-normative.*

The Protected Audience API facilitates selecting an advertisement to display to a user based on a
previous interaction with the advertiser or advertising network.
Expand All @@ -141,6 +141,8 @@ advertisement.

<h2 id="joining-interest-groups">Joining Interest Groups</h2>

*This first introductory paragraph is non-normative.*

When a user's interactions with a website indicate that the user may have a particular interest, an
advertiser or someone working on behalf of the advertiser (e.g. a demand side platform, DSP) can ask
the user's browser to record this interest on-device by calling
Expand Down Expand Up @@ -471,6 +473,8 @@ To <dfn>build an interest group permissions url</dfn> given a [=origin=] |ownerO

<h2 id="leaving-interest-groups">Leaving Interest Groups</h2>

*This first introductory paragraph is non-normative.*

{{Window/navigator}}.{{Navigator/leaveAdInterestGroup()}} removes a user from a particular interest
group.

Expand Down Expand Up @@ -533,6 +537,8 @@ are:

<h2 id="running-ad-auctions">Running Ad Auctions</h2>

*This first introductory paragraph is non-normative.*

When a website or someone working on behalf of the website (e.g. a supply side platform, SSP) wants
to conduct an auction to select an advertisement to display to the user, they can call the
{{Window/navigator}}.{{Navigator/runAdAuction()}} function, providing an auction configuration that
Expand Down Expand Up @@ -566,7 +572,7 @@ dictionary AuctionAdConfig {
Promise<record<USVString, USVString>> perBuyerCurrencies;
sequence<AuctionAdConfig> componentAuctions = [];
Promise<undefined> additionalBids;
USVString auctionNonce;
DOMString auctionNonce;
AbortSignal? signal;
Promise<boolean> resolveToConfig;
};
Expand Down Expand Up @@ -962,10 +968,10 @@ To <dfn>validate and convert auction ad config</dfn> given an {{AuctionAdConfig}
|config|["{{AuctionAdConfig/additionalBids}}"]:

Note: The JavaScript code calling {{Navigator/runAdAuction()}} is responsible for not resolving
|config|["{{AuctionAdConfig/additionalBids}}"] until a {{WindowOrWorkerGlobalScope/fetch()}}
call for fetching additional bids with the `{adAuctionHeaders: true}` option returns
a response, or alternatively, not calling {{Navigator/runAdAuction()}} until the
{{WindowOrWorkerGlobalScope/fetch()}} call returns a response.
|config|["{{AuctionAdConfig/additionalBids}}"] until an associated [=request=] whose
[=request/initiator type=] is `"fetch"` and the {{RequestInit/adAuctionHeaders}} option set to
`true` returns a response, or alternatively, not calling {{Navigator/runAdAuction()}} until the
[=request=] returns a response.

* To parse the value |result|:
1. Set |auctionConfig|'s [=auction config/expects additional bids=] to false.
Expand Down Expand Up @@ -2157,6 +2163,8 @@ a {{ReportingBrowserSignals}} |browserSignals|, and a [=direct from seller signa

## createAuctionNonce() ## {#create-auction-nonce}

*This first introductory paragraph is non-normative.*

{{Window/navigator}}.{{Navigator/createAuctionNonce()}} creates an auction nonce, a one-time
[=version 4 UUID=] uniquely associated with a single call to
{{Window/navigator}}.{{Navigator/runAdAuction()}}. For multi-seller auctions, this ID is uniquely
Expand Down Expand Up @@ -3276,6 +3284,8 @@ Each {{InterestGroupReportingScriptRunnerGlobalScope}} has a

# Interest Group Updates # {#interest-group-updates}

*This first introductory paragraph is non-normative.*

[=Interest groups=] have an [=interest group/update url=] field that allows updating the
interest group definition stored on disk with information periodically retrieved from the
[=interest group/update url=]. The [=interest group update=] steps are triggered during
Expand Down

0 comments on commit e65dff8

Please sign in to comment.