Protected Audience API (이전 명칭: FLEDGE)

Chrome은 개인 정보 보호 샌드박스의 일환으로 보호되는 잠재고객 API: 브라우저 내 API 광고주와 광고 기술 회사가 관심분야 그룹 타겟팅 광고를 게재할 수 있습니다. 서드 파티 쿠키에 의존하지 않고 사용자를 크로스 사이트로부터 보호 있습니다.

Chrome에서 Protected Audience API의 오리진 트라이얼을 실행하고 있습니다. Authorized Buyers는 Ad Manager 게시자 인벤토리에서 Protected Audience API 테스트에 참여할 수 있습니다. 입찰자는 Protected Audience API를 테스트하여 다음을 실행할 수 있습니다.

  • Protected Audience API 흐름의 효과를 반복하고 알아봅니다.
  • 공개 포럼(예: GitHub)에서 잠재적인 API 개선사항에 관한 의견을 수집합니다.
  • API를 통한 개인 맞춤 광고 지원을 준비할 때는 서드 파티 쿠키에 의존할 수 있습니다

테스트에 관심이 있는 Authorized Buyers는 온보딩 섹션을 참조하세요.

게재 흐름 요약

다음은 Authorized Buyers의 Protected Audience 광고 게재 흐름에 대한 요약입니다. 파트너:

흐름도

  1. 입찰자는 광고주와 협력하여 각 광고주의 관심분야 그룹을 유지합니다. 있습니다. 광고주는 관심분야 그룹에 브라우저를 추가하기 위해 광고주 페이지에 입찰자의 태그를 추가하는 경우가 많습니다.
  2. 최종 사용자가 광고주의 페이지를 방문합니다. 페이지에 입찰자의 태그가 포함될 수 있습니다.
  3. 입찰자의 태그가 Protected Audience API joinAdInterestGroup()를 호출합니다. 이 호출은 브라우저에 사용자를 관심분야 그룹에 추가하도록 요청합니다.
  4. 최종 사용자가 게시자 웹페이지를 방문합니다. 사용자의 브라우저에서 Google의 게시자 광고 태그입니다.
  5. Google의 게시자 광고 태그는 Google 서버에 문맥 광고를 요청합니다.
  6. Google은 참여 입찰자에게 문맥 입찰 요청을 전송합니다. 자세한 내용은 입찰 요청 변경사항 섹션을 참조하세요.
  7. 입찰자는 관심분야 그룹 입찰에 참여하는 데 필요한 InterestGroupBidding 메시지를 포함한 입찰 응답을 반환합니다. 포함 OpenRTB는 BidResponse.ext.igbid 필드를 사용하여 지정됩니다. 이는 지원 중단된 Google RTB 프로토콜의 BidResponse.interest_group_bidding 필드 입찰자가 이 정보를 지정하지 않으면 Google은 입찰 구성의 interestGroupBuyers에 입찰자의 출처를 포함하지 않습니다. 또한 InterestGroupBidding에는 다음과 같은 구매자별 신호(선택사항)가 포함될 수 있습니다. 는 브라우저 내에서 입찰자의 입찰 함수에 전달됩니다. 입찰할 수 있습니다. OpenRTB에서 이는 BidResponse.ext.igbid.igbuyer.buyerdata 필드(지원 중단됨) Google RTB 프로토콜의 경우 BidResponse.interest_group_bidding.interest_group_buyers.per_buyer_signals 필드를 확인합니다. 자세한 내용은 입찰 응답 변경사항 섹션을 참고하세요.
  8. Google은 서버 측 입찰을 실행하고 브라우저에 입찰 응답을 반환합니다. 서버 측 입찰은 기존의 서버 측 입찰가를 고려합니다. 입찰 응답에는 문맥 낙찰가에 대한 정보가 포함될 수 있습니다 (경우에 따라 모두).
  9. 입찰 응답에는 브라우저 내 입찰의 입찰 구성이 포함됩니다. 여기에는 각 참여 구매자의 문맥 시그널(이전에는 OpenRTB의 buyerdata 또는 지원 중단된 Google RTB 프로토콜의 per_buyer_signals를 통해 전송됨), 문맥 낙찰자 정보, 입찰 자격 요건 설정이 포함될 수 있습니다.
  10. Google의 게시자 태그가 Protected Audience API runAdAuction() 호출 기기 내 관심분야 그룹 입찰을 시작합니다. Google은 InterestGroupBuyer으로 포함된 구매자 입찰을 구성하는 동안 InterestGroupBidding.
  11. Google은 조건을 충족하는 각 입찰자의 구매자별 신호(선택사항)를 Protected Audience 입찰 구성
  12. 특정 입찰자의 관심분야 그룹이 trustedBiddingSignalsUrl인 경우 브라우저가 각 그룹의 trustedBiddingSignalsUrl: 각 그룹의 실시간 신호를 가져옵니다. 자세한 내용은 Protected Audience API 사양을 참고하세요.
  13. 브라우저는 선택하고 브라우저 내 입찰에 참여할 수 있는 각 관심분야 그룹에 대해 입찰자의 generateBid()를 호출합니다. 이 단계에서 입찰가를 계산하고 광고 소재를 선택합니다. generateBid()에서 액세스할 수 있는 사진 입찰자가 제공하는 선택적 구매자 신호와 신뢰할 수 있는 입찰 신호를 찾습니다.
  14. 브라우저는 판매자 (이 경우 Google의) scoreAd()를 호출하여 관심분야 그룹 광고 입찰에서 각 입찰가에 순위 지정 입찰가 순위 지정 게시자 보호 조치, 광고 정책 및 기타 광고 소재 유형에 따라 제약이 있습니다
  15. 브라우저에서 요건을 충족하는 관심분야 그룹 입찰가를 사용하여 입찰을 실행합니다. 이 최상위 문맥 입찰가가 브라우저 내 입찰에 참여합니다.
  16. 입찰 후 관심분야 그룹 낙찰자가 있는 경우 브라우저는 판매자의 reportResult() 및 입찰자의 reportWin()를 호출하여 각 당사자에게 브라우저 내 입찰의 낙찰자에 관해 알립니다.
  17. 관심분야 그룹 광고가 낙찰되면 Google의 게시자 태그가 iframe에서 광고를 렌더링합니다.

