네이티브 광고는 주변 콘텐츠와 시각 디자인에 맞게 형식을 지정하여 사용자가 보고 클릭할 가능성이 더 높은 광고입니다. 네이티브 광고 인벤토리는 모바일 앱은 물론 데스크톱 및 모바일 웹사이트에서도 사용할 수 있습니다. 네이티브 광고에 관한 자세한 내용은 네이티브 광고 개요를 참고하세요.
네이티브 광고는 Authorized Buyers와 공개 입찰에서 모두 지원됩니다.
다음은 네이티브 광고의 워크플로입니다.
- Google에서 네이티브 광고를 호출합니다. 호출하면 다음 네이티브 광고 템플릿 중 하나 또는 둘 다 지정되며, 각각 선호하는 네이티브 필드를 지정합니다.
- Google에서 구매자에게 요청한 필드 목록이 포함된 RTB 입찰 요청을 보냅니다.
- 관심이 있는 구매자가 요청한 필드를 사용하여 응답합니다.
- Google에서 입찰을 실행하여 낙찰자를 선정하고 구매자 제공 광고 애셋을 게시자에게 보냅니다.
- 게시자가 애셋을 네이티브 광고로 조합하고 사이트 디자인에 맞게 스타일을 지정합니다.
메시지 형식
Google은 JSON과 Protobuf에서 모두 OpenRTB 사양을 지원합니다.
OpenRTB Protobuf 네이티브 광고의 경우 다음 필드가 사양과 다릅니다.
| JSON | JSON 유형 | Protobuf | Protobuf 유형 |
|---|---|---|---|
BidRequest.imp[].native.request |
string |
BidRequest.imp[].native.request_native |
NativeRequest |
BidResponse.seatbid[].bid[].adm |
string |
BidResponse.seatbid[].bid[].adm_native |
NativeResponse |
OpenRTB Protobuf 필드는 문자열이 아닌 Protobuf 메시지입니다.
OpenRTB Protobuf 구현을 사용하는 경우 엔드포인트는 BidRequest.imp.native.request가 아닌 BidRequest.imp.native.request_native가 포함된 입찰 요청을 수신합니다. 또한 엔드포인트는 BidResponse.seatbid.bid.adm가 아닌 BidResponse.seatbid.bid.adm_native를 채우는 입찰 응답을 반환해야 합니다. 그러지 않으면 입찰에서 필터링됩니다.
구매자 SDK를 사용하여 네이티브 광고를 렌더링하는 경우 검토를 위해 광고 소재를 제출할 때 declared_ad에 이미지 type를 포함해야 합니다.
네이티브 광고 템플릿
네이티브 광고 템플릿은 네이티브 광고의 구성요소를 설명하고 입찰 요청에서 OpenRTB의 NativeRequest 또는 지원 중단된 Google RTB 프로토콜의 NativeAdTemplate의 콘텐츠와 구조를 결정합니다. Google에서는 동영상 외 네이티브 광고와 동영상 네이티브 광고에 가장 일반적인 두 가지 네이티브 광고 템플릿을 지원합니다.
- 앱 설치 광고 템플릿: 모바일 앱 설치를 홍보하고 유도합니다.
- 콘텐츠 광고 템플릿: 브랜드 또는 웹 광고용으로 텍스트와 이미지를 더 일반적으로 조합합니다.
- 동영상 앱 설치 광고 템플릿
- 동영상 콘텐츠 광고 템플릿
다른 템플릿도 있으며 필드, 측정기준, 크기에 대한 요구사항이 다를 수 있습니다.
앱 설치 광고 템플릿
필수 및 추천 필드
다음 표에는 필수 또는 권장으로 라벨이 지정된 필드가 표시됩니다. 다음 규칙이 적용됩니다.
- 필수로 표시된 입력란은 입찰자가 입력해야 합니다.
- 권장으로 표시된 필드는 입찰자에게 필수가 아니며 게시자는 제공된 경우 이를 표시하거나 표시하지 않을 수 있습니다 (예: 별표 평점).
- 입찰자가 클릭 유도 문안을 전송하지 않으면 기본값이 할당되므로 클릭 유도 문안 (CTA)은 항상 권장으로 표시되지만 전송된 경우에는 항상 표시됩니다.
다음 표에는 앱 설치 광고 템플릿의 필드가 나와 있습니다. 모바일 앱은 이러한 필드를 사용하여 네이티브 앱 설치 광고를 만듭니다.
| 필드 | 설명 | 필수사항인가요, 권장사항인가요? | 항상 표시되나요? | 권장 이미지 크기/최대 문자 수 | 예 |
|---|---|---|---|---|---|
| 광고 제목 | 앱 제목 | 필수 | 예 | 25자(영문 기준) | Flood-It! |
| 이미지 | 앱의 스크린샷 또는 기타 관련 이미지 | 필수 | 아니요 | 게시자가 요구하는 가로세로 비율에 따라 1,200x627픽셀 또는 600x600픽셀 | <Flood-It! 게임의 스크린샷> |
| 본문 | 앱의 기본 텍스트 | 필수 | 아니요 | 90자 | 기만적으로 단순하면서도 도전적인 게임으로 중독성이 있습니다. |
| 앱 아이콘 | 앱 아이콘 | 필수 | 아니요 | 128 x 128 px | <Flood-it! 앱 아이콘> |
| 클릭 유도 문구 | 선호하는 사용자 작업 | 추천 | 예 | 15자 | 설치 |
| 별표 평점 | 앱 스토어의 앱 평점을 나타내는 별표 수 (0~5개) | 추천 | 아니요 | 0~5 | 4.5 |
| 가격 | 앱 비용 | 추천 | 아니요 | 15자 | 무료 |
텍스트 길이 관련 참고사항
구매자가 권장 최대 글자 수보다 긴 텍스트 애셋 (예: 본문 텍스트)을 전송하는 경우 Google 또는 게시자에 의해 텍스트가 잘리고 생략될 수 있습니다. 중국어, 일본어, 한국어에서는 자르기 한도가 절반입니다. 예를 들어 제목 한도가 영어에서 90이면 중국어에서는 45입니다.
이미지 크기 관련 메모
게시자는 다음 작업을 할 수 있습니다.
- 기본 이미지를 한 측정기준 (높이 또는 너비)에서 최대 20% 까지 대칭적으로 자릅니다.
- 가로세로 비율을 변경하지 않고 이미지 크기를 조정합니다.
- 높이와 너비에서 암시하는 가로세로 비율과 크게 다른 이미지는 필터링될 수 있습니다.
콘텐츠 광고 템플릿
다음 표에는 콘텐츠 광고 템플릿의 필드가 나와 있습니다. 게시자는 이 입력란을 사용하여 네이티브 콘텐츠 광고를 만듭니다.
| 필드 | 설명 | 필수사항인가요, 권장사항인가요? | 항상 표시되나요? | 권장 이미지 크기/최대 문자 수 * | 예 |
|---|---|---|---|---|---|
| 광고 제목 | 광고 헤더 | 필수 | 예 | 25자(영문 기준) | 최저 주택담보대출 금리 |
| 이미지 | 광고의 기본 이미지 | 필수 | 아니요 | 게시자가 요구하는 가로세로 비율에 따라 1,200x627픽셀 또는 600x600픽셀 | <광고의 기본 이미지> |
| 본문 | 광고 콘텐츠 | 필수 | 아니요 | 90자 | 생각보다 저렴하고 빠르게 브루클린에 집을 마련하세요. |
| 로고 | 광고주 로고 또는 기타 관련성 높은 작은 이미지 | 추천 | 아니요 | 128 x 128 px | <NY Mortgage Inc. 로고> |
| 클릭 유도 문구 | 사용자가 선호하는 작업 | 추천 | 아니요 | 15자 | 견적 받기 |
| 광고주 | 광고주 또는 브랜드를 식별하는 텍스트 | 필수 | 아니요 | 25자(영문 기준) | NY Mortgage Inc. |
동영상 앱 설치 광고 템플릿
| 필드 | 설명 | 필수사항인가요, 권장사항인가요? | 항상 표시되나요? | 권장 이미지 크기/최대 문자 수 * | 예 |
|---|---|---|---|---|---|
| 동영상 | 동영상 광고를 재생하기 위해 필요한 모든 애셋을 포함한 동영상 VAST 응답입니다. | 필수 | 아니요 | - | Flood-It! 동영상 광고 |
| 광고 제목 | 앱 제목 | 필수 | 예 | 25자(영문 기준) | Flood-It! |
| 이미지 | 동영상 광고를 클릭하기 전이나 로딩 중에 플레이어에 표시되는 이미지 (썸네일)입니다. | 필수 | 아니요 | 동영상의 가로세로 비율과 일치해야 함 (예: 16x9 동영상의 경우 1280x720, 640x480 동영상의 경우 4x3) | Flood-It! 게임의 스크린샷 또는 동영상에서 |
| 본문 | 앱의 기본 텍스트 | 필수 | 아니요 | 90자 | 단순해 보이지만 도전적인 게임으로 중독성이 있습니다. |
| 앱 아이콘 | 앱 아이콘 | 필수 | 아니요 | 128 x 128 px | Flood-it! 앱 아이콘 |
| 클릭 유도 문구 | 선호하는 사용자 작업 | 필수 | 예 | 15자 | 설치 |
| 별표 평점 | 앱 스토어의 앱 평점을 나타내는 별표 수 (0~5개) | 추천 | 아니요 | 0~5 | 4.5 |
| 가격 | 앱 비용 | 추천 | 아니요 | 15자 | 무료 |
제한사항
동영상: 모든 동영상은 VAST URL 또는 VAST 태그 형식이어야 합니다. WebM, MP4와 같은 원시 동영상 파일은 지정할 수 없습니다.
텍스트 길이: 구매자가 응답에서
body와 같은 텍스트 애셋을 지정하면 Google 또는 게시자에 의해 일부가 잘리고 생략될 수 있습니다. 중국어, 일본어, 한국어에서는 자르기 한도가 절반입니다. 예를 들어 제목 한도가 영어에서 90이면 중국어에서는 45입니다.이미지 크기: 게시자는 다음을 할 수 있습니다.
- 기본 이미지를 한 측정기준 (높이 또는 너비)에서 최대 20% 까지 대칭으로 자릅니다.
- 가로세로 비율을 변경하지 않고 이미지 크기를 조정합니다.
앱 설치 광고의 예
동영상 콘텐츠 광고 템플릿
| 필드 | 설명 | 필수사항인가요, 권장사항인가요? | 항상 표시되나요? | 권장 이미지 크기/최대 문자 수 * | 예 |
|---|---|---|---|---|---|
| 동영상 | 동영상 광고를 재생하기 위해 필요한 모든 애셋을 포함한 동영상 VAST 응답입니다. | 필수 | 예 | - | Flood-It! 동영상 광고 |
| 광고 제목 | 광고 헤더 | 필수 | 예 | 25자(영문 기준) | 최저 주택담보대출 금리 |
| 이미지 | 동영상 광고를 클릭하기 전이나 로딩 중에 플레이어에 표시되는 이미지 (썸네일)입니다. | 필수 | 아니요 | 동영상의 가로세로 비율과 일치해야 함 (예: 16x9 동영상의 경우 1280x720, 640x480 동영상의 경우 4x3) | 동영상의 스크린샷 |
| 본문 | 광고 콘텐츠 | 필수 | 아니요 | 90자 | 생각보다 저렴하고 빠르게 브루클린에 집을 마련하세요. |
| 로고 | 광고주 로고 또는 기타 관련성 높은 작은 이미지 | 추천 | 아니요 | 128 x 128 px | NY Mortgage Inc. 로고 |
| 클릭 유도 문구 | 사용자가 선호하는 작업 | 필수 | 아니요 | 15자 | 견적 받기 |
| 광고주 | 광고주 또는 브랜드를 식별하는 텍스트 | 필수 | 아니요 | 25자(영문 기준) | NY Mortgage Inc. |
메타 필드
다음 메타 필드는 지원되는 모든 광고 템플릿에서 공유됩니다.
| Google RTB 프로토콜 | OpenRTB 등가 항목 | 설명 |
|---|---|---|
NativeAd.click_link_url |
Link.url |
사용자가 광고를 클릭할 때 브라우저에서 호출하는 URL입니다.
결국 방문 페이지로 연결되는 리디렉션 체인의 첫 번째 단계일 수 있습니다. 네이티브 광고의 경우 사용자가 최종적으로 이동할 대상을 설정하는 필드로 click_link_url을 사용하는 것이 좋습니다. 동적 방문 페이지의 경우 이 필드를 사용해야 합니다. |
Ad.click_through_url |
Bid.adomain |
입찰자가 입찰할 의도가 있는 경우 설정해야 합니다. 이는 스니펫의 도착 URL 집합으로, 사용자가 표시된 광고를 클릭할 때 이동하는 URL과 렌더링된 광고에 표시되는 모든 URL을 포함합니다. 최종 방문 페이지와 관련 없는 광고 서버에 대한 중간 호출은 포함하지 마세요. 스니펫 또는 동영상 광고를 반환하지만 비 네이티브 광고의 경우 클릭 추적이나 기타 광고 기능에 사용되지 않으며 도착 URL 선언으로만 사용됩니다. 네이티브 광고의 경우 |
NativeAd.click_tracking_urls |
Link.clicktrackers |
선택사항입니다. 광고주가 광고의 사용자 클릭을 추적할 수 있는 추가 URL입니다. |
Ad.ad_choices_destination_url |
BidExt.ad_choices_destination_url |
광고 환경설정 또는 거부 페이지 링크 있는 경우 네이티브 광고 소재에 표준 AdChoices 아이콘이 추가되며 이 URL에 연결됩니다. 이는 네이티브 광고에 지원되지만 입찰 응답의 네이티브 메시지에는 포함되지 않습니다. |
Ad.impression_tracking_url |
NativeResponse.imptrackers |
네이티브 노출은 Authorized Buyers 실시간 입찰 프로토의 impression_tracking_url 또는 OpenRTB의 네이티브 imptracker로 추적해야 합니다. |
Google RTB 프로토콜 필수 및 권장 필드
required_fields 및 recommended_fields는 게시자가 지정합니다. 이러한 비트 필드를 변환하여 필드가 필수인지 권장사항인지 확인하는 방법을 보여줍니다.
비트 필드는 바이너리 값의 각 비트를 사용하여 true 또는 false 문을 저장합니다. 이는 is_logo_required 또는 is_header_required와 같은 여러 불리언 신호를 전송하는 것과 같지만 모두 함께 압축됩니다.
예
이 예에서는 required_fields 값으로 1085를 사용합니다.
먼저 상응하는 바이너리 값을 찾습니다.
10000111101
바이너리 값을 얻은 후 비트를 확인하여 필드가 필수인지 (1) 아니면 필수가 아닌지 (0) 확인할 수 있습니다.
다음 표는 필드를 바이너리 값의 위치에 매핑합니다. 이진 값에서 가장 오른쪽 자리에 해당하는 1비트를 사용하여 이진수를 오른쪽에서 왼쪽으로 읽습니다.
| 필드 | 바이너리 값 배치 (오른쪽에서 왼쪽) |
|---|---|
HEADLINE |
1 |
BODY |
2 |
CALL_TO_ACTION |
4 |
ADVERTISER |
8 |
IMAGE |
16 |
LOGO |
32 |
APP_ICON |
64 |
STAR_RATING |
128 |
PRICE |
256 |
STORE |
512 |
VIDEO |
1024 |
이진 값 10000111101의 예를 보면 1비트(가장 오른쪽)가 1로, 필수 값을 나타냅니다. 표에 따르면 1비트는 HEADLINE에 해당합니다.
2비트 (오른쪽에서 두 번째 값)는 0로, 필요하지 않음을 나타냅니다. 2비트는 BODY에 해당합니다.
다음은 이 예시에서 해석된 모든 필수 입력란입니다.
| 값 | 설명 | 필수 여부 |
|---|---|---|
1 |
VIDEO |
예 |
0 |
STORE |
아니요 |
0 |
PRICE |
아니요 |
0 |
STAR_RATING |
아니요 |
0 |
APP_ICON |
아니요 |
1 |
LOGO |
예 |
1 |
IMAGE |
예 |
1 |
ADVERTISER |
예 |
1 |
CALL_TO_ACTION |
예 |
0 |
BODY |
아니요 |
1 |
HEADLINE |
예 |
입찰 요청의 네이티브 광고 템플릿 표현
네이티브 인벤토리가 포함된 입찰 요청을 수신하면 사용되는 프로토콜에 따라 다양한 형식의 네이티브 광고 템플릿이 포함됩니다. Google 프로토콜은 지원 중단되었으므로 OpenRTB를 사용하는 것이 좋습니다.
OpenRTB에서 네이티브 광고 템플릿은 NativeRequest 메시지로 설명됩니다. Google RTB 프로토콜에서는 NativeAdTemplate로 설명됩니다. 이러한 메시지는 네이티브 광고 인벤토리에 관한 다음 세부정보를 제공합니다.
- 필수 또는 권장 필드
- 이미지, 로고, 앱 아이콘의 크기입니다.
- 광고가 렌더링되는 스타일의 사양입니다.
OpenRTB 확장 소재 ID
OpenRTB는 응답에서 반환해야 하는 네이티브 광고의 구조를 설명하는 애셋 배열을 입찰 요청에 전달합니다. 요청의 각 애셋에는 응답에서 해당 애셋에 지정해야 하는 ID가 있습니다. 이러한 ID가 요청과 응답 간에 어떻게 일치하는지 알아보려면 네이티브 입찰 요청 샘플 및 네이티브 입찰 응답 샘플을 참고하세요.
입찰 응답에서 네이티브 광고의 표현
네이티브 인벤토리에 입찰할 때 구매자는 입찰 요청에서 확인된 필수 입력란을 채워야 합니다. OpenRTB에서는 Protobuf를 사용할 때는 BidResponse.seatbid.bid.adm_native를 사용하고 JSON의 경우 BidResponse.seatbid.bid.adm를 사용하여 이를 수행할 수 있습니다. 지원 중단된 Google 프로토콜의 경우 BidResponse.ad.native_ad 필드를 사용하여 이 작업을 실행합니다.
입찰 요청 예시
비동영상 입찰 요청
예 보기
직렬화된 요청id: "l6210s8bS8Uc726V81B821" imp { id: "1" tagid: "3019814809" bidfloor: 0.06 bidfloorcur: "USD" secure: true native { ver: "1.2" request_native { ver: "1.2" assets { id: 1 required: true title { len: 25 } } assets { id: 2 required: true data { type: DESC len: 90 } } assets { id: 3 data { type: CTATEXT len: 15 } } assets { id: 4 required: true img { type: MAIN wmin: 1200 hmin: 627 } } assets { id: 5 img { type: LOGO wmin: 100 hmin: 100 } } eventtrackers { event: IMPRESSION methods: IMG } privacy: true [com.google.doubleclick.native_ext] { style_id: 497439 style_height: 1 style_width: 1 style_layout_type: FLUID } } } exp: 3600 metric { type: "click_through_rate" value: 0.0006697923527099192 vendor: "EXCHANGE" } metric { type: "viewability" value: 0.05 vendor: "EXCHANGE" } [com.google.doubleclick.imp] { billing_id: 50577321529 dfp_ad_unit_code: "/3711494/google/test" ampad: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED buyer_generated_request_data { data: "Test Data" } excluded_creatives { buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID" } excluded_creatives { buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID" } open_bidding { is_open_bidding: true } creative_enforcement_settings { policy_enforcement: POLICY_ENFORCEMENT_PLATFORM_POLICY publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_OVERRIDDEN } auction_environment: SERVER_SIDE_AUCTION ae: SERVER_SIDE_AUCTION } } site { page: "https://www.google.com" publisher { id: "pub-1111111111111111" [com.google.doubleclick.publisher] { country: "FR" } } content { livestream: false language: "fr" } [com.google.doubleclick.site] { amp: DIALECT_HTML page_visibility: VISIBILITY_STATE_VISIBLE inventorypartnerdomain: "" ntype: NAVIGATION_TYPE_NAVIGATE } } device { ua: "OMITTED" geo { lat: 0.0 lon: 0.0 country: "FRA" region: "FR-C" zip: "63120" type: IP utcoffset: 120 accuracy: 6948 [com.google.doubleclick.geo] { geo_criteria_id: 9112278 } } ipv6: "2a01:cb14:8183::" os: "Windows" devicetype: PERSONAL_COMPUTER lmt: false pxratio: 1.0 sua { browsers { brand: "Chromium" version: "130" version: "0" } browsers { brand: "Microsoft Edge" version: "130" version: "0" } platform { brand: "Windows" version: "15" version: "0" } mobile: false architecture: "x86" bitness: "64" source: CLIENT_HINTS_HIGH_ENTROPY } } user { [com.google.doubleclick.user] { consented_providers_settings { consented_providers: 1712 consented_providers: 2316 additional_consent: "OMITTED" } consent: "OMITTED" eids { source: "OMITTED" uids { id: "12JD92JD8078S8J29SDOAKC0EF230337" } } } } at: FIRST_PRICE tmax: 350 cur: "USD" regs { gpp: "OMITTED" [com.google.doubleclick.regs] { gdpr: true } } source { schain { complete: true nodes { asi: "testssp.com" sid: "pub-1111111111111111" hp: true } ver: "1.0" } [com.google.doubleclick.source] { schain { complete: 1 nodes { asi: "testssp.com" sid: "pub-1111111111111111" hp: 1 } ver: "1.0" } } } [com.google.doubleclick.bid_request] { google_query_id: "ANy-zyo598-4J62UYQ5J70Wm78t166uKD8322K98ik4X5496cn305Sp16t94Mhegp514jh1v" fcap_scope: FREQUENCY_CAPPING_SCOPE_NONE }
예 보기
{ "id": "l6210s8bS8Uc726V81B821", "imp": [ { "id": "1", "tagid": "3019814809", "bidfloor": 0.06, "bidfloorcur": "USD", "secure": 1, "native": { "ver": "1.2", "request": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":25}},{\"id\":2,\"required\":1,\"data\":{\"type\":2,\"len\":90}},{\"id\":3,\"data\":{\"type\":12,\"len\":15}},{\"id\":4,\"required\":1,\"img\":{\"type\":3,\"wmin\":1200,\"hmin\":627}},{\"id\":5,\"img\":{\"type\":2,\"wmin\":100,\"hmin\":100}}],\"eventtrackers\":[{\"event\":1,\"methods\":[1]}],\"privacy\":1,\"ext\":{\"style_id\":497439,\"style_height\":1,\"style_width\":1,\"style_layout_type\":1}}" }, "exp": 3600, "metric": [ { "type": "click_through_rate", "value": 0.0006697923527099192, "vendor": "EXCHANGE" }, { "type": "viewability", "value": 0.05, "vendor": "EXCHANGE" } ], "ext": { "billing_id": [ "50577321529" ], "dfp_ad_unit_code": "/3711494/google/test", "ampad": 3, "buyer_generated_request_data": [ { "data": "Test Data" } ], "excluded_creatives": [ { "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID" }, { "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID" } ], "open_bidding": { "is_open_bidding": 1 }, "creative_enforcement_settings": { "policy_enforcement": 1, "publisher_blocks_enforcement": 2 }, "auction_environment": 0, "ae": 0 } } ], "site": { "page": "https://www.google.com", "publisher": { "id": "pub-1111111111111111", "ext": { "country": "FR" } }, "content": { "livestream": 0, "language": "fr" }, "ext": { "amp": 0, "page_visibility": 1, "inventorypartnerdomain": "OMITTED", "ntype": 1 } }, "device": { "ua": "OMITTED", "geo": { "lat": 0.0, "lon": 0.0, "country": "FRA", "region": "FR-C", "zip": "63120", "type": 2, "utcoffset": 120, "accuracy": 6948, "ext": { "geo_criteria_id": 9112278 } }, "ipv6": "2a01:cb14:8183::", "os": "Windows", "devicetype": 2, "lmt": 0, "pxratio": 1.0, "sua": { "browsers": [ { "brand": "Chromium", "version": [ "130", "0" ] }, { "brand": "Microsoft Edge", "version": [ "130", "0" ] } ], "platform": { "brand": "Windows", "version": [ "15", "0" ] }, "mobile": 0, "architecture": "x86", "bitness": "64", "source": 2 } }, "user": { "ext": { "consented_providers_settings": { "consented_providers": [ "1712", "2316" ], "additional_consent": "OMITTED" }, "consent": "OMITTED", "eids": [ { "source": "OMITTED", "uids": [ { "id": "12JD92JD8078S8J29SDOAKC0EF230337" } ] } ] } }, "at": 1, "tmax": 350, "cur": [ "USD" ], "regs": { "gpp": "OMITTED", "ext": { "gdpr": 1 } }, "source": { "schain": { "complete": 1, "nodes": [ { "asi": "testssp.com", "sid": "pub-1111111111111111", "hp": 1 } ], "ver": "1.0" }, "ext": { "schain": { "complete": 1, "nodes": [ { "asi": "testssp.com", "sid": "pub-1111111111111111", "hp": 1 } ], "ver": "1.0" } } }, "ext": { "google_query_id": "ANy-zyo598-4J62UYQ5J70Wm78t166uKD8322K98ik4X5496cn305Sp16t94Mhegp514jh1v", "fcap_scope": 1 } }
예 보기
직렬화된 요청id: "\213\371#\236Mh\214uJ\356\225qW88=7|\2448\315Wx" ip: "\300\250" user_agent: "OMITTED" url: "https://www.google.com" detected_language: "it" adslot { id: 1 excluded_attribute: 14 excluded_attribute: 32 allowed_vendor_type: 42 allowed_vendor_type: 144 excluded_sensitive_category: 36 excluded_sensitive_category: 19 matching_ad_data { billing_id: 74792558829 billing_id: 11204117851 minimum_cpm_micros: 390000 } matching_ad_data { billing_id: 44428418146 billing_id: 91112044263 minimum_cpm_micros: 110000 } slot_visibility: BELOW_THE_FOLD excluded_product_category: 10366 excluded_product_category: 11504 ad_block_key: 8767661977 publisher_settings_list_id: 7807286827624818876 publisher_settings_list_id: 8186380472781289268 allowed_restricted_category: 32 allowed_restricted_category: 33 excluded_creatives { buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID" } excluded_creatives { buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID" } iframing_state: UNKNOWN_IFRAME_STATE viewability: 6 allowed_restricted_category_for_deals: 32 allowed_restricted_category_for_deals: 33 click_through_rate: 0.0010397299 allowed_ad_types: ALLOWED_AD_TYPE_NATIVE is_amp_page: DIALECT_HTML amp_ad_requirement_type: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED secure_signals { data: "Test Data: bw44G12BFZ" source: "OMITTED" } consented_providers_settings { tcf_consent_string: "OMITTED" additional_consent_string: "OMITTED" } regs_gdpr: true native_ad_template { required_fields: 17 recommended_fields: 0 headline_max_safe_length: 90 body_max_safe_length: 90 call_to_action_max_safe_length: 15 advertiser_max_safe_length: 25 image_width: 1200 image_height: 627 style_id: 749853 style_layout_type: FLUID style_height: 1 style_width: 1 } creative_enforcement_settings { policy_enforcement: POLICY_ENFORCEMENT_PLATFORM_POLICY publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES } auction_environment: SERVER_SIDE_AUCTION impression_expiration_seconds: 3600 supported_auction_environment: SERVER_SIDE_AUCTION } is_test: false timezone_offset: 120 geo_criteria_id: 1008463 bid_response_feedback { request_id: "\314\354d\177=@0\271\226a^\250\302u\037\301" creative_status_code: 1 event_notification_token: "token" buyer_creative_id: "test_creative_id_744913" minimum_bid_to_win: 220000 feedback_type: BID_FEEDBACK } bid_response_feedback { request_id: "\2354\335\340\347!\341~\265\n\206\327\300\005\370G" creative_status_code: 80 event_notification_token: "token" buyer_creative_id: "test_creative_id_744913" minimum_bid_to_win: 3450000 feedback_type: BID_FEEDBACK } publisher_type: PUBLISHER_OWNED_AND_OPERATED device { device_type: PERSONAL_COMPUTER platform: "Windows" screen_pixel_ratio_millis: 1000 limit_ad_tracking: false } publisher_country: "IT" publisher_id: "pub-1111111111111111" response_deadline_ms: 350 google_query_id: "ANy-zJXQF6-ob5v09r508m39543114QNHDY20RX67Ajs996K62nkEpcMuvWam950XP9486e6" auction_type: FIRST_PRICE geo { lat: 0.0 lon: 0.0 country: "ITA" region: "IT-MI" city: "Milan" utcoffset: 120 accuracy: 6821 } user_agent_data { platform { brand: "Windows" version: "10" version: "0" } mobile: false architecture: "x86" browsers { brand: "Chromium" version: "128" version: "0" } browsers { brand: "Not;A=Brand" version: "24" version: "0" } bitness: "64" source: CLIENT_HINTS_HIGH_ENTROPY } page_visibility: VISIBILITY_STATE_VISIBLE supply_chain { complete: true nodes { advertising_system_identifier: "testdomain.com" seller_identifier: "pub-1111111111111111" handles_payment: true } version: "1.0" } frequency_capping_scope: FREQUENCY_CAPPING_SCOPE_NONE privacy_treatments { allow_user_data_collection: true } inventory_partner_domain: "OMITTED"
동영상 입찰 요청
{ id: "\\\123/f\000\t\456&\n\789\1234\"\001a\123", ip: "\0338\355", google_user_id: "CAESEJ1ur2l94_8ruuu", cookie_version: 1, cookie_age_seconds: 5184000, hosted_match_data: "W9ABDAAAAGR67nl0", user_agent: "Mozilla/5.0 (Linux; Android 5.1; CP8298_I00) Mobile Safari/537.36", publisher_country: "IN", geo_criteria_id: 1007796, timezone_offset: 330, publisher_id: "pub-2230723027927371", seller_network_id: 989, url: "https://m.example.com", detected_language: [en], google_query_id: "ANy-zJEgdus4l0MishbSmH0eOcXUA1Fbo4_tKROsbR37q", auction_type: "SECOND_PRICE", device: { device_type: "HIGHEND_PHONE", platform: "android", brand: "coolpad", model: "cp8298_i00", os_version: { major: 5, minor: 1 }, carrier_id: 70210, screen_width: 360, screen_height: 640, screen_pixel_ratio_millis: 2000 }, mobile: { is_app: false, is_mobile_web_optimized: true, DEPRECATED_platform: "android", DEPRECATED_mobile_device_type: "HIGHEND_PHONE", DEPRECATED_brand: "coolpad", DEPRECATED_model: "cp8298_i00", DEPRECATED_os_version: { os_version_major: 5, os_version_minor: 1 }, DEPRECATED_screen_width: 360, DEPRECATED_screen_height: 640, DEPRECATED_carrier_id: 70210, DEPRECATED_device_pixel_ratio_millis: 2000 }, publisher_type: "ADX_PUBLISHER_OWNED_AND_OPERATED", adslot: [{ id: 1, ad_block_key: 2882274820, width: [300,250], height: [250,250], excluded_attribute: [114,22,34,25,27,13,14,15,16,17,18,19,20,25,27,22], allowed_vendor_type: [42,144,575,698,704,743,776,785,793,797,808,828,832,885], excluded_sensitive_category: [36,27,19,4,23,30,10,3,31,5,8,37,18], excluded_product_category: [10031,11669,13423,13525,13566,13589,13612,13740], excluded_creatives: [{ buyer_creative_id: "1234567.1234567890-ssl" }], matching_ad_data: [{ billing_id: [6629616415,51386650457], minimum_cpm_micros: 1380000, direct_deal: [{ direct_deal_id: 410401, fixed_cpm_micros: 1360000, deal_type: "PREFERRED_DEAL", publisher_blocks_overridden: true },{ direct_deal_id: 240644, fixed_cpm_micros: 1500000, deal_type: "PREFERRED_DEAL", publisher_blocks_overridden: true }] },{ billing_id: [1234567890], minimum_cpm_micros: 1380000 }], publisher_settings_list_id: [12109930661871909476,11138951146123409010], slot_visibility: "BELOW_THE_FOLD", viewability: 30, click_through_rate: 0.0010072842, iframing_state: "UNKNOWN_IFRAME_STATE", native_ad_template: [{ required_fields: 1065, recommended_fields: 4, headline_max_safe_length: 25, body_max_safe_length: 90, call_to_action_max_safe_length: 15, advertiser_max_safe_length: 25, logo_width: 100, logo_height: 100, style_id: 199892, style_height: 250, style_width: 300 }], sticky_settings: { }, renderer: "GOOGLE", is_amp_page: "DIALECT_HTML", amp_ad_requirement_type: "AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED", allowed_ad_types: [ALLOWED_AD_TYPE_BANNER,ALLOWED_AD_TYPE_NATIVE], session_depth: 1, internal_data: { } }], response_deadline_ms: 122, is_test: false }
입찰 응답 예시
비동영상 입찰 응답
예 보기
직렬화된 응답id: "22i22S9494PQl819H7Ld5K" seatbid { bid { id: "2GTnPXOn76gg1C6574T" impid: "1" price: 0.24 adid: "test_creative_id_713312" adomain: "google.com" crid: "test_creative_id_713312" exp: 300 language: "xx" adm_native { ver: "1.2" assets { id: 1 title { text: "Luxury Mars Cruises" } } assets { id: 2 data { value: "Visit the planet in a luxury spaceship." } } assets { id: 3 data { value: "Book today" } } assets { id: 4 img { url: "https://native.test.com/image?id=123456" w: 1200 h: 627 } } assets { id: 5 img { url: "https://native.test.com/logo?id=123456" w: 1200 h: 1200 } } link { url: "https://www.google.com" clicktrackers: "https://native.test.com/click?id=123456" } eventtrackers { event: IMPRESSION method: IMG url: "https://test.com/event?id=123456" } eventtrackers { event: IMPRESSION method: IMG url: "https://test.com/event?id=123456" } privacy: "https://adssettings.google.com/whythisad?source=display&reasons=OMITTED" } [com.google.doubleclick.bid] { event_notification_token { payload: "token" } billing_id: 50577321529 third_party_buyer_token: "4G79rr82Ah8r51859j2XT2RBR1BW2808IQrAa2nRjf63oo5w71y8q929t794MO75n4642HmE5HQ2B1jj9a03w6BFxc4D0mVReL1NgZ42aj7l308820m77pg004705U32AC81b7nkghu7" } } seat: "5249:9218:332606" } cur: "USD"
예 보기
{ "id": "22i22S9494PQl819H7Ld5K", "seatbid": [ { "bid": [ { "id": "2GTnPXOn76gg1C6574T", "impid": "1", "price": 0.24, "adid": "test_creative_id_713312", "adomain": [ "google.com" ], "crid": "test_creative_id_713312", "exp": 300, "language": "xx", "ext": { "event_notification_token": { "payload": "token" }, "billing_id": "50577321529", "third_party_buyer_token": "4G79rr82Ah8r51859j2XT2RBR1BW2808IQrAa2nRjf63oo5w71y8q929t794MO75n4642HmE5HQ2B1jj9a03w6BFxc4D0mVReL1NgZ42aj7l308820m77pg004705U32AC81b7nkghu7" }, "adm": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"title\":{\"text\":\"Luxury Mars Cruises\"}},{\"id\":2,\"data\":{\"value\":\"Visit the planet in a luxury spaceship.\"}},{\"id\":3,\"data\":{\"value\":\"Book today\"}},{\"id\":4,\"img\":{\"url\":\"https://native.test.com/image?id=123456\",\"w\":1200,\"h\":627}},{\"id\":5,\"img\":{\"url\":\"https://native.test.com/logo?id=123456\",\"w\":1200,\"h\":1200}}],\"link\":{\"url\":\"https://www.google.com\",\"clicktrackers\":[\"https://native.test.com/click?id=123456\"]},\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"},{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"}],\"privacy\":\"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED\"}" } ], "seat": "5249:9218:332606" } ], "cur": "USD" }
예 보기
직렬화된 응답ad { adslot { id: 1 max_cpm_micros: 110734 min_cpm_micros: 0 billing_id: 74792558829 deal_id: 0 } click_through_url: "google.com" attribute: 47 attribute: 8 buyer_creative_id: "test_creative_id_907643" advertiser_name: "Google" native_ad { headline: "Luxury Mars Cruises" body: "Visit the planet in a luxury spaceship." call_to_action: "Book today" advertiser: "Galactic Luxury Cruises" image { url: "https://native.test.com/image?id=123456" width: 800 height: 800 } logo { url: "https://native.test.com/logo?id=123456" width: 200 height: 200 } price: "\342\202\254 225" click_link_url: "https://www.google.com" } impression_tracking_url: "https://test.com/imp?id=123456" impression_tracking_url: "https://test.com/imp?id=123456" ad_choices_destination_url: "https://test.com/preferences" event_notification_token: "token" dsa_transparency { buyer_render: true } } processing_time_ms: 27
동영상 입찰 응답
bid_response { ad { ... click_through_url: "https://www.exampleDomain.com" impression_tracking_url: "https://my_impression_tracking_url.com/" ad_choices_destination_url: "https://my_ad_choices_destination_url.com/" ... native_ad { headline: "Lowest mortgage rates" video_url: "https://pubads.g.doubleclick.net/gampad/ads?sz=640x480&iu=/124319096/external/single_ad_samples&ciu_szs=300x250&impl=s&gdfp_req=1&env=vp&output=vast" call_to_action: "Get a quote" advertiser: "NY Mortgage Inc." image { url: "https://www.example.net/mypromoimage.png" width: 1200 height: 700 } logo { url: "https://www.example.net/mylogo.png" width: 200 height: 200 } click_link_url: "https://r1.example.com/r/u1dhfh3cow00/b1_googleadx/830/41972/ ?_b_ctrl=1" click_tracking_urls: "https://my_click_tracking_url.com/" } } }