네이티브 광고

네이티브 광고는 주변 콘텐츠와 시각 디자인에 맞도록 형식을 지정하여 사용자가 보고 클릭할 가능성을 높인 광고입니다. 네이티브 광고 인벤토리는 모바일 앱뿐만 아니라 데스크톱 및 모바일 웹사이트에서도 사용할 수 있습니다. 네이티브 광고에 대한 자세한 내용은 네이티브 광고 개요를 참고하세요.

네이티브 광고는 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를 채우는 입찰 응답을 반환해야 합니다. 그렇지 않으면 입찰에서 필터링됩니다.

네이티브 광고를 포함한 입찰가를 설정할 때 입찰 엔드포인트는 필수 애셋과 BidResponse.seatbid.bid.{adm/adm_native}.assets 필드에 포함할 선택적 애셋을 지정해야 합니다. 응답으로 전송된 애셋에는 입찰 요청에 지정된 해당 id 값이 포함되어야 합니다. id는 템플릿을 구조화하고 기본 이미지와 아이콘과 같은 유사한 종류의 애셋을 구분하는 데 사용됩니다. 다음 예에서는 OpenRTB 및 JSON 형식으로 NativeRequest 및 NativeResponse 객체가 채워지는 방법을 보여줍니다.

OpenRTB JSON (파싱됨)

NativeRequest

{
  "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,
      "required": 1,
      "img": {
        "type": 1,
        "wmin": 100,
        "hmin": 100
      }
    },
    {
      "id": 6,
      "data": {
        "type": 3,
        "len": 5
      }
    },
    {
      "id": 7,
      "data": {
        "type": 6
      }
    }
  ],
  "eventtrackers": [
    {
      "event": 1,
      "methods": [
        1
      ]
    }
  ]
}

NativeResponse

{
  "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": 100,
        "h": 100
      }
    },
    {
      "id": 5,
      "img": {
        "url": "https://native.test.com/icon?id=123456",
        "w": 200,
        "h": 200
      }
    }
  ],
  "link": {
    "url": "https://www.google.com",
    "clicktrackers": [
      "https://native.test.com/click?id=123456"
    ]
  },
  "imptrackers": [
    "https://test.com/impression?id=123456&amt=${AUCTION_PRICE}"
  ]
}

OpenRTB Protobuf

NativeRequest

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
    required: true
    img {
      type: ICON
      wmin: 100
      hmin: 100
    }
  }
  assets {
    id: 6
    data {
      type: RATING
      len: 5
    }
  }
  assets {
    id: 7
    data {
      type: PRICE
    }
  }
  eventtrackers {
    event: IMPRESSION
    methods: IMG
  }
}

NativeResponse

adm_native {
  assets {
    id: 1
    required: true
    title {
      text: "Luxury Mars Cruises"
    }
  }
  assets {
    id: 2
    required: true
    data {
      value: "Visit the planet in a luxury spaceship."
    }
  }
  assets {
    id: 3
    data {
      value: "Book today"
    }
  }
  assets {
    id: 4
    required: true
    img {
      url: "https://native.test.com/image?id=123456"
      w: 1200
      h: 627
    }
  }
  assets {
    id: 5
    required: true
    img {
      url: "https://native.test.com/icon?id=123456"
      w: 128
      h: 128
    }
  }
  assets {
    id: 6
    data {
      value: "5"
    }
  }
  link {
    url: "https://www.google.com"
    clicktrackers: "https://native.test.com/click?id=123456"
  }
  imptrackers: "https://test.com/impression?id=123456&amt=${AUCTION_PRICE}"
}

구매자 SDK를 사용하여 네이티브 광고를 렌더링하는 경우 검토를 위해 광고 소재를 제출할 때 declared_ad에 이미지 type를 포함해야 합니다.

네이티브 광고 템플릿

네이티브 광고 템플릿은 네이티브 광고의 구성요소를 설명하고 입찰 요청에서 NativeRequest의 콘텐츠와 구조를 결정합니다. Google은 동영상이 아닌 네이티브 광고와 동영상 네이티브 광고에 가장 일반적인 두 가지 네이티브 광고 템플릿을 지원합니다.

