광고 소재 순환게재

공유 저장소를 사용하여 사이트 전체에서 사용자에게 표시되는 광고 소재를 결정합니다.

Shared Storage API는 가능한 많은 사용 사례를 지원하는 범용 크로스 사이트 스토리지용 개인 정보 보호 샌드박스 제안서입니다. 이러한 예 중 하나가 Chrome 104.0.5086.0 이상에서 테스트할 수 있는 광고 소재 순환게재입니다.

광고 소재 순환게재를 사용하면 광고 소재 ID, 조회수, 사용자 상호작용 등의 데이터를 저장하여 여러 사이트에서 사용자에게 표시되는 광고 소재를 결정할 수 있습니다.

공유 저장소 워크릿을 실행하여 저장된 데이터를 기반으로 제공된 목록에서 URL을 선택한 다음 분리 프레임에서 해당 광고 소재를 렌더링합니다. 이는 새 광고 또는 기타 콘텐츠를 선택하는 데 사용될 수 있습니다.

광고 소재 순환게재 사용해 보기

공유 저장소를 사용하여 광고 소재 순환게재를 실험하려면 Chrome 104.0.5086.0 이상을 사용 중인지 확인하세요. 그런 다음 chrome://flags/#privacy-sandbox-ads-apis에서 개인 정보 보호 샌드박스 광고 API 실험 플래그를 사용 설정합니다.

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

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

코드 샘플로 실험

광고주 또는 콘텐츠 제작자는 캠페인에 서로 다른 전략을 적용하고 콘텐츠 또는 광고 소재를 순환게재하여 효율성을 높일 수 있습니다. 공유 저장소는 여러 사이트 간에 순차 회전 및 균등 분산 회전과 같은 다양한 회전 전략을 실행하는 데 사용할 수 있습니다.

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

  • creative-rotation.js가 프레임에 삽입되어 있습니다. 이 스크립트는 가장 중요한 광고 ( 가중치)를 설정하고 Worklet에 대한 호출을 설정하여 어떤 콘텐츠를 표시해야 하는지 결정합니다.
  • creative-rotation-worklet.js는 콘텐츠의 가중 분포를 결정하고 표시해야 할 반환을 반환하는 공유 저장소 Worklet입니다.

creative-rotation.js

// 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();

creative-rotation-worklet.js

class SelectURLOperation {
  async run(urls, data) {
    // Read the rotation mode from Shared Storage
    const rotationMode = await this.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 this.sharedStorage.get('creative-rotation-index');
        index = parseInt(currentIndex, 10);
        const nextIndex = (index + 1) % urls.length;

        await this.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);

사용 사례

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

콘텐츠 선택사항

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

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

요약 보고서 생성

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

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

참여 및 의견 공유

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