Chrome은 개인 정보 보호 샌드박스의 일환으로 보호되는 잠재고객 API: 브라우저 내 API 광고주와 광고 기술 회사가 관심분야 그룹을 선별하고 타겟팅할 수 있습니다. 서드 파티 쿠키에 의존하지 않고 사용자를 보호하면서 (잠재고객 목록) 크로스 사이트 추적을 사용하지 않습니다. 개발자 가이드
SSP는 Display &Video 360을 사용한 Protected Audience API 테스트 가능 동영상 360과 Google Ads의 이점:
- Protected Audience API 흐름의 효과를 반복하고 알아봅니다.
- 공개적으로 API 개선을 위한 제안 및 의견 생성 포럼(예: GitHub)에서 찾을 수 있습니다.
- Protected Audience를 통한 개인 맞춤 광고 지원 준비 API에 액세스할 수 있도록 지원합니다.
다음 가이드에서는 SSP와 Display &Video 360 간의 통합에 대해 Video 360과 Google Ads를 함께 사용합니다. 테스트 조정에 관심이 있는 SSP는 고객의 디스플레이 광고 및 Video 360 파트너십 담당자입니다.
등록
SSP는 스스로 Protected Audience API 사용
제공 흐름 요약
아래의 다이어그램은 Chrome, SSP, Display &Video 360 및 SSP 간의 주요 상호작용 지점을 요약한 일반적인 흐름을 Video 360과 Google Ads를 함께 사용합니다.
통합 옵션
옵션 1: 직접 / 단일 판매자
단계:
- SSP 광고 태그는 SSP 서버로 광고 요청을 보내어 브라우저가 Protected Audience API를 지원합니다.
- SSP 서버는 문맥 OpenRTB 입찰 요청을 DSP로 보내 Protected Audience API를 지원하는 브라우저
- DSP는 입찰합니다.
- SSP 서버가 입찰 구성이 포함된 광고 응답을 SSP 광고 태그에 보냅니다.
- SSP 광고 태그는
runAdAuction()
님, 공개 RTB 입찰 응답의 신호를perBuyerSignals
입니다. - Chrome에서 키/값의 신뢰할 수 있는 DSP 입찰 서버를 호출합니다. 실시간 입찰 신호를 가져옵니다.
- Chrome에서
generateBid()
를 호출합니다. 참여하는 각 관심분야 그룹에 대한 DSP JavaScript 함수입니다. - Chrome에서 키/값의 신뢰할 수 있는 SSP 점수 서버를 호출합니다. 실시간 점수 신호를 가져올 수 있습니다
- Chrome에서
scoreAd()
를 호출합니다. 참여하는 각 관심분야 그룹에 대한 SSP JavaScript 함수입니다. - Chrome에서
reportWin()
를 호출합니다. 낙찰을 DSP에 보고하는 DSP JavaScript 함수 - Chrome에서
reportResult()
를 호출합니다. 낙찰자를 SSP에 보고하는 SSP JavaScript 함수
SSP 측의 최소 변경사항
SSP 광고 태그를 다음과 같이 업데이트해야 합니다.
- 브라우저가 Protected Audience API를 지원하는지 감지
- 광고 요청의 일부로 해당 정보를 SSP 서버
[1]
에 보냅니다. runAdAuction()
를 호출하여 기기 내 입찰을 시작합니다. 신호는 DSP의 OpenRTB 입찰 응답[5]
에서 제공됩니다 (자세한 내용은 입찰 요청 및 응답 구조 참조).
SSP 서버는
- Protected Audience API 지원에 관한 정보를 DSP에 전파
OpenRTB 입찰 요청
[2]
의 필드를 통해 (입찰에 대한 섹션 참조) 요청 및 응답 구조 참조). - OpenRTB 입찰 응답에서 DSP의 구매자 신호를 SSP 광고에 전파
태그 (아래의 입찰 요청 / 입찰 응답 구조에 관한 섹션 참고)
[4]
- Protected Audience API 지원에 관한 정보를 DSP에 전파
OpenRTB 입찰 요청
[Optional]
SSP는 신뢰할 수 있는 SSP 서버를 구현하여 실시간 데이터를 가져와야 합니다. 광고 품질 검사를 지원하기 위한 점수 신호, 게시자 설정 시행[8]
SSP는
"scoreAd(...)"
및"reportResult(...)"
로 JavaScript를 구현해야 합니다. 함수[9]
,[11]
옵션 2: 복수 판매자
단계:
- SSP 어댑터가 SSP 서버로 광고 요청을 보내어 브라우저가 Protected Audience API를 지원합니다.
- SSP 서버는 문맥 OpenRTB 입찰 요청을 DSP로 보내 Protected Audience API를 지원하는 브라우저
- DSP 서버는 입찰합니다.
- SSP 서버가 입찰 구성이 포함된 광고 응답을 SSP 광고 태그에 보냅니다.
- SSP Prebid 어댑터는 게시자 광고 서버에 구성요소 입찰 구성을 제공합니다. 태그 사이에 있어야 합니다.
- 게시자 광고 서버 태그는 게시자 광고 서버 서버로 광고 요청을 보냅니다.
- 게시자 광고 서버 태그가 다음을 호출하여 기기 내 입찰을 시작합니다.
runAdAuction(...)
드림 API에 액세스할 수 있습니다. - Chrome에서 키/값의 신뢰할 수 있는 DSP 입찰 서버를 호출합니다. 실시간 입찰 신호를 가져옵니다.
- Chrome에서
generateBid()
를 호출합니다. 참여하는 각 관심분야 그룹에 대한 DSP 자바스크립트 기능 - Chrome에서 키/값의 신뢰할 수 있는 SSP 점수 서버를 호출합니다. 실시간 점수 신호를 가져올 수 있습니다
- Chrome에서
scoreAd()
를 호출합니다. 참여하는 각 관심분야 그룹에 대한 SSP JavaScript 함수입니다. - Chrome에서
reportWin()
를 호출합니다. 낙찰을 DSP에 보고하는 DSP JavaScript 함수 - Chrome에서
reportResult()
를 호출합니다. 낙찰자를 SSP에 보고하는 SSP JavaScript 함수
SSP 측의 최소 변경사항
SSP 어댑터를 다음과 같이 업데이트해야 합니다.
- 브라우저가 Protected Audience를 지원하는지 감지
- 광고 요청의 일부로 해당 정보를 SSP 서버
[1]
에 보냅니다. - 게시자 광고 서버 광고 태그
[5]
에 구성요소 입찰 구성을 제공합니다. - Google Ad Manager가 게시자 광고 서버인 경우 SSP는
* 사전 입찰 Protected Audience 사용
모듈
* Google Ad Manager 광고 태그
setConfig()
를 호출합니다. API 여러 판매자
SSP 서버는
- Protected Audience 지원에 대한 정보를
OpenRTB 입찰 요청
[2]
의 필드 (입찰에 대한 섹션 참조) 요청 및 응답 구조 참조). - OpenRTB 입찰 응답에서 DSP의 구매자 신호를 SSP 광고에 전파
태그 (아래의 입찰 요청 / 입찰 응답 구조에 관한 섹션 참고)
[4]
- Protected Audience 지원에 대한 정보를
OpenRTB 입찰 요청
[Optional]
SSP는 신뢰할 수 있는 SSP 서버를 구현하여 실시간 데이터를 가져와야 합니다. 광고 품질 검사를 지원하기 위한 점수 신호, 게시자 설정 시행[10]
SSP는
scoreAd()
및reportResult()
를 사용하여 JavaScript를 노출해야 합니다. 함수[11]
,[14]
.
입찰 서비스
입찰을 면밀히 평가하고 있으며 입찰 서비스 (B&A)
proposal
디스플레이 및 Video 360에서 B&A를 사용하여 Protected Audience API를 테스트할 준비가 되었습니다. 자세한 내용을 가지고 연락드리겠습니다.
OpenRTB 프로토콜
입찰 요청
보호 조치(Protected)를 지원하는 노출 기회를 구별하기 위해
Audience API 기기 내 입찰(표준 지원만 지원하는 기기 내 입찰)
서버 측 거래소 입찰, '입찰'의 ae
라는 새로운 enum 필드
환경" OpenRTB의 Imp
객체에 확장 프로그램으로 추가되어야 합니다.
입찰 요청을 통해 지정된
지정할 수 있습니다. ae
enum에는 다음 값이 있을 수 있습니다.
0
: 표준 서버 측 입찰1
: Protected Audience API 지원이 포함된 요청이며, 입찰은 거래소 서버에서 실행되며 관심분야 그룹 입찰 최종 입찰은 브라우저에서
{
"id": …
"imp": [{
"id": "1"
"video": {...}
"ext": {
"ae": 1
}]
}
입찰 응답
문맥 입찰 외에도 입찰 응답은 디스플레이 네트워크 및 Google Ads와 Video 360의 참여가 Protected Audience API 관심분야 그룹 입찰 입찰 응답이 다음과 같이 관심분야 그룹 입찰을 지원해야 합니다.
{
"seatbid": [{
"bid": [{
… // Traditional contextual bids
}]
}],
"ext": {
// InterestGroupBidding object which holds information for running an
// in-browser interest group auction.
"igbid": [{
// ID of the Imp object of the impression to which
// these interest group bidding signals apply to.
"impid": "1",
// InterestGroupBuyer object which holds DSP information for the in-browser
// auction.
"igbuyer": [{
// Origin of Display & Video 360 and Google Ads to participate in the
// interest group auction. For more info regarding the origin see:
// https://developer.mozilla.org/en-US/docs/Glossary/Origin
"origin": "https://td.doubleclick.net",
// Buyer-specific signals to use in auctionConfig as perBuyerSignals.
// Used by the buyer's interest group bidding function. Can be left empty
"buyerdata": ...,
// Buyer experiment group id to support coordinated experiments with
// buyers' trusted servers. This experiment id should be added to the
// `perBuyerExperimentGroupIds` map in auctionConfig.
"buyer_experiment_group_id": 12345
}]
}]
}
}
다음과 같은 시나리오가 지원됩니다.
시나리오 1: 디스플레이 및 동영상 360 및 Google Ads만 참여를 원합니다. 입찰할 수 있습니다 이 시나리오에는 igbid 필드가 없습니다.
시나리오 2: 디스플레이 및 동영상 360 및 Google Ads만 참여를 원합니다. 관심분야 그룹 입찰에 참여할 수 있습니다 이 시나리오에서 디스플레이 및 동영상 360 및 Google Ads는 입찰 응답에서 Seatbid 필드를 삭제하고 igbid 정보를 반환합니다. 즉, igbid 필드가 있다는 것은 디스플레이 및 Video 360 및 Google Ads에서 관심분야 그룹을 사용하고자 함 참여할 수 있습니다.
시나리오 3: 디스플레이 및 Video 360 및 Google Ads에서 다음 이벤트에 참여하고 싶어 합니다. 둘 다 사용할 수 있습니다 이 시나리오에서 디스플레이 및 동영상 360과 Google Ads는 입찰 응답에 Seatbid 필드를 모두 반환합니다. igbid 정보를 확인할 수 있습니다.
광고 입찰가가 포함된 메타데이터
Protected Audience API를 사용하면 passing arbitrary
metadata
가
광고에 대한 정보를 generateBid()
함수에서 알려줄 수 있습니다.
디스플레이 및 Video 360에서는 다음을 활용할 계획입니다.
specification
드림
(광고 메타데이터: Protected Audience API 및 OpenRTB)
이름: 디스플레이 및 동영상 360은 광고의 일부로 다음 필드를 반환합니다. 객체:
PA 속성 | 유형 | OpenRTB 설명 |
---|---|---|
ad.seat | String; 필수 | 이 입찰을 대신하는 구매자 라이선스 (예: 광고주, 대행사)의 ID입니다. |
ad.adomain | String[] | 차단 목록 확인을 위한 광고주 도메인 (예: 'ford.com'). 광고 소재 순환게재의 경우 배열일 수 있습니다. 교환에서는 하나의 도메인만 허용되도록 지정할 수 있습니다. |
ad.cid | 문자열 | 광고 품질 검사를 지원할 캠페인 ID입니다. |
ad.crid | 문자열 | 광고 품질 검사를 지원하는 광고 소재 ID |
ad.language | 문자열 | ISO-639-1-alpha-2를 사용하는 광고 소재의 언어입니다. 비표준 코드 'xx' 광고 소재에 언어 관련 콘텐츠 (예: 회사 로고만 있는 배너)가 없는 경우에도 사용할 수 있습니다. 언어 또는 언어 중 하나만 있어야 합니다. |
ad.w | 정수 | DIPS (기기 독립적 픽셀)로 표시되는 광고 소재의 너비입니다. |
ad.h | 정수 | DIPS (기기 독립형 픽셀)로 표시되는 광고 소재의 높이입니다. |
예
{
"seat": "123"
"adomain": ["example.com"]
"cid": "12345"
"crid": "12345"
"language": "en"
"w": 300
"h": 250
}
이벤트 보고
Protected Audience API는
GitHub 게시물: Fenced Frame Ads
Reporting
API는
분리 프레임과 iframe 모두
here
)을 입력합니다.
SSP는 다음과 같은 방법으로 reportResult 함수에서 브라우저에 URL을 등록할 수 있습니다.
registerAdBeacon()
호출
API에 액세스할 수 있습니다.
디스플레이 및 Video 360에서 reportEvent()
을(를) 호출합니다.
대상 'component-seller'가 포함된 API 보고하려면
노출수, 클릭 이벤트 등입니다. 그러면 비콘이
URL을 등록하겠습니다.
참고: Display & Video 360은 노출을 위해 reportEvent()
API를 호출합니다.
게시물 데이터가 비어 있는 클릭
예
registerAdBeacon({
'impression': 'https://ssp.example/impression?ssp_event_id=abc',
});
registerAdBeacon({
'click': 'https://ssp.example/click?ssp_event_id=abc',
});
쿠키 지원 중단 테스트 라벨
디스플레이 및 Video 360은 다음 중 Chrome-facilitated
testing
에 참여합니다.
서드 파티 쿠키 지원 중단 테스트를 진행하기 위해 파트너에게 요청하는 사항
다음에 따라 OpenRTB 입찰 요청에서 Chrome 라벨을 Google에 전달합니다.
specification
:
객체: Device.ext
속성 | 유형 | 설명 |
---|---|---|
CDEP | 문자열 | 라벨을 지정합니다. |