FLEDGE API 개발자 가이드

이 도움말은 누구를 대상으로 하나요?

이 게시물은 실험용 Protected Audience API의 현재 반복 버전에 관한 기술 참고 자료입니다.

Protected Audience란 무엇인가요?

Protected Audience API는 게재할 개인 정보 보호 샌드박스 제안서 다른 사람이 사용할 수 없도록 설계된 리마케팅 및 맞춤 잠재고객 사용 사례 사이트 전반에 걸친 사용자 탐색 행동을 추적할 수 있습니다. 이 API는 사용자가 이전에 방문한 웹사이트에 대한 관련성 높은 광고를 선택할 수 있습니다.

Protected Audience는 TURTLEDOVE 제안서 모음입니다.

아래 다이어그램은 FLEDGE 수명 주기를 간략히 보여줍니다.

<ph type="x-smartling-placeholder">
</ph> <ph type="x-smartling-placeholder"></ph> <ph type="x-smartling-placeholder">FLEDGE 수명 주기의 각 단계에 관한 개요를 보여주는 그림</ph>
FLEDGE 수명 주기.

Protected Audience를 사용해 보려면 어떻게 해야 하나요?

Protected Audience 데모

광고주 및 게시자 사이트 전반에 걸친 기본적인 Protected Audience 배포 둘러보기는 다음을 참고하세요. protected-audience-demo.web.app.

데모 동영상 은 데모 코드의 작동 방식을 설명하고 Protected Audience 디버깅을 위해 Chrome DevTools를 사용하는 방법을 보여줍니다.

Protected Audience 오리진 트라이얼 참여

개인 정보 보호 샌드박스의 관련성 및 측정 오리진 트라이얼이 데스크톱용 Chrome 베타 101.0.4951.26 이상에서 Protected Audience에 제공됩니다. Topics Attribution Reporting API입니다.

참여하려면 오리진 트라이얼 토큰에 등록하세요.

무료 체험에 등록한 후 페이지에서 Protected Audience JavaScript API를 사용해 볼 수 있습니다. 유효한 무료 체험판 토큰을 제공하는 게시자: 예를 들어 브라우저에 하나 이상의 관심분야 그룹에 참여하도록 요청하려면 광고 입찰을 실행하여 광고를 선택하고 표시합니다.

Protected Audience 데모는 엔드 투 엔드 Protected Audience 배포의 기본 예시를 제공합니다.

Protected Audience API 코드를 실행하려는 모든 페이지에 무료 체험 토큰을 제공합니다.

  • <head>에 메타 태그로 삽입:

    <meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">

  • HTTP 헤더로:

    Origin-Trial: TOKEN_GOES_HERE

  • 프로그래매틱 방식으로 토큰을 제공합니다.

    const otMeta = document.createElement('meta');
    otMeta.httpEquiv = 'origin-trial';
    otMeta.content = 'TOKEN_GOES_HERE';
    document.head.append(otMeta);
    

Protected Audience 코드를 실행하는 iframe(예: navigator.joinAdInterestGroup()) 호출하려면 출처와 일치하는 토큰을 제공해야 합니다.

제안된 첫 번째 Protected Audience 오리진 트라이얼 세부정보 은 첫 번째 시험의 목표에 대한 자세한 내용과 지원되는 기능에 대해 설명합니다.

이 API 테스트

데스크톱의 Chrome 베타 101.0.4951.26 이상에서 단일 사용자에 대해 Protected Audience를 테스트할 수 있습니다.

  • chrome://settings/adPrivacy에서 모든 광고 개인 정보 보호 API를 사용 설정합니다.
  • 명령줄에서 플래그 설정

iframe 또는 분리 프레임에서 광고 렌더링

광고는 <iframe> 또는 <fencedframe>에서 렌더링될 수 있습니다. 지정할 수 있습니다

<fencedframe>를 사용하여 광고를 렌더링하는 방법:

--enable-features=InterestGroupStorage,AdInterestGroupAPI,Fledge,FencedFrames

<iframe>를 사용하여 광고를 렌더링하는 방법:

--enable-features=InterestGroupStorage,AdInterestGroupAPI,Fledge,AllowURNsInIframes --disable-features=FencedFrames

BiddingAndScoringDebugReportingAPI 플래그를 포함하여 임시 디버그 손실/성공 보고 메서드를 사용 설정합니다.

플래그를 사용하여 Chromium 실행 명령어에서 Chrome 및 기타 Chromium 기반 브라우저를 실행할 때 플래그를 설정하는 방법을 설명합니다 행입니다. Protected Audience 신고의 전체 목록은 다음에서 확인할 수 있습니다. Chromium 코드 검색.

최신 버전의 Chrome에서 지원되는 기능은 무엇인가요?

Protected Audience는 Chromium의 기능 플래그 뒤에 처음으로 제공됩니다. 를 사용하여 Protected Audience 제안서의 다음 기능을 테스트하세요.

  • 관심분야 그룹: 브라우저에 의해 저장되며, 광고 입찰을 구성하기 위해 관련 메타데이터와 함께 저장됩니다. 살펴보겠습니다
  • 구매자별 기기 내 입찰 (DSP 또는 광고주): 저장된 관심분야 그룹 및 신호 기반 판매자에게서 얻는 것입니다.
  • 판매자 (SSP 또는 게시자)에 의한 기기 내 광고 선택: 입찰 입찰가 및 메타데이터입니다.
  • 일시적으로 완화된 버전의 분리형 프레임(Fenced Frames)에서 광고 렌더링: 네트워크 액세스 및 광고 렌더링에 로깅이 허용됩니다.

API 설명에서 제공하는 자세한 정보 기능 지원 및 제약 조건

관심분야 그룹 권한

현재 Protected Audience 구현의 기본값은 다음에서 joinAdInterestGroup() 호출을 허용하는 것입니다. 를 사용할 수 있습니다. 앞으로 사이트 소유자에게 교차 도메인 iframe 권한 정책을 조정하려는 경우 교차 도메인 iframe을 사용할 수 있습니다.

