Protected Audience API (이전 명칭: FLEDGE)

개인 정보 보호 샌드박스의 일환으로 Chrome은 브라우저 내 API인 Protected Audience 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. 입찰자는 interest_group_bidding 필드가 포함된 BidResponse를 반환합니다. 입찰자가 interest_group_bidding를 지정하지 않으면 Google은 입찰자의 출처를 입찰 구성interestGroupBuyers에 포함하지 않습니다. 입찰 응답에는 interest_group_bidding.per_buyer_signals도 포함될 수 있습니다. per_buyer_signals는 브라우저 내 입찰 중에 입찰자의 입찰 함수에 전달됩니다. 자세한 내용은 입찰 응답 변경사항 섹션을 참고하세요.
  8. Google은 서버 측 입찰을 실행하고 브라우저에 입찰 응답을 반환합니다. 서버 측 입찰에서는 기존의 서버 측 입찰가를 고려합니다. 입찰 응답에는 문맥 낙찰가 (있는 경우)에 대한 정보가 포함될 수 있습니다.
  9. 입찰 응답에는 브라우저 내 입찰을 위한 입찰 구성이 포함되어 있습니다. 여기에는 참여하는 각 구매자의 문맥 시그널(interest_group_bidding.per_buyer_signals를 통해 전송됨), 문맥 낙찰자 정보, 입찰 자격 요건 설정이 포함될 수 있습니다.
  10. Google의 게시자 태그는 Protected Audience API runAdAuction()를 호출하여 기기 내 관심분야 그룹 입찰을 시작합니다. Google은 이전에 입찰 구성에서 interest_group_biddinginterestGroupBuyers로 반환한 구매자만 포함합니다.
  11. Google은 요건을 충족하는 각 입찰자의 per_buyer_signals를 Protected Audience 입찰 구성으로 전달합니다.
  12. 특정 입찰자의 관심분야 그룹에서 trustedBiddingSignalsUrl를 지정한 경우 브라우저는 각 그룹의 trustedBiddingSignalsUrl에 각 그룹의 실시간 신호를 가져오도록 요청합니다. 자세한 내용은 Protected Audience API 사양을 참고하세요.
  13. 브라우저는 선택하고 브라우저 내 입찰에 참여할 수 있는 각 관심분야 그룹에 대해 입찰자의 generateBid()를 호출합니다. 이 단계에서는 입찰가를 계산하고 광고 소재를 선택합니다. generateBid()는 입찰자가 제공하는 per_buyer_signals 및 특정 관심분야 그룹의 신뢰할 수 있는 입찰 신호에 액세스할 수 있습니다.
  14. 브라우저는 판매자 (이 경우 Google)의 scoreAd()를 호출하여 관심분야 그룹 광고 입찰의 각 입찰가에 순위를 할당합니다. 입찰은 게시자 보호 조치, 광고 정책 및 기타 제약 조건에 따라 순위가 지정되고 필터링됩니다.
  15. 브라우저가 요건을 충족하는 관심분야 그룹 입찰가로 입찰을 실행합니다. 최상위 문맥 입찰가는 브라우저 내 입찰에 참여합니다.
  16. 입찰 후에 관심분야 그룹 낙찰자가 있으면 브라우저에서 판매자의 reportResult() 및 입찰자의 reportWin()를 호출하여 각 당사자에게 브라우저 내 입찰의 낙찰자를 알립니다.
  17. 관심분야 그룹 광고가 낙찰되면 Google의 게시자 태그가 광고를 iframe에서 렌더링합니다.

서빙 흐름 세부정보

광고 게재 전

광고 소재 검토

광고 소재는 Protected Audience 브라우저 내 입찰에서 게재되기 전에 Google의 검토 및 승인을 받아야 합니다. 실시간 입찰 API 또는 자동 광고 소재 스캔을 통해 광고 소재를 제출하여 검토를 받을 수 있습니다. Protected Audience 브라우저 내 관심분야 그룹 광고 입찰의 광고 소재에는 검토를 위해 renderUrls가 포함되어야 합니다.

renderUrls 요구사항:

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

입찰자는 실시간 입찰 API를 사용하여 관심분야 그룹 입찰용 광고 소재를 업로드할 수 있습니다.

광고 소재 자동 스캔