게재 흐름 세부정보

광고 게재 전

광고 소재 검토

광고 소재는 Google이 검토하고 승인해야 Protected Audience 브라우저 내 입찰 검토를 위해 광고 소재를 제출할 수 있습니다. 실시간 입찰 API 또는 자동 광고 소재 스캔을 사용할 수 있습니다. 광고 소재 Protected Audience 브라우저 내 관심분야 그룹 광고 입찰에는 다음이 포함되어야 합니다. renderUrls 검토

renderUrls 요구사항:

  • API를 통해 제출된 renderUrl는 관심분야 그룹 광고 입찰에 사용된 renderUrl와 일치해야 합니다.
  • 각 renderUrl은(는) 단일 광고주 또는 광고만을 나타낼 수 있습니다. 확인할 수 있습니다. 지정된 renderUrl는 여러 광고주를 대신하여 광고를 렌더링하는 데 사용할 수 없습니다. 각 renderUrl는 단일 광고 소재에 매핑해야 합니다.
  • renderUrl는 광고가 마지막으로 입찰된 후 최대 7일 동안 Google의 오프라인 광고 소재 검토 시스템에서 액세스하고 가져올 수 있어야 합니다.
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 측정기준으로 이동합니다.

서버 측 입찰

입찰 요청 변경사항

다음은 실험에 사용할 수 있는 지원되는 프로토콜의 초기 버전입니다.

관심분야 그룹 입찰 지원 표시

입찰 요청에 관심분야 그룹 입찰 지원을 나타내는 새로운 필드가 추가되었습니다.

  • OpenRTB:
    • BidRequest.imp.ext.ae
    • BidRequest.imp.ext.igbid
  • Google RTB 프로토콜 (지원 중단됨): <ph type="x-smartling-placeholder">
      </ph>
    • BidRequest.adslot.supported_auction_environment
    • BidRequest.adslot.interest_group_bidding_allowed

이 필드를 사용하여 Protected Audience 브라우저 내 관심분야 그룹 입찰을 지원하고 기존 서버 측 Exchange 입찰만 지원합니다 AuctionEnvironment enum은 다음 값을 가질 수 있습니다.

  • SERVER_SIDE_AUCTION (OpenRTB JSON: 0): 낙찰된 광고가 거래소 서버에서 실행됩니다.
  • ON_DEVICE_INTEREST_GROUP_AUCTION (OpenRTB JSON: 1): Protected Audience 지원: 관심분야 그룹 입찰 및 최종 입찰이 브라우저에서 실행됩니다.
  • SERVER_SIDE_INTEREST_GROUP_AUCTION(OpenRTB JSON: 3): 문맥 입찰은 거래소의 서버에서 실행되며 관심분야 그룹 입찰의 입찰 로직과 최종 낙찰 광고를 결정하기 위한 점수 로직은 입찰 서버에서 실행됩니다.
Protected Audience 광고 슬롯 크기 표시

입찰 요청에는 Protected Audience 광고 슬롯 크기를 제공하기 위한 다음 필드가 포함됩니다.

  • OpenRTB: <ph type="x-smartling-placeholder">
      </ph>
    • BidRequest.imp.ext.interest_group_auction.width
    • BidRequest.imp.ext.interest_group_auction.height
  • Google RTB 프로토콜(지원 중단됨):
    • BidRequest.adslot.interest_group_auction.width
    • BidRequest.adslot.interest_group_auction.height

