Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Browser triggered reportEvent() call on creative load for reliable impression reporting #1100

Open
warrrrren opened this issue Mar 26, 2024 · 5 comments

Comments

@warrrrren
Copy link
Contributor

Context

The current fenced frame reporting API allows the buyer's creative to decide which entities to send events to.
This denies publishers and sell-side entities a guaranteed mechanism to log the impressions rendered by a buyer. In situations today wherein the buyer creative has errors and cannot render, publishers depend on sell-side entities to accurately record impressions and bill buyers accordingly.

Proposal

Add a new reserved event(automatic beacon perhaps) fired by the browser once a frame with an ad creative is initialized.
suggested name: reserved.rendered

The browser will call the URL associated with the event registered by the component and top-level sellers when the iframe/fenced-frame initializes the supplied URN/config.

@rdgordon-index
Copy link
Contributor

#826 is related

@warrrrren
Copy link
Contributor Author

Thanks, @rdgordon-index. Was it brought up in a prior weekly sync call?

@rdgordon-index
Copy link
Contributor

Yes, cf.

## Additional browser event beacons - https://github.com/WICG/turtledove/issues/826

@warrrrren
Copy link
Contributor Author

Thank you.

So if I understand from the conversation, the sendReportTo() function inside reportResult() is called only when an ad renders, making it sufficient to know that an ad was rendered. I didn't see this documented, must have missed it.

Is there a similar mechanism then to detect instances only where a bid was submitted to the top-level auction from the component auction?

@MattMenke2
Copy link
Contributor

MattMenke2 commented Mar 27, 2024

Note that sendReportTo() is actually called right after the auction, however, the report is only sent when navigation to the ad starts (Or when deprecatedUrnToURL is invoked with sendReports=true, though that method is, of course, slated for removal at some point). It's only requested at most once per action, even if the winning ad is used multiple times.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants