게재빈도별 광고 소재 선택

공유 저장소 워크릿을 실행하여 URL을 선택하고 분리 프레임에서 렌더링합니다.

Shared Storage API는 가능한 많은 사용 사례를 지원하는 범용 크로스 사이트 스토리지용 개인 정보 보호 샌드박스 제안서입니다. 한 가지 예로 Chrome 베타 104.0.5086.0 이상에서 테스트할 수 있는 빈도 제어가 있습니다.

Worklet 스크립트를 실행하여 저장된 데이터를 기반으로 제공된 목록에서 URL을 선택한 다음 분리 프레임에서 해당 URL을 렌더링합니다. 게재빈도 한도에 도달했을 때 새 광고나 기타 콘텐츠를 선택하는 데 사용할 수 있습니다.

게재빈도별 광고 소재 선택 테스트

공유 저장소 및 분리 프레임을 사용하여 게재빈도별로 광고 소재 선택을 테스트하려면 Chrome 104.0.5086.0 이상을 사용하고 있는지 확인하세요. 그런 다음 chrome://flags/#privacy-sandbox-ads-apis에서 개인 정보 보호 샌드박스 광고 API 실험 플래그를 사용 설정합니다.

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

명령줄에서 --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames 플래그를 사용하여 공유 저장소를 사용 설정할 수도 있습니다.

코드 샘플로 실험

불투명 URL을 선택하고 만들려면 공유 저장소 데이터를 읽을 Worklet 모듈을 등록합니다. worklet 클래스는 최대 8개의 URL 목록을 수신한 후 선택된 URL의 색인을 반환합니다.

클라이언트가 sharedStorage.selectURL()를 호출하면 Worklet은 분리 프레임으로 렌더링될 불투명 URL을 실행하고 반환합니다.

사용자가 이전에 광고를 본 횟수에 따라 렌더링할 다른 광고 또는 콘텐츠를 선택한다고 가정해 보겠습니다. 사용자가 콘텐츠를 본 횟수를 계산하고 그 값을 공유 저장소에 저장할 수 있습니다. 저장되면 공유 스토리지의 값은 여러 출처에서 사용할 수 있습니다.

그런 다음 공유 저장소 Worklet은 공유 저장소의 값을 읽고 뷰가 추가될 때마다 카운터를 증가시킵니다. 개수가 사전 정의된 제한에 도달하지 않은 경우 렌더링하려는 콘텐츠 (색인 1)가 반환됩니다. 그렇지 않으면 기본 URL (색인 0)이 반환됩니다.

이 예에서는 다음과 같이 정의됩니다.

  • creative-selection-by-frequencyjs는 콘텐츠 제작자 또는 광고주의 iframe을 통해 로드되며 공유 저장소 Worklet을 로드하고 반환된 불투명 소스를 분리 프레임으로 렌더링합니다.
  • creative-selection-by-frequency-worklet.js는 최대 게재빈도 수를 읽어 콘텐츠나 광고 소재에 반환되는 URL을 결정하는 공유 저장소 워크릿입니다.

creative-selection-by-frequency.js

// The first URL is the default content or ad to be rendered when the frequency limits reached.
const CONTENT_URLS = [
  { url: `https://${contentProducerUrl}/default-content.html` },
  { url: `https://${contentProducerUrl}/example-content.html` },
];

async function injectAd() {
  // Load the worklet module.
  await window.sharedStorage.worklet.addModule('creative-selection-by-frequency-worklet.js');

  // Set the initial frequency count
  window.sharedStorage.set('frequency-count', 0, {
    ignoreIfPresent: true,
  });

  // Run the URL selection operation to choose an ad based on the frequency count in shared storage.
  const fencedFrameConfig = await window.sharedStorage.selectURL('creative-selection-by-frequency', CONTENT_URLS, {
    resolveToConfig: true
  });

  // Render the opaque URL into a fenced frame
  document.getElementById('content-slot').config = fencedFrameConfig;
}

injectAd();

creative-selection-by-frequency-worklet.js

const FREQUENCY_LIMIT = 5;

class CreativeSelectionByFrequencyOperation {
  async run(urls, data) {
    // Read the current frequency limit in shared storage
    const count = parseInt(await this.sharedStorage.get('frequency-count'));

    // Check if the frequency limit has been reached.
    if (count === FREQUENCY_LIMIT) {
      console.log('Frequency limit has been reached, and the default content will be rendered.');
      return 0;
    }

    // Set the new frequency count in shared storage
    await this.sharedStorage.set('frequency-count', count + 1);
    return 1;
  }
}

// Register the operation as 'creative-selection-by-frequency'.
register('creative-selection-by-frequency', CreativeSelectionByFrequencyOperation);

사용 사례

이는 공유 스토리지의 가능한 사용 사례 중 일부에 불과합니다. 의견을 받고 새로운 사용 사례를 탐색하면서 예시를 계속 추가할 예정입니다.

콘텐츠 선택사항

공유 저장소에서 수집한 정보를 기반으로 분리 프레임의 여러 웹사이트의 다른 콘텐츠를 선택하여 표시합니다. 이러한 사용 사례의 출력 게이트는 URL 선택입니다.

  • 광고 소재 순환게재: 광고 소재 ID, 조회수, 사용자 상호작용과 같은 데이터를 저장하여 여러 사이트에서 사용자에게 표시되는 광고 소재를 결정합니다.
  • A/B 테스트: 실험 그룹에 사용자를 할당한 다음 해당 그룹을 공유 저장소에 저장하면 크로스 사이트에서 액세스할 수 있습니다.
  • 커스텀 사용자 환경: 사용자의 등록 상태 또는 기타 사용자 상태를 기반으로 커스텀 콘텐츠와 클릭 유도 문구를 공유합니다.

요약 보고서 생성

Shared Storage로 정보를 수집하고 노이즈가 포함된 합산 요약 보고서를 생성함 이러한 사용 사례의 출력 게이트는 Private Aggregation API입니다.

  • 순 사용자 도달범위 측정: 많은 콘텐츠 제작자 및 광고주는 콘텐츠를 본 순 사용자 수를 알고 싶어 합니다. 공유 저장소를 사용하면 사용자가 처음 광고, 삽입된 동영상 또는 게시물을 볼 때를 기록하고, 다른 사이트에서 동일한 사용자가 중복 집계되는 것을 방지할 수 있습니다. 그런 다음 Private Aggregation API를 사용하여 도달범위에 대한 요약 보고서를 출력할 수 있습니다.
  • 인구통계 측정: 콘텐츠 제작자가 잠재고객의 인구통계를 알고 싶어하는 경우가 많습니다. 공유 저장소를 사용하면 퍼스트 파티 사이트와 같이 보유하고 있는 컨텍스트에서 사용자 인구통계 데이터를 기록하고, 집계 보고를 사용하여 삽입된 콘텐츠와 같은 다른 많은 사이트에서 이에 대해 보고할 수 있습니다.
  • K+ 게재빈도 측정: '유효 게재빈도'라고도 하며 사용자가 특정 콘텐츠를 인식하거나 기억하기 전에 최소 조회수가 있는 경우가 많습니다 (종종 광고 조회수와 관련하여). 공유 저장소를 사용하여 콘텐츠를 K회 이상 본 순 사용자에 대한 보고서를 작성할 수 있습니다.

참여 및 의견 공유

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