Proto 참조 데이터

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

Protos

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

공개 베타 프로토

파일 설명 버전 최종 업데이트
openrtb-adx.proto Google의 OpenRTB 프로토콜에는 별도의 프로토에 제공된 일부 확장 프로그램이 포함되어 있습니다. v.189 2024년 12월 10일
realtime-bidding.proto Google의 Authorized Buyers RTB 프로토콜 Google에서 입찰가를 요청하는 데 사용하는 메시지입니다. BidRequest에는 단일 노출의 광고 슬롯이 포함됩니다. v.342 2024년 10월 31일

참조 데이터

사전(.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 필드에 제공할 표준 입찰 불가 이유 값입니다.
사전 타겟팅 가능한 광고 소재 속성 Buyer REST API에 노출된 PretargetingConfig 리소스의 supportedCreativeAttribute 필드에 사용됩니다. 이 필드는 단일 사전 타겟팅 구성에 해당하는 모든 광고 소재에 표시될 것으로 예상되는 광고 소재 속성을 설명합니다.
게시자가 제외할 수 있는 광고 소재 속성 BidRequest의 excluded_attribute 필드에서 사용됩니다. 이 입력란에는 게시자가 허용하지 않는 광고 소재 유형이 설명됩니다. 예를 들어 쿠키 사용 허용 여부 또는 미디어 또는 텍스트 광고 허용 여부에 관한 제한사항을 지정할 수 있습니다.
게시자 카테고리 BidRequest의 detected_vertical 필드에서 사용됩니다. 이 필드는 광고가 게재될 페이지의 카테고리를 지정합니다 (키워드와 유사). Google은 페이지를 크롤링하고 사용되는 카테고리를 결정하여 이 필드를 생성합니다.
공급업체 BidRequest의 allowed_vendor_type 필드에서 사용됩니다. 이 필드에는 게시자가 지정한 대로 게재되는 광고 소재에 허용되는 리치 미디어 공급업체(예: Campaign Monitor, VoiceFive)가 나열됩니다.

지원 중단된 gdn-vendors.txt 사전 파일의 공급업체를 포함합니다.
데이터 제공업체 BidRequest의 SegmentData.id 필드에서 사용됩니다. 이 입력란에는 게시자 제공 신호를 제공한 법인에 관한 정보가 포함됩니다.

참조 표 (클릭하여 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 파일을 요청합니다.

광고 소재 검토 정책 주제

이 파일의 정책 주제를 사용하여 Real-time Bidding API에서 검토 중에 광고 소재를 필터링할 수 있습니다.

정책 주제를 CSV 파일로 다운로드합니다.

최종 업데이트: 2022년 4월 18일