이 필드는 Protected Audience 입찰의 광고 슬롯 크기를 픽셀로 나타냅니다.

이 크기는 OpenRTB의 BidRequest.imp.banner.format.w 및 BidRequest.imp.banner.format.h 필드 또는 지원 중단된 Google RTB 프로토콜의 BidRequest.adslot.width 및 BidRequest.adslot.height 필드에 표시되는 것과 같은 문맥 요청의 크기와 다를 수 있습니다.

문맥 요청에는 여러 크기가 있을 수 있습니다. 기기 내 입찰에서 낙찰된 광고는 고정된 단일 슬롯 크기만 채울 것으로 예상됩니다.

Protected Audience 광고 렌더링 가능 여부 표시

Protected Audience 광고는 현재 통합 단계 (비렌더링 실험)에 참여했습니다. render_interest_group_ads 낙찰된 Protected Audience 광고가 낙찰되었는지 여부를 나타내는 입찰 요청의 필드 렌더링됩니다.

  • OpenRTB: BidRequest.imp.ext.interest_group_auction.render_interest_group_ads
  • Google RTB 프로토콜 (지원 중단됨): BidRequest.adslot.interest_group_auction.render_interest_group_ads
사용자 식별자 사용 최소화

Protected Audience API 테스트 범위 내의 문맥 입찰 요청은 브라우저에서 사용할 수 있는 경우 기존 쿠키 기반 식별자(예: BidRequest.user.id 및 BidRequest.user.buyerid 필드 또는 지원 중단된 Google RTB 프로토콜의 BidRequest.google_user_id 및 BidRequest.hosted_match_data)를 계속 전송할 수 있습니다. 입찰에 이러한 식별자가 있음 요청에는 기존 개인정보처리방침이 적용됩니다. 따라서 쿠키 기반 식별자를 사용하지 않고 서드 파티 쿠키가 없을 때 효율적인 구매에 대비하기 위한 테스트 진행 더 오래 사용할 수 있습니다.

Google은 Protected Audience API 테스트 범위 내 입찰 요청에서 쿠키 기반 식별자가 삭제되는 소규모 실험을 진행할 수도 있습니다. 이는 서드 파티 쿠키 지원 중단이 미칠 수 있는 영향을 평가하기 위한 것입니다.

2024년 서드 파티 쿠키 지원 중단(3PCD)에 대비하기 위해 이제 Chrome에서 Chrome 지원 테스트를 제공합니다.

사이트 및 공급업체는 Chrome에서 진행하는 테스트를 사용하여 서드 파티 쿠키 지원 중단 테스트에서 Chrome 브라우저는 모드 A 또는 모드 B 중 하나인 3PCD 실험 그룹에 할당됩니다. 각 브라우저에 일관성 있는 라벨이 지정됩니다. 이를 통해 액세스할 수 있는 특정 서드 파티 쿠키 지원 중단 실험 그룹에 해당하는 브라우저 기반 Chrome API에 대해 알아보겠습니다

Google은 RTB 입찰 요청에서 Chrome API의 수정되지 않은 라벨을 전달합니다. Google은 개별 라벨의 트래픽 양이 적기 때문에 개인 정보 보호가 제한된 컨텍스트에 항상 라벨이 포함되는 것은 아닙니다.

라벨을 볼 수 있는 입력란은 다음과 같습니다.

  • OpenRTB: BidRequest.device.ext.cdep
  • Google RTB 프로토콜(지원 중단됨): BidRequest.device.cookie_deprecation_label

입찰 응답 변경사항

관심분야 그룹 입찰 참여 표시

문맥 입찰 응답에서 InterestGroupBidding 객체를 반환하여 브라우저 내 입찰에 참여하겠다는 의도를 명시적으로 표시해야 합니다.

  • OpenRTB: BidResponse.ext.igbid
  • Google RTB 프로토콜 (지원 중단됨): BidResponse.interest_group_bidding

문맥 입찰 응답을 제공해야 합니다. 응답에 문맥 입찰을 포함할 필요는 없습니다. InterestGroupBidding 객체에는 각 InterestGroupBuyer의 origin가 포함되어야 하며, 이 origin는 입찰자가 계정에 대해 구성한 출처 중 하나와 일치해야 합니다. origin이(가) 입찰에 추가되었습니다. Google 게시자 태그가 호출할 때 구성의 interestGroupBuyers runAdAuction()입니다.

구매자 문맥 시그널 전파

문맥 입찰 응답에 구매자의 신호를 포함할 수 있으며, Google에서는 perBuyerSignals 인수를 통해 기기 내 입찰 함수에 JSON 객체로 전파합니다. 이는 프로토콜에 따라 다음 필드와 함께 입찰 응답에 포함될 수 있습니다.

  • OpenRTB: BidResponse.ext.igbid.igbuyer.buyerdata
  • Google RTB(지원 중단됨): BidResponse.interest_group_bidding.per_buyer_signals