앱 설치 광고 템플릿 - 모바일 앱 설치를 홍보하고 유도합니다.
콘텐츠 광고 템플릿 - 브랜드 또는 웹 광고를 위한 텍스트와 이미지의 일반적인 조합입니다.
동영상 앱 설치 광고 템플릿
동영상 콘텐츠 광고 템플릿

이 외에도 필드, 측정기준, 크기에 대한 요구사항이 다를 수 있는 기타 템플릿이 제공됩니다.

앱 설치 광고 템플릿

필수 및 추천 필드

다음 표에는 필수 또는 권장으로 표시된 필드가 나와 있습니다. 다음 규칙이 적용됩니다.

필수로 표시된 필드는 입찰자가 입력해야 합니다.
권장으로 표시된 필드는 입찰자에게 필수가 아니며, 게시자는 제공된 경우 이를 표시할 수도 있고 표시하지 않을 수도 있습니다 (예: 별점).
클릭 유도문안 (CTA)은 입찰자가 전송하지 않으면 기본값이 할당되지만 전송되면 항상 표시되므로 항상 추천으로 표시됩니다.

다음 표에는 앱 설치 광고 템플릿의 필드가 나와 있습니다. 모바일 앱은 이러한 필드를 사용하여 네이티브 앱 설치 광고를 만듭니다.

필드	설명	필수 또는 권장 여부	항상 표시되나요?	권장 이미지 크기/최대 문자 수	예
광고 제목	앱 제목	필수	예	25자(영문 기준)	Flood-It!
이미지	앱의 스크린샷 또는 기타 관련 이미지	필수	아니요	게시자가 요구하는 가로세로 비율에 따라 1,200px x 627px 또는 600px x 600px	<게임 Flood-It!의 스크린샷>
본문	앱의 기본 텍스트	필수	아니요	90자	겉으로는 간단해 보이지만 묘하게 중독성 있는 게임입니다.
앱 아이콘	앱 아이콘	필수	아니요	128 x 128 px	<Flood-it! 앱 아이콘>
클릭 유도 문구	선호하는 사용자 작업	추천	예	15자	설치
별표 평점	앱 스토어에서 앱의 평점을 나타내는 별점 수 (0~5)	추천	아니요	0~5	4.5
가격	앱 비용	추천	아니요	15자	무료

텍스트 길이에 관한 참고사항

구매자가 권장 최대 글자 수보다 긴 텍스트 애셋 (예: 본문 텍스트)을 보내면 Google 또는 게시자가 텍스트를 자르고 생략할 수 있습니다. 중국어, 일본어, 한국어에서는 잘림 제한이 절반입니다. 예를 들어 제목 한도가 영어에서 90이면 중국어에서는 45입니다.

이미지 크기에 관한 참고사항

게시자는 다음 작업을 할 수 있습니다.

기본 이미지를 한쪽 방향 (높이 또는 너비)으로 최대 20% 까지 대칭적으로 자릅니다.
가로세로 비율을 변경하지 않고 이미지 크기를 조절합니다.
높이와 너비로 암시되는 가로세로 비율과 크게 다른 이미지는 필터링될 수 있습니다.

콘텐츠 광고 템플릿

다음 표에는 콘텐츠 광고 템플릿의 필드가 나열되어 있습니다. 게시자는 이러한 필드를 사용하여 네이티브 콘텐츠 광고를 만듭니다.

필드	설명	필수 또는 권장 여부	항상 표시되나요?	권장 이미지 크기/최대 문자 수 *	예
광고 제목	광고 헤더	필수	예	25자(영문 기준)	최저 주택담보대출 금리
이미지	광고의 기본 이미지	필수	아니요	게시자가 요구하는 가로세로 비율에 따라 1,200px x 627px 또는 600px x 600px	<광고의 기본 이미지>
본문	광고 콘텐츠	필수	아니요	90자	브루클린에 내 집을 마련하세요. 생각보다 저렴하고 빠르게 가능합니다.
로고	광고주의 로고 또는 기타 관련 소형 이미지	추천	아니요	128 x 128 px	<NY Mortgage Inc. 로고>
클릭 유도 문구	사용자가 선호하는 작업	추천	아니요	15자	견적 받기
광고주	광고주 또는 브랜드를 식별하는 텍스트	필수	아니요	25자(영문 기준)	NY Mortgage Inc.

