Chrome은 개인 정보 보호 샌드박스의 일환으로 보호되는 잠재고객 API: 브라우저 내 API 광고주와 광고 기술 회사가 관심분야 그룹 타겟팅 광고를 게재할 수 있습니다. 서드 파티 쿠키에 의존하지 않고 사용자를 크로스 사이트로부터 보호 있습니다.
Chrome에서 원본 사이트를 실행 중입니다. 무료 체험 (Protected Audience API용) Authorized Buyers는 Ad Manager 게시자 인벤토리에서 Protected Audience API를 테스트합니다. 입찰자는 Protected Audience API를 테스트하여 다음을 달성할 수 있습니다.
- Protected Audience API 흐름의 효과를 반복하고 알아봅니다.
- 공개 포럼에서 API 개선을 위한 의견을 예: GitHub
- API를 통한 개인 맞춤 광고 지원을 준비할 때는 서드 파티 쿠키에 의존할 수 있습니다
테스트에 관심이 있는 Authorized Buyers는 온보딩 섹션을 참조하세요.
제공 흐름 요약
다음은 Authorized Buyers의 Protected Audience 광고 게재 흐름에 대한 요약입니다. 파트너:
- 입찰자는 광고주와 협력하여 각 광고주의 관심분야 그룹을 유지합니다. 있습니다. 광고주는 종종 입찰자의 태그를 관심분야 그룹에 브라우저를 추가할 수 있습니다.
- 최종 사용자가 광고주의 페이지를 방문합니다. 페이지에는 입찰자의 태그 사이에 있어야 합니다.
- 입찰자의 태그가 Protected Audience API
joinAdInterestGroup()를 호출합니다. 이 호출은 브라우저에 사용자를 관심분야 그룹에 추가하도록 요청합니다. - 최종 사용자가 게시자 웹페이지를 방문합니다. 사용자의 브라우저에서 Google의 게시자 광고 태그입니다.
- Google의 게시자 광고 태그는 Google 서버에 문맥 광고를 요청합니다.
- Google은 참여하는 입찰자에게 문맥 입찰 요청을 보냅니다. 자세한 내용은 입찰 요청 변경사항 섹션을 참조하세요.
- 입찰자는
interest_group_bidding필드가 있는BidResponse를 반환합니다. 입찰자가interest_group_bidding를 지정하지 않으면 Google은 입찰에서interestGroupBuyers에 입찰자의 출처 포함 구성을 참조하세요. 입찰 응답에는interest_group_bidding.per_buyer_signals도 포함될 수 있습니다.per_buyer_signals는 입찰할 수 있습니다. 자세한 내용은 입찰 응답 변경사항 섹션을 참조하세요. - Google은 서버 측 입찰을 실행하고 입찰 응답을 있습니다. 서버 측 입찰에서는 기존의 서버 측 입찰가를 고려합니다. 입찰 응답에는 문맥 낙찰가에 대한 정보가 포함될 수 있습니다 (경우에 따라 모두 포함).
- 입찰 응답에는 브라우저 내 입찰 구성이 포함되어 있습니다.
입찰할 수 있습니다. 여기에는 참여하는 각 구매자의 문맥 시그널이 포함될 수 있습니다.
(
interest_group_bidding.per_buyer_signals을(를) 통해 전송됨) 입찰 가능 여부에 대한 설정 정보를 볼 수 있습니다. - Google의 게시자 태그가 Protected Audience API
runAdAuction()호출 기기 내 관심분야 그룹 입찰을 시작합니다. Google은 이전에interest_group_bidding을(를) 지불한 구매자 입찰 구성의interestGroupBuyers - Google은 조건을 충족하는 각 입찰자의
per_buyer_signals를 보호 대상 잠재고객 입찰 구성입니다. - 특정 입찰자의 관심분야 그룹이
trustedBiddingSignalsUrl인 경우 브라우저가 각 그룹의trustedBiddingSignalsUrl: 각 그룹의 실시간 신호를 가져옵니다. 자세한 내용은 Protected Audience API에 관한 세부정보 사양을 참조하세요. - 브라우저는 각 관심분야 그룹에 대해 입찰자의
generateBid()를 호출합니다. 브라우저 내 입찰에 참여할 수 있는 자격이 주어집니다. 이 단계에서 입찰가를 계산하고 광고 소재를 선택합니다.generateBid()에서 액세스할 수 있는 사진 입찰자가 제공한per_buyer_signals및 신뢰할 수 있는 입찰 신호를 찾습니다. - 브라우저는 판매자 (이 경우 Google의)
scoreAd()를 호출하여 관심분야 그룹 광고 입찰에서 각 입찰가에 순위 지정 입찰가 순위 지정 게시자 보호 조치, 광고 정책 및 기타 광고 소재 유형에 따라 제약이 있습니다 - 브라우저가 요건을 충족하는 관심분야 그룹 입찰가로 입찰을 실행합니다. 이 최상위 문맥 입찰가가 브라우저 내 입찰에 참여합니다.
- 입찰 후 관심분야 그룹 낙찰자가 있으면 브라우저가
판매자의
reportResult()및 입찰자의reportWin()에 각각 정보를 제공합니다. - 관심분야 그룹 광고가 낙찰되면 Google의 게시자 태그는 있습니다.
서빙 흐름 세부정보
광고 게재 전
광고 소재 검토
광고 소재는 Google이 검토하고 승인해야
Protected Audience 브라우저 내 입찰 검토를 위해 광고 소재를 제출할 수 있습니다.
실시간 입찰 API 또는
자동 광고 소재 스캔을 사용할 수 있습니다. 광고 소재
Protected Audience 브라우저 내 관심분야 그룹 광고 입찰에는 다음이 포함되어야 합니다.
renderUrls 검토
renderUrls 요구사항:
- API를 통해 제출된
renderUrl는 사용된renderUrl와 일치해야 합니다. 관심분야 그룹 광고 입찰에서 - 각
renderUrl은(는) 단일 광고주 또는 광고만을 나타낼 수 있습니다. 확인할 수 있습니다. 지정된renderUrl은(는) 다음을 대신하여 광고를 렌더링하는 데 사용할 수 없습니다. 여러 광고주가 사용할 수 있습니다. 각renderUrl은 단일 광고 소재에 매핑되어야 합니다. renderUrl는 Google의 오프라인에서 액세스하고 가져올 수 있어야 합니다. 광고가 마지막으로 입찰된 후 최대 7일 동안 광고 소재 검토 시스템에 의해 검토됩니다.
Real-time Bidding API
입찰자는 실시간 입찰 광고 소재를 업로드할 수 있는 API를 관심분야 그룹 입찰
자동 광고 소재 스캔
입찰자는 다음과 같은 광고 소재에 대해 자동 광고 소재 스캔을 설정할 수 있습니다. 실시간 입찰 API를 통해 업로드됩니다.
자동 광고 소재 스캔을 설정하면 Google이 인브라우저 입찰을 통해 자동으로 스캔합니다. 향후 입찰에 참여할 수 있습니다.
자동 광고 소재 스캔을 사용 설정하는 방법은 다음과 같습니다.
관심분야 그룹 광고 소재의
renderUrl원본을 모두 연결되어 있어야 합니다.다음 맞춤 HTTP 헤더를 광고 소재의 HTTP 응답에 추가합니다.
Authorized-Buyers-Creative-ID문자열
구매자별 광고 소재 ID입니다. 광고 소재 ID의 최대 길이는 128바이트입니다.
Authorized-Buyers-Click-Through-URLs문자열
RFC2396으로 전달됩니다.
예:
HTTP/1.1 200 OK
Date: Mon, 8 Jan 2022 12:28:53 GMT
Server: Apache/2.2.14 (Win32)
Last-Modified: Mon, 8 Jan 2022 12:01:53 GMT
Content-Length: 88
Content-Type: text/html
Connection: Closed
Authorized-Buyers-Creative-ID:123456
Authorized-Buyers-Click-Through-URLs:https://www.advertiser.com/clickUrl1,https://www.advertiser.com/clickUrl12
<html>
<body>
<h1>Hello, World!</h1>
</body>
</html>
광고 소재 만료
광고 소재는 15일 동안 승인됩니다. 실시간 입찰 API를 사용하는 경우 15일 후에 광고 소재를 다시 제출해야 합니다. 자동 광고 소재 스캔을 사용하면 스캔 과정에서 자동으로 해당 광고 소재를 다시 스캔합니다.
구매자 보고 ID
측정기준을 사용하여 노출수와 같은 보고서 측정항목을 분류할 수 있습니다.
입니다 (예: 캠페인 ID 또는 광고주 ID). 광고 소재에
관심분야 그룹 지출의 측정기준을 알아보려면 buyerAndSellerReportingId를 지정하세요.
사용자의 기기를 관심분야 그룹에 추가할 때 광고가 게재됩니다. 자세한 내용은
자세한 내용은 Protected Audience를 참고하세요.
문서를 참조하세요.
다음은 buyerAndSellerReportingId를 추가하는 방법을 보여주는 예입니다.
관심분야 그룹 설정:
const myGroup = {
...
'ads': [
{
...
'buyerAndSellerReportingId':
'{"google_signals": {"buyer_reporting_id": "12345"}}',
...
}
]
}
joinAdInterestGroup(myGroup);
buyer_reporting_id이(가) 승인된 측정기준에 새 측정기준으로 표시됩니다.
구매자 보고 도구에서 구매자 보고 ID 측정기준으로 이동합니다.
서버 측 입찰
입찰 요청 변경사항
다음은 실험:
관심분야 그룹 입찰 지원 여부 표시
입찰 요청에 새로운 필드(auction_environment)가 있습니다.
- Google RTB 프로토콜:
BidRequest.adslot.auction_environment - OpenRTB:
BidRequest.imp.ext.auction_environment
이 필드를 사용하여
Protected Audience 브라우저 내 관심분야 그룹 입찰을 지원하고
기존 서버 측 Exchange 입찰만 지원합니다 이
auction_environment enum은 다음 값을 가질 수 있습니다.
SERVER_SIDE_AUCTION(OpenRTB JSON:0): 기존 서버 측 입찰ON_DEVICE_INTEREST_GROUP_AUCTION(OpenRTB JSON:1): Protected Audience 지원: 관심분야 그룹 입찰 및 최종 입찰이 실행되며 브라우저에서
Protected Audience 광고 슬롯 크기 표시
입찰 요청에는 잠재고객 광고 슬롯 크기:
- Google RTB 프로토콜:
<ph type="x-smartling-placeholder">
- </ph>
BidRequest.adslot.interest_group_auction.widthBidRequest.adslot.interest_group_auction.height
- OpenRTB:
<ph type="x-smartling-placeholder">
- </ph>
BidRequest.imp.ext.interest_group_auction.widthBidRequest.imp.ext.interest_group_auction.height
이 필드는 Protected Audience 입찰의 광고 슬롯 크기를 나타냅니다. 픽셀 단위로 표시됩니다.
이 크기는 문맥 요청의 크기와 다를 수 있습니다.
(Adslot.width및 Adslot.height 또는 OpenRTB의 경우:
BidRequest.imp.banner.format)을 입력합니다.
문맥 요청에는 여러 크기가 있을 수 있습니다. 기기 내 입찰 낙찰 광고는 하나의 고정 슬롯 크기만 채울 것으로 예상됩니다.
Protected Audience 광고 렌더링 가능 여부 표시
Protected Audience 광고는 현재
통합 단계 (비렌더링
실험)에 참여했습니다. render_interest_group_ads
낙찰된 Protected Audience 광고가 낙찰되었는지 여부를 나타내는 입찰 요청의 필드
렌더링됩니다.
- Google RTB 프로토콜:
BidRequest.adslot.interest_group_auction.render_interest_group_ads - OpenRTB:
BidRequest.imp.ext.interest_group_auction.render_interest_group_ads
사용자 식별자 사용 최소화
Protected Audience API 테스트 범위 내에 있는 문맥 입찰 요청은
기존 쿠키 기반 식별자를 계속 보유합니다(
google_user_id (OpenRTB의 BidRequest.user.id) 등의 브라우저
hosted_match_data (OpenRTB의 경우 BidRequest.user.buyerid) 필드 현재 상태
입찰 요청에서 이러한 식별자 중 일부는 계속해서 기존
개인정보처리방침을 제공합니다. 쿠키 기반 식별자를 사용하지 않는 것이 좋습니다.
보다 효과적으로 대비할 수 있도록 테스트 과정에서 타겟팅과 입찰을 목적으로 사용
더 이상 구매할 수 없게 됩니다.
Google은 쿠키 기반 식별자를 사용하여 Protected Audience API 테스트 범위 내에 있는 입찰 요청에서 수정되었습니다. 이 서드 파티 쿠키 지원 중단의 잠재적 영향을 평가하는 것입니다.
Chrome에서 지원하는 서드 파티 쿠키 지원 중단 테스트
서드 파티 쿠키 지원 중단 (3PCD) 2024년에 Chrome은 이제 Chrome에서 진행하는 테스트.
사이트 및 공급업체는 Chrome에서 진행하는 테스트를 사용하여 서드 파티 쿠키 지원 중단 테스트에서 Chrome 브라우저는 3PCD 실험 그룹에 할당되며 모드 A 또는 모드 B일 수 있습니다. 각 브라우저에 일관성 있는 라벨이 지정됩니다. 이를 통해 액세스할 수 있는 특정 서드 파티 쿠키 지원 중단 실험 그룹에 해당하는 브라우저 기반 Chrome API에 대해 알아보겠습니다
Google은 RTB 입찰가에서 Chrome API의 수정되지 않은 라벨을 전달합니다. 합니다. Google은 개별 라벨의 트래픽 양이 적기 때문에 개인 정보 보호가 제한된 컨텍스트에 항상 라벨이 포함되는 것은 아닙니다.
다음은 라벨을 볼 수 있는 필드입니다.
- Google RTB 프로토콜:
BidRequest.device.cookie_deprecation_label - OpenRTB:
BidRequest.device.ext.cdep
입찰 응답 변경사항
관심분야 그룹 입찰 참여 표시
귀하는
InterestGroupBidding 객체를 반환하여 브라우저 내 입찰
문맥 입찰 응답:
- Google RTB 프로토콜:
BidResponse.interest_group_bidding - OpenRTB:
BidResponse.ext.igbid
문맥 입찰 응답을 제공해야 합니다. 응답은
문맥 입찰가 포함 InterestGroupBidding 객체에는
출처 중 하나와 일치해야 하는 관심분야 그룹 소유자의 origin
설정할 수 있습니다. origin이(가) 입찰에 추가되었습니다.
Google 게시자 태그가 호출할 때 구성의 interestGroupBuyers
runAdAuction()입니다.
구매자 문맥 시그널 전파 (perBuyerSignals)
문맥 입찰 응답에 구매자의 신호를 포함할 수 있는데,
JSON 객체로 전파됩니다.
perBuyerSignals 인수. 이는
다음 필드가 프로토콜에 따라 달라집니다.
- Google 실시간 입찰:
BidResponse.interest_group_bidding.per_buyer_signals - OpenRTB:
BidResponse.ext.igbid.igbuyer.buyerdata
구매자 문맥 렌더링 신호 전파
관심분야 그룹 광고 소재는 렌더링 중에 제한된 문맥 시그널을 사용하여 문맥 입찰 응답을 통해 이러한 신호를 전송하고 수신하는 것은 렌더링 URL 요청에서 매크로 확장을 사용하여 렌더링 URL을 처리합니다. 예를 들어 신호를 사용하여 광고 소재의 디자인과 분위기를 맞춤설정하여 실적을 모니터링할 수 있습니다.
URL 보안 문자열로 직렬화된 구매자의 렌더링 신호를
문맥 입찰 응답
렌더링 URL을 그룹화하여
${RENDER_DATA_buyer.origin.example[_OPTIONAL_SUFFIX]} 매크로
렌더링 신호는 다음을 사용하여 입찰 응답에 지정할 수 있습니다. 프로토콜에 따라 다음과 같이 입력합니다.
- Google 실시간 입찰:
BidResponse.interest_group_bidding.interest_group_buyer.rendering_signals - OpenRTB:
BidResponse.ext.igbid.igbuyer.rsig
매크로 접미사가 서로 다른 렌더링 신호의 최대 3개 세트가 포함될 수 있습니다. 를 사용하여 서로 다른 신호를 구별할 수 있습니다. 예를 들어 서픽스 광고 소재에만 적용되는 특정 신호 집합을 매칭하는 데 사용할 수 있음 해당 매크로를 렌더링 URL에 포함하여 데이터 전송량을 줄일 수 있습니다. 있습니다.
관심분야 그룹 구매자는 보호 신호가 URL 안전하지 않거나 매크로 접미사가 고유하지 않은 경우 잠재고객 입찰로 이동합니다. 3개 이상의 신호가 제공되는 경우
브라우저 내 최대 입찰가 지정
Protected Audience 제안서를 사용하면 입찰가 계산을 통해 최종 입찰은 기기에서 로컬로 실행됩니다. 이로 인해 최종 입찰의 무결성에 영향을 줄 수 있는 잠재적인 악용 벡터 낙찰가와 같은 결과입니다.
Google의 Protected Audience API 테스트 중에 지원되는 완화 조치 의 RTB 파트너에 대해 입찰별로 예상 최대 입찰가를 지정할 수 문맥 입찰 응답입니다. 예상 최대 입찰가는 광고주가 원하는 최대 입찰가가 예상되는 광고 수익을 확인할 수 있습니다 낙찰가가 브라우저 내 입찰이 이 금액을 초과하면 낙찰가가 계산되지 않습니다. 청구 대상 이벤트로 설정할 수 있습니다 이 접근 방식은 변경될 수 있습니다.
입찰 응답에서 다음 필드를 포함해야 합니다.
- Google RTB 프로토콜:
BidResponse.interest_group_bidding.interest_group_buyers.max_bid_cpm_micros(마이크로CPM으로 표시됨) - OpenRTB:
BidResponse.igbid.igbuyer.maxbid(CPM 통화 단위로 표시됨)
여러 계정에 노출 기여도 부여
입찰자는 결제 ID를 선택하여 관심분야에 대한 기여도를 부여해야 합니다. 입찰의 노출을 다음 필드를 사용하여 그룹화할 수 있습니다.
- Google RTB 프로토콜:
BidResponse.interest_group_bidding.interest_group_buyers.billing_id - OpenRTB:
BidResponse.igbid.igbuyer.billing_id
선택한 결제 ID는 입찰 요청에서 사용 가능한 결제 ID여야 합니다.
- Google RTB 프로토콜:
BidRequest.adslot.matching_ad_data.billing_id - OpenRTB:
BidRequest.imp.ext.billing_id
관심분야 그룹 입찰 노출 기여도를 부여할 결제 ID가 입찰자가 Protected Audience 입찰에 참여하지 않습니다.
하위 계정에는 최대 2개의 결제 ID가 포함될 수 있습니다. 구매자는 결제 ID는 문맥 지출에 사용되고 다른 하나는 관심분야 그룹 지출에 사용됩니다. 2개의 결제 ID를 구성하려면 계정 관리자에게 문의하세요. 을 탭합니다.
결제 ID별로 일일 예산을 설정할 수 있습니다. 담당 고객 지원 담당자에게 계정 관리자가 하위 계정의 결제 ID에 대한 일일 예산을 설정합니다.
다음에 입찰할 수 있는 사용 가능한 예산이 있는 모든 하위 계정의 결제 ID 지출 기여 선택에 대한 입찰 요청에서 노출이 표시되는지 확인합니다. 연락하기 계정 관리자에게 연락하여 관심분야 그룹 결제 ID의 예산을 수정하세요.
브라우저 내 입찰 중
브라우저 내 입찰가 생성
generateBid()를 사용하여 브라우저 내 입찰가를 생성합니다.
Google에서는 다음과 같은 매개변수를 제공합니다.
auctionSignals: 비어 있음perBuyerSignals: 입찰할 수 있으며
다음과 같은 매개변수가 반환됩니다.
ad: Google은 이 필드를 무시합니다.bid: 입찰에 참여하는 숫자로 된 입찰가입니다. CPM 단위로 입력해야 합니다. (마이크로가 아님)입니다.render: 낙찰 시 광고 소재를 게재하기 위해 렌더링되는 URL 입찰할 수 있습니다. Google에서 이 URL을 검토하고 승인해야 합니다. 그렇지 않으면 URL이 필터링됩니다. 얻을 수 있습니다.allowComponentAuction:true여야 합니다. Google은 현재 테스트를 입찰하는 경우가 많습니다
예를 들면 다음과 같습니다.
function generateBid(...) {
...
return {'ad': 'example',
'bid': ad.metadata.bid,
'render': ad.renderUrl,
'allowComponentAuction': true};
}
기기에서 Protected Audience 사양 확인
입찰
섹션을 참조하세요.generateBid()
입찰 통화
브라우저 내 입찰은 선택한 입찰 통화의 CPM 단위로 이루어집니다.
입찰 통화는 문맥 입찰 응답과
generateBid의 반환 값이며 유효한 ISO 4217 알파 코드여야 합니다.
'USD', 'EUR' 또는 'JPY').
OpenRTB의 경우curInterestGroupBuyer
Google의 입찰 응답 확장 프로그램입니다.
예를 들면 다음과 같습니다.
ext {
igbid {
impid: "1"
igbuyer {
origin: "https://examplebuyerorigin.com"
cur: "EUR"
}
}
}
Google RTB 프로토콜에서currency
InterestGroupBuyer 메시지를 포함합니다.
예를 들면 다음과 같습니다.
interest_group_bidding {
adslot_id: 1
interest_group_buyer {
origin: "https://examplebuyerorigin.com"
currency: "EUR"
}
}
입찰자 generateBid 함수는
표시됩니다. 새 bidCurrency 속성을
generateBid의 반환 값:
function generateBid(...) {
...
return {'ad': ad,
'bid': bid,
'bidCurrency': 'EUR',
...};
}
문맥 입찰 응답의 통화가 통화와 다른 경우
generateBid에서 반환되거나 둘 중 하나가 잘못된 통화를 반환하는 경우
입찰 전에 필터링됩니다.
광고 품질 검사
광고 소재 정책 및 게시자 관리 기능 시행이 RTB에 대한 Protected Audience API 테스트 중 브라우저 내 관심분야 그룹 입찰 있습니다.
디지털 서비스법 지원
디지털 서비스법 제26조에 따라 게시자는 구매자가
광고 내 투명성 공개 '구매자에게 DSA가 포함된 광고만 표시하도록 요청
EEA 내 사이트 또는 앱의 투명성 정보' 제어 영역에 의해
관심분야 그룹 구매자는 자신이 어떤 기회를
필수 입력란인
접수된 입찰 요청 수:
BidRequest.dsa.dsa_support 및 BidRequest.dsa.publisher_rendering_support
(Google Authorized Buyers 프로토콜 및 BidRequest.regs.dsa.required)
OpenRTB 프로토콜의 경우 BidRequest.dsa.pubrender입니다.
Protected Audience API 입찰에 참여하려는 입찰자가
입찰 요청에서 DSA 투명성이 표시되어야 한다는 신호를 받음
광고가 게재될 때
필요한 정보를 적절히 표시하고
BidResponse.interest_group_bidding.interest_group_buyers.dsa_buyer_render
Google Authorized Buyers 프로토콜 또는
BidResponse.ext.igbid.igbuyer.dsaadrenderOpenRTB 프로토콜 그렇지 않으면
구매자가 Protected Audience API 입찰에 포함되지 않습니다.
디지털 서비스법 광고 투명성에 관한 자세한 내용은 고객센터 도움말: 디지털 서비스법 지원
입찰 필터링
Google이 게시자에게 관리 기능 및 광고 정책 기기 내 입찰 중
브라우저 내 입찰 후
구매자에게 입찰 결과 보고: reportWin()
Google에서는 다음 인수를 채우지 않습니다.
auctionSignalssellerSignals
reportWin()를 사용하여 입찰 결과를 구매자에게 보고합니다.
자세한 내용은 렌더링 및 광고에 대한 구매자 보고서입니다. 이벤트 섹션을 참고하세요.
매크로
Protected Audience API 광고 소재를 참조하는 renderUrl에는 다음이 포함될 수 있습니다.
매크로라고 하는 하나 이상의 자리표시자를 포함할 수 있습니다. 관심분야 그룹 입찰 이후
종료되지만 렌더링 전에 매크로가 해당하는
값으로 사용됩니다. 기기 내 입찰에 사용되는 renderUrl에는 다음이 포함될 수 있습니다.
매크로:
${GDPR}
|
GDPR이 적용되지 않는 경우 0으로, GDPR이 적용되는 경우 1로 확장됩니다. 문서 보기 |
${GDPR_CONSENT_XXXX}
|
투명성으로 확대
및 요청과 연결된 동의 (TC) 문자열입니다. 투명성 및
동의 (TC) 문자열이 비어 있거나 잘못되어 이 매크로는 확장되지 않습니다.
이 매크로를 사용하여 URL에서 TC 문자열을 IAB GVL 등록 공급업체에 전달합니다.
${GDPR_CONSENT_XXXX} 매크로는
renderUrl
|
${ADDL_CONSENT}
|
추가 요청과 연결된 동의 (AC) 문자열입니다. |
${AD_WIDTH}, ${AD_HEIGHT)
|
이 매크로는 광고 슬롯 너비와 높이를 삽입합니다. |
${RENDER_DATA_buyer.origin.example[_OPTIONAL_SUFFIX]}
|
렌더링 시간 구매자 신호가 포함된 매크로 입찰 응답에서 지정됩니다.
|
노출수 집계
RTB 파트너와의 Protected Audience API 테스트 중 Google에서는
브라우저가 reportResult() 함수를 호출하고
이후에 sendReportTo() 호출을 통해 Google의 보고 URL을 가져옵니다.
Protected Audience에서 노출수를 집계하기 위해 Google이 사용하는 이벤트 이후 브라우저 내 입찰은 집계에 사용되는 이벤트와 다를 수 있음 RTB 구매자 파트너에 의해 노출이 발생하는 경우 노출수가 다를 수 있습니다.
Protected Audience API 테스트를 위한 Google의 목표 중 하나는 불일치를 줄일 수 있습니다
청구 가능 노출수 기여 분석
Protected Audience 브라우저 내 입찰에서 발생한 입찰자의 모든 지출은 단일 입찰자 계정에 기여했다고 간주하는 입찰자에 대해 구성된 그룹 소유자 출처 비용의 기여도를 각기 다른 입찰자의 하위 시트 계정은 지원되지 않습니다.
일일예산 한도
Protected Audience API 테스트 중에 각 계정에는 계정 수준이 있습니다. Protected Audience 지출 일일 예산 한도입니다. 일일 예산 한도는 입찰할 수 있습니다. 일일예산 한도에 도달하면 계정에서 더 이상 Protected Audience 요건을 충족하는 입찰 요청을 받지 않습니다.
이 계정은
Protected Audience 한도에 도달하는 것이 좋습니다. 예를 들어 입찰자 계정이
입찰 요청이auction_environment
= SERVER_SIDE_AUCTION0
Protected Audience 입찰
실시간 피드백 및 낙찰을 위한 최소 입찰가
수신에 동의한 입찰자 실시간 피드백 은(는) 기기 내 Protected Audience 입찰 입찰자가 은 구매자가 Protected Audience 입찰에 참여하게 됩니다. 이 관심분야 그룹 구매자 의견에 대해 다음 정보가 제공됩니다. 객체:
- 의견 객체의 피드백 유형은
INTEREST_GROUP_BUYER_FEEDBACK - 관심분야 그룹 구매자의 출처입니다.
- 낙찰을 받기 위해 관심분야 그룹 구매자가 낙찰받기 위한 최소 입찰가 입찰할 수 있습니다.
- 낙찰을 받기 위해 관심분야 그룹 구매자가 낙찰받으려는 최소 입찰가 전체 입찰의 서버 측 구성요소에서 가장 높은 순위의 입찰가를 가져옵니다.
- 관심분야 그룹 구매자의 상태 코드입니다. 가능한 상태 코드는 다음과 같습니다. 정의된 위치 interest-group-buyer-status-codes.txt.
자세한 내용은 프로토콜 문서를 참조하세요. Authorized Buyers RTB 및 OpenRTB 확장 프로그램 특정 필드 이름의 경우
입찰가 의견 알림
Chrome은 Chrome에서 일시적인 디버깅을 제공하여 API 이는 Ad Manager에서 실시간으로 서버 간 디버그 알림이 잠재고객 입찰가 이 알림에는 기존에 입찰한 입찰수에 비해 Protected Audience 인브라우저 입찰과 확인할 수 있습니다.
입찰자는 계정 관리자에게 문의하여 Protected Audience 디버깅 입찰가 의견 알림을 제공하는 데 사용됩니다. 이 선택한 매크로가 교체된 Google 서버에서 정적 URL을 가져옵니다. 입찰할 수 있습니다. 다음 매크로는 지원됨:
%%GOOGLE_QUERY_ID%%: 이 매크로는 Google 검색어 ID로 대체됩니다. (Authorized Buyer 프로토콜의BidRequest.google_query_id및BidRequest.ext.google_query_id)를 호출합니다. Protected Audience가 사용 설정된 문맥 입찰 요청입니다.%%INTEREST_GROUP_OWNER%%: 관심분야 그룹 소유자의 출처입니다.%%BID_CPM%%:generateBid()함수%%RENDER_URL%%: 광고 소재의 렌더링 URL입니다.%%STATUS%%:scoreAd()내에 입찰이 거부된 경우의 상태 코드입니다. 값은 광고 소재 상태임 코드가 있어야 합니다.
다음은 입찰자가 계정 관리자에게 제공할 수 있는 정적 URL 샘플입니다.
https://dsp.example/debug?google_query_id=%%GOOGLE_QUERY_ID%%&ig_owner=%%INTEREST_GROUP_OWNER%%&render_url=%%RENDER_URL%%&bid=%%BID_CPM%%&status=%%STATUS%%
입찰가 의견 알림은 Chrome의
임시 ForDebuggingOnly API입니다.
제품 수준 TURTLEDOVE
여러 부분으로 구성된 광고 또는 제품 수준 TURTLEDOVE (PLTD)는 Protected Audience API가 진행되는 동안 Google RTB 파트너를 대상으로 지원됩니다. 있습니다. 테스트할 계획이라면 통합 중에 계정 관리자에게 알리세요. PLTD, 추가 리소스와 구성이 필요하기 때문입니다.
온보딩
Protected Audience API를 테스트하는 방법은 다음과 같습니다.
단계
- 요청 양식 작성 Protected Audience API 실험에 참여하세요.
- 요청 양식을 제출한 후 계정 관리자 또는 파일에 문의하세요. Authorized Buyer 도움말 중앙으로 이동합니다.
- 계정이 구성되면 Google과 파트너 모두 테스트 단계의 단계를 통해 통합을 설명합니다.
광고 소재 검토
제품 수준 광고 (여러 부분으로 구성된 광고)로 입찰하려는 경우 Protected Audience API 입찰에 참여하려면 다음 요구사항을 따르세요.
- 다음을 위한
renderUrl에&pltd=True쿼리 매개변수를 포함합니다. 구성요소 광고의 컨테이너 (최상위renderUrl라고도 함)를 광고 소재 검토 중에 최상위renderUrls를 구별합니다. - 구성요소 광고의 컨테이너가 다음에 해당하는 경우 대표 광고 소재 렌더링
Google의 광고 소재 검토를 위해
가져옵니다 광고가 클릭될 때
반환되어야 하는 경우
Google 광고 소재 검토 시스템에서 설정한
validation=True쿼리 매개변수
통합 체크리스트
- Protected Audience API를 채우는 입찰 요청 엔드포인트 설정
관련 필드(예:
interest_group_bidding - 광고주의 페이지에 태그를 구현하여 사용자의 브라우저가 알 수 있습니다.
generateBid()및reportWin()를 구현합니다.- 관심분야 그룹 소유자 출처를 선택하여 Authorized Buyer에 추가하세요.
있습니다.
- 관심분야 그룹 소유자 출처는
generateBid()함수가 호스팅됩니다. - 계정 관리자에게 문의하거나 승인됨 구매자 고객센터를 이 단계를 완료합니다.
- 관심분야 그룹 소유자 출처는
- Protected Audience API와 관련된 인벤토리에 사전 타겟팅 설정하기 있습니다.
- 검토 및 승인을 위해 광고 소재 API를 참고하세요.
- (선택사항) 신뢰할 수 있는 입찰 신호 엔드포인트를 설정합니다.
- (선택사항) Google 엔지니어가 게시자의 관심분야 그룹 구매자가 소유한 관심분야 그룹에 출처입니다. 이렇게 하면 Protected Audience 입찰을 수동으로 트리거할 수 있습니다.
- (선택사항) 계정에 대한 실시간 피드백을 사용 설정하여 다음에 대한 의견을 받습니다. Protected Audience에 포함되도록 요청한 관심분야 그룹 구매자 입찰할 수 있습니다.
- (선택사항) 계정 관리자에게 문의하여 Protected Audience 입찰가를 제공하는 서버 간 알림 수신 기기 내 Protected Audience의 입찰 상태에 관한 의견 입찰을 통해 예기치 않은 문제를 디버깅하는 데 도움이 됩니다 입찰가 의견 보기 알림을 참고하세요.
테스트 단계
1단계: 수동 테스트
Protected Audience 입찰을 수동으로 트리거하는 방법은 다음과 같습니다. 렌더링되고 노출을 기록합니다.
- Chrome 101 이상을 사용합니다.
- 다음을 사용하여 개인 정보 보호 샌드박스 API 및 분리 프레임 사용 설정
chrome://flags/#privacy-sandbox-ads-apis및chrome://flags/#enable-fenced-frames입니다. 자세한 내용은 개인 정보 보호 테스트하기 샌드박스 입니다. - 승인을 위해 실시간 입찰 사용 API를 참고하세요.
- 입찰자가 제공한 광고주 페이지에서 브라우저를 입찰자 소유 관심분야 그룹입니다.
Google에서 제공하는 다음 테스트 게시자 페이지를 사용하여 보호된 테스트 게시자 잠재고객 입찰:
https://fledge-testing.uc.r.appspot.com/?nid=allow_all
브라우저 내 관심분야 그룹은 입찰에서 낙찰될 만큼 입찰가가 높아야 합니다. 기존의 서버 측 입찰과 경쟁할 수 있습니다. 또한 Google은 각 파트너의 전용 테스트 게시자 페이지(해당 파트너만 입찰에 참여할 수 있습니다. 안정적으로 낙찰받는 것이 더 쉬울 수 있습니다. '브라우저 내 입찰'을 설정할 수 있습니다
다음을 확인합니다.
- 예상되는 낙찰 광고가 렌더링됩니다.
- 입찰 결과는 서버 측으로 전송되므로 낙찰자가 낙찰을 받게 됩니다.
reportWin()에서 핑백을 수신합니다. - 테스트 게시자 페이지 콘솔에는
다음 정보가 포함됩니다.
<ph type="x-smartling-placeholder">
- </ph>
renderUrl: 입찰의 렌더링 URL입니다.interestGroupOwner: 입찰의 관심분야 그룹 소유자입니다.accepted: 입찰가가 수락된 경우 이 필드는true이고, 입찰가가 수락되면false입니다.scoreAd()에서 입찰을 거부한 경우입니다.externalBidStatus: 다음과 같은 시간 내에 입찰이 거부된 경우의 상태 코드입니다.scoreAd()입니다. 값은 광고 소재 상태임 코드가 있어야 합니다.
2단계: (선택사항) 렌더링하지 않는 실험
Google과 파트너가 파트너가 다음을 수행할 수 있음을 수동으로 확인한 후 입찰에 참여할 경우 Google은 파트너가 살펴볼 것입니다.
Google은 Protected Audience를 실행하기 위해 소량의 실시간 트래픽을 할당합니다. 입찰할 수 있습니다. 그러면 Google과 파트너가 더 이상 Protected Audience 입찰 Protected Audience 입찰의 결과는 있습니다. 이를 통해 대규모로 통합을 테스트할 수 있습니다.
계정 관리자에게 문의하거나 Authorized Buyer 고객센터를 방문하세요. Google은 이 단계에서 계정을 사용 설정합니다.
3단계: 렌더링 실험
Google과 파트너가 Protected Audience 입찰을 대규모로 확인한 후 Google은 파트너가 보호된 콘텐츠를 렌더링하고 낙찰된 잠재고객 광고입니다. Google은 보호 대상일 경우 트래픽이 적은데 잠재고객 입찰을 실행할 수 있으며 낙찰된 관심분야 그룹 광고는 있습니다. 참여하는 입찰자의 인브라우저 입찰은 기존의 게재위치와 입찰할 수 있습니다.
계정 관리자에게 문의하거나 Authorized Buyer 고객센터를 방문하세요. Google은 이 단계에서 계정을 사용 설정합니다.
추가 기능
다음 기능은 핵심 프로토콜의 확장 프로그램입니다.
동시 로드
동시 로드는 엔드 투 엔드 입찰 지연 시간을
이 요청에 따라 문맥 광고 요청을
구매자가 신뢰할 수 있는 서버
trustedBiddingSignalsUrl에 지정됩니다.
동시 로드는 지연 시간을 줄이지만 관심분야 그룹에 영향을 미칩니다. 구매자 자격 요건 및 조정 실험 병렬 처리는 모든 입찰자에 적용됨 기기 내 관심분야 그룹 입찰입니다. 입찰자는 어떻게 해야 하는지를 알고 있어야 동시 로드가 기기 내 입찰 적합성에 미치는 영향 조정된 실험을 위한 실험 그룹 ID는 아직 지원되지 않습니다. 입찰할 수 있습니다
제공 흐름 요약
다음은 병렬 입찰 흐름을 요약한 것입니다.
기기 내 관심분야 그룹 구매자 자격 요건
병렬 입찰의 경우 navigator.runAdAuction의 호출이 전에 발생합니다.
문맥 광고 응답이 반환됩니다. 구매자가 신뢰할 수 있는
navigator.runAdAuction를 사용하려면
interestGroupBuyers 매개변수는 다음과 같아야 합니다.
값으로 전달되지만 나머지 입찰 매개변수는 자바스크립트를 허용합니다.
문맥 광고 응답 후에 해결될 수 있는 프라미스입니다. 이후
interestGroupBuyers는 문맥 광고 응답 전에 전달됩니다.
문맥 광고 응답 (입찰 응답 포함)
동시에 진행되는 입찰에 참여할 구매자를 선택하는 데 사용할 수 없음
확인할 수 있습니다. 대신 Google의 게시자 태그는
사용자 브라우저의 interestGroupBuyers 매개변수
동일한 도메인에서 navigator.runAdAuction가 실행됩니다.
병렬 처리에는 몇 가지 중요한 고려사항이 있습니다.
구매자가 신뢰하는 서버 요청에 필요하지 않은 입찰 신호 RTB 입찰 응답에 계속 지정될 수 있음(예:
perBuyerSignals) 동일한 방식으로 입찰할 수 있습니다. 이러한 신호에 대한 프로미스가 해결되면 기기 내 입찰은 비동시 입찰과 동일한 방식으로 완료됩니다. 입찰 흐름에 따라 다릅니다.동시 로드는 관심분야 그룹 구매자 목록 캐싱에 의존하므로 Google은 동시 로드를 캐시에 사용하기 때문에 항상 동시 입찰을 실행하지는 않습니다. 비어 있거나 만료된 것일 수 있습니다. 캐시가 비어 있거나 만료된 경우 Google은 표준 비동시 Protected Audience API 입찰과 구매자 의도를 사용하여 비동시 입찰에 참여하여 관심분야 그룹 구매자 캐시를 구축합니다.
입찰자에 대해 한 명 이상의 구매자가 현재 게시자에 대해 캐시된 경우 Google은 해당 도메인에 대한 입찰 요청에서 표시됩니다.
- Google RTB 프로토콜:
BidRequest.adslot.interest_group_auction.parallelized - OpenRTB:
BidRequest.imp.ext.interest_group_auction.parallelized
- Google RTB 프로토콜:
특정 입찰자에 대해 등록된 관심분야 그룹 구매자 출처는 병렬 입찰에 포함된 입찰 응답에는
ParallelAuctionBuyer항목:- Google RTB 프로토콜:
BidRequest.adslot.interest_group_auction.parallel_auction_buyer - OpenRTB:
BidRequest.imp.ext.interest_group_auction.pbuyer
- Google RTB 프로토콜:
병렬 입찰이 실행 중이지만 특정 구매자 출처가 없는 경우 해당 구매자가 현재의 기기 내 입찰할 수 있습니다. 이는
parallelized=True지정된 관심분야 그룹 구매자 출처의 항목이ParallelAuctionBuyer개 있습니다. 그러나 유효하고 요건을 충족하는 입찰 응답에 대한InterestGroupBuyer해당 관심분야 그룹 구매자가 출처가 캐시에 추가되어, 해당 출처는 동일한 브라우저 및 도메인에서 향후 병렬 처리되는 요청을 처리할 수 있습니다. 관심분야 그룹 입찰 참여 의사 다음 필드에 표시할 수 있습니다.- Google RTB 프로토콜:
BidResponse.adslot.interest_group_bidding.interest_group_buyers - OpenRTB:
BidResponse.ext.igbid.igbuyer
- Google RTB 프로토콜:
캐시된 구매자 출처 (병렬 입찰의
interestGroupBuyers매개변수)를 정의하며 이는 입찰자가 의도를 나타내지 않는 경우에 해당합니다. 구매자의 신뢰할 수 있는 서버 호출을 수신할 수 있으며, 병렬 입찰에는 참여하지 않습니다.