공유 저장소를 사용하여 사이트 전체에서 사용자에게 표시되는 광고 소재를 결정합니다.
Shared Storage API는 개인 정보 보호 다양한 용도를 지원하는 크로스 사이트 스토리지를 위한 범용 샌드박스 제안 사용 사례일 수 있습니다. 이러한 예로는 광고 소재 순환게재를 들 수 있는데, Chrome 104.0.5086.0 이상에서 테스트할 수 있습니다.
광고 소재 순환게재를 통해 광고 소재 ID, 보기 권한 등의 데이터를 광고 소재 사용자의 전체 보기 확인할 수 있습니다.
공유 저장소 Worklet을 실행하여 제공된 목록에서 해당 광고 소재를 분리 프레임에 렌더링할 수 있습니다. 이는 새 광고나 다른 콘텐츠를 선택할 수 있습니다
광고 소재 순환게재 사용해 보기
공유 스토리지를 사용하여 광고 소재 순환게재를 실험하려면 Chrome 104.0.5086.0 이상을 사용하고 있는지 확인하세요. chrome://settings/adPrivacy
에서 모든 광고 개인 정보 보호 API를 사용 설정합니다.
명령줄에서 --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames
플래그를 사용하여 공유 저장소를 사용 설정할 수도 있습니다.
코드 샘플 실험
광고주나 콘텐츠 제작자는 각 콘텐츠별로 서로 다른 전략을 콘텐츠 또는 광고 소재를 순환게재하여 효과를 높일 수 있습니다. 공유 스토리지는 다음과 같은 다양한 회전 전략을 실행하는 데 사용할 수 있습니다. 서로 다른 사이트에 순차 순환게재와 균등 분산 순환게재를 지원합니다.
이 예에서는 다음과 같이 정의됩니다.
creative-rotation.js
는 프레임에 삽입됩니다. 이 스크립트는 가장 중요한 광고 ( 가중치)와 워크렛을 호출하여 어떤 콘텐츠를 표시해야 하는지 결정합니다.creative-rotation-worklet.js
는 표시해야 하는 콘텐츠 및 반환의 가중치 분포를 결정하는 공유 저장소 Worklet입니다.
// Ad config with the URL of the content, a probability weight for rotation, and the clickthrough rate.
const DEMO_CONTENT_CONFIG = [
{
url: 'https://your-server.example/contents/content-1.html',
weight: 0.7,
},
{
url: 'https://your-server.example/contents/content-2.html',
weight: 0.2,
},
{
url: 'https://your-server.example/contents/content-3.html',
weight: 0.1,
},
];
// Set the mode to sequential and set the starting index to 0.
async function seedStorage() {
await window.sharedStorage.set('content-rotation-mode', 'sequential', {
ignoreIfPresent: true,
});
await window.sharedStorage.set('content-rotation-index', 0, {
ignoreIfPresent: true,
});
}
async function injectAd() {
// Load the worklet module
await window.sharedStorage.worklet.addModule('content-rotation-worklet.js');
// Initially set the storage to sequential mode for the demo
seedStorage();
// Run the URL selection operation to determine the next content rendered.
const urls = DEMO_CONTENT_CONFIG.map(({ url }) => ({ url }));
const fencedFrameConfig = await window.sharedStorage.selectURL('content-rotation', urls, {
data: DEMO_CONTENT_CONFIG,
resolveToConfig: true
});
// Render the opaque URL into a fenced frame
document.getElementById('content-slot').config = fencedFrameConfig;
}
injectAd();
class SelectURLOperation {
async run(urls, data) {
// Read the rotation mode from Shared Storage
const rotationMode = await sharedStorage.get('content-rotation-mode');
// Generate a random number to be used for rotation
const randomNumber = Math.random();
let index;
switch (rotationMode) {
/**
* Sequential rotation
* - Rotates the contents in order
* - Example: A -> B -> C -> A ...
*/
case 'sequential':
const currentIndex = await sharedStorage.get('creative-rotation-index');
index = parseInt(currentIndex, 10);
const nextIndex = (index + 1) % urls.length;
await sharedStorage.set('content-rotation-index', nextIndex);
break;
/**
* Weighted rotation
* - Rotates the contentswith weighted probability
* - Example: A=70% / B=20% / C=10%
*/
case 'weighted-distribution':
// Sum the weights cumulatively, and find the first URL where the
// sum exceeds the random number. The array is sorted in
// descending order first.
let weightSum = 0;
const { url } = data
.sort((a, b) => b.weight - a.weight)
.find(({ weight }) => {
weightSum += weight;
return weightSum > randomNumber;
});
index = urls.indexOf(url);
break;
default:
index = 0;
}
return index;
}
}
register('content-rotation', SelectURLOperation);
使用场景
以上只是共享存储空间的一部分用例。我们将 我们会继续添加样本, 获取反馈 并发现新的应用场景
内容选择
在以下位置选择和显示不同网站上的不同内容: 围栏框架 共享存储空间这些用例的输出门控是网址选择。
- 广告素材轮播: 存储广告素材 ID、观看次数和用户互动等数据,以确定哪个广告素材在不同网站上的呈现效果
- A/B 测试: 您可以将用户分配到实验组,然后将该组存储在共享存储空间中,以便跨网站访问。
- 自定义用户体验: 根据用户的注册状态或其他用户状态共享自定义内容和号召性用语
生成摘要报告
通过共享存储空间收集信息,并生成杂乱的汇总摘要报告。这些用例的输出门控是 Private Aggregation API。
- 唯一身份用户覆盖面衡量: 许多内容制作者和广告客户都想知道 人查看了他们的内容。使用共享存储空间记录用户首次访问 用户看过您的广告、嵌入式视频或发布内容,并防止重复 统计不同网站上的同一用户然后,您可以使用 Private Aggregation API 输出覆盖面的摘要报告。
- 受众特征衡量: 内容制作者通常希望了解其网站的受众特征 受众群体。您可以使用共享存储空间来记录 背景信息(例如您的第一方网站),并使用汇总的数据 以便在其他许多网站(例如嵌入式内容)中生成此报告。
- K+ 频次衡量: 有时也称为“有效频次”通常会有一个 用户会认出或回想某些内容(通常在 广告观看情境)。您可以使用共享存储空间生成报告 的唯一身份用户中,特定内容至少浏览了 K 次。
참여 및 의견 공유
공유 저장용량 제안은 현재 논의 중이며 변경될 수 있습니다. 있습니다. 이 API를 사용해 보고 의견이 있으면 언제든지 알려 주세요.
- GitHub: 제안, 도달범위 백서, 질문 제기 및 토론 참여를 참조하세요.
- Shared Storage API 공지사항: 메일링 리스트에 등록된 지난 공지사항에 참여하거나 공지사항 확인하기
- 개발자 지원: 개인 정보 보호 샌드박스 개발자 지원 저장소