Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[spec] Add Bidding and auction payload customization support #1274

Merged
merged 11 commits into from
Sep 30, 2024
39 changes: 34 additions & 5 deletions spec.bs
Original file line number Diff line number Diff line change
Expand Up @@ -2862,23 +2862,52 @@ partial interface Navigator {
Promise<AdAuctionData> getInterestGroupAdAuctionData(AdAuctionDataConfig config);
};

dictionary AdAuctionData {
required Uint8Array request;
required USVString requestId;
};
</xmp>

<xmp class="idl">
dictionary AdAuctionDataConfig {
required USVString seller;
required USVString coordinatorOrigin;
unsigned long requestSize;
record<USVString, AdAuctionDataBuyerConfig> perBuyerConfig;
};
</xmp>

<dl class=domintro>
<dt>{{AdAuctionDataConfig/seller}}
<dd>The seller that will be used as the {{AuctionAdConfig/seller}} in the
following {{AuctionAdConfig}} passed to {{Window/navigator}}.{{Navigator/runAdAuction()}}.
<dt>{{AdAuctionDataConfig/coordinatorOrigin}}
<dd>The origin of the coordinator hosting public encryption keys for the server
running the ad auction. The [=origin/scheme=] must be "`https`". An implementation
may select which coordinators are acceptable.
brusshamilton marked this conversation as resolved.
Show resolved Hide resolved
<dt>{{AdAuctionDataConfig/requestSize}}
<dd>The desired size for the returned response. If any buyers are specified in
brusshamilton marked this conversation as resolved.
Show resolved Hide resolved
the per-buyer config, this will be the exact size of the returned request.
brusshamilton marked this conversation as resolved.
Show resolved Hide resolved
Otherwise the returned request will be at most the
brusshamilton marked this conversation as resolved.
Show resolved Hide resolved
{{AdAuctionDataConfig/requestSize}}.
<dt>{{AdAuctionDataConfig/perBuyerConfig}}
<dd>A [=map=] whose [=map/keys=] are [=origins=] are the buyers that should
qingxinwu marked this conversation as resolved.
Show resolved Hide resolved
be included in the returned request.
brusshamilton marked this conversation as resolved.
Show resolved Hide resolved
</dl>

<xmp class="idl">
dictionary AdAuctionDataBuyerConfig {
unsigned long targetSize;
};

dictionary AdAuctionData {
required Uint8Array request;
required USVString requestId;
};
</xmp>

<dl class=domintro>
<dt>{{AdAuctionDataBuyerConfig/targetSize}}
<dd>The size of the request to allocate for this buyer. Required when
{{AdAuctionDataConfig}}'s {{AdAuctionDataConfig/requestSize}} is not
specified.
</dl>

A <dfn>server auction interest group</dfn> is a [=struct=] with the following [=struct/items=]:
<dl dfn-for="server auction interest group">
: <dfn>name</dfn>
Expand Down
Loading