키/값 서비스

Protected Audience 광고 입찰의 일환으로 브라우저에서는 키/값 서비스 는 간단한 키-값 쌍을 반환하여 광고 구매자에게 정보(잔여 광고, 캠페인 예산 Protected Audience 제안서에서는 다음과 같은 사항을 명령합니다. 이 서버가 "이벤트 수준 로깅을 수행하지 않으며, 이러한 로그를 기반으로 하는 다른 부작용이 없다는 것" 있습니다.

이제 개인 정보 보호 샌드박스 GitHub 저장소에서 Protected Audience 키/값 서비스 코드를 사용할 수 있습니다. 이 서비스는 Chrome 및 Android 개발자가 사용할 수 있습니다. 상태 업데이트는 공지사항 블로그 게시물을 확인하세요. API 설명신뢰 모델 설명에서 Protected Audience 키/값 서비스에 관해 자세히 알아보세요.

초기 테스트에는 'Bring Your Own Server' 모델이 사용됩니다. 장기적으로 광고 기술은 실시간 데이터를 가져오기 위해 신뢰할 수 있는 실행 환경에서 실행되는 오픈소스 Protected Audience 키/값 서비스를 사용해야 합니다.

생태계에 충분한 테스트 시간을 확보하기 위해 서드 파티 쿠키가 지원 중단되기 전까지는 오픈소스 키/값 서비스(TEE) 사용을 요구하지 않을 것으로 예상됩니다. Google에서는 이 전환이 진행되기 전에 개발자에게 테스트와 채택을 시작하도록 충분히 공지할 예정입니다.

기능 지원 감지

API를 사용하기 전에 브라우저에서 API를 지원하고 문서에서 사용할 수 있는지 확인하세요.

'joinAdInterestGroup' in navigator &&
  document.featurePolicy.allowsFeature('join-ad-interest-group') &&
  document.featurePolicy.allowsFeature('run-ad-auction') ?
  console.log('navigator.joinAdInterestGroup() is supported on this page') :
  console.log('navigator.joinAdInterestGroup() is not supported on this page');
드림

Protected Audience를 선택 해제하려면 어떻게 해야 하나요?

사이트 소유자 또는 개별 사용자가 Protected Audience API에 대한 액세스를 차단할 수 있습니다.

사이트에서 액세스를 어떻게 제어할 수 있나요?

Protected Audience는 결국 사이트에 권한 정책을 설정하도록 요구합니다. Protected Audience 기능을 사용할 수 있습니다. 이렇게 하면 임의의 제3자가 사이트의 있습니다. 하지만 첫 번째 오리진 트라이얼 동안 테스트를 원활하게 진행하려면 이 요구사항은 기본적으로 면제됩니다. 테스트 기간 동안 Protected Audience 기능을 명시적으로 사용 중지하려는 사이트에서는 다음을 사용할 수 있습니다. 관련 권한 정책을 사용하여 액세스를 차단합니다.

독립적으로 설정할 수 있는 두 가지 Protected Audience 권한 정책이 있습니다.

  • join-ad-interest-group에서 관심분야 그룹에 브라우저를 추가하는 기능을 사용 설정/사용 중지합니다.
  • run-ad-auction는 기기 내 입찰을 실행하는 기능을 사용 설정/사용 중지합니다.

다음을 지정하여 퍼스트 파티 컨텍스트에서 Protected Audience API에 대한 액세스를 완전히 사용 중지할 수 있습니다. 권한 정책을 설정해야 합니다.

Permissions-Policy: join-ad-interest-group=(), run-ad-auction=()

다음 allow 속성을 iframe 요소:

<iframe src="https://example.com" allow="join-ad-interest-group 'none'; run-ad-auction 'none'"></iframe>

자세한 내용은 제안된 첫 번째 Protected Audience 오리진 트라이얼 권한 정책 섹션을 참고하세요.

사용자 선택 해제

사용자는 다음 중 하나를 사용하여 Protected Audience API 및 기타 개인 정보 보호 샌드박스 기능에 대한 액세스를 차단할 수 있습니다. 메커니즘을 제공합니다

  • Chrome 설정에서 개인 정보 보호 샌드박스 무료 체험 사용 중지: 설정 > 보안 및 개인 정보 보호 > 개인 정보 보호 샌드박스. chrome://settings/adPrivacy에서도 액세스할 수 있습니다.
  • Chrome 설정에서 서드 파티 쿠키 사용 중지: 설정 > 보안 및 개인 정보 보호.
  • 쿠키 및 기타 사이트 데이터를 '서드 파티 쿠키 차단'으로 설정합니다. 또는 '모든 쿠키 차단' 최저가 chrome://settings/cookies.
  • 시크릿 모드를 사용합니다.

Protected Audience 설명에서는 API 설계 요소에 관한 자세한 내용을 제공하고 API가 개인 정보 보호 목표를 달성하는 방법을 설명합니다.

Protected Audience 워크릿 디버그

Chrome Canary 98.0.4718.0부터 Chrome DevTools 내에서 Protected Audience 워크렛을 디버그할 수 있습니다.

첫 번째 단계는 Event Listener Breakpoints 창의 새 카테고리를 통해 중단점을 설정하는 것입니다. (Sources(소스) 패널)에 있는 값을 볼 수 있습니다.

스크린샷
   Chrome Canary의 DevTools로, Sources 패널에서 Event Listener Breakpoints 창이 강조표시되어 있습니다.
   광고 입찰 Worklet에서 입찰자 입찰 단계 시작이 선택되었습니다.

중단점이 트리거되면 worklet 스크립트를 실행합니다. 일반 중단점 또는 단계 명령어를 사용하여 입찰/점수/보고로 이동할 수 있습니다. 함수 자체를 사용합니다.

라이브 Worklet 스크립트도 Threads 패널 아래에 표시됩니다.

스크린샷
Chrome Canary의 DevTools로, Sources 패널의 Threads 창이 강조표시되고 현재
Worklet 스크립트를 만들 수 있습니다.

일부 워크릿은 병렬로 실행될 수 있으므로 여러 스레드가 '일시중지됨' 상태로 끝날 수 있습니다. 있습니다. 스레드 목록을 사용하여 스레드 간에 전환하고 스레드를 재개하거나 더 면밀히 검사할 수 있기 때문에 있습니다.

Protected Audience 이벤트 관찰

Chrome DevTools의 애플리케이션 패널에서 Protected Audience 관심분야 그룹과 입찰을 관찰할 수 있습니다. 이벤트를 수신합니다.

Protected Audience 데모 쇼핑 사이트를 방문하는 경우 Protected Audience가 사용 설정된 브라우저에서 DevTools는 join 이벤트에 관한 정보를 표시합니다.

이
   Protected Audience 관심분야 그룹에 관한 정보가 표시된 Chrome Canary의 DevTools Application 패널
   <start> ID를 제공합니다.

이제 Protected Audience 데모 게시자 사이트를 Protected Audience가 사용 설정된 브라우저에서 DevTools는 bidwin 이벤트에 관한 정보를 표시합니다.

<ph type="x-smartling-placeholder">
</ph> 이
   Protected Audience 입찰 입찰가 및 입찰에 관한 정보가 표시된 Chrome Canary의 DevTools Application 패널
   제공합니다.

Protected Audience API는 어떻게 작동하나요?

이 예시에서는 사용자가 커스텀 자전거 제조업체의 웹사이트를 둘러본 후 뉴스 웹사이트를 방문합니다. 자전거 제조업체의 새 자전거 광고가 표시되었습니다.

1. 사용자가 광고주 사이트를 방문합니다.

그림 표시
  노트북의 브라우저로 맞춤 자전거 제조업체 사이트를 방문하는 사람

사용자가 자전거 제조업체의 광고주인 맞춤 자전거 제조업체의 웹사이트를 수제 스틸 자전거의 제품 페이지에서 시간을 보냅니다. 이렇게 하면 리마케팅 기회가 있는 자전거 제조업체

2. 사용자의 브라우저에 관심분야 그룹을 추가하라는 메시지가 표시됨

노트북으로 브라우저로 사이트를 보고 있는 사람을 보여주는 삽화 JavaScript
  joinAdInterestGroup() 코드가 브라우저에서 실행되고 있는지 확인합니다.

설명 섹션: 브라우저는 관심분야 그룹을 기록함

광고주의 수요측 플랫폼 (DSP) (또는 광고주) 자체)가 navigator.joinAdInterestGroup()를 호출하여 브라우저에 관심분야 그룹을 브라우저가 속한 그룹의 목록입니다. 이 예에서 그룹 이름은 custom-bikes이며 소유자는 dsp.example입니다. 관심분야 그룹 소유자 (이 경우 DSP)는 구매자 4단계에서 설명된 광고 입찰에 참여함 관심분야 그룹 멤버십은 브라우저, 사용자 기기에 저장되며 브라우저 공급업체 또는 기타 개인을 식별할 수 있습니다.

