크로스 사이트 서드 파티 추적 없이 리마케팅 및 맞춤 잠재고객에게 광고를 게재하기 위한 기기 내 광고 입찰에 관한 개발자 가이드입니다.
Protected Audience API를 처음 사용하는 경우 Protected Audience API 개요를 참고하세요. 참조하세요.
이 게시물은 대부분의 개발자를 위한 기술 참고 자료로 개발자를 위해 작성되었습니다. 실험용 Protected Audience API의 최근 반복입니다. 기본 데모 현재 상태 그대로 Protected Audience API 배포 사용 가능 광고 구매자 및 판매자를 위한 API 참조
구현 상태
- Protected Audience API 제안서가 이제 정식 버전으로 전환됩니다. 질문을 제기하고 토론을 팔로우합니다.
- 대기 중인 기능의 Protected Audience API 상태에는 Protected Audience API 및 기능의 변경사항 및 개선사항에 대한 세부정보가 나와 있습니다.
- 깜빡임 상태
- Protected Audience API Chrome 플랫폼 상태: Chrome의 Protected Audience API에만 적용됩니다.
- Ads API Chrome 플랫폼 상태: 광고를 용이하게 하는 API 모음(Protected Audience API, Topics, Fenced Frames, Attribution Reporting)입니다.
API의 상태 변경 알림을 받으려면 개발자를 위한 메일링 리스트에 가입하세요.
Protected Audience API란 무엇인가요?
Protected Audience API는 개인 정보 보호 샌드박스 API로, 리마케팅 및 맞춤 잠재고객 사용 제3자가 사용자를 추적하는 데 사용할 수 없도록 만들어진 케이스 파악할 수 있습니다. 이 API는 사용자가 이전에 방문한 웹사이트에 대한 관련성 높은 광고를 선택할 수 있습니다.
Protected Audience API는 Chromium에서 구현되는 첫 번째 실험입니다. TURTLEDOVE 제안서 모음입니다.
Protected Audience API 사용해 보기
사용 가능한 API 참조
이 문서는 Protected Audience API의 개요 역할을 합니다. 특정 API 메서드 및 매개변수를 찾는 경우:
joinAdInterestGroup()및generateBid()구매자 가이드- Protected Audience API 판매자 가이드
runAdAuction()드림 reportWin()및reportResult()판매자 가이드- Protected Audience API 문제 해결하기
Protected Audience API 광고 입찰 지연 시간 권장사항을 참고하세요.
Protected Audience API 데모
광고주와 게시자 전반에 걸친 기본적인 Protected Audience API 배포 과정 protected-audience-demo.web.app/에서 사용 가능합니다.
<ph type="x-smartling-placeholder">이 API 테스트
Chrome 베타 101.0.4951.26 이상에서 단일 사용자에 대한 Protected Audience API를 테스트할 수 있습니다. 데스크톱:
chrome://settings/adPrivacy에서 모든 광고 개인 정보 보호 API를 사용 설정합니다.- 명령줄에서 플래그 설정 사용 가능한 Protected Audience API 플래그의 전체 목록은 다음에서 확인할 수 있습니다. Chromium 코드 검색.
iframe 또는 분리 프레임에서 광고 렌더링
광고는 <iframe> 또는
<fencedframe>, 다음에 따라 다름
플래그가 설정됩니다
<fencedframe>를 사용하여 광고를 렌더링하는 방법:
--enable-features=InterestGroupStorage,AdInterestGroupAPI,Fledge,FencedFrames
<iframe>를 사용하여 광고를 렌더링하는 방법:
--enable-features=InterestGroupStorage,AdInterestGroupAPI,Fledge,AllowURNsInIframes --disable-features=FencedFrames
사용 설정하려면 BiddingAndScoringDebugReportingAPI 플래그를 포함합니다.
임시 디버그 손실/성공 보고 메서드.
지원되는 기능
Chromium의 기능 플래그 뒤에 숨은 Protected Audience API는 다음 기능이 포함됩니다.
- 관심분야 그룹: 브라우저에 의해 저장되며, 광고 입찰 및 렌더링을 구성합니다.
- 구매자별 기기 내 입찰 (DSP 또는 광고주): 신호를 기반으로 합니다
- 판매자 (SSP 또는 게시자)가 기기 내 광고 선택: 메타데이터 및 메타데이터입니다.
- 일시적으로 완화된 버전의 분리 프레임(Fenced Frames)에서 광고 렌더링: 네트워크 액세스 및 로깅을 사용할 수 있습니다.
기능 지원 및 제약 조건에 대한 자세한 내용은 Protected Audience API 설명
관심분야 그룹 권한
현재 Protected Audience API 구현의 기본값은
joinAdInterestGroup() 드림
액세스할 수 있습니다.
앞으로 사이트 소유자가 교차 도메인을 업데이트할 시간이 생기면 iframe 권한 정책에 따라 교차 도메인 iframe에서의 호출을 허용하지 않는 것입니다.
키/값 서비스
Protected Audience API 광고 입찰을 지원하기 위해 브라우저는 키/값 서비스 Protected Audience API 광고 입찰을 지원하는 실시간 정보를 검색합니다. 이 정보는 다음과 같이 다양한 방식으로 사용될 수 있습니다.
- 구매자는 광고 캠페인의 남은 예산을 계산하기를 원할 수 있습니다.
- 판매자는 게시자 정책에 따라 광고 소재를 확인해야 할 수도 있습니다.
Protected Audience API 키/값 서비스 코드 을(를) 사용할 수 있습니다. 상태 업데이트는 공지사항 블로그 게시물을 확인하세요.
초기 테스트의 경우 'Bring Your Own Server(사용자 서버 사용)' 모델을 도입했습니다. 장기적으로 광고 기술은 신뢰할 수 있는 실행에서 실행되는 오픈소스 Protected Audience API 키/값 서비스 지원합니다
Protected Audience API 서비스 블로그 게시물을 참고하세요. 타임라인 업데이트를 확인하세요. Google에서는 개발자 여러분께 테스트 및 채택이 진행되기 전에
기능 지원 감지
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 API는 어떻게 작동하나요?
이 예시에서는 사용자가 커스텀 자전거 제조업체의 웹사이트를 둘러본 후 뉴스 웹사이트를 방문하다가 제조사의 새 자전거 광고를 봅니다.
Protected Audience API의 기능은 구현 작업이 진행됨에 따라 시간이 지남에 따라 추가될 예정입니다.
1. 사용자가 광고주 사이트를 방문합니다.
사용자가 커스텀 자전거 제조업체 (광고주)의 웹사이트를 방문한다고 가정해 보겠습니다. 수제 강철에 대한 제품 페이지에서 시간을 보냅니다. 있습니다. 이를 통해 자전거 제조업체에 리마케팅 기회를 제공합니다.
2. 사용자의 브라우저에 관심분야 그룹을 추가하라는 메시지가 표시됨
광고주의 수요측 플랫폼 (DSP) (또는 광고주 자체)이
navigator.joinAdInterestGroup(): 브라우저에 관심분야 그룹 추가를 요청합니다.
를 브라우저가 속한 그룹 목록에 추가합니다.
이 예에서 그룹 이름은 custom-bikes이며 소유자는 dsp.example입니다. 관심분야 그룹 소유자 (이 경우 DSP)는 구매자가 됩니다.
광고주로부터 보호받을 수 있습니다. 관심분야 그룹 멤버십은 브라우저에 저장되며
사용자 기기에 저장되며 브라우저 공급업체 또는 다른 누구와도 공유되지 않습니다.
- Protected Audience API 설명 읽기: 브라우저가 관심분야 그룹을 기록합니다.
- API 가이드 읽기: 구매자와 DSP는
joinAdInterestGroup()입찰을 선택하고 입찰가를 생성합니다.
관심분야 그룹에 광고 지정하기
ads 및 adComponents 객체에는 광고 소재의 URL이 포함됩니다.
입찰 시 사용할 수 있는 임의의 메타데이터입니다(선택사항). 예를 들면 다음과 같습니다.
{
renderUrl: 'https://cdn.example/.../bikeAd1.html',
metadata: bikeAd1metadata // optional
}
구매자는 어떻게 입찰하나요?
generateBid()는 브라우저가 속한 각 관심분야 그룹에 대해 호출됩니다.
- 관심분야 그룹 소유자가 입찰에 초대된 경우
generatedBid() 개발자 문서를 참고하세요.
3. 사용자가 광고 공간을 판매하는 사이트를 방문합니다.
나중에 사용자가 광고 공간을 판매하는 사이트(이 예에서는 뉴스 사이트)를 방문합니다. 있습니다. 사이트에 프로그래매틱 방식으로 판매하는 광고 인벤토리가 있습니다. 실시간 입찰입니다.
4. 광고 입찰은 브라우저에서 실행됩니다.
광고 입찰은 게시자의 공급 측 제공업체가 실행할 가능성이 높습니다. 게시자 또는 게시자(SSP)가 될 수 있습니다. 입찰의 목적은 현재 페이지의 사용 가능한 단일 광고 슬롯에 가장 적합한 광고를 찾습니다. 이 입찰은 브라우저가 속한 관심분야 그룹, 광고 공간 구매자 및 키-값 서비스.
- Protected Audience API 설명 읽기: 판매자가 온디바이스 입찰 실행
- API 가이드 읽기: 판매자는
runAdAuction()및 광고 입찰 지연 시간 권장사항
5. 판매자와 참여 구매자가 키/값 서비스에 실시간 데이터를 요청합니다.
광고 입찰 중에 판매자는 특정 광고에 대한 실시간 데이터를 요청할 수 있습니다.
키/값 서비스에 요청하여 광고 소재를 만들 수 있습니다.
판매자는
trustedScoringSignalsUrl 속성별 runAdAuction()
ads에 있는 모든 항목의 renderUrl 속성 키 포함
및 입찰에서 모든 관심분야 그룹의 adComponents 필드
구매자는
trustedBiddingSignalsUrl 및 trustedBiddingSignalsKeys 속성
navigator.joinAdInterestGroup()에 전달된 관심분야 그룹 인수입니다.
runAdAuction()가 호출되면 브라우저에서 각 광고에 요청합니다.
제공할 수 있습니다. 이 요청의 URL은 다음과 같습니다.
https://kv-service.example/getvalues?hostname=publisher.example&keys=key1,key2
- 기본 URL은
trustedBiddingSignalsUrl에서 가져옵니다. hostname는 브라우저에서 제공합니다.keys값은trustedBiddingSignalsKeys에서 가져옵니다.
이 요청에 대한 응답은 키를 누릅니다.
- Protected Audience API 설명 읽기: Protected Audience API 키/값 서비스에서 실시간 데이터 가져오기.
- Protected Audience API 키/값 서비스 오픈소스 제공을 참고하세요.
6. 낙찰된 광고가 표시됩니다.
입찰 구성에서 resolveToConfig 플래그가 true로 설정된 경우 runAdAuction()에서 반환된 프로미스는 분리 프레임 구성 객체 (FencedFrameConfig)로 확인됩니다. 프레임 구성은 낙찰된 광고로 프레임을 이동하기 위해 분리 프레임이 사용하지만, 광고의 URL은 프레임 삽입자에게 표시되지 않습니다.
분리 프레임 구성 객체는 M114부터 사용할 수 있습니다. FencedFrameConfig 객체에 관한 자세한 내용은 Chrome 블로그 도움말을 참고하세요.
- Protected Audience API 설명 읽기: 브라우저에서 낙찰된 광고 렌더링
7. 입찰 결과가 보고됩니다.
장기적인 계획은 브라우저가 비공개 집계 API를 사용하는 판매자와 구매자
임시 이벤트 수준 보고 메커니즘으로서
판매자의 경우 reportResult(), 낙찰자에게는 reportWin()가
sendReportTo() 함수를 호출합니다. 단일 인수(문자열)를 사용합니다.
입찰이 완료된 후 가져오는 URL을 나타내며,
보고해야 합니다.
- API 가이드 읽기: 판매자 및 구매자 보고에 대해 알아보기
8. 광고 클릭이 보고됨
분리 프레임에서 렌더링된 광고의 클릭이 보고됩니다. 자세히 알아보려면 자세한 내용은 분리 프레임 광고 보고를 참고하세요.
<ph type="x-smartling-placeholder">
Protected Audience API와 TURTLEDOVE의 차이점은 무엇인가요?
Protected Audience API는 Chromium에서 구현되는 첫 번째 실험입니다. TURTLEDOVE의 제안입니다.
Protected Audience API는 TURTLEDOVE의 대략적인 원칙을 따릅니다. 일부 온라인 광고는 흥미로울 가능성이 있는 사용자에게 광고를 게재하는 것을 기반으로 하여 어떤 상호작용을 했는지 확인할 수 있습니다 지금까지는 탐색 중인 특정 사람을 인식하는 광고주의 광고 게재 기간 오늘날 웹에서 가장 중요한 개인 정보 보호 문제점입니다.
TURTLEDOVE는 이 사용 사례를 해결하기 위한 새로운 API를 제공하기 위해 노력하고 있습니다. 몇 가지 주요 개인 정보 보호 개선사항을 제공합니다.
- 광고주가 아닌 브라우저가 사용자가 관심이 있다고 판단하는 데 사용됩니다.
- 광고주는 관심분야를 기반으로 광고를 게재할 수 있지만 이를 결합할 수는 없습니다. 어떤 사람에 대한 다른 정보, 특히 그 사람이 누구인가 사용자가 방문하는 페이지 등입니다.
Protected Audience API는 TURTLEDOVE와 API를 사용할 개발자에게 더 나은 서비스를 제공하기 위해 다음과 같이 수정했습니다.
- SPARROW에서: Criteo에서는 신뢰할 수 있는 실행 환경(TEE)에서 실행되는('게이트키퍼') 서비스 모델의 인스턴스입니다. Protected Audience API는 실시간 데이터 조회 및 집계된 보고를 위해 TEE를 더 제한적으로 사용합니다.
- NextRoll의 TERN 및 매그나이트의 PARRROT 제안서에는 Ad Exchange에서 구매자와 판매자가 입찰합니다. Protected Audience API의 광고 입찰/점수 산정 흐름은 이 작업을 기반으로 합니다.
- RTB House의 결과 기반 및 제품 수준 TURTLEDOVE를 수정하여 익명성 모델과 맞춤설정이 개선됨 기기 내 입찰의 기능
- PARAKEET은 프록시에 의존하는 TURTLEDOVE 같은 광고 서비스에 대한 Microsoft의 제안 브라우저와 광고 기술 제공업체 간의 TEE에서 실행되는 서버 광고 요청 익명처리 및 개인 정보 보호 시행 속성 Protected Audience API는 이 프록시 모델을 채택하지 않았습니다. Google에서는 PARAKEET용 JavaScript API와 Protected Audience API가 두 제안의 가장 뛰어난 기능을 추가로 결합할 것입니다.
Protected Audience API는 아직 웹사이트의 광고 네트워크가 사용자에게 표시되는 광고를 학습하는 것을 차단하지 않습니다. 시간이 지날수록 API의 개인 정보 보호가 강화되도록 수정할 예정입니다.
Topics API를 Protected Audience API와 함께 사용할 수 있나요?
예. 현재 사용자에 대해 관찰된 주제(Topics API에서 제공)는 다음과 같이 사용할 수 있습니다. 파악할 수 있습니다. 주제는 다음 속성이 포함됩니다.
auctionSignals:navigator.runAdAuction()에 전달된 입찰 구성 객체의 속성입니다.userBiddingSignals는 관심분야 그룹 구성의 속성입니다. 객체가navigator.joinAdInterestGroup()에 전달됨
사용 가능한 브라우저 구성
사용자는 다음과 같은 방법으로 Chrome의 개인 정보 보호 샌드박스 무료 체험 참여를 조정할 수 있습니다.
최상위 수준 설정을 사용 또는 사용 중지하여
chrome://settings/adPrivacy
초기 테스트 중에 사용자는 이 높은 수준의 개인 정보 보호 기능을 사용할 수 있습니다. Protected Audience API를 선택 해제하는 샌드박스 설정입니다. Chrome은 사용자가 Chrome에서 웹에서 추가된 관심분야 그룹 목록 관리 확인할 수 있습니다. 개인 정보 보호 샌드박스 기술 자체와 마찬가지로 사용자 설정은 사용자, 규제 기관 등의 피드백에 따라 달라질 수 있습니다.
Google은 테스트 및 의견을 바탕으로 Chrome에서 사용 가능한 설정을 계속 업데이트할 예정입니다. 앞으로 Protected Audience API 및 데이터가 포함됩니다.
사용자가 시크릿 모드로 탐색할 때 API 호출자가 그룹 멤버십에 액세스할 수 없음 사용자가 사이트 데이터를 지우면 멤버십이 삭제됩니다.
브라우저에서 Protected Audience 워크렛을 캐시하나요?
Protected Audience 워크릿(구매자의 입찰 생성 및 보고 워크렛, 판매자의 광고 점수 및 보고 워크렛)이 포함된 리소스는 브라우저에 의해 캐시됩니다. Cache-Control 헤더를 사용하여 캐싱 동작을 제어할 수 있습니다.
참여 및 의견 공유
지원 받기
구현, 데모 또는 문서:
- GitHub: 설명, 질문을 제기하고 토론을 따릅니다.
- 데모: 데모 코드 저장소에 문제를 제출합니다.
- 개발자 지원: 개인 정보 보호 샌드박스 개발자 지원 저장소를 참조하세요. Protected Audience API의 문제 템플릿을 선택합니다.
- Chrome 구현: Chrome의 구현과 관련된 버그 또는 문제의 경우 Protected Audience API를 사용하는 경우 기존 문제를 확인할 수 있습니다. 또는 새로운 문제를 제기하세요.
Protected Audience API 사용의 필요성 충족에 관한 보다 일반적인 질문은 다음을 참고하세요. API 저장소에서 문제 제출 또한 W3C 웹 광고 비즈니스 그룹 개선.
개인 정보 보호 샌드박스 의견 양식을 사용하세요. 을 사용하여 공개 포럼 외부에서 Chrome팀과 비공개로 의견을 공유할 수 있습니다.
선택 해제
Protected Audience API를 선택 해제하시겠습니까? 자세히 알아보기 Protected Audience API에 대한 액세스를 차단하는 경우 권한을 부여할 수 있습니다.
업데이트 소식 받기
- API 상태 변경 알림을 받으려면 개발자용 메일링 리스트를 제공합니다.
- API에서 진행 중인 모든 토론을 자세히 살펴보려면 API 페이지에서 GitHub를 참고하세요. 이 기능을 사용하려면 GitHub가 있거나 계정을 선택합니다.
- 개인 정보 보호 샌드박스에 관한 전반적인 업데이트를 받으려면 RSS 피드를 구독하세요. [개인 정보 보호 샌드박스 진행 상황].
- Protected Audience API의 예약된 호출에 참여 (2주마다) 누구나 참여할 수 있습니다. 먼저 WICG에 가입하세요. 나 적극적으로 참여하거나 경청할 수 있습니다.