Release_Notes.md

FLEDGE has been renamed to Protected Audience API. To learn more about the name change, see the blog post

FLEDGE Release Notes

Chrome M114

• Functions that are called from Protected Audience worklets are now only accessible from inside the worklets, not from the global scope. See #489 for more information.

Chrome M114

• Support the ability to specify requestedSize in the auction config, which is eventually stored in the winning fenced frame config's container size. The requestedSize may not be accessible through browser signals in the auction until M116, and is a lower priority because it is a convenience feature only (presumably the size of the ad slot is already passed in through other signals, if it is needed).

Chrome M113

• Support some of the size-related API changes (the ability to declare ad sizes in joinAdInterestGroup, include sizes with bids in generateBid, and have those sizes macro'd into the URL with AD_WIDTH and AD_HEIGHT macros), in a backwards compatible and opt-in way.

Chrome M109

• Since version 109.0.5414.16, the sendReports parameter to navigator.deprecatedURNToURL() is respected.

Chrome M108

• Support reporting bid reject reason to buyers through calling forDebuggingOnly.reportAdAuctionLoss() API in generateBid() and including ${rejectReason} in the report URL's query string. See FOT#1 reporting details for more information.

Chrome M107

• Bug fixes:
  • The forDebuggingOnly.reportAdAuctionLoss() and forDebuggingOnly.reportAdAuctionWin() APIs were fixed to perform post-auction signal parameter replacement on URL query parameters instead of the URL path.

Chrome M104

• Add .well-known join/leave permission cache.
• Clear pending report request queue after a certain time to prevent reports continuing for unbounded amounts of time.
• Implement improved process model for Android (for local FLEDGE testing by developers while the FLEDGE origin trial is not supported on Android).

Chrome M103

• Add chrome://tracing support for FLEDGE auctions (including worklets).
• Add basic .well-known support for determining if a site is allowed to join or leave interest groups for an owner. .well-known ownership delegation is documented in the explainer.
• joinAdInterestGroup() and leaveAdInterestGroup() changed to return promises (fulfilled or rejected based on whether the join or leave is allowed based on the .well-known lookup).
• Rate-limit report network requests, to prevent over-consuming networking resources and allow requests to be sent in parallel.
• Add navigator.deprecatedReplaceInURN() function. For more information see Issue #286.
• Bug fixes:
  • Fix error when component auction does not bid.

Chrome M102

• Fenced Frame reporting added. Worklets now support a registerAdBeacon() function in reportWin() and reportResult() which can be used to register reporting URLs.
• As described in the FLEDGE explainer, ads selected by a FLEDGE runAdAuction() call and rendered in a Fenced Frame can now call navigator.leaveAdInterestGroup() without arguments to leave the interest group that triggered the ad.
• Limits on the number of interest groups allowed to participate in auctions cause auctions to choose interest groups uniformly and randomly. They have equal priority instead of in order of decreasing expiration time. See perBuyerGroupLimits in the FLEDGE explainer for more information about interest group limits in auctions.
• Post-auction signals:
  • Post-auction signals highestScoringOtherBid and madeHighestScoringOtherBid added to browser_signals provided to reporting functions reportWin() and reportResult() as documented by pull request #316.
  • Post-auction signals can be included in the URLs fetched through the reportAdAuctionLoss() and reportAdAuctionWin() APIs: text placeholders like “${winningBid}” in the URL will be replaced with the corresponding value from the auction. For example a URL provided to reportAdAuctionLoss() as 'https://example.com/report/group=myGroup/bid=${winningBid}/otherBid=${highestScoringOtherBid}' may be fetched as 'https://example.com/report/group=myGroup/bid=1/otherBid=2' Note that due to a bug replacement is currently supported only in the URL path, but will be changed to only be supported in the URL query parameters when that bug is fixed. Further details are present in the FLEDGE OT explainer.
• As discussed in https://crbug.com/1311478, forDebuggingOnly.reportAdAuctionLoss() now sends a loss report event if an error or timeout occurs after the report URL was registered. This can be useful for measuring how often worklets do not complete due to timeouts or throwing exceptions.
• componentAuctions and trustedScoringSignalsUrl from auction config passed to seller worklets.
• Add biddingLogicUrl, biddingWasmHelperUrl, trustedBiddingSignalsUrl, trustedBiddingSignalsKeys, and dailyUpdateUrl fields to interestGroup parameter passed to generateBid().
• Worklet features
  • ad output field of generateBid() now optional
  • setBid() function added to generateBid(). This function sets a default return value to be used if the worklet times out. setBid() can be called multiple times, with newer values overwriting previous ones. This function may be useful for bidding scripts that progressively increase.
  • reportAdAuctionWin() and reportAdAuctionLoss() can be called multiple times within a worklet, with newer values overwriting previous ones.

Chrome M101

• joinAdInterestGroup() can specify interest group priority using the priority value. Limits on the number of interest groups per bidder can be specified using the perBuyerGroupLimits value in the auction configuration passed to runAdAuction(). The default interest group priority is 0. Per-bidder limits on interest groups restrict the number of interest groups that can participate in an ad auction, choosing higher priority interest groups preferentially.
• Update interest groups that were involved in an auction, as described in the proposal for the first FLEDGE origin trial. Chrome collects the origins of owners for interest groups that participated in the auction, including inside component auctions, then randomizes the order and updates each one. Updates occur for both successful and failed auctions.
• Component auctions are now supported.
• Bug fixes:
  • Interest group updates can change biddingWASMHelperURL and adComponents fields within the stored interest groups.
  • forDebuggingOnly.reportAdAuctionLoss() now sends a report when no bid wins and the auction runs to completion. If an auction is canceled (for example, due to a new navigation), no reports will be generated.

Chrome M100

• Support passing Data-Version from the trusted key/value server to the worklet via the dataVersion value as specified in the explainer.
• Devtools Interest Group storage under the Applications panel shows interest groups as they are used. Described in the FLEDGE API Developer Guide.
• Per-Buyer worklet timeout: In AuctionConfig, perBuyerTimeouts can be specified to restrict the runtime (in milliseconds) of particular buyer's generateBid() scripts. If no value is specified for a particular buyer, a default timeout of 50 ms will be selected. Any timeout higher than 500 ms will be clamped to 500 ms. A key of '*' is used to change the default of unspecified buyers. Addresses FLEDGE issue #90.
• Seller worklet timeout: In AuctionConfig, sellerTimeouts can be specified to restrict the runtime (in milliseconds) of the seller's scoreAd() scripts. If no value is specified, a default timeout of 50 ms will be selected. Any timeout higher than 500 ms will be clamped to 500 ms.
• Full console API should now be available for worklets (rather than a small subset).