공유 저장소 개요

개인 정보가 보호되는 읽기 액세스로 크로스 사이트 저장소 쓰기 액세스를 무제한으로 허용합니다.

구현 상태

이 문서에서는 파티션을 나누지 않은 크로스 사이트 저장소인 Shared Storage API에 관한 제안을 간략히 설명합니다.

제안 내용 상태
콘텐츠 선택에 대한 이벤트 수준 보고 (selectURL()) 최소 2026년까지 사용 가능
사이트별 예산 책정
설명 동영상
M119에서 사용 가능
응답 헤더에서 쓰기 허용
설명서
GitHub 문제
M124에서 사용할 수 있습니다. M119-M123에서 수동으로 사용 설정할 수 있습니다.
비공개 집계 참여 제한 시간
설명 동영상
M119에서 사용 가능
DevTools로 공유 저장소 Worklet 디버깅
섹션
M120에서 사용 가능
공유 저장소 데이터 저장용량 한도를 5MB로 업데이트
설명
M124에서 사용 가능

이 API가 필요한 이유는 무엇인가요?

교차 사이트 사용자 추적을 방지하기 위해 브라우저는 모든 형태의 스토리지 (쿠키, localStorage, 캐시 등)의 파티션을 나눕니다. 그러나 새로운 웹 API의 도움 없이는 불가능할 수 있는 파티션을 나누지 않은 스토리지를 사용하는 합법적인 사용 사례가 많이 있습니다. 예를 들어 콘텐츠 제작자는 교차 사이트 식별자에 의존하지 않고 여러 사이트 간의 도달범위를 측정하려고 할 수 있습니다.

Shared Storage API를 사용하면 사이트에서 파티션을 나누지 않은 크로스 사이트 데이터를 저장하고 액세스할 수 있습니다. 이 데이터는 유출을 방지하기 위해 안전한 환경에서 읽어야 합니다.

다음 두 가지 방법으로 공유 저장소 데이터를 사용할 수 있습니다.

사용 대상

Shared Storage API를 사용하여 이점을 얻을 수 있는 회사에는 여러 가지가 있습니다. 예를 들면 다음과 같습니다.

  • 광고 기술은 캠페인 도달범위를 측정하고 최대 게재빈도를 설정하며 광고 소재를 순환게재할 수 있습니다. 이러한 모든 작업은 현재 서드 파티 쿠키를 사용합니다.
  • 결제 시스템 공급자는 사용자가 기존 고객인지 확인하고 결제 환경을 조정할 수 있습니다.
  • 웹 보안 회사는 의심스럽거나 위험한 행동을 플래깅하는 맞춤형 로직을 작성할 수 있습니다.

회사에서 아직 해결되지 않은 크로스 사이트 스토리지 솔루션을 찾고 있나요? 사용 사례를 공유하세요.

사용 사례

Shared Storage API는 서드 파티 쿠키의 여러 기존 용도를 대체하는 많은 사용 사례를 지원하려고 합니다. 여기에는 다음과 같은 콘텐츠가 포함됩니다.

사용 사례 설명 출력 게이트
광고 소재 순환게재 광고 소재 ID, 조회수 및 사용자 상호작용과 같은 데이터를 저장하여 다양한 사이트에서 사용자에게 표시되는 광고 소재를 결정할 수 있습니다. 이를 통해 조회수의 균형을 유지하고 특정 콘텐츠의 과포화를 방지하여 부정적인 사용자 경험을 방지할 수 있습니다. URL 선택
A/B 테스트 실행 사용자를 실험 그룹에 할당한 다음 해당 그룹을 공유 스토리지에 저장하여 크로스 사이트에서 액세스할 수 있습니다. URL 선택
알려진 고객에 맞게 사용자 환경 맞춤설정하기 사용자의 등록 상태나 기타 사용자 상태에 따라 맞춤 콘텐츠와 클릭 유도 문구를 공유할 수 있습니다. URL 선택
악용 방지 완화 악용 방지, 사기 방지 및 웹 보안 조직에서는 독점 기술을 사용하여 자동화된 봇이든 실제 사람이 해를 입으려고 하는지에 관계없이 악의적인 사용자를 탐지하는 경우가 많습니다. URL 선택 출력 게이트를 사용하여 사용자 신뢰성 평가를 인코딩하거나 비공개 집계 출력 게이트를 사용하여 이상 감지를 위한 데이터 세트를 빌드하는 등 다양한 전략을 테스트할 수 있습니다. URL 선택, Private Aggregation API
순 사용자 도달범위 측정 많은 콘텐츠 제작자와 광고주는 자신의 콘텐츠를 본 순 시청자 수를 알고 싶어 할 때가 많습니다. 공유 저장소를 사용하면 사용자가 처음 광고를 본 시점, 삽입된 동영상, 간행물을 보고하고, 다른 사이트에서 동일한 사용자가 중복 집계되는 것을 방지하여 대략적인 순 사용자 도달범위에 대한 집계 노이즈 보고서를 확인할 수 있습니다. Private Aggregation API
사용자 인구통계 측정 콘텐츠 제작자는 종종 시청자의 인구통계를 알고 싶어 합니다. 공유 저장소를 사용하면 퍼스트 파티 사이트와 같이 보유하고 있는 상황에서 사용자 인구통계 데이터를 기록할 수 있으며, 통합 보고서를 사용하여 삽입된 콘텐츠 등 여러 다른 사이트에서 이 데이터를 보고할 수 있습니다. Private Aggregation API
K+ 게재빈도 도달범위 측정 '유효 게재빈도'라고도 하며, 최소 조회수가 있어야 사용자가 특정 콘텐츠를 인식하거나 떠올릴 수 있습니다 (보통 광고 조회수와 관련됨). 공유 저장소를 사용하면 콘텐츠를 K회 이상 본 순 사용자에 대한 보고서를 작성할 수 있습니다. Private Aggregation API