입찰자는 Real-timeBidding API를 통해 업로드되지 않은 광고 소재에 대해 자동 광고 소재 스캔을 설정할 수 있습니다.

자동 광고 소재 검사를 설정하면 Google이 브라우저 내 입찰에서 광고 소재를 찾아 자동으로 스캔하므로 향후 입찰에 참여할 수 있습니다.

광고 소재 자동 스캔을 사용 설정하는 방법은 다음과 같습니다.

  • 관심분야 그룹 광고 소재의 모든 renderUrl 출처를 Authorized Buyer 계정에 추가합니다.

  • 다음 맞춤 HTTP 헤더를 광고 소재의 HTTP 응답에 추가합니다.

    Authorized-Buyers-Creative-ID

    문자열

    구매자별 광고 소재 ID입니다. 광고 소재 ID의 최대 길이는 128바이트입니다.

    Authorized-Buyers-Click-Through-URLs

    문자열

    RFC2396에 따라 인코딩된 광고 소재에 대해 선언된 도착 URL 집합입니다.

예:

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일 동안 승인됩니다. Real-timeBidding API를 사용해 광고 소재를 제출하는 경우 15일 후에 광고 소재를 다시 제출해야 합니다. 광고 소재 자동 스캔을 사용하는 경우 스캔 과정에서 자동으로 광고 소재를 다시 스캔합니다.

구매자 보고 ID

구매자가 제공한 측정기준 (예: 캠페인 ID, 광고주 ID)을 사용하여 보고 측정항목 (예: 노출수)을 세분화할 수 있습니다. 관심분야 그룹 지출 측정기준을 추가하려면 사용자의 기기를 관심분야 그룹에 추가할 때 광고의 buyerAndSellerReportingId를 지정합니다. 자세한 내용은 Protected Audience 문서를 참고하세요.

다음은 관심분야 그룹 구성에 buyerAndSellerReportingId를 추가하는 방법의 예입니다.

const myGroup = {
  ...
  'ads': [
    {
      ...
      'buyerAndSellerReportingId':
        '{"google_signals": {"buyer_reporting_id": "12345"}}',
      ...
    }
  ]
}
joinAdInterestGroup(myGroup);

buyer_reporting_id는 Authorized Buyers의 보고 도구에서 새로운 측정기준으로 구매자 보고 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 광고 슬롯 크기 표시

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

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

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