구매자 문맥 렌더링 신호 전파

관심분야 그룹 광고 소재는 렌더링 중에 제한된 문맥 시그널을 사용하여 문맥 입찰 응답을 통해 이러한 신호를 전송하고 수신하는 것은 렌더링 URL 요청에서 매크로 확장을 사용하여 렌더링 URL을 처리합니다. 예를 들어 렌더링 신호를 사용하여 광고 소재의 디자인을 맞춤설정하여 특정 광고 슬롯 또는 게시자 페이지의 맥락에서 실적을 개선할 수 있습니다.

문맥 입찰 응답에 URL에 안전한 문자열로 직렬화된 구매자의 렌더링 신호를 포함할 수 있습니다. 그러면 Google에서 ${RENDER_DATA_buyer.origin.example[_OPTIONAL_SUFFIX]} 매크로를 구성하여 낙찰된 관심분야 그룹 렌더링 URL에서 이를 대체합니다.

렌더링 신호는 다음을 사용하여 입찰 응답에 지정할 수 있습니다. 프로토콜에 따라 다음과 같이 입력합니다.

  • OpenRTB: BidResponse.ext.igbid.igbuyer.rsig
  • Google RTB(지원 중단됨): BidResponse.interest_group_bidding.interest_group_buyer.rendering_signals

매크로 접미사가 서로 다른 렌더링 신호의 최대 3개 세트가 포함될 수 있습니다. 를 사용하여 서로 다른 신호를 구별할 수 있습니다. 예를 들어 접미사를 사용하여 광고 소재에만 적용되는 특정 신호 집합을 렌더링 URL의 상응하는 매크로와 일치시켜 데이터 전송 크기를 줄일 수 있습니다.

관심분야 그룹 구매자는 보호 대상 신호가 URL 안전하지 않거나 매크로 접미사가 고유하지 않은 경우 잠재고객 입찰로 이동합니다. 3개 이상의 신호가 제공되는 경우

최대 브라우저 내 입찰가 지정

Protected Audience 제안서를 사용하면 입찰가 계산을 통해 최종 입찰은 기기에서 로컬로 실행됩니다. 이로 인해 최종 입찰의 무결성에 영향을 줄 수 있는 잠재적인 악용 벡터 낙찰가와 같은 결과입니다.

Google에서 RTB 파트너를 위해 Protected Audience API를 테스트하는 동안 지원된 완화 조치로, 각 문맥 입찰 응답에서 예상 최대 입찰가 값을 지정할 수 있습니다. 예상 최대 입찰가는 입찰 함수가 반환할 것으로 예상되는 최대 입찰가입니다. 브라우저 내 입찰에서 보고된 낙찰가가 이 금액을 초과하면 낙찰가가 청구 가능 이벤트로 집계되지 않습니다. 이 접근 방식은 변경될 수 있습니다.

입찰 응답에서 다음 필드를 포함해야 합니다.

  • OpenRTB: BidResponse.igbid.igbuyer.maxbid(CPM 통화 단위로 표시됨)
  • Google RTB 프로토콜(지원 중단됨): BidResponse.interest_group_bidding.interest_group_buyers.max_bid_cpm_micros (microCPM으로 표시됨)
여러 계정에 노출 기여도 부여

입찰자는 다음 필드를 사용하여 관심분야 그룹 입찰 노출의 기여도를 부여할 결제 ID를 선택해야 합니다.

  • OpenRTB: BidResponse.igbid.igbuyer.billing_id
  • Google RTB 프로토콜(지원 중단됨): BidResponse.interest_group_bidding.interest_group_buyers.billing_id

선택한 결제 ID는 입찰 요청에서 사용 가능한 결제 ID여야 합니다.

  • OpenRTB: BidRequest.imp.ext.billing_id
  • Google RTB 프로토콜 (지원 중단됨): BidRequest.adslot.matching_ad_data.billing_id

관심분야 그룹 입찰 노출 기여도를 부여할 결제 ID가 입찰자가 Protected Audience 입찰에 참여하지 않습니다.

하위 계정에는 최대 2개의 결제 ID를 보유할 수 있습니다. 구매자는 문맥별 지출에 하나의 결제 ID를 사용하고 관심분야 그룹 지출에 다른 ID를 사용할 수 있습니다. 2개의 결제 ID를 구성하려면 계정 관리자에게 문의하세요. 을 탭합니다.

청구 ID별로 일일 예산을 설정할 수 있습니다. 담당 고객 지원 담당자에게 계정 관리자가 하위 계정의 결제 ID에 대한 일일 예산을 설정합니다.

노출에 입찰할 수 있는 예산이 있고 지출 기여 분석 선택을 위한 입찰 요청에 표시되는 모든 하위 계정의 결제 ID입니다. 계정 관리자에게 연락하여 관심분야 그룹 결제 ID의 예산을 수정하세요.

