Skip to content

Latest commit

 

History

History
62 lines (32 loc) · 4.03 KB

GOALS.md

File metadata and controls

62 lines (32 loc) · 4.03 KB

API Design Goals

This document is a collection of use cases and design principles that a web platform feature for measuring and reporting ad click conversions should support and follow.

Privacy

Any conversion measurement API will be built around joining impression level information with conversion information. If this information channel is not carefully controlled, this API could be used to share identity across sites. To maintain good privacy, we need to ensure that the information in a report does not reveal much more information about a given user than the publisher / advertiser already knew without the API (i.e. the unjoined data).

Since the browser has control over this channel, limits can be tuned to give good privacy and utility.

First party and third party ads

Ideally, this API should be able to support conversion measurement on ads in first party and third party contexts. The vast majority of the web advertising ecosystem relies on third parties for their ads, and ideally a solution would accommodate them.

Restricting to first party ads could lead to perverse incentives for third parties to opt-out of isolating themselves using primitives like cross-domain iframes.

Few site updates

Ideally, most publishers and advertisers will not need to update their sites much to take advantage of this API. Ad tech providers and ad creative authors can change their code to do it under the hood.

Lots of conversion tags today rely on <img> "pixels", so a conversion registration mechanism that relied on Javascript would force advertisers to make updates. Additionally, nearly all ad tech companies fall back to <img> tags if Javascript is disabled, or partner with existing publishers using legacy <img> tags.

Examples: Google, Appnexus, Facebook.

Declarative / Non-script based

All else being equal, it is beneficial to avoid the need for more third-party Javascript running on pages.

Event-level impression metadata

Event-level data is data that identifies a single unique event, as opposed to aggregated data. This kind of data is essential for training machine learning models used to optimize ad selection, since success / failure needs to propagate to the individual inference that chose the ad in the first place.

Event level impression data is also useful to filter out fraudulent clicks. With coarser impression data, fraudsters can more easily hide in the crowd.

If full fidelity impression data is not available, these key use-cases are much harder to achieve.

Some conversion metadata

Here are some legitimate use cases of conversion metadata:

  • Conversion label (sign-up vs purchase)

  • Conversion value ($10 purchase vs. $1000 purchase)

  • Conversion delay (conversion time – impression time)

  • Lifetime value (sum of all purchase values for a given user)

  • Conversion basket (the list of items and quantity purchased)

  • New / existing customer (whether the customer was existing or new, for the purpose of optimizing for customer acquisition)

Some of these use-cases may not be supported by this API, depending on their informational needs.

Third party reporting

Most publishers and advertisers do not have the server-side infrastructure required to log and measure conversions. Instead, they have third party ad tech companies do it for them. For a conversion API to be broadly used, it should allow for this use-case.

This goal is purely for ergonomics. It shouldn’t change the underlying privacy properties of the API assuming publishers / advertisers would forward reports to their ad tech companies anyway on the server-side.

Of course, it should not be possible for untrusted third parties to receive conversion reports without publisher / advertiser permission. This could potentially be addressed via a Feature Policy delegation of permission.