joinAdInterestGroup()에 다음 권한이 필요합니다.

  • 방문 중인 사이트
  • 관심분야 그룹 소유자

예: malicious.example가 호출할 수 없어야 합니다. joinAdInterestGroup()이(가) dsp.example의 허락 없이 소유자임 dsp.example입니다.

방문 중인 사이트의 권한

동일한 출처: 기본적으로 다음과 같은 joinAdInterestGroup() 호출에 대한 권한이 암시적으로 부여됩니다. 방문하는 사이트의 최상위 프레임과 동일한 출처의 표시됩니다. 사이트에서 Protected Audience 권한 정책 헤더를 사용할 수 있음 joinAdInterestGroup() 호출을 사용 중지하는 join-ad-interest-group 지시문

교차 출처: 현재와 다른 출처에서 joinAdInterestGroup() 호출 방문 중인 사이트가 교차 출처 iframe의 joinAdInterestGroup()

관심분야 그룹 소유자의 권한

joinAdInterestGroup()를 호출하여 관심분야 그룹 소유자 권한이 암시적으로 부여되었습니다. 관심분야 그룹 소유자와 동일한 출처의 iframe에서 더 이상 가져올 수 없습니다. 예: dsp.example iframe은 dsp.example에서 소유한 관심분야 그룹에 대해 joinAdInterestGroup()를 호출할 수 있습니다.

joinAdInterestGroup()가 소유자 도메인의 페이지 또는 iframe에서 실행될 수 있도록 하는 것이 좋습니다. .well-known URL의 목록을 사용하여 제공된 다른 도메인에 위임될 수 있습니다.

navigator.joinAdInterestGroup() 사용

다음은 API를 사용하는 방법의 예입니다.

const interestGroup = {
  owner: 'https://dsp.example',
  name: 'custom-bikes',
  biddingLogicUrl: ...,
  biddingWasmHelperUrl: ...,
  dailyUpdateUrl: ...,
  trustedBiddingSignalsUrl: ...,
  trustedBiddingSignalsKeys: ['key1', 'key2'],
  userBiddingSignals: {...},
  ads: [bikeAd1, bikeAd2, bikeAd3],
  adComponents: [customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2],
};

navigator.joinAdInterestGroup(interestGroup, 7 * kSecsPerDay);

함수에 전달되는 interestGroup 객체의 크기는 50KiB 이하여야 합니다. 그렇지 않으면 호출이 실패합니다. 두 번째 매개변수는 관심분야 그룹의 기간을 30으로 제한합니다. 일 연속적인 호출은 이전에 저장된 값을 덮어씁니다.

관심분야 그룹 속성