제안서의 목표는 향후 가능한 많은 사용 사례를 지원하는 범용 API를 만드는 것입니다. 이를 통해 추가 실험과 변화가 웹 생태계와 함께 성장할 수 있습니다.

공유 스토리지는 어떻게 작동하나요?

공유 저장소를 사용하면 사용자 정보 (예: 브라우저 기록 또는 기타 개인 정보)를 삽입 사이트와 공유하거나 데이터를 자체 서버로 유출하지 않고도 교차 사이트 데이터를 기반으로 정보에 입각한 결정을 내릴 수 있습니다.

localStorage 또는 IndexingDB와 같은 다른 JavaScript 저장소 API와 마찬가지로 언제든지 공유 저장소에 쓸 수 있습니다. 다른 저장소 API와 달리 공유 저장소 Worklet이라고 하는 보안 환경에서만 공유 저장소 값을 읽을 수 있습니다.

Worklet에서는 비즈니스 로직을 추가할 수 있습니다. Worklet 내에서 공유 저장소의 값을 읽고 처리할 수 있지만 정확한 값을 Worklet 호출자에게 직접 반환할 수는 없습니다. Worklet에서 유용한 정보를 추출하기 위해 '게이트' 세트를 사용할 수 있습니다. 게이트를 두 개 사용할 수 있지만 향후 더 많은 게이트가 추가될 수 있습니다.

사용 가능한 Shared Storage API 출력 게이트는 다음과 같습니다.

  • 교차 사이트 URL 선택: Worklet 스크립트를 실행하여 저장된 데이터를 기반으로 제공된 목록에서 URL을 선택한 다음 분리 프레임에서 콘텐츠를 렌더링할 수 있습니다.
  • Private Aggregation API를 사용한 노이즈 집계: Worklet을 실행하여 Private Aggregation API를 통해 크로스 사이트 데이터를 전송하고 요약 보고서를 반환할 수 있습니다.

Shared Storage API 사용해 보기

URL 선택 출력 게이트 및 비공개 집계 출력 게이트용 Shared Storage API를 테스트에 사용할 수 있습니다. 콘텐츠 선택은 Chrome Canary/개발자/베타 M105+에서 테스트할 수 있고 Private Aggregation API는 Chrome M107+ Canary 및 개발자에서 테스트할 수 있습니다. chrome://flags/#privacy-sandbox-ads-apis에서 개인 정보 보호 샌드박스 광고 API 실험 플래그를 사용 설정하여 API를 테스트할 수 있습니다.

이러한 API를 사용하려면 개인 정보 보호 샌드박스 Ads API 실험을 사용 설정하세요.

데모 사용

데모가 제공되며 GitHub에서 코드를 검토할 수 있습니다.

이 데모는 여러 게시자의 사이트에 정보를 저장하려는 광고주, 광고 기술, 콘텐츠 유통업체 또는 기타 서드 파티 서비스의 관점에서 구성됩니다. 데모에서는 동일한 서드 파티의 코드가 사용 사례별로 게시자 A게시자 B 사이트 모두에서 실행됩니다. 게시자의 페이지를 방문하여 크로스 사이트 컨텍스트에서 데이터가 공유되는 방식을 확인합니다.

데모에는 콘텐츠 선택 및 비공개 집계의 사용 사례가 포함되어 있습니다.

콘텐츠 선택 데모에서는 광고 소재 순환게재, 알려진 고객을 위한 맞춤설정 사용 환경, A/B 테스트 실행 사용 사례를 확인할 수 있습니다.

비공개 집계 데모의 경우 순 순 사용자 도달범위 측정, K+ 게재빈도 도달범위 측정을 미리 볼 수 있습니다. 사용자 인구통계 측정

DevTools로 공유 저장소 워크릿 디버그

현재 페이지에서 시작된 공유 저장소 Worklet을 검사하려면 DevTools 패널의 'Sources' 탭으로 이동하여 'Shared Storage Worklet / Script First Statement' 이벤트 리스너 중단점을 추가합니다. 이 중단점은 시작 시 초기 모듈 스크립트 실행 또는 단기 워크릿을 일시 중지합니다.

이벤트 수준 리스너를 추가하여 공유 저장소 Worklet을 디버깅합니다.
공유 저장소 Worklet에 중단점을 추가할 수 있습니다.

또한 chrome://inspect/#shared-storage-worklets 페이지에는 모든 페이지의 모든 활성 공유 저장소 워크릿이 표시됩니다.

참여 및 의견 공유

공유 저장소 제안은 논의 중이며 향후 변경될 수 있습니다. 이 API를 사용해 보고 의견을 보내 주세요.