동영상 앱 설치 광고 템플릿

필드	설명	필수 또는 권장 여부	항상 표시되나요?	권장 이미지 크기/최대 문자 수*	예
동영상	동영상 광고를 재생하기 위해 필요한 모든 애셋을 포함한 동영상 VAST 응답입니다.	필수	아니요	-	Flood-It!이 포함된 VAST XML의 URL입니다. 동영상 광고
광고 제목	앱 제목	필수	예	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!이 포함된 VAST XML의 URL입니다. 동영상 광고
광고 제목	광고 헤더	필수	예	25자(영문 기준)	최저 주택담보대출 금리
이미지	동영상 광고를 클릭하기 전이나 로드하는 중에 플레이어에 표시되는 이미지 (썸네일)입니다.	필수	아니요	동영상의 가로세로 비율과 일치해야 합니다 (예: 16x9 동영상의 경우 1280x720, 640x480 동영상의 경우 4x3).	동영상 스크린샷
본문	광고 콘텐츠	필수	아니요	90자	브루클린에 내 집을 마련하세요. 생각보다 저렴하고 빠르게 가능합니다.
로고	광고주의 로고 또는 기타 관련 소형 이미지	추천	아니요	128 x 128 px	NY Mortgage Inc. 로고
클릭 유도 문구	사용자가 선호하는 작업	필수	아니요	15자	견적 받기
광고주	광고주 또는 브랜드를 식별하는 텍스트	필수	아니요	25자(영문 기준)	NY Mortgage Inc.

메타 필드

다음 메타 필드는 지원되는 모든 광고 템플릿에서 공유됩니다.

필드	설명
`BidResponse.seatbid.bid.{adm/adm_native}.link.url`	사용자가 광고를 클릭한 후 연결되는 최종 방문 페이지의 URL입니다. 동적 방문 페이지의 경우 이 필드를 사용해야 합니다.
`BidResponse.seatbid.bid.{adm/adm_native}.link.clicktrackers`	선택사항입니다. 광고주가 광고에 대한 사용자 클릭을 추적할 수 있도록 허용하는 추가 URL입니다.
`BidResponse.seatbid.bid.{adm/adm_native}.privacy`	광고 환경설정 또는 선택 해제 페이지로 연결되는 링크 있는 경우 표준 AdChoices 아이콘이 네이티브 광고 소재에 추가되고 이 URL에 연결됩니다.
`BidResponse.seatbid.bid.{adm/adm_native}.eventtrackers`	노출 추적은 네이티브 응답에 `eventtrackers`를 포함하여 실행할 수 있습니다. 여기서 `event`는 `IMPRESSION`로 설정됩니다.

입찰 요청의 네이티브 광고 템플릿 표현

네이티브 인벤토리가 포함된 입찰 요청을 수신하면 OpenRTB의 NativeRequest 메시지로 표시된 네이티브 광고 템플릿이 포함됩니다. 네이티브 광고 인벤토리에 관한 다음 정보를 제공합니다.

선택사항 또는 필수 애셋
이미지, 로고, 앱 아이콘의 크기입니다.
광고가 렌더링되는 스타일의 사양입니다.

참고: BidRequest.imp.native.{request/request_native}.ext.style_layout_type의 경우 PIXEL은 기본 단위가 고정 크기임을 나타내고 FLUID은 둘러싸는 열의 너비를 채우도록 크기를 조정하고 가로세로 비율을 유지하도록 높이를 조정한다는 의미입니다. FLUID가 지정되면 높이와 너비가 1x1로 표시될 수 있습니다.

선택사항 및 필수 애셋

네이티브 광고 노출에 필요한 선택사항 및 필수 확장 소재는 BidRequest.imp.native.{request/request_native}.assets에서 확인할 수 있습니다. 네이티브 광고의 구성요소(예: 광고 제목, 본문, 로고)를 설명합니다. 요청에 포함된 각 애셋에는 고유한 id가 있으며, 입찰 응답에 포함되어야 하는 애셋의 경우 required이 True로 채워집니다.