속성 필수 역할
owner 필수 'https://dsp.example' 관심분야 그룹 소유자의 출처입니다.
name 필수 'custom-bikes' 관심분야 그룹의 이름입니다.
biddingLogicUrl** 선택사항* 'https://dsp.example/bid/custom-bikes/bid.js' Worklet에서 실행되는 입찰 JavaScript의 URL입니다.
biddingWasmHelperUrl** 선택사항* 'https://dsp.example/bid/custom-bikes/bid.wasm' biddingLogicUrl에서 구동되는 WebAssembly 코드의 URL
dailyUpdateUrl** 선택사항 'https://dsp.example/bid/custom-bikes/update' JSON을 반환하여 관심분야 그룹 속성을 업데이트하는 URL입니다. 관심분야 그룹 업데이트를 참고하세요.
trustedBiddingSignalsUrl** 선택사항 'https://dsp.example/trusted/bidding-signals' 입찰자의 신뢰할 수 있는 서버에 대한 키-값 요청의 기본 URL입니다.
trustedBiddingSignalsKeys 선택사항 ['key1', 'key2' ...] 키-값 신뢰할 수 있는 서버에 대한 요청의 키입니다.
userBiddingSignals 선택사항 {...} 소유자가 입찰 중에 사용할 수 있는 추가 메타데이터입니다.
ads 선택사항* [bikeAd1, bikeAd2, bikeAd3] 이 관심분야 그룹에 대해 렌더링할 수 있는 광고입니다.
adComponents 선택사항 [customBike1, customBike2, bikePedal, bikeFrame1, bikeFrame2] 여러 부분으로 구성된 광고의 구성요소입니다.

* ownername를 제외한 모든 속성은 선택사항입니다. biddingLogicUrlads 선택사항이지만 입찰에 참여하려면 필수 항목입니다. Cloud Functions와 이러한 속성 없이 관심분야 그룹 만들기: 예를 들어 관심분야 그룹 소유자는 아직 운영하지 않는 캠페인이나 일부 캠페인의 관심분야 그룹에 브라우저를 추가하려고 할 때 일시적으로 광고 예산이 소진되었을 수 있습니다.

** biddingLogicUrl, biddingWasmHelperUrl, dailyUpdateUrl, trustedBiddingSignalsUrl URL의 출처는 소유자와 동일해야 합니다. adsadComponents URL에는 이러한 제약 조건이 없습니다.

관심분야 그룹 속성 업데이트

dailyUpdateUrl는 관심분야 그룹 속성을 정의하는 JSON을 반환하는 웹 서버를 지정합니다. navigator.joinAdInterestGroup()에 전달된 관심분야 그룹 객체에 해당합니다. 이 그룹 소유자가 정기적으로 관심분야 그룹입니다. 현재 구현에서 다음 속성을 변경할 수 있습니다.

  • biddingLogicUrl
  • biddingWasmHelperUrl
  • trustedBiddingSignalsUrl
  • trustedBiddingSignalsKeys
  • ads
  • priority

JSON에서 지정되지 않은 필드는 덮어쓰지 않습니다. JSON get에서 지정된 필드만 덮어쓰게 됩니다. 업데이트됨: navigator.joinAdInterestGroup()를 호출하면 기존 관심분야 그룹을 덮어씁니다.

업데이트는 최선의 방법이며 다음과 같은 조건에서 실패할 수 있습니다.

  • 네트워크 요청 제한 시간 (현재 30초)
  • 기타 네트워크 오류입니다.
  • JSON 파싱에 실패했습니다.

또한 업데이트에 너무 많은 시간이 소요된 경우에도 업데이트를 취소할 수 있습니다. 취소된 (나머지) 업데이트에 비율 제한을 적용하지 않습니다. 업데이트 비율 제한 최대 1일. 네트워크 오류로 인해 실패한 업데이트는 1시간 후에 재시도됩니다. 인터넷 연결이 끊어져 실패한 업데이트는 재연결 시 즉시 재시도됩니다.

수동 업데이트

현재 프레임의 출처가 소유한 관심분야 그룹에 대한 업데이트는 다음을 통해 수동으로 트리거할 수 있습니다. navigator.updateAdInterestGroups() 비율 제한을 사용하면 업데이트가 너무 자주 발생하는 것을 방지할 수 있습니다. navigator.updateAdInterestGroups() 반복 호출은 비율 제한까지 아무 작업도 하지 않음 기간 (현재 1일)이 지났습니다. 비율 제한은 동일한 관심분야 그룹 ownername에 대해 navigator.joinAdInterestGroup()이(가) 다시 호출됩니다.

자동 업데이트

입찰을 위해 로드된 모든 관심분야 그룹은 입찰이 완료된 후 자동으로 업데이트되므로 수동 업데이트와 동일한 비율 제한이 적용됩니다. 하나 이상의 관심분야 그룹이 있는 각 소유자 이는 마치 navigator.updateAdInterestGroups()가 출처가 해당 소유자와 일치하는 iframe입니다.

관심분야 그룹에 광고 지정하기

adsadComponents 객체에는 광고 소재의 URL 및 선택사항인 임의의 URL이 포함됩니다. 입찰 시 사용할 수 있는 메타데이터입니다. 예를 들면 다음과 같습니다.

{
  renderUrl: 'https://cdn.example/.../bikeAd1.html',
  metadata: bikeAd1metadata // optional
}

구매자는 어떻게 입찰하나요?

관심분야 그룹 소유자가 제공한 biddingLogicUrl의 스크립트는 generateBid()을(를) 포함해야 합니다. 함수를 사용하세요. 광고 공간 판매자가 navigator.runAdAuction()를 호출하면 generatedBid()는 함수는 브라우저가 구성원인 각 관심분야 그룹에 대해 한 번씩 호출됩니다. 그룹 소유자가 입찰에 초대됩니다. 즉, generateBid()는 각 후보별로 한 번씩 호출됩니다. 있습니다. 판매자는 전달된 입찰 구성 매개변수에 decisionLogicUrl 속성을 제공합니다. navigator.runAdAuction()에게 전송합니다. 이 URL의 코드에는 다음과 같은 scoreAd() 함수가 포함되어야 합니다. generateBid()에서 반환한 각 입찰에 대해 점수를 매깁니다.

