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

Started on explainer stuff for multi-bid #1048

Merged
merged 13 commits into from
Apr 16, 2024
8 changes: 7 additions & 1 deletion FLEDGE.md
Original file line number Diff line number Diff line change
Expand Up @@ -752,7 +752,7 @@ In case returning multiple bids is supported by the implementation in use,
`generateBid` may also return up to `browserSignals.multiBidLimit` valid bid
objects of the format above in an array.

If none of the returned bids pass the k-anonymity checks, `generateBid` will be
If none of the produced bids pass the k-anonymity checks, `generateBid` will be
re-run with the input `interestGroup` filtered to contain only k-anonymous ads
and component ads. Such re-runs are limited to returning only a single bid,
morlovich marked this conversation as resolved.
Show resolved Hide resolved
even if multiple bid support is otherwise on, so they will have
Expand All @@ -761,6 +761,12 @@ even if multiple bid support is otherwise on, so they will have

`generateBid()` has access to the `setPrioritySignalsOverride(key, value)` method. This adds an entry to the current interest group's `prioritySignalsOverrides` dictionary with the specified `key` and `value`, overwriting the previous value, if there was already an entry with `key`. If `value` is null, the entry with the specified key is deleted, if it exists.

`generateBid()` has access to the `setBid(bids)` method. That takes the
morlovich marked this conversation as resolved.
Show resolved Hide resolved
exact same types as the return values do, and is used as a fallback value in
case `generateBid()` throws an exception. Each call will overwrite the
morlovich marked this conversation as resolved.
Show resolved Hide resolved
previously set value; if there is something wrong with the provided `bids` it
will throw an exception and clear the fallback bid. In implementations
supporting returning multiple bids, an array can be passed here as well.

#### 3.3 Metadata with the Ad Bid

Expand Down
Loading