입찰 응답의 네이티브 광고 표현

네이티브 인벤토리에 입찰할 때는 입찰 요청에 표시된 필수 애셋으로 채워진 NativeResponse를 포함해야 하며, 지정된 선택적 애셋도 포함할 수 있습니다. BidResponse.seatbid.bid.{adm/adm_native}.assets를 사용하여 입찰 응답에 이를 포함할 수 있습니다. 응답에 assets를 채울 때 각 assets에는 입찰 요청의 해당 애셋에 해당하는 id이 포함되어야 합니다.

입찰 요청 예시

OpenRTB Protobuf

예 보기

직렬화된 요청

id: "E308Tm2QEoE47lnhe83X9q"
imp {
  id: "1"
  tagid: "4903055077"
  bidfloor: 81.14974999553961
  bidfloorcur: "JPY"
  secure: true
  native {
    ver: "1.2"
    api: VPAID_1
    api: VPAID_2
    battr: VIDEO_IN_BANNER_AUTO_PLAY
    battr: VIDEO_IN_BANNER_USER_INITIATED
    request_native {
      ver: "1.2"
      assets {
        id: 1
        required: true
        title {
          len: 25
        }
      }
      assets {
        id: 2
        required: true
        img {
          type: MAIN
          wmin: 1200
          hmin: 627
        }
      }
      eventtrackers {
        event: IMPRESSION
        methods: IMG
      }
      privacy: true
      [com.google.doubleclick.native_ext] {
        style_height: 1
        style_width: 1
        style_layout_type: FLUID
        pos: BELOW_THE_FOLD
      }
    }
  }
  exp: 3600
  metric {
    type: "click_through_rate"
    value: 0.004343720618635416
    vendor: "EXCHANGE"
  }
  metric {
    type: "viewability"
    value: 0.71
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 24180454294
    billing_id: 14521002479
    publisher_settings_list_id: 3546930920304928337
    publisher_settings_list_id: 6175971934253075185
    allowed_vendor_type: 0
    ampad: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
    }
    auction_environment: SERVER_SIDE_AUCTION
    ae: SERVER_SIDE_AUCTION
  }
}
site {
  page: "https://www.google.com"
  publisher {
    id: "pub-1111111111111111"
    [com.google.doubleclick.publisher] {
      country: "PL"
    }
  }
  content {
    livestream: false
    language: "pl"
  }
  [com.google.doubleclick.site] {
    amp: DIALECT_HTML
    page_visibility: VISIBILITY_STATE_VISIBLE
    ntype: NAVIGATION_TYPE_BACK_FORWARD
  }
}
device {
  ua: "OMITTED"
  ip: "192.168.1.0"
  geo {
    lat: 0.0
    lon: 0.0
    country: "POL"
    region: "PL-WP"
    city: "Konin"
    zip: "62-500"
    type: IP
    utcoffset: 120
    accuracy: 5108
    [com.google.doubleclick.geo] {
      geo_criteria_id: 1011590
    }
  }
  os: "Windows"
  devicetype: PERSONAL_COMPUTER
  pxratio: 1.2
  sua {
    browsers {
      brand: "Mozilla"
      version: "5"
      version: "0"
    }
    browsers {
      brand: "Gecko"
      version: "20100101"
    }
    platform {
      brand: "Windows NT"
      version: "10"
      version: "0"
    }
    mobile: false
    source: USER_AGENT_STRING
  }
}
user {
  id: "E0ML7e7ETr249RfY471vuDEPklO"
  data {
    id: "0"
    segment {
      id: "OMITTED"
    }
    segment {
      id: "OMITTED"
    }
    [com.google.doubleclick.data] {
      segtax: 4
    }
  }
  consent: "OMITTED"
  [com.google.doubleclick.user] {
    consented_providers_settings {
      consented_providers: 1301
      consented_providers: 70
      additional_consent: "OMITTED"
    }
    consent: "OMITTED"
    idage: 75600
  }
}
at: FIRST_PRICE
tmax: 350
cur: "GBP"
cur: "JPY"
bcat: "3"
bcat: "5"
regs {
  [com.google.doubleclick.regs] {
    gdpr: true
  }
}
source {
  schain {
    complete: true
    nodes {
      asi: "testssp.com"
      sid: "pub-1111111111111111"
      hp: true
    }
    ver: "1.0"
  }
}
cattax: GOOGLE_CATEGORIES
[com.google.doubleclick.bid_request] {
  bid_feedback {
    request_id: "L47877z78x3rN3S7S58fK4"
    creative_status_code: 80
    event_notification_token {
      payload: "token"
    }
    buyer_creative_id: "test_creative_id_472475"
    minimum_bid_to_win: 1.55
    feedbacktype: BID_FEEDBACK
  }
  google_query_id: "ANy-zlz7ER-Ywn21DS7CCy047o63UiiOIE1ye5yXAYubmwH33Y6y8T3rLT3G338zT4lOxA79"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_BROWSER
  privacy_treatments {
    allow_user_data_collection: true
  }
}