광고 공간 구매자가 제공한 biddingLogicUrl의 스크립트는 generateBid() 함수를 포함해야 합니다. 이 함수는 각 조합 광고에 대해 한 번씩 호출됩니다. runAdAuction() 드림 각 광고를 연결된 입찰 및 메타데이터와 함께 개별적으로 확인한 다음 수치적 호감도 점수입니다.

generateBid(interestGroup, auctionSignals, perBuyerSignals,
    trustedBiddingSignals, browserSignals) {
  ...
  return {
    ad: adObject,
    bid: bidValue,
    render: renderUrl,
    adComponents: [adComponentRenderUrl1, ...]
   };
}

generateBid()는 다음 인수를 사용합니다.

  • interestGroup
    광고 구매자가 joinAdInterestGroup()에 전달하는 객체입니다. (관심분야 그룹 dailyUpdateUrl를 통해 업데이트될 수 있음)

  • auctionSignals
    입찰 구성 인수의 속성 광고 공간 판매자navigator.runAdAuction()입니다. 이렇게 하면 페이지 컨텍스트에 대한 정보 (예: 광고 크기 및 게시자 ID), 입찰 유형 (단일 가격 또는 2순위 가격) 및 기타 메타데이터로 변환할 수 있습니다.

  • perBuyerSignals
    auctionSignals와 마찬가지로 입찰 구성의 속성입니다. 인수가 navigator.runAdAuction()에 전달한 인수입니다. 이를 통해 SSP인 경우 구매자 서버에서 페이지에 대한 신호를 보냅니다. 구매자 서버에 대한 실시간 입찰 호출을 수행하고 응답을 다시 보냅니다. 구매자 서버에 직접 접속합니다. 그렇다면 구매자는 조작 방지를 위해 generateBid() 내에서 이러한 신호의 서명을 받습니다.

  • trustedBiddingSignals
    키가 trustedBiddingSignalsKeys 관심분야 그룹을 정의하며, 해당 값이 trustedBiddingSignals 요청에서 반환됩니다.

  • browserSignals
    브라우저에 의해 생성된 객체로, 페이지에 대한 정보를 포함할 수 있습니다. 컨텍스트 (예: 판매자가 위조할 수 있는 현재 페이지의 hostname) 및 데이터 (예: 해당 그룹이 이전에 낙찰된 시기의 기록 등) 기기 내 최대 게재빈도 설정).

browserSignals 객체에는 다음과 같은 속성이 있습니다.

{
  topWindowHostname: 'publisher.example',
  seller: 'https://ssp.example',
  joinCount: 3,
  bidCount: 17,
  prevWins: [[time1,ad1],[time2,ad2],...],
  wasmHelper: ... /* WebAssembly.Module object based on interest group's biddingWasmHelperUrl. */
  dataVersion: 1, /* Data-Version value from the buyer's Key/Value service response(s). */
}

bid 값을 계산하기 위해 generateBid()의 코드는 함수 매개변수입니다. 예를 들면 다음과 같습니다.

function generateBid(interestGroup, auctionSignals, perBuyerSignals,
    trustedBiddingSignals, browserSignals) {
  return {
    ...
    bid: auctionSignals.is_above_the_fold ? perBuyerSignals.atf_value : perBuyerSignals.btf_value,
    ...
  }
}

generateBid()는 다음 4가지 속성이 있는 객체를 반환합니다.

  • ad
    광고에 대한 임의의 메타데이터(예: 판매자가 이 입찰가에 대해 알 것으로 예상하는 정보 또는 정보) 있습니다. 판매자](/privacy-sandbox/resources/glossary#ssp)는 입찰 및 결정에 이 정보를 사용합니다. 있습니다. 판매자는 입찰 및 결정에 이 정보를 사용합니다. 제공합니다.

  • bid
    입찰에 참여할 숫자로 된 입찰가 판매자는 비교 가능한 위치에 있어야 합니다. 따라서 입찰가는 판매자가 선택한 일부 단위 (예: 'USD/ 천'). 입찰가가 0 또는 음수일 경우 이 관심분야 그룹은 입찰하지 않습니다. 이 메커니즘을 통해 구매자는 특정 인벤토리에 대해 광고가 게재될 수도 있고 게재되지 않을 수도 있습니다.

  • render
    이 입찰가가 낙찰되는 경우 광고 소재를 렌더링하는 데 사용될 URL 또는 URL 목록입니다. (여러 부분으로 구성된 광고 참조) 참조하세요.) 값은 다음 중 하나의 renderUrl와 일치해야 합니다. 관심분야 그룹에 정의된 광고

  • adComponents
    에 대한 구성요소(최대 20개) 목록(선택사항) 여러 부분으로 구성된 광고를 관심분야 그룹 인수의 adComponents 속성에서 가져옴 navigator.joinAdInterestGroup()(으)로 전달됩니다.

브라우저에 관심분야 그룹 탈퇴 요청

관심분야 그룹 소유자는 관심분야 그룹에서 브라우저를 삭제하도록 요청할 수 있습니다. 기타 단어가 포함된 경우 브라우저에는 해당 관심분야 그룹이 속한 목록에서 관심분야 그룹을 삭제하라는 메시지가 표시됩니다.

navigator.leaveAdInterestGroup({
  owner: 'https://dsp.example',
  name: 'custom-bikes'
});

사용자가 브라우저에 관심분야 그룹 추가를 요청한 사이트를 다시 방문하면 관심분야 그룹 소유자는 navigator.leaveAdInterestGroup() 함수를 호출하여 브라우저에 관심분야 그룹을 삭제하도록 요청할 수 있습니다. 광고 코드는 관심분야 그룹에 대해서도 이 함수를 호출할 수 있습니다.

3. 사용자가 광고 공간을 판매하는 사이트를 방문합니다.