이 크기는 문맥 요청(Adslot.widthAdslot.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 테스트 범위에 속하는 입찰 요청에서 수정되는 소규모 실험을 실행할 수도 있습니다. 이는 서드 파티 쿠키 지원 중단의 잠재적 영향을 평가하기 위한 것입니다.

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

사이트 및 공급업체는 Chrome에서 진행하는 테스트를 사용하여 3PCD에서 시스템을 테스트할 수 있습니다. 테스트에서 Chrome 브라우저는 3PCD 실험 그룹(모드 A 또는 모드 B)에 할당됩니다. 각 브라우저에는 브라우저 내 Chrome API를 통해 액세스할 수 있는 특정 3PCD 실험 그룹에 상응하는 일관된 라벨이 할당됩니다.

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 게시자 태그가 runAdAuction()를 호출할 때 입찰 구성의 interestGroupBuyers에 추가됩니다.

구매자 문맥 신호 전파 (구매자 신호별)

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

  • Google 실시간 입찰: BidResponse.interest_group_bidding.per_buyer_signals
  • OpenRTB: BidResponse.ext.igbid.igbuyer.buyerdata
브라우저 내 최대 입찰가 지정

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

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

입찰 응답에서 다음 필드에 예상 최대 입찰가를 지정할 수 있습니다.

  • Google RTB 프로토콜: BidResponse.interest_group_bidding.interest_group_buyers.max_bid_cpm_micros (microCPM으로 표현됨)
  • 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를 사용하고 관심분야 그룹 지출에 다른 결제 ID를 사용할 수 있습니다. 하위 계정에 두 개의 결제 ID를 구성하려면 계정 관리자에게 문의하세요.

결제 ID별로 일일 예산을 설정할 수 있습니다. 하위 계정의 결제 ID에 대한 일일 예산을 설정하려면 계정 관리자에게 문의하세요.

노출에 입찰할 수 있는 사용 가능한 예산이 있는 모든 하위 계정의 결제 ID가 지출 기여 분석 선택의 입찰 요청에 표시됩니다. 관심분야 그룹 결제 ID의 예산을 수정하려면 계정 관리자에게 문의하세요.

브라우저 내 입찰 중

브라우저 내 입찰 생성

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

Google은 다음 매개변수를 제공합니다.

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

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

  • ad: Google은 이 필드를 무시합니다.
  • bid: 입찰에 참여하는 숫자 입찰가입니다. 마이크로가 아닌 CPM 단위여야 합니다.
  • render: 입찰에서 낙찰되면 광고 소재를 표시하도록 렌더링된 URL입니다. Google에서 이 URL을 검토하고 승인하지 않으면 입찰에서 필터링됩니다.
  • allowComponentAuction: true여야 합니다. Google은 현재 다중 판매자 입찰의 테스트를 지원합니다.

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

function generateBid(...) {
  ...
  return {'ad': 'example',
          'bid': ad.metadata.bid,
          'render': ad.renderUrl,
          'allowComponentAuction': true};
}

generateBid() 함수에 관한 설명은 Protected Audience 사양 기기 내 입찰 섹션을 참고하세요.

입찰 통화

브라우저 내 입찰은 선택된 입찰 통화의 CPM 단위로 배치됩니다.

입찰 통화는 문맥 입찰 응답 및 generateBid의 반환 값에 모두 표시되어야 하며 'USD', 'EUR' 또는 'JPY'와 같은 유효한 ISO 4217 알파 코드여야 합니다.

OpenRTB에서 Google의 입찰 응답 확장에 있는 InterestGroupBuyer 객체의 새 cur 필드를 사용합니다.

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

ext {
  igbid {
    impid: "1"
    igbuyer {
      origin: "https://examplebuyerorigin.com"
      cur: "EUR"
    }
  }
}

Google RTB 프로토콜에서 입찰 응답의 InterestGroupBuyer 메시지에 새 currency 필드를 사용하세요.

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

interest_group_bidding {
  adslot_id: 1
  interest_group_buyer {
    origin: "https://examplebuyerorigin.com"
    currency: "EUR"
  }
}

입찰자의 generateBid 함수는 문맥 입찰 응답에 표시된 것과 동일한 통화로 입찰가를 반환해야 합니다. generateBid의 반환 값에 새 bidCurrency 속성을 입력합니다.

function generateBid(...) {
  ...
  return {'ad': ad,
          'bid': bid,
          'bidCurrency': 'EUR',
          ...};
}

문맥 입찰 응답의 통화가 generateBid에서 반환된 통화와 다르거나 둘 중 하나라도 잘못된 통화를 반환하는 경우 입찰이 입찰 전에 필터링됩니다.

광고 품질 검사

광고 소재 정책 및 게시자 관리 기능 적용은 RTB 파트너를 위한 Protected Audience API 테스트 중에 브라우저 내 관심분야 그룹 입찰에 더 제한될 수 있습니다.

디지털 서비스법 지원

디지털 서비스법 제26조에 따라 게시자는 구매자에게 광고 내 투명성 공개를 표시하도록 요구할 수 있습니다. 게시자가 '구매자에게 EEA 내 사이트 또는 앱에 DSA 투명성 정보가 포함된 광고만 표시하도록 요청' 컨트롤을 사용 설정한 경우, 관심분야 그룹 구매자는 수신된 입찰 요청에서 BidRequest.dsa.dsa_supportBidRequest.dsa.publisher_rendering_support 필드, OpenRTB 프로토콜의 경우 BidRequest.regs.dsa.requiredBidRequest.dsa.pubrender 필드를 확인하여 구매자 투명성을 렌더링하는 데 필요한 기회를 결정할 수 있습니다.

Protected Audience API 입찰에 참여하려는 입찰자가 입찰 요청에서 Protected Audience API를 통해 게재되는 광고에 DSA 투명성을 표시해야 한다는 신호를 수신하면 Google Authorized Buyers 프로토콜의 경우 BidResponse.interest_group_bidding.interest_group_buyers.dsa_buyer_render 또는 OpenRTB 프로토콜의 경우 BidResponse.ext.igbid.igbuyer.dsaadrender를 설정하여 필요한 정보를 적절하게 표시할 수 있는지 평가하고 지정해야 합니다. 그렇지 않으면 구매자가 Protected Audience API 입찰에 포함되지 않습니다.

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

입찰 필터링

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 문자열이 비어 있거나 잘못되어 있는 경우 이 매크로는 확장되지 않습니다.

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

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

노출수 계산

RTB 파트너와 함께 Protected Audience API를 테스트하는 동안 Google은 브라우저가 reportResult() 함수를 호출한 후 sendReportTo() 호출에서 Google의 보고 URL을 가져올 때 노출수를 계산합니다.

Google에서 Protected Audience 브라우저 내 입찰에서 노출수를 계산하는 데 사용하는 이벤트는 RTB 구매자 파트너의 노출수를 계산하는 데 사용되는 이벤트와 다를 수 있으므로 노출수가 다를 수 있습니다.

Protected Audience API를 테스트하는 Google의 목표 중 하나는 이러한 불일치를 식별하고 줄이는 것입니다.

청구 가능 노출수 기여 분석

Protected Audience 브라우저 내 입찰에서 발생한 입찰자의 모든 지출은 입찰자에 대해 구성된 관심분야 그룹 소유자 출처의 매핑을 기반으로 단일 입찰자 계정으로 발생합니다. 입찰자의 서로 다른 하위 시트 계정에 비용을 할당하는 기능은 지원되지 않습니다.

일일 예산 한도

Protected Audience API 테스트 중에 각 계정에는 계정 수준의 Protected Audience 지출 일일 예산 한도가 있습니다. 일일 예산 한도는 브라우저 내 입찰 환경에서 위험을 제한합니다. 일일 예산 한도에 도달하면 계정에서 더 이상 Protected Audience 사용 가능 입찰 요청을 수신하지 않습니다.

계정은 Protected Audience 한도에 도달한 후에도 서버 측 문맥 입찰에 계속 참여할 수 있습니다. 예를 들어 Protected Audience 한도에 도달한 입찰자 계정은 입찰 요청이 Protected Audience 입찰에 적합하더라도 auction_environment = SERVER_SIDE_AUCTION (OpenRTB: 0)를 사용하여 입찰 요청을 수신할 수 있습니다.

실시간 의견 및 낙찰을 위한 최소 입찰가

실시간 의견을 수신하도록 선택한 입찰자는 기기 내 Protected Audience 입찰에 포함되도록 요청된 관심분야 그룹 구매자에 관한 의견을 받습니다. 입찰자가 입찰 응답에 지정하는 각 관심분야 그룹 구매자는 관심분야 그룹 구매자가 Protected Audience 입찰에 입찰하는 수와 관계없이 하나의 의견 객체를 수신합니다. 관심분야 그룹 구매자 의견 객체에서 다음 정보를 확인할 수 있습니다.

  • 의견 객체의 의견 유형은 INTEREST_GROUP_BUYER_FEEDBACK입니다.
  • 관심분야 그룹 구매자의 출처입니다.
  • 전체 입찰에서 낙찰을 받기 위해 관심분야 그룹 구매자가 낙찰받을 수 있는 최소 입찰가입니다.
  • 전체 입찰의 서버 측 구성요소에서 가장 높은 순위의 입찰가를 이기기 위해 관심분야 그룹 구매자를 낙찰받을 수 있는 최소 입찰가입니다.
  • 관심분야 그룹 구매자의 상태 코드입니다. 가능한 상태 코드는 interest-group-buyer-status-codes.txt에 정의됩니다.

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

입찰가 의견 알림

Chrome은 Ad Manager가 Protected Audience 입찰에 관한 의견이 포함된 실시간 서버 간 디버그 알림을 전송할 수 있도록 Protected Audience API를 위한 임시 디버깅 API를 제공합니다. 이 알림에는 아래에 설명된 입찰가에 관한 기타 정보 외에도 Protected Audience 브라우저 내 입찰에서 입찰이 필터링되었을 수 있는 이유가 포함됩니다.

입찰자는 계정 관리자에게 연락하여 Protected Audience 디버깅 입찰가 의견 알림을 전달하는 데 사용될 정적 URL을 구성할 수 있습니다. Protected Audience 입찰이 완료된 후 선택된 매크로가 대체되어 Google 서버에서 이 정적 URL을 가져옵니다. 지원되는 매크로는 다음과 같습니다.

  • %%GOOGLE_QUERY_ID%%: 이 매크로는 Protected Audience가 사용 설정된 문맥 입찰 요청에서 전송된 Google 쿼리 ID(Authorized Buyer 프로토콜의 경우 BidRequest.google_query_id, OpenRTB 프로토콜의 BidRequest.ext.google_query_id)로 대체됩니다.
  • %%INTEREST_GROUP_OWNER%%: 관심분야 그룹 소유자의 출처입니다.
  • %%BID_CPM%%: 구매자가 generateBid() 함수에서 지정한 입찰가(CPM 기준)입니다.
  • %%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에 종속된 임시 기능입니다.

클릭 이벤트

입찰자는 Fenced Frame Reporting API를 사용하여 Protected Audience 광고의 클릭 이벤트를 Google에 보고할 수 있습니다. 입찰자는 click 이벤트 유형을 사용하여 Google에 클릭을 알려야 합니다. 예를 들면 다음과 같습니다.

window.fence.reportEvent({
    'eventType': 'click',
    // Google does not require bidders to send data to Google in 'eventData'.
    // However, 'eventData' must be a non-null value, such as an empty string.
    'eventData': '',
    'destinations': ['direct-seller']
});

제품 수준 TURTLEDOVE

여러 조각으로 구성된 광고 또는 제품 수준 TURTLEDOVE(PLTD)는 Protected Audience API 테스트 중에 Google RTB 파트너에게 지원됩니다. PLTD를 테스트할 계획이라면 통합 과정에서 추가 리소스 및 구성이 필요하므로 계정 관리자에게 알려주세요.

온보딩

Protected Audience API를 테스트하는 방법은 다음과 같습니다.

맞춤설정 단계

  1. 요청 양식을 작성하여 Protected Audience API 실험에 참여합니다.
  2. 요청 양식을 제출한 후 계정 관리자에게 연락하거나 Authorized Buyer 고객센터에서 티켓을 제출하세요.
  3. 계정이 구성되면 Google과 파트너 모두 테스트 단계의 단계를 통해 통합을 확인할 수 있습니다.

광고 소재 검토

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

  • 광고 소재 검토 중에 최상위 renderUrls를 구별할 수 있도록 구성요소 광고의 컨테이너 (최상위 수준 renderUrl이라고도 함)의 renderUrl&pltd=True 쿼리 매개변수를 포함합니다.
  • Google의 광고 소재 검토를 위해 구성요소 광고의 컨테이너를 가져오면 대표적인 광고 소재를 렌더링합니다. 대표적인 광고 렌더링이 언제 반환되어야 하는지 알아보려면 Google 광고 소재 검토 시스템에서 설정한 validation=True 쿼리 매개변수를 참조하세요.

통합 체크리스트

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

테스트 단계

1단계: 수동 테스트

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

  1. Chrome 101 이상을 사용합니다.
  2. chrome://flags/#privacy-sandbox-ads-apischrome://flags/#enable-fenced-frames를 사용하여 Privacy Sandbox API와 Fenced Frame을 사용 설정합니다. 자세한 내용은 개인 정보 보호 샌드박스 테스트를 참고하세요.
  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이고, scoreAd()에서 거부된 경우 false입니다.
      • externalBidStatus: scoreAd() 내에서 입찰이 거부된 경우의 상태 코드입니다. 값은 광고 소재 상태 코드입니다.

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

Google과 파트너가 파트너가 Protected Audience 입찰에 참여할 수 있음을 직접 확인한 후 Google은 파트너의 다음 테스트 단계를 사용 설정합니다.

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

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

3단계: 렌더링 실험

Google과 파트너가 렌더링 없이 대규모로 Protected Audience 입찰을 확인하면 Google은 파트너가 Protected Audience 낙찰 광고를 렌더링할 수 있도록 할 수 있습니다. Google에는 Protected Audience 입찰을 실행할 수 있는 소량의 트래픽이 있으며 낙찰된 관심분야 그룹 광고가 렌더링됩니다. 참여하는 입찰자의 브라우저 내 입찰가는 기존 입찰과 경쟁합니다.

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