OpenRTB JSON

예 보기

{
  "id": "E308Tm2QEoE47lnhe83X9q",
  "imp": [
    {
      "id": "1",
      "tagid": "4903055077",
      "bidfloor": 81.14974999553961,
      "bidfloorcur": "JPY",
      "secure": 1,
      "native": {
        "ver": "1.2",
        "api": [
          1,
          2
        ],
        "battr": [
          6,
          7
        ],
        "request": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":25}},{\"id\":2,\"required\":1,\"img\":{\"type\":3,\"wmin\":1200,\"hmin\":627}}],\"eventtrackers\":[{\"event\":1,\"methods\":[1]}],\"privacy\":1,\"ext\":{\"style_height\":1,\"style_width\":1,\"style_layout_type\":1,\"pos\":3}}"
      },
      "exp": 3600,
      "metric": [
        {
          "type": "click_through_rate",
          "value": 0.004343720618635416,
          "vendor": "EXCHANGE"
        },
        {
          "type": "viewability",
          "value": 0.71,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          "24180454294",
          "14521002479"
        ],
        "publisher_settings_list_id": [
          "3546930920304928337",
          "6175971934253075185"
        ],
        "allowed_vendor_type": [
          0
        ],
        "ampad": 3,
        "excluded_creatives": [
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          },
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          }
        ],
        "creative_enforcement_settings": {
          "policy_enforcement": 2,
          "publisher_blocks_enforcement": 1
        },
        "auction_environment": 0,
        "ae": 0
      }
    }
  ],
  "site": {
    "page": "https://www.google.com",
    "publisher": {
      "id": "pub-1111111111111111",
      "ext": {
        "country": "PL"
      }
    },
    "content": {
      "livestream": 0,
      "language": "pl"
    },
    "ext": {
      "amp": 0,
      "page_visibility": 1,
      "ntype": 3
    }
  },
  "device": {
    "ua": "OMITTED",
    "ip": "192.168.1.0",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "POL",
      "region": "PL-WP",
      "city": "Konin",
      "zip": "62-500",
      "type": 2,
      "utcoffset": 120,
      "accuracy": 5108,
      "ext": {
        "geo_criteria_id": 1011590
      }
    },
    "os": "Windows",
    "devicetype": 2,
    "pxratio": 1.2,
    "sua": {
      "browsers": [
        {
          "brand": "Mozilla",
          "version": [
            "5",
            "0"
          ]
        },
        {
          "brand": "Gecko",
          "version": [
            "20100101"
          ]
        }
      ],
      "platform": {
        "brand": "Windows NT",
        "version": [
          "10",
          "0"
        ]
      },
      "mobile": 0,
      "source": 3
    }
  },
  "user": {
    "id": "E0ML7e7ETr249RfY471vuDEPklO",
    "data": [
      {
        "id": "0",
        "segment": [
          {
            "id": "OMITTED"
          },
          {
            "id": "OMITTED"
          }
        ],
        "ext": {
          "segtax": 4
        }
      }
    ],
    "consent": "OMITTED",
    "ext": {
      "consented_providers_settings": {
        "consented_providers": [
          "1301",
          "70"
        ],
        "additional_consent": "OMITTED"
      },
      "consent": "OMITTED",
      "idage": 75600
    }
  },
  "at": 1,
  "tmax": 350,
  "cur": [
    "GBP",
    "JPY"
  ],
  "bcat": [
    "3",
    "5"
  ],
  "regs": {
    "ext": {
      "gdpr": 1
    }
  },
  "source": {
    "schain": {
      "complete": 1,
      "nodes": [
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        }
      ],
      "ver": "1.0"
    }
  },
  "cattax": 500,
  "ext": {
    "bid_feedback": [
      {
        "request_id": "L47877z78x3rN3S7S58fK4",
        "creative_status_code": 80,
        "event_notification_token": {
          "payload": "token"
        },
        "buyer_creative_id": "test_creative_id_472475",
        "minimum_bid_to_win": 1.55,
        "feedbacktype": 1
      }
    ],
    "google_query_id": "ANy-zlz7ER-Ywn21DS7CCy047o63UiiOIE1ye5yXAYubmwH33Y6y8T3rLT3G338zT4lOxA79",
    "fcap_scope": 2,
    "privacy_treatments": {
      "allow_user_data_collection": 1
    }
  }
}

