공유 저장소 개요

개인 정보를 보호하는 읽기 액세스로 무제한 크로스 사이트 스토리지 쓰기 액세스를 허용합니다.

구현 상태

이 문서에서는 파티션을 나누지 않은 크로스 사이트 스토리지인 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처럼 언제든지 공유 저장소에 쓸 수 있습니다. 다른 Storage API와 달리 공유 스토리지 워크릿이라고 하는 보안 환경에서만 공유 스토리지 값을 읽을 수 있습니다.

Worklet은 비즈니스 로직을 추가하는 곳입니다. Worklet 내에서는 Shared Storage의 값을 읽고 처리할 수 있지만, 정확한 값을 Worklet 호출자에게 직접 반환할 수는 없습니다. Worklet에서 유용한 정보를 추출하기 위해 일련의 '게이트'를 사용할 수 있습니다. 게이트가 2개 있지만 향후 더 추가될 수 있습니다.

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

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

Shared Storage API 사용해 보기

URL 선택 출력 게이트와 비공개 집계 출력 게이트를 위한 Shared Storage API를 테스트에 사용할 수 있습니다. 콘텐츠 선택은 Chrome Canary/Dev/베타 M105 이상에서 테스트할 수 있으며 Private Aggregation API는 Chrome M107+ Canary 및 개발자에서 테스트할 수 있습니다. chrome://settings/adPrivacy에서 모든 광고 개인 정보 보호 API를 사용 설정하여 API를 테스트할 수 있습니다.

데모 사용

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

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

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

콘텐츠 선택 데모의 경우 광고 소재 순환게재, 알려진 고객을 대상으로 사용 환경 맞춤설정, A/B 테스트 실행 사용 사례를 이용할 수 있습니다.

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

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

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

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

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

참여 및 의견 공유

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