RTB 프로토콜을 지원하는 파일을 보거나 다운로드합니다.
Protos
| 파일 | 설명 | 버전 | 최종 업데이트 |
|---|---|---|---|
| cookie-bulk-upload.proto | 이 메시지를 사용하여 사용자 타겟팅 데이터를 일괄 업로드합니다. | v.24 | 2024년 3월 27일 |
| openrtb.proto | Google은 JSON 또는 Protobuf 인코딩을 사용하여 OpenRTB 프로토콜을 지원합니다. OpenRTB/Protobuf를 사용하는 경우 이 프로토가 필요합니다. 또한 지원되는 필드와 Google's 네이티브 프로토콜에 대한 매핑에 관한 문서도 포함되어 있습니다. | 2.6 | 2026년 1월 20일 |
| openrtb-adx.proto | Google의 OpenRTB 프로토콜에는 별도의 프로토에서 제공되는 일부 확장 프로그램이 포함되어 있습니다. | v.207 | 2026년 4월 13일 |
| publisher-settings.proto | 실시간 입찰자 네트워크에 특정한 게시자 설정의 집합입니다. | v.14 | 2024년 2월 5일 |
공개 베타 Protos
| 파일 | 설명 | 버전 | 최종 업데이트 |
|---|---|---|---|
| openrtb-adx.proto | Google의 OpenRTB 프로토콜에는 별도의 프로토에서 제공되는 일부 확장 프로그램이 포함되어 있습니다. | v.215 | 2026년 4월 13일 |
참조 데이터
사전(.txt 파일을 다운로드하려면 클릭) |
|
|---|---|
| 광고 제품 카테고리 | `BidRequest`의 `excluded_product_category` 필드에 사용됩니다. 이 필드는 게시자가 허용하지 않는 제품 및
서비스 카테고리를 설명합니다. 예를 들어 게시자가
온라인 뱅킹과 관련된 광고를 호스팅하지 않으려는 경우입니다. |
| 광고 제한된 카테고리 |
의 allowed_restricted_category 필드와
의 restricted_category 필드에 사용됩니다.BidRequestBidResponse `allowed_restricted_category` 필드는 일반적으로 제한되지만 게시자가 명시적으로 허용된 것으로 선언한 카테고리를 설명합니다. 예를 들어 주류 관련 콘텐츠가 포함된 광고입니다.allowed_restricted_category |
| 광고 민감한 카테고리 |
의 excluded_sensitive_category 필드와
의 category 필드에 사용됩니다.BidRequestBidResponse excluded_sensitive_category
필드는 게시자가 허용하지 않는 민감한 카테고리를 설명합니다.
예를 들어 게시자가
정치와 관련된 광고를 호스팅하지 않으려는 경우입니다. |
| 광고주 | SnippetStatusItem의 advertiser_id 필드에 사용됩니다. 이
필드는 스니펫과 연결된 광고 소재로 표시되는 광고주를 지정합니다. 이 목록은 거래소 전반의 광고주를 반영하며
특정 구매자가 표시하는 광고주를 반영하지 않습니다. |
| 브랜드 | 클라이언트 액세스 API에 사용되는 브랜드 목록입니다. |
| 구매자가 선언할 수 있는 광고 소재 속성 | BidResponse의 attribute 필드에 사용됩니다.
이 필드는 BidRequest의 excluded_attribute에 표시되지 않아야 하는 광고 소재의 구매자가 선언할 수 있는 속성을 설명합니다. |
| 콜아웃 상태 코드 | performancereport 메서드
호출에서 반환되는 상태 코드입니다. |
| 콘텐츠 라벨 | `detected_content_labels` 필드의 `
BidRequest`에 사용됩니다. |
| 쿠키 매처 상태 코드 | RTB 프로토콜
실적 보고서의 cookieMatcherStatusRate 필드에 사용됩니다. 사용 가능한 코드는 쿠키 매칭
가이드에 설명되어 있습니다. |
| 광고 소재 상태 코드 | 사용 기능 creative_status_code 실시간 피드백에서 반환됩니다.
|
| 호스팅된 일치 상태 코드 | RTB 프로토콜
실적 보고서의 hostedMatchStatusRate 필드에 사용됩니다. |
| 입찰하지 않는 이유 | Authorized Buyers 입찰 프로토콜의 BidResponse.no_bid_reason 필드에 제공할 표준 입찰하지 않는 이유 값입니다. |
| 사전 타겟팅 가능한 광고 소재 속성 | 구매자 REST API에 노출된 PretargetingConfig 리소스의 supportedCreativeAttribute 필드에 사용됩니다. 이 필드는
단일 사전 타겟팅 구성에 해당하는 모든 광고 소재에 있어야 하는 광고 소재 속성을 설명합니다. |
| 게시자가 제외할 수 있는 광고 소재 속성 | `BidRequest`의 `excluded_attribute` 필드에 사용됩니다. 이 필드는 게시자가 허용하지 않는 광고 소재 유형을 설명합니다. 예를 들어 쿠키 사용이 허용되는지 또는 미디어 및/또는 텍스트
광고가 허용되는지에 관한 제한사항을 지정할 수 있습니다. |
| 공급업체 | `BidRequest`의 `allowed_vendor_type` 필드에 사용됩니다. 이 필드에는 게시자가 지정한 대로 게재되는 광고 소재에 허용되는 리치 미디어 공급업체(예:
Campaign Monitor, VoiceFive)가 나열됩니다. 지원 중단된
|
| 데이터 제공업체 | `
`의 `SegmentData.id` 필드에 사용됩니다.BidRequest 이 필드에는
게시자 제공 신호를 제공한 법인에 관한 정보가 포함되어 있습니다. |
참조 표 (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일