Proto 참조 데이터

RTB 프로토콜을 지원하는 파일을 보거나 다운로드합니다.

프로토스

파일 설명 버전 최종 업데이트
cookie-bulk-upload.proto 사용자 타겟팅 데이터를 일괄 업로드하려면 이 메시지를 사용하세요. v.23 2024년 1월 12일
openrtb.proto Google은 JSON 또는 Protobuf 인코딩을 사용하여 OpenRTB 프로토콜을 지원합니다. 이 프로토콜은 OpenRTB/Protobuf를 사용하는 경우에 필요합니다. 또한 지원되는 필드와 Google의 기본 프로토콜에 대한 매핑에 대한 문서도 포함되어 있습니다. 2.6 2024년 3월 23일
openrtb-adx.proto Google의 OpenRTB 프로토콜에는 별도의 프로토콜로 제공되는 일부 확장 프로그램이 포함되어 있습니다. v.169 2024년 3월 23일
publisher-settings.proto 실시간 입찰자 네트워크와 관련된 게시자 설정 모음입니다. v.13 2024년 2월 5일
realtime-bidding.proto Google의 Authorized Buyers RTB 프로토콜입니다. Google에서 입찰을 요청할 때 사용하는 메시지입니다. BidRequest는 단일 노출의 광고 슬롯을 포함합니다. v.322 2024년 3월 13일

베타 Protos 공개

파일 설명 버전 최종 업데이트
openrtb-adx.proto Google의 OpenRTB 프로토콜에는 별도의 프로토콜로 제공되는 일부 확장 프로그램이 포함되어 있습니다. v.172 2024년 3월 23일
realtime-bidding.proto Google의 Authorized Buyers RTB 프로토콜입니다. Google에서 입찰을 요청할 때 사용하는 메시지입니다. BidRequest는 단일 노출의 광고 슬롯을 포함합니다. v.329 2024년 3월 14일

참조 데이터

사전 (클릭하여 .txt 파일 다운로드)

광고 상품 카테고리 BidRequestexcluded_product_category 필드에 사용됩니다. 이 필드는 게시자가 허용하지 않는 제품 및 서비스의 카테고리를 설명합니다(예: 게시자가 온라인 뱅킹과 관련된 광고를 호스팅하지 않으려는 경우).
광고 제한 카테고리 BidRequestallowed_restricted_category 필드와 BidResponserestricted_category 필드에 사용됩니다. allowed_restricted_category 필드는 일반적으로 제한되지만 게시자가 허용하는 것으로 명시적으로 선언한 카테고리(예: 주류 관련 콘텐츠가 포함된 광고)를 설명합니다.
민감한 광고 카테고리 BidRequestexcluded_sensitive_category 필드와 BidResponsecategory 필드에 사용됩니다. excluded_sensitive_category 필드는 게시자가 정치와 관련된 광고를 호스팅하지 않으려는 경우와 같이 게시자가 허용하지 않는 민감한 카테고리를 설명합니다.
광고주 snippetStatusItem의 advertiser_id 필드에서 사용됩니다. 이 필드는 스니펫과 연결된 광고 소재가 나타내는 광고주를 지정합니다. 이 목록은 거래소의 광고주를 반영하며 특정 구매자가 대표하는 광고주는 반영하지 않습니다.
브랜드 Client Access API에서 사용되는 브랜드 목록입니다.
구매자 선언이 가능한 광고 소재 속성 BidResponseattribute 필드에 사용됩니다. 이 필드는 BidRequestexcluded_attribute에 표시되어서는 안 되는 광고 소재의 구매자 선언 가능한 속성을 설명합니다.
콜아웃 상태 코드 performancereport 메서드 호출에서 반환된 상태 코드입니다.
콘텐츠 라벨 BidRequestdetected_content_labels 필드에서 사용됩니다.
쿠키 일치자 상태 코드 RTB 프로토콜 성능 보고서의 cookieMatcherStatusRate 필드에서 사용됩니다. 사용 가능한 코드는 쿠키 매칭 가이드에 설명되어 있습니다.
광고 소재 상태 코드

사용 기능

creative_status_code실시간 피드백으로 반환됩니다.
호스팅된 일치 상태 코드 RTB 프로토콜 성능 보고서의 hostedMatchStatusRate 필드에서 사용됩니다.
입찰 이유 없음 Authorized Buyers 입찰 프로토콜의 BidResponse.no_bid_reason 필드에 제공될 표준 입찰 없는 이유 값입니다.
사전 타겟팅 가능한 광고 소재 속성 구매자 REST API에 노출된 PretargetingConfig 리소스의 supportedCreativeAttribute 필드에서 사용됩니다. 이 필드는 단일 사전 타겟팅 구성에 해당하는 모든 광고 소재에 있을 것으로 예상되는 광고 소재 속성을 설명합니다.
게시자 제외 가능한 광고 소재 속성 BidRequestexcluded_attribute 필드에 사용됩니다. 이 필드는 게시자가 허용하지 않는 광고 소재의 유형을 설명합니다. 예를 들어 쿠키 사용 허용 여부 또는 미디어 또는 텍스트 광고 허용 여부에 관한 제한사항을 지정할 수 있습니다.
게시자 카테고리 BidRequestdetected_vertical 필드에 사용됩니다. 이 필드는 광고가 게재될 페이지의 카테고리 (키워드와 유사)를 지정합니다. Google은 페이지를 크롤링하고 사용되는 카테고리를 확인하여 이 필드를 생성합니다.
판매자 네트워크 ID BidRequestseller_network_id 필드에 사용됩니다. 이 필드는 게시자가 속한 판매자 네트워크를 지정합니다. 이 파일의 콘텐츠는 판매자 네트워크 ID 값을 기준으로 오름차순으로 표시됩니다.
공급업체 BidRequestallowed_vendor_type 필드에 사용됩니다. 이 필드에는 게시자가 지정한 대로 Campaign Monitor 및 VoiceFive와 같은 게재 중인 광고 소재에 대해 허용된 리치 미디어 공급업체가 나열됩니다.

지원 중단된 gdn-vendors.txt 사전 파일의 공급업체가 포함됩니다.

참조 테이블 (클릭하여 CSV 다운로드)

Android 모바일 앱 앱 ID, 카테고리 ID, 사람이 읽을 수 있는 앱 이름과 함께 타겟팅 가능한 Android 모바일 앱 목록입니다.
지역 표 BidRequestgeo_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일