Skip to content

Commit

Permalink
Mention Permissions-Policy directives join-ad-interest-group and run-…
Browse files Browse the repository at this point in the history
…ad-auction in FLEDGE explainer. (WICG#249)

* mention policy-controlled features join-ad-interest-group and run-ad-auction

* change term policy-controlled feature to directive named

Co-authored-by: Qingxin Wu <qingxinwu@google.com>
  • Loading branch information
qingxinwu and Qingxin Wu authored Dec 23, 2021
1 parent 70b73ac commit ebd96b8
Showing 1 changed file with 3 additions and 1 deletion.
4 changes: 3 additions & 1 deletion FLEDGE.md
Original file line number Diff line number Diff line change
Expand Up @@ -97,7 +97,7 @@ navigator.joinAdInterestGroup(myGroup, 30 * kSecsPerDay);
```


The browser will only allow the `joinAdInterestGroup()` operation with the permission of both the site being visited and the group's owner. The site can allow or deny permission to any or all third parties via a `Permissions-Policy`, where the default policy is to allow all in the top-level page and to deny all in cross-domain iframes. The group's owner can indicate permission by `joinAdInterestGroup()` running in a page or iframe in the owner's domain, and can delegate that permission to any other domains via a list at a `.well-known` URL. These can be combined, to allow a DSP to add a person to one of its interest groups based on publisher context, as discussed in [TERN](https://github.com/WICG/turtledove/blob/master/TERN.md#c-contextual-interest-groups) — provided the publisher's `Permissions-Policy` permits interest group additions by its SSP, and the DSP gives this SSP this ability. If some permission is missing, `joinAdInterestGroup()` will raise an `Error` describing the reason for failure.
The browser will only allow the `joinAdInterestGroup()` operation with the permission of both the site being visited and the group's owner. The site can allow or deny permission to any or all third parties via a `Permissions-Policy` (directive named "join-ad-interest-group"), where the default policy is to allow all in the top-level page and to deny all in cross-domain iframes. The group's owner can indicate permission by `joinAdInterestGroup()` running in a page or iframe in the owner's domain, and can delegate that permission to any other domains via a list at a `.well-known` URL. These can be combined, to allow a DSP to add a person to one of its interest groups based on publisher context, as discussed in [TERN](https://github.com/WICG/turtledove/blob/master/TERN.md#c-contextual-interest-groups) — provided the publisher's `Permissions-Policy` permits interest group additions by its SSP, and the DSP gives this SSP this ability. If some permission is missing, `joinAdInterestGroup()` will raise an `Error` describing the reason for failure.

There is a complementary API `navigator.leaveAdInterestGroup(myGroup)` which looks only at `myGroup.name` and `myGroup.owner`. As a special case to support in-ad UIs, invoking `navigator.leaveAdInterestGroup({})` from inside an ad that is being targeted at a particular interest group will cause the browser to leave that group, irrespective of permission policies.

Expand Down Expand Up @@ -162,6 +162,8 @@ The returned `auctionResultPromise` object is _opaque_: it is not possible for a

Optionally, `perBuyerTimeouts` can be specified to restrict the runtime (in milliseconds) of particular buyer's bidding scripts. If no value is specified for a particular buyer, a default timeout of 50 ms will be selected. Any `perBuyerTimeouts` higher than 500 ms will be clamped to 500 ms. A key of `'*'` is used to change the default of unspecified buyers.

A `Permissions-Policy` directive named "run-ad-auction" controls access to the `navigator.runAdAuction()` API.


#### 2.2 Auction Participants

Expand Down

0 comments on commit ebd96b8

Please sign in to comment.