노트북의 브라우저로 뉴스 웹사이트를 방문하는 사람을 보여주는 삽화 사이트
  빈 광고 슬롯이 있습니다.

나중에 사용자는 광고 공간을 판매하는 사이트(이 예에서는 뉴스 웹사이트)를 방문합니다. 사이트: 광고 인벤토리: 광고 인벤토리는 프로그래매틱 방식으로 판매합니다. 실시간 입찰입니다.

4. 광고 입찰은 브라우저에서 실행됩니다.

노트북으로 브라우저에서 뉴스 웹사이트를 보고 있는 사람을 보여주는 삽화 광고
  입찰이 진행되고 있습니다

설명 섹션: 판매자가 기기 내 입찰 진행

게시자의 SSP에서 실행할 가능성이 높은 광고 입찰 게시자 자체를 도울 수 있습니다 입찰의 목적은 단일 사용자에 가장 적합한 광고를 선택하는 것입니다. 현재 페이지에서 사용 가능한 광고 슬롯을 추가할 수 있습니다. 입찰은 광고주의 관심분야가 아니라 브라우저는 광고 공간 구매자 및 키/값 서비스의 판매자 데이터와 함께 회원입니다.

광고 공간 판매자navigator.runAdAuction()입니다.

예를 들면 다음과 같습니다.

const auctionConfig = {
  seller: 'https://ssp.example',
  decisionLogicUrl: ...,
  trustedScoringSignalsUrl: ...,
  interestGroupBuyers: ['https://dsp.example', 'https://buyer2.example', ...],
  auctionSignals: {...},
  sellerSignals: {...},
  sellerTimeout: 100,
  perBuyerSignals: {
    'https://dsp.example': {...},
    'https://another-buyer.example': {...},
    ...
  },
  perBuyerTimeouts: {
    'https://dsp.example': 50,
    'https://another-buyer.example': 200,
    '*': 150,
    ...
  },
  componentAuctions: [
    {
      'seller': 'https://some-other-ssp.example',
      'decisionLogicUrl': ...,
      ...
    },
    ...
  ]
};

const auctionResultPromise = navigator.runAdAuction(auctionConfig);

runAdAuction()는 다음을 나타내는 URN (urn:uuid:<something>)으로 확인되는 프로미스를 반환합니다. 확인할 수 있습니다. 이는 분리 프레임으로 전달될 때만 브라우저에서 디코딩할 수 있습니다. 게시자 페이지에서 낙찰된 광고를 검사할 수 없습니다.

decisionLogicUrl 스크립트는 각 개별 광고와 연결된 입찰가, 메타데이터를 한 번에 하나씩 생성한 다음 수치적 호감도 점수를 할당합니다.

숙박 시설 auctionConfig

속성 필수 역할
seller 필수 'https://ssp.example' 판매자의 출발지입니다.
decisionLogicUrl 필수 'https://ssp.example/auction-decision-logic.js' 입찰 Worklet JavaScript의 URL입니다.
trustedScoringSignalsUrl 선택사항 'https://ssp.example/scoring-signals' 판매자의 신뢰할 수 있는 서버 URL입니다.
interestGroupBuyers* 필수 ['https://dsp.example', 'https://buyer2.example', ...] 입찰에 입찰하도록 요청된 모든 관심분야 그룹 소유자의 출처입니다.
auctionSignals 선택사항 {...} 페이지 문맥, 입찰 유형 등에 대한 판매자 정보
sellerSignals 선택사항 {...} 게시자 설정, 문맥 광고 요청 등에 기반한 정보입니다.
sellerTimeout 선택사항 100 판매자 scoreAd() 스크립트의 최대 런타임 (밀리초)입니다.
perBuyerSignals 선택사항 {'https://dsp.example': {...},
  'https://another-buyer.example': {...},
...}
서버에서 각 특정 구매자를 위한 페이지에 대한 문맥 시그널
perBuyerTimeouts 선택사항 50 특정 구매자의 generateBid() 스크립트의 최대 런타임 (밀리초)입니다.
componentAuctions 선택사항 [{'seller': 'https://www.some-other-ssp.com',
  'decisionLogicUrl': ..., ...},
  ...]
구성요소 입찰의 추가 구성

* 판매자는 모든 관심분야 그룹이 입찰할 수 있도록 interestGroupBuyers: '*'를 지정할 수 있습니다. 그런 다음 관심분야 그룹 소유자 포함 이외의 기준에 따라 광고가 승인되거나 거부됩니다. 예를 들어 판매자는 광고 소재를 검토하여 정책을 준수하는지 확인할 수 있습니다.

** additionalBids는 현재 Protected Audience의 구현에서 지원되지 않습니다. 입찰에 대해 알아보기 참여자 섹션을 자세한 내용은 Protected Audience 설명을 참고하세요.

광고는 어떻게 선택되나요?

decisionLogicUrl의 코드( runAdAuction())에는 scoreAd() 함수가 포함되어야 합니다. 광고마다 한 번씩 실행됩니다. 결정할 수 있습니다.

scoreAd(adMetadata, bid, auctionConfig, trustedScoringSignals, browserSignals) {
  ...
  return desirabilityScoreForThisAd;
}

scoreAd()는 다음 인수를 사용합니다.

  • adMetadata
    구매자가 제공한 임의의 메타데이터입니다.
  • bid
    숫자로 된 입찰가입니다.
  • auctionConfig
    navigator.runAdAuction()에 전달된 입찰 구성 객체입니다.
  • trustedScoringSignals
    입찰 시 판매자의 신뢰할 수 있는 서버에서 가져온 값 광고에 대한 판매자의 의견을 나타냅니다.
  • browserSignals
    브라우저가 생성하는 객체로, 브라우저가 생성하는 판매자의 입찰 스크립트가 확인하려고 할 수 있는 항목은 다음과 같습니다.
{
  topWindowHostname: 'publisher.example',
  interestGroupOwner: 'https://dsp.example',
  renderUrl: 'https://cdn.example/render',
  adComponents: ['https://cdn.com/ad-component-1', ...],
  biddingDurationMsec: 12,
  dataVersion: 1 /* Data-Version value from the seller's Key/Value service response. */
}

