diff --git a/FLEDGE.md b/FLEDGE.md index e02d1a637..6f5df9c3c 100644 --- a/FLEDGE.md +++ b/FLEDGE.md @@ -35,6 +35,7 @@ See [the Protected Audience API specification](https://wicg.github.io/turtledove - [3.4.1 Flexible Component Ad Selection Considering k-Anonymity](#341-flexible-component-ad-selection-considering-k-anonymity) - [3.5 Filtering and Prioritizing Interest Groups](#35-filtering-and-prioritizing-interest-groups) - [3.6 Currency Checking](#36-currency-checking) + - [3.7 View and Click Data](#37-view-and-click-data) - [4. Browsers Render the Winning Ad](#4-browsers-render-the-winning-ad) - [5. Event-Level Reporting (for now)](#5-event-level-reporting-for-now) - [5.1 Seller Reporting on Render](#51-seller-reporting-on-render) @@ -946,6 +947,8 @@ The arguments to `generateBid()` are: 'adComponentsLimit': 40, /* Maximum number of ad components generateBid() may return */ 'multiBidLimit': 5, /* If set, maximum number of bids that can be returned at once; see perBuyerMultiBidLimits */ + 'viewCounts': { pastHour: 1, pastDay: 2, pastWeek: 3, past30Days: 3, past90Days: 3 }, + 'clickCounts': { pastHour: 0, pastDay: 0, pastWeek: 1, past30Days: 1, past90Days: 1 }, } ``` * directFromSellerSignals is an object that may contain the following fields: @@ -1148,6 +1151,113 @@ Currency checking after `scoreAd()` happens only inside component auctions. If `sellerCurrency` also has an extensive effect on how reporting behaves. Please see the section on [Currencies in Reporting](#53-currencies-in-reporting) for more details. +### 3.7 View and Click Data +User clickiness, the propensity of a user to interact with ads, is an important feature in existing bidding models, which could indicate a user’s general ad interaction behavior. In Protected Audience, buyers can get access to limited cross-site clickiness signals. To do this, adtechs can register views and clicks with the browser. At bidding time, the browser counts the registered views and clicks on that device for pre-defined time intervals, so that bidding logic can take them into account. + +#### 3.7.1 Registering View and Click Events + +[attributionsrc](https://wicg.github.io/attribution-reporting-api/#dom-htmlattributionsrcelementutils-attributionsrc) is an attribute on select HTML elements (``, ``, `