RTB 프로토콜을 지원하는 파일을 보거나 다운로드합니다.
Protos
| 파일 | 설명 | 버전 | 최종 업데이트 |
|---|---|---|---|
| cookie-bulk-upload.proto | 이 메시지를 사용하여 사용자 타겟팅 데이터를 일괄 업로드합니다. | v.24 | 2024년 3월 27일 |
| openrtb.proto | Google은 JSON 또는 Protobuf 인코딩을 사용하여 OpenRTB 프로토콜을 지원합니다. OpenRTB/Protobuf를 사용하는 경우 이 프로토가 필요합니다. 또한 지원되는 필드와 Google의 네이티브 프로토콜에 대한 매핑에 관한 문서도 포함됩니다. | 2.6 | 2025년 8월 12일 |
| openrtb-adx.proto | Google의 OpenRTB 프로토콜에는 별도의 프로토에 제공되는 일부 확장 프로그램이 포함되어 있습니다. | v.196 | 2025년 9월 4일 |
| publisher-settings.proto | 실시간 입찰자 네트워크에 특화된 게시자 설정입니다. | v.14 | 2024년 2월 5일 |
공개 베타 프로토
| 파일 | 설명 | 버전 | 최종 업데이트 |
|---|---|---|---|
| openrtb-adx.proto | Google의 OpenRTB 프로토콜에는 별도의 프로토에 제공되는 일부 확장 프로그램이 포함되어 있습니다. | v.203 | 2025년 9월 4일 |
참조 데이터
사전(.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 필드에서 사용됩니다. 이 필드는 스니펫과 연결된 광고 소재로 표시되는 광고주를 지정합니다. 이 목록은 거래소의 광고주를 반영하며 특정 구매자가 대표하는 광고주는 반영하지 않습니다. |
| 브랜드 | 클라이언트 액세스 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의 allowed_vendor_type 필드에서 사용됩니다. 이 필드에는 게시자가 지정한 대로 게재되는 광고 소재에 허용되는 리치 미디어 공급업체(예: Campaign Monitor, VoiceFive)가 나열됩니다. 지원 중단된 |
| 데이터 제공업체 | BidRequest의 SegmentData.id 필드에서 사용됩니다. 이 필드에는 게시자 제공 신호를 제공한 법인에 관한 정보가 포함됩니다. |
참조 표 (클릭하여 CSV 다운로드) |
|
| Android 모바일 앱 | 타겟팅 가능한 Android 모바일 앱의 목록입니다. 앱 ID, 카테고리 ID, 사람이 읽을 수 있는 앱 이름이 포함됩니다. |
| 지역 테이블 | 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일