입찰 응답 예시

OpenRTB Protobuf

예 보기

직렬화된 응답

id: "42MVqin85i25Y9832I39o7"
seatbid {
  bid {
    id: "VL1295pT2ke789Bvu86"
    impid: "1"
    price: 1.0531195402145386
    crid: "test_creative_id_783370"
    dealid: "0"
    adm_native {
      ver: "1.2"
      assets {
        id: 2
        img {
          url: "https://native.test.com/image?id=123456"
          w: 800
          h: 800
          type: MAIN
        }
      }
      assets {
        id: 1
        title {
          text: "Luxury Mars Cruises"
        }
      }
      link {
        url: "https://www.google.com"
      }
    }
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      impression_tracking_url: "https://example.com/impression?id=654321"
      ad_choices_destination_url: "https://test.com/preferences"
      event_notification_token {
        payload: "token"
      }
      billing_id: 24180454294
      dsa {
        adrender: true
      }
      clickurl: "google.com"
    }
  }
}
cur: "JPY"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 16
}

OpenRTB JSON

예 보기

{
  "id": "42MVqin85i25Y9832I39o7",
  "seatbid": [
    {
      "bid": [
        {
          "id": "VL1295pT2ke789Bvu86",
          "impid": "1",
          "price": 1.0531195402145386,
          "crid": "test_creative_id_783370",
          "dealid": "0",
          "ext": {
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://example.com/impression?id=654321"
            ],
            "ad_choices_destination_url": "https://test.com/preferences",
            "event_notification_token": {
              "payload": "token"
            },
            "billing_id": "24180454294",
            "dsa": {
              "adrender": 1
            },
            "clickurl": [
              "google.com"
            ]
          },
          "adm": "{\"ver\":\"1.2\",\"assets\":[{\"id\":2,\"img\":{\"url\":\"https://native.test.com/image?id=123456\",\"w\":800,\"h\":800,\"type\":3}},{\"id\":1,\"title\":{\"text\":\"Luxury Mars Cruises\"}}],\"link\":{\"url\":\"https://www.google.com\"}}"
        }
      ]
    }
  ],
  "cur": "JPY",
  "ext": {
    "processing_time_ms": 16
  }
}

네이티브 광고 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

메시지 형식

OpenRTB JSON (파싱됨)

OpenRTB Protobuf

네이티브 광고 템플릿

앱 설치 광고 템플릿

필수 및 추천 필드

텍스트 길이에 관한 참고사항

이미지 크기에 관한 참고사항

콘텐츠 광고 템플릿

동영상 앱 설치 광고 템플릿

제한사항

앱 설치 광고 예

동영상 콘텐츠 광고 템플릿

메타 필드

입찰 요청의 네이티브 광고 템플릿 표현

선택사항 및 필수 애셋

입찰 응답의 네이티브 광고 표현

입찰 요청 예시

OpenRTB Protobuf

예 보기

OpenRTB JSON

예 보기

입찰 응답 예시

OpenRTB Protobuf

예 보기

OpenRTB JSON

예 보기

네이티브 광고