브라우저 내 입찰 중

브라우저 내 입찰 생성

generateBid()를 사용하여 브라우저 내 입찰가를 생성합니다.

Google에서는 다음과 같은 매개변수를 제공합니다.

  • auctionSignals: 비어 있음
  • perBuyerSignals: 입찰자가 문맥 응답에서 제공한 것과 동일한 신호의 JavaScript 객체입니다.

다음 매개변수가 반환됩니다.

  • 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에서는 Google의 입찰 응답 확장 프로그램에 있는 InterestGroupBuyer 객체의 새 cur 필드를 사용합니다.

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

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.regs.dsa.required 및 BidRequest.dsa.pubrender 요청 (BidRequest.dsa.dsa_support 및 지원 중단된 각각 BidRequest.dsa.publisher_rendering_support Google RTB 프로토콜)에서 사용할 수 있습니다.

Protected Audience API 입찰에 참여하려는 입찰자가 입찰 요청에서 DSA 투명성이 표시되어야 한다는 신호를 받음 광고가 게재될 때 필요한 정보를 적절히 표시하고 BidResponse.ext.igbid.igbuyer.dsaadrender (BidResponse.interest_group_bidding.interest_group_buyers.dsa_buyer_render인치 더 이상 사용되지 않는 Google RTB 프로토콜도 사용할 수 있습니다. 그렇지 않으면 구매자는 광고주로부터 보호받을 수 있습니다.

디지털 서비스법 광고 투명성에 관한 자세한 내용은 고객센터 도움말: 디지털 서비스법 지원을 참고하세요.

입찰 필터링

Google은 기기 내 입찰 중에 게시자 제어 및 광고 정책을 시행합니다.

브라우저 내 입찰 후

구매자에게 입찰 결과 보고: reportWin()

Google에서는 다음 인수를 채우지 않습니다.

  • auctionSignals
  • sellerSignals

reportWin()를 사용하여 구매자에게 입찰 결과를 보고합니다.

자세한 내용은 Protected Audience API 설명의 렌더링 및 광고 이벤트에 관한 구매자 보고 섹션을 참고하세요.

매크로

Protected Audience API 광고 소재를 참조하는 renderUrl에는 매크로라고 하는 하나 이상의 자리표시자가 포함될 수 있습니다. 관심분야 그룹 입찰이 종료된 후 렌더링 전에 매크로가 상응하는 값으로 대체됩니다. 기기 내 입찰에 사용되는 renderUrl에는 다음이 포함될 수 있습니다. 매크로:

${GDPR} GDPR이 적용되지 않는 경우 0으로, GDPR이 적용되는 경우 1로 확장됩니다. 문서 보기
${GDPR_CONSENT_XXXX} 요청과 연결된 투명성 및 동의(TC) 문자열로 확장됩니다. 투명성 및 동의 (TC) 문자열이 비어 있거나 잘못되어 이 매크로는 확장되지 않습니다.

이 매크로를 사용하여 TC 문자열을 URL의 IAB GVL 등록 공급업체에 전달하세요. XXXX를 IAB GVL에 등록된 IAB GVL ID로 대체 있습니다. TC 문자열이 비어 있거나 잘못되어 있는 경우 이 매크로는 확장되지 않습니다.

삽입한 IAB GVL ID와 연결된 IAB GVL 등록 공급업체가 사용자 동의를 얻지 못하면 ${GDPR_CONSENT_XXXX} 매크로가 포함된 광고 소재는 차단될 수 있습니다.

${GDPR_CONSENT_XXXX} 매크로는 renderUrl 내에서 한 번만 발생해야 합니다.
${ADDL_CONSENT} 추가 요청과 연결된 동의 (AC) 문자열입니다.
${AD_WIDTH}, ${AD_HEIGHT) 이 매크로는 광고 슬롯 너비와 높이를 삽입합니다.
${RENDER_DATA_buyer.origin.example[_OPTIONAL_SUFFIX]}

입찰 응답에 지정된 렌더링 시간 구매자 신호가 포함된 매크로입니다.

buyer.origin.example 자리표시자를 관심분야 그룹 구매자의 출처로 바꿉니다. 이 출처는 입찰 응답의 interest_group_buyers.origin에 해당합니다. _OPTIONAL_SUFFIX를 포함하여 최대 3개의 서로 다른 렌더링 신호 값을 제공할 수 있습니다.

노출수 집계

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 한도에 도달하는 것이 좋습니다. 예를 들어 입찰자 계정이 입찰 요청이 요건을 충족하더라도 Protected Audience 상한에서 auction_environment = SERVER_SIDE_AUCTION (OpenRTB JSON: 0)를 사용하여 입찰 요청을 수신할 수 있습니다. '보호 대상'으로 표시됩니다.

실시간 피드백 및 낙찰을 위한 최소 입찰가

실시간 피드백 수신을 선택한 입찰자는 기기 내 Protected Audience 입찰에 포함하도록 요청된 관심분야 그룹 구매자에 대한 피드백을 받습니다. 입찰자가 은 구매자가 Protected Audience 입찰에 참여하게 됩니다. 관심분야 그룹 구매자 의견 객체에서 다음 정보를 사용할 수 있습니다.

  • 의견 객체의 의견 유형은 INTEREST_GROUP_BUYER_FEEDBACK입니다.
  • 관심분야 그룹 구매자의 출처입니다.
  • 전체 입찰에서 낙찰되기 위해 관심분야 그룹 구매자가 제시해야 하는 최소 입찰가입니다.
  • 낙찰을 받기 위해 관심분야 그룹 구매자가 낙찰받으려는 최소 입찰가 전체 입찰의 서버 측 구성요소에서 가장 높은 순위의 입찰가를 가져옵니다.
  • 관심분야 그룹 구매자의 상태 코드입니다. 가능한 상태 코드는 다음과 같습니다. 정의된 위치 interest-group-buyer-status-codes.txt.

특정 필드 이름은 Authorized Buyers RTB 및 OpenRTB 확장 프로그램의 프로토콜 문서를 참고하세요.

입찰가 의견 알림

Chrome은 Protected Audience API용 임시 디버깅 API를 제공합니다. 이 API를 사용하면 Ad Manager가 Protected Audience 입찰에 대한 의견이 포함된 실시간 서버 간 디버그 알림을 보낼 수 있습니다. 이 알림에는 기존에 입찰한 입찰수에 비해 Protected Audience 인브라우저 입찰과 확인할 수 있습니다.

입찰자는 계정 관리자에게 문의하여 Protected Audience 디버깅 입찰가 의견 알림을 제공하는 데 사용됩니다. 이 정적 URL은 Protected Audience 입찰이 완료된 후 선택한 매크로가 대체된 상태로 Google 서버에서 가져옵니다. 다음 매크로는 지원됨:

  • %%GOOGLE_QUERY_ID%%: 이 매크로는 Protected Audience 지원 문맥 입찰 요청에 전송된 Google 쿼리 ID로 대체됩니다. 포함 지정된 OpenRTB 프로토콜 BidRequest.ext.google_query_id인 반면 지원 중단된 Google RTB는 프로토콜은 BidRequest.google_query_id를 사용합니다.
  • %%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를 테스트하는 방법은 다음과 같습니다.

단계

  1. 요청 양식을 작성하여 Protected Audience API 실험에 참여하세요.
  2. 요청 양식을 제출한 후 계정 관리자 또는 파일에 문의하세요. Authorized Buyer 도움말 중앙으로 이동합니다.
  3. 계정이 구성되면 Google과 파트너 모두 테스트 단계의 단계에 따라 통합을 확인할 수 있습니다.

광고 소재 검토

Protected Audience API 입찰에서 제품 수준 광고(여러 부분으로 구성된 광고)로 입찰하려면 다음 요구사항을 따르세요.

  • 다음을 위한 renderUrl에 &pltd=True 쿼리 매개변수를 포함합니다. 구성요소 광고의 컨테이너 (최상위 renderUrl라고도 함)를 광고 소재 검토 중에 최상위 renderUrls를 구별합니다.
  • 구성요소 광고의 컨테이너가 다음에 해당하는 경우 대표 광고 소재 렌더링 Google의 광고 소재 검토를 위해 가져옵니다 광고가 클릭될 때 반환되어야 하는 경우 Google 광고 소재 검토 시스템에서 설정한 validation=True 쿼리 매개변수

통합 체크리스트

  • 문맥 입찰 응답에 Protected Audience API 관련 필드를 채울 입찰 요청 엔드포인트(예: interest_group_bidding)를 설정합니다.
  • 광고주의 페이지에 태그를 구현하여 사용자의 브라우저가 알 수 있습니다.
  • generateBid() 및 reportWin()를 구현합니다.
  • 관심분야 그룹 소유자 출처를 선택하고 승인된 구매자 계정에 추가합니다.
    • 관심분야 그룹 소유자 출처는 generateBid() 함수가 호스팅되는 출처와 일치해야 합니다.
    • 계정 관리자에게 문의하거나 승인됨 구매자 고객센터를 이 단계를 완료합니다.
  • Protected Audience API와 관련된 인벤토리에 사전 타겟팅 설정하기 있습니다.
  • Creatives API를 통해 검토 및 승인을 위해 광고 소재를 제출합니다.
  • (선택사항) 신뢰할 수 있는 입찰 신호 엔드포인트를 설정합니다.
  • (선택사항) Google 엔지니어가 관심분야 그룹 구매자의 출처에서 소유한 관심분야 그룹에 브라우저를 추가할 수 있는 테스트 광고주 페이지를 설정합니다. 이렇게 하면 Protected Audience 입찰을 수동으로 트리거할 수 있습니다.
  • (선택사항) 계정에서 실시간 피드백을 사용 설정하여 Protected Audience 입찰에 포함하도록 요청된 관심분야 그룹 구매자에 대한 피드백을 수신합니다.
  • (선택사항) 예상치 못한 문제를 디버그하는 데 도움이 되도록 기기 내 Protected Audience 입찰의 입찰 상태에 관한 Protected Audience 입찰가 의견을 제공하는 서버 간 알림을 수신하도록 정적 URL을 구성하려면 계정 관리자에게 문의하세요. 입찰가 의견 보기 알림을 참고하세요.

테스트 단계

1단계: 수동 테스트

다음은 Protected Audience 입찰을 수동으로 트리거하고, 광고를 렌더링할 수 있는지 확인하고, 노출을 기록하는 방법입니다.

  1. Chrome 101 이상을 사용합니다.
  2. 다음을 사용하여 개인 정보 보호 샌드박스 API 및 분리 프레임 사용 설정 chrome://flags/#privacy-sandbox-ads-apis 및 chrome://flags/#enable-fenced-frames 자세한 내용은 개인 정보 보호 테스트하기 샌드박스 입니다.
  3. 승인을 위해 실시간 입찰 사용 API를 참고하세요.
  4. 입찰자가 제공한 광고주 페이지에서 브라우저를 입찰자 소유 관심분야 그룹입니다.

  5. 다음 Google 제공 테스트 게시자 페이지를 사용하여 Protected Audience 입찰을 트리거합니다.

    https://fledge-testing.uc.r.appspot.com/?nid=allow_all

    브라우저 내 관심분야 그룹은 입찰에서 낙찰될 만큼 입찰가가 높아야 합니다. 기존의 서버측 입찰가와 경쟁할 수 있습니다 또한 Google은 각 파트너에게 전용 테스트 게시자 페이지를 제공하며, 여기에서 해당 파트너만 입찰에 참여할 수 있습니다. 파트너별 페이지에서 브라우저 내 입찰을 더 안정적으로 낙찰받을 수 있습니다.

  6. 다음을 확인합니다.

    1. 예상되는 낙찰 광고가 렌더링됩니다.
    2. 입찰 결과가 서버 측으로 전송됩니다. 즉, 낙찰된 입찰자는 reportWin()에서 핑백을 수신합니다.
    3. 테스트 게시자 페이지 콘솔은 각 입찰에 대해 다음 정보가 포함된 디버그 메시지를 로깅합니다.
      • renderUrl: 입찰의 렌더링 URL입니다.
      • interestGroupOwner: 입찰의 관심분야 그룹 소유자입니다.
      • accepted: 입찰가가 수락된 경우 이 필드는 true이고, 입찰가가 수락되면 false입니다. scoreAd()에서 입찰을 거부한 경우입니다.
      • externalBidStatus: 입찰이 scoreAd() 내에 거부된 경우의 상태 코드입니다. 값은 광고 소재 상태임 코드를 참조하세요.

2단계: (선택사항) 렌더링하지 않는 실험

Google과 파트너가 파트너가 다음을 수행할 수 있음을 수동으로 확인한 후 입찰에 참여할 경우 Google은 파트너가 살펴볼 것입니다.

Google은 Protected Audience를 실행하기 위해 소량의 실시간 트래픽을 할당합니다. 입찰할 수 있습니다. 그러면 Google과 파트너가 더 이상 Protected Audience 입찰 Protected Audience 입찰의 결과는 있습니다. 이를 통해 대규모로 통합을 테스트할 수 있습니다.

준비가 되면 계정 관리자에게 문의하거나 공인 구매자 고객센터를 통해 티켓을 제출하세요. Google에서 이 단계에 맞게 계정을 사용 설정합니다.

3단계: 렌더링 실험

Google과 파트너가 렌더링 없이 대규모로 Protected Audience 입찰을 확인한 후에는 Google에서 파트너가 Protected Audience 낙찰 광고를 렌더링하도록 설정할 수 있습니다. Google은 보호 대상일 경우 트래픽이 적은데 잠재고객 입찰을 실행할 수 있으며 낙찰된 관심분야 그룹 광고는 있습니다. 참여 입찰자의 브라우저 내 입찰가가 기존 입찰가와 경쟁합니다.

준비가 되면 계정 관리자에게 문의하거나 공인 구매자 고객센터를 통해 티켓을 제출하세요. Google은 이 단계에서 계정을 사용 설정합니다.

추가 기능

다음 기능은 핵심 프로토콜의 확장 프로그램입니다.

병렬 처리

병렬 처리는 trustedBiddingSignalsUrl에 지정된 구매자 신뢰할 수 있는 서버에 대한 요청과 동시에 문맥 광고 요청을 시작하여 엔드 투 엔드 입찰 지연 시간을 줄이는 최적화입니다.

동시 로드는 지연 시간을 줄이지만 관심분야 그룹에 영향을 미칩니다. 구매자 자격 요건 및 조정 실험 병렬 처리는 기기 내 관심분야 그룹 입찰에 참여하는 모든 입찰자에게 적용됩니다. 입찰자는 병렬 입찰에 참여하기 위해 조치를 취할 필요는 없지만 병렬화가 기기 내 입찰의 자격요건에 어떤 영향을 미칠 수 있는지 숙지해야 합니다. 조정된 실험을 위한 실험 그룹 ID는 아직 지원되지 않습니다. 입찰할 수 있습니다

게재 흐름 요약

다음은 병렬 입찰 흐름을 요약한 것입니다. 흐름도

온디바이스 관심분야 그룹 구매자 자격 요건

병렬 입찰의 경우 navigator.runAdAuction의 호출이 전에 발생합니다. 문맥 광고 응답이 반환됩니다. 구매자가 신뢰할 수 있는 navigator.runAdAuction를 사용하려면 interestGroupBuyers 매개변수는 다음과 같아야 합니다. 값으로 전달되지만 나머지 입찰 매개변수는 자바스크립트를 허용합니다. 문맥 광고 응답 후에 해결될 수 있는 프라미스입니다. 이후 interestGroupBuyers는 문맥 광고 응답 전에 전달됩니다. 문맥 광고 응답 (입찰 응답 포함) 동시에 진행되는 입찰에 참여할 구매자를 선택하는 데 사용할 수 없음 확인할 수 있습니다. 대신 Google의 게시자 태그는 사용자의 브라우저에서 동일한 도메인에서 이전 navigator.runAdAuction 실행의 interestGroupBuyers 매개변수를 캐시합니다.

병렬 처리에는 몇 가지 중요한 고려사항이 있습니다.

  1. 구매자가 신뢰하는 서버 요청에 필요하지 않은 입찰 신호 RTB 입찰 응답에 계속 지정될 수 있음(예: perBuyerSignals) 동일한 방식으로 입찰할 수 있습니다. 이러한 신호에 대한 프로미스가 해결되면 기기 내 입찰은 비동시 입찰과 동일한 방식으로 완료됩니다. 입찰 흐름에 따라 다릅니다.

  2. 병렬화는 관심분야 그룹 구매자 목록을 캐시하는 데 의존하므로 병렬화 캐시가 비어 있거나 만료되었을 수 있으므로 Google에서 항상 병렬 입찰을 실행하지는 않습니다. 캐시가 비어 있거나 만료된 경우 Google은 표준 비병렬 Protected Audience API 입찰을 실행하고 구매자 의도를 사용하여 비병렬 입찰에 참여하여 관심분야 그룹 구매자 캐시를 빌드합니다.

  3. 입찰자에 대해 한 명 이상의 구매자가 현재 게시자에 대해 캐시된 경우 Google은 해당 도메인에 대한 입찰 요청에서 표시됩니다.

    • Google RTB 프로토콜: BidRequest.adslot.interest_group_auction.parallelized
    • OpenRTB: BidRequest.imp.ext.interest_group_auction.parallelized

  4. 특정 입찰자에 대해 등록된 관심분야 그룹 구매자 출처는 병렬 입찰에 포함된 입찰 응답에는 ParallelAuctionBuyer 항목:

    • Google RTB 프로토콜: BidRequest.adslot.interest_group_auction.parallel_auction_buyer
    • OpenRTB: BidRequest.imp.ext.interest_group_auction.pbuyer

  5. 병렬 입찰이 실행 중이지만 특정 구매자 출처가 없는 경우 해당 구매자가 현재의 기기 내 입찰할 수 있습니다. 이는 특정 관심분야 그룹 구매자 출처에 대한 ParallelAuctionBuyer 항목이 없는 parallelized=True가 있는 요청으로 표시됩니다. 그러나 입찰 응답에 유효하고 요건을 충족하는 InterestGroupBuyer를 포함하여 관심을 나타내는 입찰자는 해당 관심분야 그룹 구매자 출처가 캐시에 추가되며 이러한 출처는 동일한 브라우저와 도메인에서 향후 병렬화된 요청을 받을 수 있습니다. 관심분야 그룹 입찰 참여 의사 다음 필드에 표시할 수 있습니다.

    • Google RTB 프로토콜: BidResponse.adslot.interest_group_bidding.interest_group_buyers
    • OpenRTB: BidResponse.ext.igbid.igbuyer

  6. 입찰자가 입찰 응답에 참여할 의도를 나타내지 않은 캐시된 구매자 출처(병렬 입찰의 interestGroupBuyers 매개변수에 포함됨)는 구매자 신뢰할 수 있는 서버 호출을 수신할 수 있지만 병렬 입찰에는 참여하지 않습니다.