Attribution Reporting 제안서가 Chrome 버전 104에 새로운 API 메커니즘, 기능, 집계 서비스 업데이트와 함께 변경됩니다.
업데이트 대상은 누구인가요?
이러한 업데이트는 다음과 같은 경우에 적용됩니다.
- 이미 API에 익숙합니다. 예를 들어 WICG 저장소에 대한 토론을 관찰하거나 참여한 적이 있고 API의 변경사항을 이해하려는 경우가 여기에 해당합니다.
- 데모 또는 계획에서 Attribution Reporting API를 사용하여 오리진 트라이얼을 테스트하고 있습니다.
이 API를 처음 사용하거나 아직 사용해 보지 않았다면 API 소개로 바로 이동하세요.
Attribution Reporting API 업데이트
Attribution Reporting 클라이언트 측 API의 최신 변경사항을 반영하도록 Attribution Reporting 데모가 업데이트되었습니다.
대부분의 변경사항은 별도의 조치가 필요하지 않습니다. 구현을 위해 업데이트가 필요한 항목은 아래에 강조표시되어 있습니다.
(조치 필요) 등록용 통합 헤더
헤더가 통합되었습니다. 이제 소스용 헤더와 JSON 형식의 트리거용 헤더가 하나씩만 있습니다.
- 기여 분석 소스를 등록하려면
Attribution-Reporting-Register-Source헤더로 등록 요청에 응답하면 됩니다. - 트리거 등록을 완료하려면
Attribution-Reporting-Register-Trigger헤더를 설정합니다.
이 변경사항을 적용하려면 조치가 필요합니다. 자세한 내용은 API 개발자 가이드를 참고하세요.
(조치 필요) 이제 집계 키가 사전이 되었습니다.
기여 분석 소스를 등록하려면 aggregation_keys를 계속 사용하지만 이제 목록 대신 JSON 사전으로 저장됩니다.
예를 들면 다음과 같습니다.
"aggregation_keys": {
// Generate a "0x159" key piece for the key named "campaignCounts".
"campaignCounts": "0x159", // User saw ad from campaign 345 (out of 511)
// 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
}
이 변경사항을 적용하려면 조치가 필요합니다. 자세한 내용은 API 핸드북을 참조하세요.
보고서 생성
요약 보고서로 집계할 수 있는 집계 가능한 보고서만 생성하도록 선택할 수 있습니다. 필터와 일치하는 이벤트 트리거가 없으면 이벤트 수준 보고서가 생성되지 않습니다.
통합 디버그 키 설정
이제 별도의 헤더가 아닌 소스 및 트리거 헤더에 디버그 키가 설정됩니다. 보고서를 디버그하는 방법을 자세히 알아보세요.
기여 분석 소스 등록
이제 <img> 태그 지원과 유사하게 스크립트 태그를 사용하여 기여 분석 소스를 등록할 수 있습니다.
API 업데이트 더보기
API 핸드북에 변경 및 인용된 기타 변경사항은 다음과 같습니다.
- 소스는 JavaScript 요청 API에 등록할 수 있습니다.
window.registerSource가 삭제되었습니다.- 이제 소스를 등록할 때
attributionsrc값을 포함하는 것은 선택사항입니다. - 수신되는 소스 등록 요청에
Attribution-Reporting-Eligible헤더가 추가되었습니다. encodeURIComponent에 소폭 변경되었습니다.- 집계 가능한 보고서의
shared_info필드에서 개인 정보 보호 예산 키가 삭제되었습니다.
집계 서비스 지원
Chrome 104에서는 집계 가능한 보고서 내의 일부 정보 형식을 업데이트하려고 합니다. 현재 집계 서비스에서 이 변경사항에 관한 지원을 구축하고 있습니다. 변경사항이 제공된 후 이 문서와 변경 로그가 업데이트됩니다.
요약 보고서를 생성하기 위한 실용적인 도움말 및 전략 문서가 준비되어 있습니다. 다음과 같은 다양한 통계가 제공됩니다.
- 요약 보고서 생성의 노이즈 개요
- 측정기준, 키, 값에 대한 자세한 설명
- 키 구조 맵을 포함한 실제 집계 키
- 실제로 집계 가능한 값과 기여 예산의 영향
- epsilon 실험 가이드
업데이트 자세히 알아보기
- API에 대해 알아야 할 사항 읽어보기
- 기여도 보고 실험: 요약 보고서의 전략 및 팁을 읽어보세요.