Skip to content

Latest commit

 

History

History
91 lines (49 loc) · 8.82 KB

Release_Notes.md

File metadata and controls

91 lines (49 loc) · 8.82 KB
Raw

FLEDGE Release Notes

Chrome M113

  • 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) will be added in M113 (and will be backwards compatible + opt-in). The ability to specify a requestedSize in the auction config (and downstream effects in browser signals and fenced frame configs) is targeting M114, because it is only a convenience feature.

Chrome M109

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

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:

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:
  • 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).