판매자는 입찰이 시작되기 전에 사용 가능한 광고 슬롯에 가장 적합한 문맥 광고를 찾습니다. 소속 scoreAd() 로직은 문맥에서 최우수 설정을 이길 수 없는 광고를 거부하는 것입니다.

5. 판매자와 참여 구매자가 키/값 서비스에서 실시간 데이터를 수신합니다.

노트북으로 브라우저에서 뉴스 웹사이트를 보고 있는 사람을 보여주는 삽화 광고
  입찰이 진행되며, 참가자는 키/값 서비스에서 데이터를 가져옵니다.

설명자 섹션: Protected Audience 키/값 서비스에서 실시간 데이터 가져오기.

광고 입찰 중에 광고 공간 판매자는 키/값 서비스의 trustedScoringSignalsUrl 속성을 사용하여 키/값 서비스에 요청을 키와 함께 navigator.runAdAuction()에 전달되는 입찰 구성 인수 전체 adsadComponents 필드에 있는 모든 항목의 renderUrl 속성에서 관심분야 그룹을 만들 수 있습니다.

마찬가지로 광고 공간 구매자는 관심분야 그룹 인수의 trustedBiddingSignalsUrltrustedBiddingSignalsKeys 속성 navigator.joinAdInterestGroup()에 전달되었습니다.

runAdAuction()가 호출되면 브라우저에서는 각 광고 구매자의 신뢰할 수 있는 서버에 요청을 보냅니다. 이 이 요청의 URL은 다음과 같습니다.

https://kv-service.example/getvalues?hostname=publisher.example&keys=key1,key2
  • 기본 URL은 trustedBiddingSignalsUrl에서 가져옵니다.
  • hostname는 브라우저에서 제공합니다.
  • keys 값은 trustedBiddingSignalsKeys에서 가져옵니다.

이 요청에 대한 응답은 각 키에 대한 값을 제공하는 JSON 객체입니다.

6. 낙찰된 광고가 표시됩니다.

노트북으로 브라우저에서 뉴스 웹사이트를 보고 있는 사람을 보여주는 삽화 광고
  광고가
  있습니다.

설명 섹션: 브라우저는 낙찰된 광고를 렌더링함

앞서 설명했듯이 runAdAuction()에서 반환된 프로미스는 URN으로 확인됩니다. 이 프레임은 렌더링을 위해 분리된 프레임으로 전달되며, 사이트에 확인할 수 있습니다.

7. 입찰 결과가 보고됩니다.

설명 동영상 섹션: 이벤트 수준 보고 (현재)

판매자 보고서 결과

설명 섹션: 렌더링에 대한 판매자 보고

decisionLogicUrl에서 제공된 판매자의 JavaScript (scoreAd()도 제공함)는 다음을 수행할 수 있습니다. reportResult() 함수를 포함하여 입찰 결과를 보고합니다.

reportResult(auctionConfig, browserSignals) {
  ...
  return signalsForWinner;
}

이 함수에 전달되는 인수는 다음과 같습니다.

  • auctionConfig
    navigator.runAdAuction()에 전달된 입찰 구성 객체입니다.

  • browserSignals(
    ) 브라우저에 의해 생성되는 객체로서 입찰에 대한 정보를 제공합니다. 예를 들면 다음과 같습니다.

    {
      'topWindowHostname': 'publisher.example',
      'interestGroupOwner': 'https://dsp.example',
      'renderUrl': 'https://cdn.example/url-of-winning-creative.wbn',
      'bid:' <bidValue>,
      'desirability': <winningAdScore>
    }
    

이 함수의 반환 값은 낙찰자의 sellerSignals 인수로 사용됩니다. reportWin() 함수.

낙찰자 보고서 결과

설명 섹션: 렌더링 및 광고 이벤트에 대한 구매자 보고

낙찰자의 JavaScript (generateBid()도 제공함)에는 reportWin() 함수를 사용하여 입찰 결과를 보고합니다.

reportWin(auctionSignals, perBuyerSignals, sellerSignals, browserSignals) {
  ...
}
드림

이 함수에 전달되는 인수는 다음과 같습니다.

  • auctionSignalsperBuyerSignals
    낙찰자를 위해 generateBid()에 동일한 값이 전달됩니다.
  • sellerSignals
    reportResult()의 반환 값으로, 판매자에게 구매자에게 정보를 전달할 수 있는 기회를 제공합니다.
  • browserSignals
    브라우저에 의해 생성되는 객체로서 입찰에 대한 정보를 제공합니다. 예를 들면 다음과 같습니다.

    {
      'topWindowHostname': 'publisher.example',
      'seller': 'https://ssp.example',
      'interestGroupOwner': 'https://dsp.example',
      'interestGroupName': 'custom-bikes',
      'renderUrl': 'https://cdn.example/winning-creative.wbn',
      'bid:' <bidValue>
    }
    

일시적인 손실/낙찰 보고 구현

일시적으로 Chrome에서 입찰 보고를 위해 다음 두 가지 방법을 사용할 수 있습니다.

  • forDebuggingOnly.reportAdAuctionLoss()
  • forDebuggingOnly.reportAdAuctionWin()

이러한 메서드는 각각 입찰이 완료된 후 가져올 URL인 단일 인수를 사용합니다. 사용자는 할 수 있습니다. scoreAd()generateBid()에서 다른 URL 인수로 여러 번 호출될 수 있습니다.

Chrome은 입찰이 완료될 때까지만 디버그 손실/낙찰 보고서를 전송합니다. 입찰이 취소된 경우 (예: 새 탐색으로 인해) 보고서가 생성되지 않습니다.

