You can now experiment and participate in an origin
trial for Attribution
Reporting. There are a number of available developer resources and code samples
to get started.
To generate summary reports in the origin trial, you’ll first need to set up
the aggregation service. This blog post gives an overview of those steps.
If you ran an origin trial with this API in 2021, follow the migration
guide
to prepare for the latest origin trial.
Key terms
If you haven’t already, we recommend you read the overview of Attribution
Reporting and more
about summary reports
before learning about the aggregation service set up.
- A summary report is a compiled output for the Attribution Reporting API,
which aggregates information about a group of users. Summary reports offer
detailed conversion data, such as purchase value and cart contents, with flexibility for click and view data. - An aggregatable report is an encrypted report, generated by an individual
user’s browser. These contain data about individual conversions and
associated metrics, as defined by the advertiser or adtech. Learn more about
aggregatable reports. - The aggregation service processes data from aggregatable reports to
create a summary report.
Set up the aggregation service
The aggregation service
proposal
asks each adtech provider to operate their own instance of the aggregation
service in a Trusted Execution Environment (TEE) deployed on a cloud service
that supports needed security features.
For the initial implementation and origin trial, adtechs can set up
local testing
or test in TEEs with Amazon Web Services (AWS):
- Register for the Privacy Sandbox Relevance and Measurement origin trial (OT).
- Create or have an Amazon Web Services account.
- Complete the aggregation service
onboarding form. After filling out
this form we will send a verification email and instructions for how to set
up the aggregation service.
Both the local testing tool and the aggregation service running on AWS expect
aggregatable reports to be batched in the
Apache Avro format.
Review code snippets
which demonstrate how to collect and batch aggregatable reports.
Generate summary reports with TEEs on AWS
This is a general overview of how to generate summary reports in TEEs. Read the
detailed developer documentation on testing the aggregation service with
AWS.
To generate summary reports, you’ll need to set up the aggregation service in
AWS with Terraform. Terraform will help provision,
manage, and decommission the aggregation service on AWS
Nitro Enclave instances.
- Install
and set up
the latest AWS client. - Set up Terraform.
- Download the aggregation service
dependencies. - Set up a deployment
environment. - Test your
system.
Get support
For more support with the Attribution Reporting API:
- Open a new Issue on the Privacy Sandbox Developer Support GitHub
repository.
Select the Issue template for Attribution Reporting. - Or join the Attribution Reporting mailing list for
developers
and ask there.
If you notice any unexpected behavior:
- View Chrome
issues reported for the API implementation. - Open a Chrome bug.
- Raise a new Issue for the Trusted Execution Aggregation
Service.
This post is also available in: English