RTB 프로토콜을 지원하는 파일을 보거나 다운로드합니다.
프로토스
파일 | 설명 | 버전 | 최종 업데이트 |
---|---|---|---|
cookie-bulk-upload.proto | 사용자 타겟팅 데이터를 일괄 업로드하려면 이 메시지를 사용하세요. | v.24 | 2024년 3월 27일 |
openrtb.proto | Google은 JSON 또는 Protobuf 인코딩을 사용하여 OpenRTB 프로토콜을 지원합니다. 이 프로토콜은 OpenRTB/Protobuf를 사용하는 경우에 필요합니다. 또한 지원되는 필드와 Google의 기본 프로토콜에 대한 매핑에 대한 문서도 포함되어 있습니다. | 2.6 | 2024년 3월 23일 |
openrtb-adx.proto | Google의 OpenRTB 프로토콜에는 별도의 프로토콜로 제공되는 일부 확장 프로그램이 포함되어 있습니다. | v.171 | 2024년 4월 17일 |
publisher-settings.proto | 실시간 입찰자 네트워크와 관련된 게시자 설정 모음입니다. | v.13 | 2024년 2월 5일 |
realtime-bidding.proto | Google의 Authorized Buyers RTB 프로토콜입니다. Google에서 입찰을 요청할 때 사용하는 메시지입니다. BidRequest 는 단일 노출의 광고 슬롯을
포함합니다. |
v.325 | 2024년 4월 25일 |
베타 Protos 공개
파일 | 설명 | 버전 | 최종 업데이트 |
---|---|---|---|
openrtb-adx.proto | Google의 OpenRTB 프로토콜에는 별도의 프로토콜로 제공되는 일부 확장 프로그램이 포함되어 있습니다. | v.174 | 2024년 4월 17일 |
realtime-bidding.proto | Google의 Authorized Buyers RTB 프로토콜입니다. Google에서 입찰을 요청할 때 사용하는 메시지입니다. BidRequest 는 단일 노출의 광고 슬롯을
포함합니다. |
v.332 | 2024년 4월 17일 |
참조 데이터
사전 (클릭하여 .txt 파일 다운로드) |
|
---|---|
광고 상품 카테고리 | BidRequest 의 excluded_product_category 필드에 사용됩니다. 이 필드는 게시자가 허용하지 않는 제품 및 서비스의 카테고리를 설명합니다(예: 게시자가 온라인 뱅킹과 관련된 광고를 호스팅하지 않으려는 경우). |
광고 제한 카테고리 | BidRequest 의 allowed_restricted_category 필드와 BidResponse 의 restricted_category 필드에 사용됩니다. allowed_restricted_category 필드는 일반적으로 제한되지만 게시자가 허용하는 것으로 명시적으로 선언한 카테고리(예: 주류 관련 콘텐츠가 포함된 광고)를 설명합니다. |
민감한 광고 카테고리 | BidRequest 의 excluded_sensitive_category 필드와 BidResponse 의 category 필드에 사용됩니다. excluded_sensitive_category 필드는 게시자가 정치와 관련된 광고를 호스팅하지 않으려는 경우와 같이 게시자가 허용하지 않는 민감한 카테고리를 설명합니다. |
광고주 | snippetStatusItem의 advertiser_id 필드에서 사용됩니다. 이 필드는 스니펫과 연결된 광고 소재가 나타내는 광고주를 지정합니다. 이 목록은 거래소의 광고주를 반영하며 특정 구매자가 대표하는 광고주는 반영하지 않습니다. |
브랜드 | Client Access API에서 사용되는 브랜드 목록입니다. |
구매자 선언이 가능한 광고 소재 속성 | BidResponse 의 attribute 필드에 사용됩니다.
이 필드는 BidRequest 의 excluded_attribute 에 표시되어서는 안 되는
광고 소재의 구매자 선언 가능한 속성을
설명합니다. |
콜아웃 상태 코드 | performancereport 메서드 호출에서 반환된 상태 코드입니다. |
콘텐츠 라벨 | BidRequest 의 detected_content_labels 필드에서 사용됩니다. |
쿠키 일치자 상태 코드 | RTB 프로토콜 성능 보고서의 cookieMatcherStatusRate 필드에서 사용됩니다. 사용 가능한 코드는 쿠키 매칭 가이드에 설명되어 있습니다. |
광고 소재 상태 코드 | 사용 기능 creative_status_code 가 실시간 피드백으로 반환됩니다.
|
호스팅된 일치 상태 코드 | RTB 프로토콜 성능 보고서의 hostedMatchStatusRate 필드에서 사용됩니다. |
입찰 이유 없음 | Authorized Buyers 입찰 프로토콜의 BidResponse.no_bid_reason 필드에 제공될 표준 입찰 없는 이유 값입니다.
|
사전 타겟팅 가능한 광고 소재 속성 | 구매자 REST API에 노출된 PretargetingConfig 리소스의 supportedCreativeAttribute 필드에서 사용됩니다. 이 필드는
단일 사전 타겟팅 구성에 해당하는 모든 광고 소재에 있을 것으로 예상되는
광고 소재 속성을 설명합니다. |
게시자 제외 가능한 광고 소재 속성 | BidRequest 의 excluded_attribute 필드에 사용됩니다. 이 필드는 게시자가 허용하지 않는 광고 소재의 유형을
설명합니다. 예를 들어 쿠키 사용 허용 여부 또는 미디어 또는 텍스트 광고 허용 여부에 관한 제한사항을 지정할 수 있습니다. |
게시자 카테고리 | BidRequest 의 detected_vertical 필드에 사용됩니다. 이 필드는 광고가 게재될 페이지의 카테고리 (키워드와
유사)를 지정합니다. Google은 페이지를 크롤링하고 사용되는 카테고리를 확인하여 이 필드를 생성합니다. |
판매자 네트워크 ID | BidRequest 의 seller_network_id 필드에 사용됩니다. 이 필드는 게시자가 속한 판매자 네트워크를
지정합니다. 이 파일의 콘텐츠는 판매자 네트워크 ID 값을 기준으로 오름차순으로 표시됩니다. |
공급업체 | BidRequest 의 allowed_vendor_type 필드에 사용됩니다. 이 필드에는 게시자가 지정한 대로 Campaign Monitor 및 VoiceFive와 같은 게재 중인 광고 소재에 대해 허용된 리치 미디어 공급업체가 나열됩니다. 지원 중단된 |
참조 테이블 (클릭하여 CSV 다운로드) |
|
Android 모바일 앱 | 앱 ID, 카테고리 ID, 사람이 읽을 수 있는 앱 이름과 함께 타겟팅 가능한 Android 모바일 앱 목록입니다. |
지역 표 | BidRequest 의 geo_criteria_id 필드를 디코딩하는 데 사용되는 테이블입니다. 자세한 내용은 지역 타겟팅을
참고하세요. |
LGPD 제공업체 |
LGPD 트래픽에 게재할 수 있는 광고 개인 최적화 제공업체의 목록으로, ID, 사람이 읽을 수 있는 이름, 개인 정보 보호 URL, 제공업체에 귀속될 수 있는 도메인 목록이 포함됩니다. LGPD 시행은 Authorized Buyers 입찰 프로토콜의 BidRequest.adslot.regs_lgpd 필드와 OpenRTB 입찰 프로토콜의 BidRequest.regs.ext.lgpd 필드를 통해 특정 입찰 요청에 표시됩니다.
|
이동통신사 | 이동통신사 목록입니다. |
휴대기기 | 휴대기기 목록입니다. |
모바일 운영체제 | 모바일 운영체제 목록입니다. |
제공자 | 광고 개인 최적화 제공업체 ID를 사람이 읽을 수 있는 이름, 개인정보처리방침 URL, 제공업체가 귀속할 수 있는 도메인 목록에 매핑합니다.
현재 공급업체는 AdX 프로토콜의 경우 BidRequest.AdSlot.consented_providers_settings 필드, OpenRTB 프로토콜의 경우 BidRequest.User.UserExt.consented_providers_settings 필드에서 사용됩니다. 이 필드에 나열된 제공업체는 유럽 경제 지역 내 국가의 사용자를 위해 게시자가 전달한 사용자 동의를 얻었습니다. |
게시자 설정
계정 담당자에게 publisher-settings.pb.gz
파일을 요청합니다.
광고 소재 검토 정책 주제
실시간 입찰 API에서 검토하는 동안 이 파일의 정책 주제를 사용하여 광고 소재를 필터링할 수 있습니다.
정책 주제를 CSV 파일로 다운로드합니다.최종 업데이트: 2022년 4월 18일