이 방법은 Chrome에서 기본적으로 사용할 수 있습니다. 메서드를 테스트하려면 chrome://settings/adPrivacy에서 모든 광고 개인 정보 보호 API를 사용 설정합니다. 명령줄 플래그로 Chrome을 실행하여 Protected Audience를 사용 설정하는 경우 BiddingAndScoringDebugReportingAPI 플래그를 포함하여 메서드를 명시적으로 사용 설정할 수 있습니다. 만약 플래그가 사용 설정되지 않은 경우 메서드는 계속 사용할 수 있지만 아무것도 하지 않습니다.

8. 광고 클릭이 보고됨

그림 표시
  울타리가 쳐진 프레임 안의 뉴스 웹사이트에서 자전거 광고를 클릭하는 사람
  데이터가 판매자와 구매자에게 전달될 수 있습니다.

분리 프레임에서 렌더링된 광고의 클릭이 보고됩니다. 작동 방식에 대해 자세히 알아보려면 분리 프레임 광고 보고를 참고하세요.



아래의 다이어그램은 Protected Audience 광고 입찰의 각 단계를 간략히 보여줍니다.

Protected Audience 광고 입찰의 각 단계에 대한 개요를 보여주는 그림


Protected Audience와 TURTLEDOVE의 차이점은 무엇인가요?

Protected Audience는 TURTLEDOVE 제안서군 내에서 Chromium에서 구현되는 첫 번째 실험입니다.

Protected Audience는 TURTLEDOVE의 대략적인 원칙을 따릅니다. 일부 온라인 광고는 이전에 광고주 또는 광고 네트워크와 상호작용했던 잠재 관심 사용자에게 광고를 게재하는 것을 기반으로 합니다. 지금까지는 광고주가 특정 사용자가 웹사이트를 탐색할 때 이러한 방식을 이용해 왔으며, 이는 오늘날의 웹에서 가장 중요한 개인 정보 보호 문제입니다.

TURTLEDOVE는 이 사용 사례를 해결하기 위한 새로운 API를 제공하는 동시에 몇 가지 주요 개인 정보 보호 개선사항을 제공하기 위해 노력하고 있습니다.

  • 광고주가 아닌 브라우저가 광고주의 생각에 대한 정보를 보관합니다. 확인할 수 있습니다.
  • 광고주는 관심분야를 기반으로 광고를 게재할 수 있지만 이를 다른 관심분야와 결합할 수는 없습니다. 개인 정보(특히 사용자가 누구인지 또는 방문 중인 페이지)에 관한 정보를 수집합니다.

Protected Audience는 TURTLEDOVE와 API를 사용할 개발자에게 더 나은 서비스를 제공하기 위한 수정 제안 모음에서 나왔습니다.

  • SPARROW에서: Criteo에서는 신뢰할 수 있는 실행 환경(TEE)에서 실행되는('게이트키퍼') 서비스 모델 Protected Audience에는 실시간 데이터 조회 및 집계된 보고를 위해 TEE를 더 제한적으로 사용하는 것이 포함됩니다.
  • NextRoll의 TERN 및 Magnite 패러트 제안서에는 구매자와 판매자가 기기 내 입찰에서 가졌던 다양한 역할이 설명되어 있습니다. Protected Audience의 광고 입찰/점수 산정 흐름은 이 작업을 기반으로 합니다.
  • RTB House의 결과 기반제품 수준 터틀도브 수정을 통해 익명성 모델과 기기 내 입찰의 맞춤설정 기능이 개선되었습니다.
  • PARAKEET은 TEE에서 실행되는 프록시 서버에 의존하는 TURTLEDOVE와 유사한 광고 서비스에 대한 Microsoft의 제안 광고 요청을 익명처리하고 개인 정보 보호를 시행하기 위해 브라우저와 광고 기술 제공업체 간에 속성 Protected Audience는 이 프록시 모델을 채택하지 않았습니다. 이제 JavaScript API와 PARAKEET과 Protected Audience가 조화를 이룰 수 있도록 기능을 살펴보겠습니다

Protected Audience는 아직 웹사이트의 광고 네트워크가 사용자에게 표시되는 광고를 학습하는 것을 차단하지 않습니다. 예상되는 결과 시간이 지날수록 API가 비공개로 바뀌도록 수정할 수 있습니다.

어떤 브라우저 구성을 사용할 수 있나요?

사용자는 사용 설정 또는 중지하여 Chrome의 개인 정보 보호 샌드박스 무료 체험에 대한 참여를 조정할 수 있습니다. chrome://settings/adPrivacy의 최상위 수준 설정으로 이동합니다. 초기 테스트 중에 사람들은 이러한 상위 수준의 개인 정보 보호 샌드박스 설정을 사용하여 Protected Audience를 선택 해제할 수 있습니다. Chrome은 사용자가 웹에서 자신이 추가된 관심분야 그룹 목록을 보고 관리할 수 있음 확인할 수 있습니다. 개인 정보 보호 샌드박스 기술 자체와 마찬가지로 사용자 설정은 사용자, 규제 기관 등의 피드백과 함께 발전할 수 있습니다

Protected Audience 제안이 진행됨에 따라 Chrome에서 사용 가능한 설정을 계속 업데이트할 예정입니다. 방법을 자세히 알아보세요. 앞으로 Protected Audience 및 관련 데이터를 관리하기 위해 보다 세분화된 설정을 제공할 계획입니다.

사용자가 시크릿 모드로 탐색할 때 API 호출자는 그룹 멤버십에 액세스할 수 없으며 멤버십이 사이트 데이터를 삭제하면 삭제됩니다.



참여 및 의견 공유

지원 받기

구현, 데모 또는 문서에 관해 질문하려면 다음 안내를 따르세요.

Chrome에서의 Protected Audience API 구현과 관련된 버그 및 문제는 다음을 참고하세요. * 기존 문제 보기 확인할 수 있습니다 * crbug.com/new에서 새로운 문제를 신고합니다.

업데이트 소식 받기

자세히 알아보기


사진: 레이 헤네시, Unsplash