Skip to content

Allow source expiry to be independently configured for aggregatable attribution #556

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.

Sign up for GitHub

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

Merged
merged 1 commit into from
Sep 21, 2022
Merged

Allow source expiry to be independently configured for aggregatable attribution #556

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 10 additions & 3 deletions AGGREGATE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -69,8 +69,8 @@ example an ad-tech will use the API to collect:
* Aggregate purchase values at a per geo level
### Attribution source registration

Registering sources eligible for aggregate reporting entails adding a new
`aggregation_keys` dictionary field to the JSON dictionary of the
Registering sources eligible for aggregate reporting entails adding new
`aggregation_keys` and `aggregatable_expiry` dictionary fields to the JSON dictionary of the
[`Attribution-Reporting-Register-Source` header](https://github.com/WICG/conversion-measurement-api/blob/main/EVENT.md#registering-attribution-sources):
```jsonc
{
Expand All @@ -83,7 +83,9 @@ Registering sources eligible for aggregate reporting entails adding a new

// Generates a "0x5" key piece (low order bits of the key) for the key named "geoValue".
"geoValue": "0x5" // Source-side geo region = 5 (US), out of a possible ~100 regions
}
},

"aggregatable_expiry": "[64-bit signed integer]"
}
```
This defines a dictionary of named aggregation keys, each with a piece of the
Expand All @@ -94,6 +96,11 @@ trigger-side pieces.
Final keys will be restricted to a maximum of 128 bits. This means that hex
strings in the JSON must be limited to at most 32 digits.

`aggregatable_expiry` is an optional string field containing a signed 64-bit
integer representing the number of seconds for which the source is eligible for
aggregatable attribution. If omitted, the field defaults to the value specified
in the `expiry` field.

### Attribution trigger registration

Trigger registration will also add two new fields to the JSON dictionary of the
Expand Down