Proto 참조 데이터

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

프로토스

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

공개 베타 프로토스

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

참조 데이터

사전 (클릭하여 .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은 페이지를 크롤링하고 사용되는 카테고리를 확인하여 이 필드를 생성합니다.
공급업체 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 파일을 요청합니다.

광고 소재 검토 정책 주제

이 파일의 정책 주제를 사용하여 실시간 입찰 API의 검토 중에 광고 소재를 필터링할 수 있습니다.

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

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