많은 콘텐츠 제작자와 광고주는 콘텐츠를 시청한 순 시청자 수를 알고 싶어 합니다. 공유 저장공간을 사용하면 사용자가 광고, 삽입된 동영상, 간행물을 처음 본 시점을 기록하고 여러 사이트에서 동일한 사용자가 중복 집계되는 것을 방지할 수 있습니다. 그런 다음 Private Aggregation API를 사용하여 도달범위에 대한 요약 보고서를 출력할 수 있습니다.
Shared Storage API는 개인 정보 보호 다양한 용도를 지원하는 크로스 사이트 스토리지를 위한 범용 샌드박스 제안 사용 사례일 수 있습니다. Private Aggregation API는 공유 저장소에서 사용할 수 있는 출력으로, 이를 통해 크로스 사이트 데이터를 집계할 수 있습니다. 이러한 측정을 구현하는 방법을 자세히 알아보려면 도달범위 백서를 확인하세요.
순 사용자 도달범위 측정 사용해 보기
공유 스토리지 및 비공개 집계를 사용하여 순 사용자 도달범위 측정을 실험하려면 Chrome M107 이상을 사용하고 있는지 확인하세요. chrome://settings/adPrivacy
에서 모든 광고 개인 정보 보호 API를 사용 설정합니다.
명령줄에서 --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames
플래그를 사용하여 공유 저장소를 사용 설정할 수도 있습니다.
코드 샘플 실험
여러 사이트에서 내 콘텐츠를 본 순 사용자 수를 추적하는 것이 좋습니다. 이 예에서는 콘텐츠 ID 측정기준이 집계 키 (버킷)로 인코딩되며 개수는 집계 가능한 값으로 사용됩니다. 요약 보고서에는 '약 391명의 사용자가 Content ID 123을 확인했습니다.'와 같은 정보가 포함됩니다.
이 예에서
* unique-reach-measurement.js
는 프레임을 통해 로드되며 공유 저장소 Worklet의 로드를 담당합니다.
* unique-reach-measurement-worklet.js
는 공유 스토리지의 플래그를 확인하고 Private Aggregation API를 통해 보고서를 전송하는 공유 스토리지 워크렛입니다.
async function measureUniqueReach() {
// Load the Shared Storage worklet
await window.sharedStorage.worklet.addModule('reach-measurement-worklet.js');
// Run the reach measurement operation
await window.sharedStorage.run('reach-measurement', { data: { contentId: '1234' } });
}
measureUniqueReach();
// Learn more about noise and scaling from the Private Aggregation fundamentals
// documentation on Chrome blog
const SCALE_FACTOR = 65536;
function convertContentIdToBucket(contentId) {
return BigInt(contentId);
}
class ReachMeasurementOperation {
async run(data) {
const { contentId } = data;
// Read from Shared Storage
const key = 'has-reported-content';
const hasReportedContent = (await sharedStorage.get(key)) === 'true';
// Do not report if a report has been sent already
if (hasReportedContent) {
return;
}
// Generate the aggregation key and the aggregatable value
const bucket = convertContentIdToBucket(contentId);
const value = 1 * SCALE_FACTOR;
// Send an aggregatable report via the Private Aggregation API
privateAggregation.contributeToHistogram({ bucket, value });
// Set the report submission status flag
await sharedStorage.set(key, true);
}
}
// Register the operation
register('reach-measurement', ReachMeasurementOperation);
참여 및 의견 공유
Shared Storage API 제안은 현재 활발한 논의와 개발이 진행 중이며 따라서 변경될 수 있습니다.
Shared Storage API에 관한 의견을 보내주세요.
최신 정보 확인하기
- 메일링 리스트: 메일링 리스트를 구독하여 Shared Storage API와 관련된 최신 업데이트 및 공지사항을 확인하세요.
도움이 필요하신가요?
- 개발자 지원: 개인 정보 보호 샌드박스 개발자 지원 저장소에서 다른 개발자와 소통하고 질문에 대한 답변을 얻을 수 있습니다.