Here's where to start, including setup and a quick overview.
Choose a report type
Using the Attribution Reporting API, you can generate two types of reports: event-level and summary reports. Event-level reports require less setup than aggregatable or summary reports, so they may be a good place to start. Summary reports require integration with the Aggregation Service; event-level reports don't.
You can set up reporting for both event-level and summary reports. They are complementary.
Event-level reports
Event-level reports associate a particular ad click or view (on the ad side) with data on the conversion side. To preserve user privacy by limiting the joining of user identity across sites, conversion-side data is very limited, and the data is noisy.
Summary reports
A summary report is an Attribution Reporting API and Private Aggregation API report type. A summary report includes aggregated user data and can contain detailed conversion data, with noise added. Summary reports are made up of aggregate reports.
Implementation
You can get started by trying out the steps that follow.
Note that for a given event source, it's possible to generate both an event-level and an aggregatable report. The demo walks you through the process.
Event-level report generation
Here are the minimum steps to follow to generate event-level reports:
Register a source. Refer to Register attribution sources for the instructions. Note that the steps are different for clicks and views.
Register a trigger. Refer to Register attribution triggers for the instructions.
Set up an endpoint with the following URL:
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution
.
Refer to the example code in adtech.js to see thePOST
method and to Wikipedia for more information on.well-known
.
More details are available in the event-level report explainer.
Summary report generation
To generate summary reports, follow these high-level steps:
Register a source. Refer to Register attribution sources for the instructions. Note that the steps are different for clicks and views. Additional details can be found in Attribution source registration.
Register a trigger. Refer to Register attribution triggers for the instructions.
Set up an endpoint for aggregatable reports with the following URL:
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution
.
Refer to the example code in adtech.js to see thePOST
method and to Wikipedia for more information on.well-known
.Batch and send the reports for further processing by the Aggregation Service which will produce summary reports. Refer to batched aggregatable reports.
More details are available in the aggregatable report explainer.
Learn how to set up debug reports in the Attribution reporting debugging series.
Summary reports additional concepts
In addition to understanding the implementation steps here, the following concepts will help you plan your summary reporting strategy:
Optional steps
- Set up filters (optional):
- Follow the instructions in Define custom rules using filters.
- Review details specific to filters for aggregatable reports in the triggers section of the explainer.
Don't forget feature detection
Before you use the API, detect if it hasn't been blocked on the page using a permissions policy. To do so, run the following code:
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// the Attribution Reporting API is enabled
}
If this feature-detection check returns true, the API is allowed in the context (page) where the check is run.
Note that this check alone isn't a guarantee that the API is usable on that page; the user may have disabled the API using their browser settings, or they may have other settings that prevent the API from being used. In order to protect user privacy, there is no way to check for this programmatically.
Next steps
If you're ready to begin implementation, check out these docs:
Setup
- Register an attribution source
- Register an attribution trigger
- Prioritize specific clicks, views, or conversions
- Debugging Attribution Reporting
- Aggregation keys
Background
- Attribution Reporting with event-level reports
- Attribution Reporting with Aggregatable Reports
- Constraints on Aggregation Reporting data
- Understanding noise
- Working with noise
Demos and tools
Planning
If you're still in the planning stage, take a look at these docs: