diff --git a/FLEDGE.md b/FLEDGE.md index f1caa25dd..64910963c 100644 --- a/FLEDGE.md +++ b/FLEDGE.md @@ -36,6 +36,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) @@ -940,6 +941,10 @@ 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 }, + /* Aggregated view counts as described in section 3.7: View and Click Data */ + 'clickCounts': { 'pastHour': 0, 'pastDay': 0, 'pastWeek': 1, 'past30Days': 1, 'past90Days': 1 }, + /* Aggregated click counts as described in section 3.7: View and Click Data */ } ``` * directFromSellerSignals is an object that may contain the following fields: @@ -1142,6 +1147,217 @@ 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 +record views and clicks with the browser. At bidding time, the browser counts the recorded views and +clicks on that device for pre-defined time intervals, so that bidding logic can take them into +account. + +#### 3.7.1 Recording View and Click Events + +[attributionsrc](https://wicg.github.io/attribution-reporting-api/#dom-htmlattributionsrcelementutils-attributionsrc) +is an attribute on select HTML elements (``, ``, `