응답 만들기

애플리케이션에서 Google의 입찰 요청을 처리한 후 응답을 작성하고 전송해야 합니다. 이 가이드에서는 애플리케이션을 코딩하여 응답을 빌드하는 방법을 설명합니다.

입찰 응답 메시지 작성

Authorized Buyers는 BidRequest를 HTTP POST의 메시지 본문으로 전송합니다. 애플리케이션이 전송하는 응답에는 application/octet-stream로 설정된 Content-Type 헤더와 직렬화된 프로토콜 버퍼로 구성된 메시지 본문이 있어야 합니다. 프로토콜 버퍼는 realtime-bidding.proto에 정의된 BidResponse 메시지입니다. 애플리케이션은 모든 BidRequest에 대한 응답으로 파싱 가능한 BidResponse를 반환해야 합니다. 시간 초과와 파싱할 수 없는 응답은 오류로 간주되며 Google은 오류율이 높은 입찰자를 제한합니다.

노출에 입찰하지 않으려면 processing_time_ms 필드만 설정하고 다른 모든 필드를 비워 두면 됩니다. 참조 데이터 페이지에서 realtime-bidding.proto를 가져올 수 있습니다.

광고 소재 ID

BidResponse에서 buyer_creative_id 필드를 통해 광고 소재를 지정합니다 (64바이트 제한). 유사한 광고 소재라도 크기, 선언된 URL, 광고 소재 속성, 공급업체 유형을 포함하되 이에 국한되지 않는 중요한 특성이 다른 경우 buyer_creative_id에 고유한 값을 가져야 합니다. 즉, 다음에 해당하는 두 광고에 서로 다른 광고 소재 ID를 부여해야 합니다.

• 외모나 행동이 다릅니다.
• 다양한 이미지에 렌더링하세요.
• 다른 방법으로 렌더링합니다 (예: 한 광고는 이미지로 구성되고 다른 광고는 플래시를 포함하는 경우).

애플리케이션을 설계할 때 제출하려는 광고 소재 유형에 적합한 식별자를 체계적으로 생성하는 방법을 결정해야 합니다.

광고 속성

BidResponse.Ad.attribute에서 광고의 특성과 타겟팅을 완전히 설명하는 광고 소재 속성을 선언해야 합니다. 선언해야 하는 속성은 다음과 같습니다. buyer-declarable-creative-attributes.txt에서 지원되는 속성의 전체 목록도 참고하세요.

• 7 Tagging: IsTagged
  광고에 후속 리마케팅을 위한 쿠키 ID 목록을 생성하기 위한 픽셀 또는 웹 표지가 포함되어 있습니다.
• 8 Remarketing: IsRemarketing
  광고는 쿠키 ID 또는 기기 ID를 기반으로 소비자를 타겟팅합니다. 여기서 쿠키 ID 또는 기기 ID 목록은 구매자가 소유하거나 대표하는 사이트와 이전에 상호작용한 소비자 집합을 나타냅니다.
• 9 UserInterestTargeting: IsUserInterestTargeted
  광고는 쿠키 ID 또는 기기 ID를 기반으로 소비자를 타겟팅합니다. 여기서 쿠키 ID 또는 기기 ID 목록은 구매자가 공통 관심분야 그룹으로 정의한 소비자 집합을 나타냅니다.
• 30 InstreamVastVideoType: Vpaid
  광고를 렌더링하려면 VPAID 지원이 필요합니다.
• 32 MraidType: MRAID
  광고를 렌더링하려면 MRAID API가 필요합니다.

또한 다음과 같은 속성이 지원되지만 필수는 아닙니다. Authorized Buyers에서 이 속성을 자동으로 감지하고, 선언이 아닌 감지된 값에 따라 광고 소재를 차단 (또는 허용)하기 때문입니다. 광고 소재의 감지된 속성에 관한 의견을 얻는 방법에 대한 설명은 Creatives API를 참고하세요.

• 34 RichMediaCapabilityType: RichMediaCapabilityFlash
  광고를 렌더링하려면 플래시 지원이 필요합니다.
• 50 RichMediaCapabilityType: RichMediaCapabilityNonFlash
  광고를 렌더링하는 데 플래시가 필요하지 않습니다.
• 47 RichMediaCapabilityType: RichMediaCapabilitySSL
  광고가 SSL 페이지에서 렌더링할 수 있습니다. Authorized Buyers에서는 이 속성의 선언된 값이 서로 다른 광고 소재를 고유한 것으로 취급합니다 (광고 소재는 별도로 검토되며 고유한 승인 상태를 가짐). 따라서 동일한 광고 소재의 SSL 준수 버전과 SSL 미준수 버전을 모두 사용하여 입찰하는 경우에는 이 속성을 적절하게 선언하여 이러한 구분이 AdX에 제대로 반영되도록 해야 합니다.

공개 입찰 필드

공개 입찰에 참여하는 거래소 및 네트워크 입찰자가 전송한 입찰 응답은 표준 실시간 입찰에 참여하는 Authorized Buyers의 입찰 응답과 유사합니다. 공개 입찰 고객은 소수의 추가 필드를 지정할 수 있으며 기존 몇 가지 필드는 대체 용도로 사용할 수 있습니다. 여기에는 다음이 포함됩니다.

OpenRTB	Authorized Buyers	세부정보
BidResponse.imp[].pmp.deals[].id	BidResponse.ad[].adslot[].exchange_deal_id	이 입찰과 연결되어 게시자에게 보고되는 거래소 네임스페이스의 거래 ID입니다. 참고: 이 필드는 현재 비공개 베타 참여자에게만 전송됩니다.
BidResponse.seatbid[].bid[].ext.exchange_deal_type	BidResponse.ad[].adslot[].exchange_deal_type	게시자에게 보고되는 거래 유형으로, 입찰에서 거래가 처리되는 방식에 영향을 미칩니다. 참고: 이 필드는 현재 비공개 베타 참여자에게만 전송됩니다.
BidResponse.seatbid[].bid[].ext.third_party_buyer_token	BidResponse.ad[].adslot[].third_party_buyer_token	공개 입찰자로서의 거래소가 중개자인 경우 최종 서드 파티 구매자 정보를 식별하는 데 사용되는 토큰입니다. 이는 서드 파티 구매자로부터 가져오며 입찰 응답에서 변경되지 않은 상태로 Google에 전달되어야 합니다.

권장사항

• 서버에서 영구 HTTPS 연결('연결 유지' 또는 '연결 재사용'이라고도 함)을 사용 설정합니다. 제한 시간을 최소 10초로 설정하세요. 대부분의 경우 값이 높을수록 좋습니다. Google은 애플리케이션의 초기 지연 시간 테스트 중에 이를 확인합니다. Authorized Buyers가 빠른 속도로 요청을 전송하고, 요청별로 별도의 TCP 연결을 설정하는 데 따른 지연 시간 오버헤드를 피해야 하기 때문입니다.

• 입찰자가 낙찰받을 때가 아닌 노출이 렌더링되는 시점을 추적하려면 노출 추적 URL(선택사항)을 포함합니다. 낙찰과 렌더링 간의 중단으로 인해 이 점이 더 정확한 추적 통계를 얻을 수 있습니다.

  참고: OpenRTB 2.5 이상을 사용하는 경우 표준 필드는 BidResponse.seatbid[].bid[].burl입니다.
• 입찰자 코드에 지원 중단된 필드에 대한 종속 항목이 없어야 합니다. 이렇게 하면 오류가 발생하여 입찰이 실패할 수 있습니다.
• BidResponse에 BidResponse.Ad.width 및 BidResponse.Ad.height를 포함합니다. 여러 광고 크기가 포함된 요청에 대한 BidResponse은 width 및 height 값을 포함해야 합니다. 그렇지 않으면 입찰에서 제외됩니다.
• 응답 크기를 8K 미만으로 제한하세요. 응답이 매우 크면 네트워크 지연 시간이 늘어나고 시간 초과가 발생할 수 있습니다.
• SKAdNetwork 기여 분석이 필요한 iOS 인벤토리의 입찰 가이드라인을 따릅니다.

입찰 응답의 예

다음 예는 Protobuf 및 JSON 요청의 사람이 읽을 수 있는 샘플을 나타냅니다.

Google

예 보기

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 6496
    billing_id: 25059430769
    deal_id: 30183930
  }
  click_through_url: "google.com"
  attribute: 47
  buyer_creative_id: "test_creative_id_244584"
  advertiser_name: "Google"
  width: 300
  height: 50
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 6

OpenRTB JSON

예 보기

{
  "id": "KO9b4i49863AW26d1Tl9q6",
  "seatbid": [
    {
      "bid": [
        {
          "id": "Zc2MS8m162f920x7944",
          "impid": "1",
          "price": 0.133555,
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "w": 300,
          "h": 250,
          "crid": "test_creative_id_410013",
          "creativeType": "DISPLAY",
          "burl": "https://test.com/imp?id=123456",
          "cid": "37092002186",
          "adid": "test_creative_id_410013"
        }
      ],
      "seat": "8333:6953:689419"
    }
  ],
  "ext": {
    "pixels": "<script type='text/javascript'>var adContent = '';\nadContent += '<scr' + 'ipt type=\"text/javascript\" src=\"https://service.idsync.analytics.yahoo.com/sp/v0/pixels?pixelIds=58292,58301,58294&referrer=&limit=12&us_privacy=null&js=1&_origin=1&gdpr=0&euconsent=\"></scr' + 'ipt>' + '\\n';\ndocument.write(adContent);</script>"
  }
}

OpenRTB Protobuf

예 보기

id: "kMr24Q2iIW45X66r58005i"
seatbid {
  bid {
    id: "ne1hrjHUhQ53A1rC721"
    impid: "1"
    price: 0.05813896656036377
    adid: "test_creative_id_744028"
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "53026323592"
    crid: "test_creative_id_744028"
    w: 320
    h: 50
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      billing_id: 53026323592
    }
  }
  seat: "7524:3385:491205"
}
bidid: "6T5lR3ZI-U4xrqc15-Q6RK-426A53024Mf4"
cur: "USD"

중요: 샘플에 묘사된 Protobuf 메시지는 여기에 사람이 읽을 수 있는 텍스트로 표시됩니다. 그러나 이는 메시지가 유선으로 전송되는 방식이 아닙니다. Google 또는 OpenRTB Protobuf 형식을 사용하는 경우 직렬화된 BidResponse 메시지만 허용됩니다.

다음 C++ 코드를 사용하여 BidResponse 메시지를 만들고 직렬화할 수 있습니다.

BidResponse bid_response;
// fill in bid response with bid information
string post_response;
if (bid_response.SerializeToString(&post_response)) {
  // respond to the POST with post_response as the content
} else {
  // return an error to the POST
}

광고 소재 지정

입찰 응답은 낙찰된 경우 게재할 광고 소재를 지정합니다. 입찰가에는 지원되는 광고 형식 (AMP, 동영상, 네이티브) 중 하나가 포함되어야 합니다. 이 예에서는 html_snippet 필드를 사용하여 광고 소재를 지정합니다.

또는 광고 형식에 따라 다음 필드 중 하나를 사용하여 광고 소재를 지정할 수 있습니다.

• SDK 렌더링 광고
  • BidResponse.Ad.sdk_rendered_ad
• AMP
  • BidResponse.Ad.amp_ad_url
• 동영상
  • BidResponse.Ad.video_url 또는
  • BidResponse.Ad.video_vast_xml
• 네이티브
  • BidResponse.Ad.native_ad

BidResponse의 html_snippet 필드에 있는 HTML 스니펫을 사용하여 자체 서버에서 호스팅되는 광고를 지정합니다. 스니펫은 웹페이지에 삽입된 iFrame에 포함되어 있으므로 페이지가 로드될 때 광고가 검색되고 렌더링됩니다. 광고 (배너 또는 전면 광고)가 iframe 내에서, 그리고 입찰 중인 광고 슬롯에 맞는 크기로 올바르게 렌더링되도록 HTML 스니펫을 작성해야 합니다.

또한 입찰 응답에서 선언된 광고 크기는 다음과 같은 경우 입찰 요청의 크기 조합 중 하나와 정확히 일치해야 합니다.

• 광고는 일반 배너입니다 (동영상, 네이티브 또는 전면 광고가 아님).
• 입찰자가 입찰 응답에서 크기를 선언했습니다. 요청에 크기가 두 개 이상 있을 때마다 크기 선언이 필요합니다.
• 전면 광고의 경우에는 예외입니다. 전면 광고의 경우 너비는 화면 너비의 50% 이상, 높이는 화면 높이의 40% 이상이어야 합니다.

html_snippet 필드는 올바르게 렌더링되는 모든 유효한 HTML 코드를 지원하지만 BidResponse 메시지 만들기 섹션에 buyer_creative_id 필드를 지정할 때 적용되는 제한사항이 있습니다. 광고 렌더링의 일환으로 서버에서 가져오는 URL의 인수에 추가 정보를 입력할 수도 있습니다. 이를 통해 노출에 관한 임의의 데이터를 자체 서버로 다시 전달할 수 있습니다.

입찰 응답에서 반환되는 HTML 스니펫에 대한 대부분의 정책은 서드 파티 광고와 동일합니다. 자세한 내용은 Authorized Buyers 프로그램 가이드라인, 서드 파티 광고 게재 요구사항, 광고에서 클릭연결 URL 선언하기를 참고하세요.

매크로 지정

광고 소재를 정의하는 HTML 스니펫에는 매크로라는 특수 구조가 하나 이상 포함될 수 있습니다. 광고 게재 시 값이 매크로로 대체됩니다. 예를 들어 클라이언트 입찰 애플리케이션은 WINNING_PRICE 매크로를 사용하여 낙찰 시 광고에 지불한 금액을 결정할 수 있습니다. 이 매크로를 파싱하려면 가격 확인을 복호화하는 애플리케이션을 구현해야 합니다. 자세한 내용은 가격 확인 복호화 페이지를 참조하세요.

매크로를 %%MACRO%% 형식으로 HTML 스니펫의 일부로 지정합니다. 여기서 MACRO는 아래 표에 나열된 지원되는 매크로 중 하나입니다.

참고: AMP 광고 입찰 응답 (amp_ad_url)의 경우 WINNING_PRICE 및 WINNING_PRICE_ESC 매크로만 지원됩니다.

서드 파티가 게재한 광고의 광고 소재에는 CLICK_URL_UNESC 또는 CLICK_URL_ESC 매크로를 사용해야 합니다. Google에서는 클릭 추적에 CLICK_URL 매크로를 사용합니다.

매크로를 사용하려면 사용자가 광고를 클릭할 때 URL을 가져올 수 있도록 광고에 매크로를 포함합니다. 가져오기의 반환 값은 개발자가 CLICK_URL에 추가하는 다른 URL의 리디렉션입니다.

참고: 이러한 DoubleClick 매크로 외에 OpenRTB 매크로도 지원됩니다. OpenRTB 매크로에 대한 자세한 내용은 OpenRTB 사양을 참조하세요.

매크로	설명
ADVERTISING_IDENTIFIER	구매자가 노출 렌더링 시 iOS IDFA 또는 Android의 광고 ID를 수신할 수 있습니다. 자세한 내용은 광고주 식별자 복호화를 참조하세요.
CACHEBUSTER	부호 없는 임의의 4바이트 정수의 문자열 표현입니다.
CLICK_URL_UNESC	광고에 대한 이스케이프 처리되지 않은 클릭 URL. 스니펫에서 서드 파티 클릭 URL의 이스케이프 버전은 스니펫에서 바로 매크로를 따라야 합니다. 예를 들어 서드 파티 클릭 URL이 http://my.adserver.com/some/path/handleclick?click=clk인 경우 매크로 호출 뒤에 오는 단일 이스케이프 처리된 버전의 서드 파티 클릭 URL과 함께 다음 코드를 사용할 수 있습니다. <a href="%%CLICK_URL_UNESC%%http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a> 광고 게재 시 이는 다음으로 확장됩니다. <a href="http://google-click-url?...&ad_url=http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a> URL은 먼저 Google에 클릭을 등록한 다음 서드 파티 클릭 URL로 리디렉션됩니다.
CLICK_URL_ESC	광고에 대한 이스케이프 처리된 클릭 URL. 다른 서버를 통해 값을 전달한 후 리디렉션이 반환되어야 한다면 CLICK_URL_UNESC 대신 이 값을 사용하세요. 예를 들어 다음 코드를 HTML 스니펫에서 사용할 수 있습니다. <a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC%%"></a> 광고 게재 시 이는 다음으로 확장됩니다. <a href="http://my.adserver.com/click?google_click_url=http://google-click- url%3F...%26ad_url%3D"></a> 이렇게 하면 my.adserver.com에 클릭이 등록되고 그러면 google_click_url 매개변수에 전달된 URL로 리디렉션됩니다. 이때 my.adserver.com가 google_click_url 매개변수를 언이스케이프한다고 가정합니다. 이중 이스케이프 처리된 URL을 %%CLICK_URL_ESC%% 뒤에 추가할 수 있습니다. my.adserver.com에 의해 이스케이프가 해제되면 URL의 단일 이스케이프 버전이 google_click_url에 추가됩니다. google_click_url를 가져오면 한 번 더 이스케이프 취소된 후 리디렉션됩니다.
CLICK_URL_ESC_ESC	광고에 대한 이중 이스케이프된 URL. 다른 서버를 통해 값을 전달한 후 리디렉션이 반환되어야 한다면 CLICK_URL_UNESC 대신 이 값을 사용하세요. 예를 들어 다음 코드를 HTML 스니펫에서 사용할 수 있습니다. <a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC_ESC%%"></a> 광고 게재 시 이는 다음으로 확장됩니다. <a href="http://my.otheradserver.com/click?google_click_url=http%3A%2F%2Fmy.adserver.com%2Fclick%3Fgoogle_click_url%3Dhttp%3A%2F%2Fgoogle-click-%20url%253F...%2526ad_url%253D"></a>
SCHEME	입찰 요청에서 SSL을 요구하지 않으면 http:로, 입찰 요청에 SSL을 요구하는 경우 https:로 확장됩니다.
SITE	콘텐츠 URL에서 URL이 이스케이프 처리된 도메인 또는 익명 인벤토리의 익명 ID입니다.
SITE_URL	지원이 중단되었습니다. 동일한 기능을 제공하는 SITE 매크로로 대체되었습니다.
TZ_OFFSET	시간대 오프셋입니다.
VERIFICATION	프로덕션 및 인증 파이프라인에서 광고 소재를 스캔하는 경우에 적용되는 여러 값 형식은 %%?VERIFICATION:true-val:false-val%%입니다. 여기서 매크로를 제외한 모든 값은 빈 문자열을 포함하여 true-val 및 false-val에 사용할 수 있습니다. 공개 입찰의 경우 거래소는 이 매크로를 사용하는 것이 좋습니다. 그러면 수요측 플랫폼에서 변경할 필요가 없습니다. 예를 들어 광고 소재에 %%?VERIFICATION:-1:5000%%이(가) 포함된 경우 텍스트 교체는 게재 시 5000, 인증 파이프라인의 -1가 됩니다. 이는 두 핑 집합을 구분하기 위한 것입니다.
WINNING_PRICE	계정 통화의 마이크로(micros)로 인코딩된 노출 비용(CPM 보다는 CPI 우선). 예를 들어 $5 USD의 낙찰 CPM은 5,000,000마이크로 CPM 또는 5,000마이크로 CPI에 해당합니다. 이 경우 WINNING_PRICE의 디코딩 값은 5,000이 됩니다. 낙찰 가격은 CPI에 지정됩니다.
WINNING_PRICE_ESC	URL 이스케이프 처리된 WINNING_PRICE

매크로에서 이스케이프 처리된 URL은 다음 스키마를 사용합니다.

• 공백 문자는 더하기 기호 (+)로 대체됩니다.
• 영숫자 문자 (0~9, a~z, A~Z) 및 !()*,-./:_~ 집합의 문자는 변경되지 않습니다.
• 다른 모든 문자는 %XX로 대체됩니다. 여기서 XX는 문자를 나타내는 16진수입니다.

게시자 제한사항

게시자는 BidRequest를 사용하여 허용할 광고에 대한 제한사항을 전달합니다. 다음 필드의 제한사항을 적용해야 합니다.

• allowed_vendor_type
• excluded_attribute
• excluded_sensitive_category

한 필드는 광고의 허용된 기능을 지정하고 다른 필드는 허용되지 않는 기능을 지정합니다. 허용되지 않는 기능이 있는 광고는 절대로 반환하지 마세요. 공급업체 유형과 같은 허용된 기능의 경우 공급업체 유형이 BidRequest의 allowed_vendor_type 목록에 있는 경우에만 광고를 반환합니다. 자세한 내용은 BidRequest 프로토콜 버퍼 정의에서 이러한 필드에 관한 설명을 참고하세요.

HTML 스니펫이 BidResponse에서 반환되면 BidResponse에서 attribute, category, click_through_url 필드를 정확하게 설정해야 합니다. 광고에 이러한 필드에 적용 가능한 값이 여러 개 있으면 모든 값을 포함해야 합니다. 자세한 내용은 BidResponse 프로토콜 버퍼 정의에서 이러한 필드에 관한 주석을 참고하세요. 이 필드가 설정되지 않은 응답은 삭제됩니다.

BidRequest.excluded_attribute의 가능한 값은 다음과 같습니다(publisher-excludable-creative-attributes.txt).

• 7 Tagging: IsTagged
  광고에 픽셀 또는 웹 비콘이 포함된 경우 향후 리마케팅을 위한 쿠키 ID 목록을 생성할 목적으로 이러한 광고를 허용하지 않습니다.
• 8 CookieTargeting: IsCookieTargeted
  쿠키 ID 목록이 구매자가 소유하거나 대표하는 사이트와 이전에 상호작용한 소비자 집합을 나타내는 쿠키 ID를 기반으로 소비자를 타겟팅하는 경우 광고가 허용되지 않습니다.
• 9 UserInterestTargeting: IsUserInterestTargeted
  쿠키 ID 목록이 구매자가 공통 관심분야 그룹으로 정의한 소비자 집합을 나타내는 쿠키 ID를 기반으로 소비자를 타겟팅하는 광고는 허용되지 않습니다.
• 21 CreativeType: Html
  광고는 BidResponse.Ad에 html_snippet 또는 snippet_template 필드를 사용할 수 없습니다.
• 22 CreativeType: VastVideo
  광고는 BidResponse.Ad의 video_url 필드를 사용할 수 없습니다.
• 30 InstreamVastVideoType: Vpaid
  광고 렌더링을 위해 VPAID 지원을 요구할 수 없습니다.
• 32 MraidType: MRAID
  광고는 MRAID API를 렌더링하도록 요구해서는 안 됩니다.
• 34 RichMediaCapabilityType: RichMediaCapabilityFlash
  광고 렌더링을 위해 플래시 지원을 요구해서는 안 됩니다.
• 39 RichMediaCapabilityType: RichMediaCapabilityHTML5
  광고 렌더링을 위해 HTML5 기능을 요구해서는 안 됩니다.
• 48 RichMediaCapabilityType: RichMediaCapabilityNonSSL
  광고는 SSL을 준수하지 않는 요청을 할 수 없습니다.

따라서 excluded_attribute 필드에 값 7이 포함된 경우 목록을 만드는 데 픽셀 또는 웹 비콘을 사용하는 광고를 반환해서는 안 됩니다. 이렇게 하는 광고는 BidResponse의 속성 필드에 값 7을 설정해야 합니다. 마찬가지로 excluded_attribute 필드에 값 48이 포함된 경우 SSL 페이지에서 렌더링할 수 있는 광고만 반환해야 합니다. 이에 따라 속성 47 RichMediaCapabilityType: RichMediaCapabilitySSL을 선언해야 합니다.

또한 BidRequest의 excluded_sensitive_category 필드는 참조 데이터 페이지에 있는 ad-sensitive-categories.txt 파일의 코드를 사용합니다. 다음은 이러한 코드 중 일부의 확장된 설명입니다.

• 3 Politics
  정치 또는 논란이 되고 있는 사회 문제는 포함됩니다. 특정 정당의 의견을 대변하지 않는 언론사에 대한 광고는 포함되지 않습니다.
• 4 Dating
  데이트 서비스 및 온라인 데이트 커뮤니티가 포함됩니다.
• 5 Religion
  종교 관련 광고와 특정 종교의 교리에 찬성하거나 반대하는 광고가 포함됩니다. 점성술 또는 교파가 없는 종교는 포함되지 않습니다.
• 7 Video Games (Casual & Online)
  비디오 게임, 온라인 게임 및 다운로드 게임은 포함됩니다. 비디오 게임 콘솔은 포함되지 않습니다.
• 8 Ringtones & Downloadables
  벨소리를 포함한 모바일 부가 기능과 데스크톱 PC용 화면 보호기 및 배경화면, 소셜 네트워크용 프로필 레이아웃 및 그래픽과 같은 다운로드 가능한 기능
• 10 Get Rich Quick
  빠른 수입을 약속하는 제도
• 18 Weight Loss
  체중 감량, 다이어트 및 관련 제품과 프로그램은 포함됩니다. 건강식 또는 일반 피트니스 광고는 포함되지 않습니다.
• 19 Cosmetic Procedures & Body Modification
  주름 제거, 지방 흡입, 레이저, 제모 및 모발 이식, 문신, 체형 교정이 포함됩니다.
• 23 Drugs & Supplements:
  의약품, 비타민, 보조제 및 관련 소매업체는 포함됩니다. 마약 관련 정보를 제공하는 자료는 포함되지 않습니다.
• 24 Sexual & Reproductive Health
  성기능 관련 및 불임 치료 광고가 포함됩니다. 일반 임신 자료는 포함되지 않습니다.
• 35 Social Casino Games
  현금이나 경품과 같이 가치가 있는 것을 획득할 기회가 없는 시뮬레이션 도박 게임(포커, 슬롯, 빙고, 복권, 스포츠 베팅, 경주 베팅을 포함하되 이에 국한되지 않음)이 포함됩니다.
• 36 Significant Skin Exposure
  흉골부터 허벅지 가운데까지의 신체 부위에 옷을 걸치지 않았거나, 속옷, 수영복, 란제리, 속이 비치는 옷을 입고 있거나 수건 또는 침대 시트와 같이 의류가 아닌 제품을 걸치고 있는 광고 이미지
• 37 Sensationalism
  호기심을 자극하여 클릭을 유도하는 것을 목표로 하는 광고로, 종종 과장된 표현이나 이미지가 담긴 티저 메시지를 사용합니다. 선정적인 주제 (예: 유명인의 체포, 사망 또는 이혼)를 중심으로 하거나 충격적인 내용의 광고가 포함됩니다.

개방형 측정

Open Measurement를 사용하면 모바일 앱 환경에 게재되는 광고에 대해 독립적인 측정 및 인증 서비스를 제공하는 서드 파티 공급업체를 지정할 수 있습니다.

현재 지원되는 광고 형식으로는 동영상, 배너, 전면 광고가 있습니다. 이러한 형식이 포함된 입찰 응답에서 Open Measurement를 사용하는 방법에 관한 자세한 내용은 Open Measurement SDK 고객센터 도움말을 참고하세요.

샘플 입찰 응답

다음 섹션에서는 다양한 광고 유형에 대한 샘플 입찰 응답을 보여줍니다.

앱 배너

Google

예 보기

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 68101
    billing_id: 86124453824
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 105
  buyer_creative_id: "test_creative_id_450011"
  width: 390
  height: 61
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 23

OpenRTB JSON

예 보기

{
  "id": "4735YiDtCstD1Y445YHstT",
  "cur": "USD",
  "seatbid": [
    {
      "seat": "6670:8027:659779",
      "bid": [
        {
          "ext": {
            "third_party_buyer_token": "7Njk3e2s21E6Url23a30w4d4621Qh57u4w2L9uy4xq864V6lMf348aC72L767592sIPdJ84U2E2aU00jjVGF3wbjl25L019c7Z43eKVb09Sk5fRX72B33Q92f359l40M0t6jAseiJVp8"
          },
          "crid": "test_creative_id_109447",
          "exp": 900,
          "id": "M9mAq8768Nr7W048E6G",
          "price": 0.025286061000000002,
          "adomain": [
            "google.com"
          ],
          "w": 320,
          "impid": "1",
          "h": 50,
          "burl": "https://test.com/imp?id=123456",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "cid": "48666909902"
        }
      ]
    }
  ]
}

OpenRTB Protobuf

예 보기

id: "AA1796z4iC270863f4w9n0"
seatbid {
  bid {
    id: "9hJvWOk2f3GF6Z0qIR6"
    impid: "1"
    price: 0.917419
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "38676986454"
    crid: "test_creative_id_589316"
    w: 320
    h: 50
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      billing_id: 38676986454
    }
  }
  seat: "5890:4144:786042"
}
bidid: "3L6xM6aN-2c492E7J-IxrR-gA80g0xJb980"
cur: "USD"

앱 전면 광고

Google

예 보기

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 7510304
    billing_id: 70362152071
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  buyer_creative_id: "test_creative_id_775966"
  advertiser_name: "Google"
  width: 344
  height: 566
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 16

OpenRTB JSON

예 보기

{
  "id": "I61Sxs7d484326p4D83O5f",
  "seatbid": [
    {
      "bid": [
        {
          "id": "9T39T8KnUivM9518KnH",
          "impid": "1",
          "price": 0.6353,
          "adid": "test_creative_id_288773",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "cid": "42824952399",
          "crid": "test_creative_id_288773",
          "w": 414,
          "h": 816,
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "QyYKoxm0",
              "campaign": "87661657",
              "itunesitem": "434836425",
              "sourceapp": "240782188",
              "fidelities": [
                {
                  "fidelity": 1,
                  "nonce": "abc1f08d-785b-4937-90eb-c2bbd92dd5d8",
                  "signature": "j3kdO5nT3kl4X9488yr6h7N8I83Ck3n0fRQ1tidNAy13q29QBC67917Dw44w99BRx70a6z5i565lc64979x9G1a83d3gjiA0",
                  "timestamp": "1674986741687"
                },
                {
                  "fidelity": 0,
                  "nonce": "abc1f08d-785b-4937-90eb-c2bbd92dd5d8",
                  "signature": "H6opG1lxBHNi921C65Yq6972239i01goGrQb53xtq38Dlm9M0wU4256868fwy509762N5po8Ou2x3vb0JJX7432yLTv2X021",
                  "timestamp": "1674986741687"
                }
              ]
            },
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "6447:7558:568680"
    }
  ],
  "bidid": "4Jol9v45-xp0442M7-268b-9Ix24W30Q298"
}

OpenRTB Protobuf

예 보기

id: "82WW59EKX928i315ws8Vf6"
seatbid {
  bid {
    id: "GzqINzH96g3ZX8g67FO"
    impid: "1"
    price: 0.011380645260214805
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "43834715105"
    crid: "test_creative_id_772436"
    cat: "IAB14"
    w: 360
    h: 640
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 43834715105
    }
  }
  seat: "1184:9545:274689"
}
cur: "USD"

앱 전면 광고 동영상

Google

예 보기

ad {
  adslot {
    id: 1
    max_cpm_micros: 830000
    billing_id: 45806415189
    buyer_reporting_id: "T7f433l"
  }
  click_through_url: "google.com"
  attribute: 47
  video_url: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
  buyer_creative_id: "test_creative_id_596030"
  width: 640
  height: 360
  event_notification_token: "token"
}
processing_time_ms: 9

OpenRTB Protobuf

예 보기

id: "cRPF1960K8WH788KM8ZT5k"
seatbid {
  bid {
    id: "99862J52T2r9f8n6hzY"
    impid: "1"
    price: 0.2873480215418293
    adid: "test_creative_id_958969"
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    cid: "80831705186"
    crid: "test_creative_id_958969"
    w: 480
    h: 854
  }
  seat: "5731:4728:218110"
}
bidid: "dR2wx766-444e907U-Xpv0-634m58Wa5V73"
cur: "USD"

앱 네이티브

Google

예 보기

ad {
  adslot {
    id: 1
    max_cpm_micros: 80000
    billing_id: 52511964331
    deal_id: 1
  }
  click_through_url: "google.com"
  attribute: 70
  buyer_creative_id: "test_creative_id_287513"
  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: 1200
      height: 627
    }
    app_icon {
      url: "https://native.test.com/icon?id=123456"
      width: 100
      height: 100
    }
    star_rating: 4.800000190734863
    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"
  event_notification_token: "token"
  skadn {
    version: "3.0"
    network: "Ft98iS7c"
    campaign: 31947859
    itunesitem: "305656909"
    sourceapp: "531025541"
    fidelities {
      fidelity_type: STOREKIT_RENDERED_ADS
      nonce: "42748172-ff0e-43a1-a9da-e97f28e09eab"
      timestamp: 1675328391911
      signature: "9bGR391q8KEUGg0N8aI5Vg90fgX731q67y2xtXH09k27A5UccmE83YT9833q4g72P3t01759F15J9ZVSx0984q9A2eHnM5fn"
    }
    fidelities {
      fidelity_type: VIEW_THROUGH_ADS
      nonce: "42748172-ff0e-43a1-a9da-e97f28e09eab"
      timestamp: 1675328391911
      signature: "Hxr3FdOR2298951684ztq85X3GgF0gI1O3K7CuhAb6tC9g06fsvU1N1Uo7h7Ts38755801rVSB63o50cfk6q80N66vHr1u59"
    }
  }
  click_tracking_urls: "https://google.com/rtb/click?imp_id=4a4cb2c0-4012-4434-b37e-ed08095a1bc8"
  advertised_app_id: "APP_ID_OMITTED"
}
processing_time_ms: 57

OpenRTB JSON

예 보기

{
  "id": "w68lr2H3Q9S8mAc18QP2wp",
  "seatbid": [
    {
      "bid": [
        {
          "id": "4VF8803Y5b4314j072f",
          "impid": "1",
          "price": 0.01575,
          "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\": 100, \"h\": 100}}, {\"id\": 5, \"img\": {\"url\": \"https://native.test.com/icon?id=123456\", \"w\": 200, \"h\": 200}}, {\"id\": 7, \"data\": {\"value\": \"\\uc804\\uc124\\uc758 \\ub9cc\\ub819 \\uc2ac\\ub77c\\uc784\\uc774 \\ub418\\uc5b4\\ubcf4\\uae30\"}}], \"link\": {\"url\": \"https://www.google.com\", \"clicktrackers\": [\"https://native.test.com/click?id=123456\"]}, \"imptrackers\": [\"https://test.com/impression?id=123456&amt=${AUCTION_PRICE}\"]}",
          "adid": "test_creative_id_546056",
          "adomain": [
            "google.com"
          ],
          "cid": "19851733647",
          "crid": "test_creative_id_546056",
          "cat": [
            "IAB9-25"
          ],
          "w": 1200,
          "h": 627,
          "ext": {
            "event_notification_token": {
              "payload": "token"
            }
          }
        }
      ],
      "seat": "7859:5415:609992"
    }
  ],
  "bidid": "58nBZSP4-e3LCgFS8-C2Pz-01O0337Vr56A",
  "cur": "USD"
}

OpenRTB Protobuf

예 보기

id: "a504l3y62599Xv09173V2Z"
seatbid {
  bid {
    id: "jP1Ok7b46T9p789v6R2"
    impid: "1"
    price: 0.1680304792439826
    adid: "test_creative_id_620230"
    adomain: "google.com"
    cid: "74994669337"
    crid: "test_creative_id_620230"
    w: 1200
    h: 627
    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}"
    }
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      billing_id: 74994669337
      skadn {
        version: "3.0"
        network: "46L6RQ79"
        campaign: "17432314"
        itunesitem: "782565581"
        nonce: "ecfc7b9a-f328-4719-bba5-fa14c0233615"
        sourceapp: "187789793"
        timestamp: ""
        signature: "169L03hq0qtDeIoj19lL880oO96P24du405y60U08H71302C5d5r315jus940016d208o6kFt2G14x4YK530KI683wI41bR4"
        fidelities {
          fidelity: VIEW_THROUGH_ADS
          nonce: "1919c279-d6c5-46d3-b486-0c15b91bfd51"
          timestamp: "1675346267364"
          signature: "12g8675BqX3x8jJ60Zt9LwlNQwfe20s6M6n4zwtJ4H5170DU991wfwi9hn108rX53bU872L60u2io288755x0RS9bsvAg68b"
        }
        fidelities {
          fidelity: STOREKIT_RENDERED_ADS
          nonce: "1919c279-d6c5-46d3-b486-0c15b91bfd51"
          timestamp: "1675346267364"
          signature: "qAF324j0597P58JrYins8Lz01v7p41zfJ8JK6l2hoZ36z6RS1GE7FT0r8bAn6B93s77tv04k59fr4J173W992Wa3Ev40489R"
        }
      }
    }
  }
  seat: "6989:4819:604522"
}
bidid: "15ds1647-89y8715T-V0AX-6DL468ks81Q5"
cur: "USD"

웹 동영상

Google

예 보기

ad {
  adslot {
    id: 1
    max_cpm_micros: 16000000
    billing_id: 34223090460
    deal_id: 17775265
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  video_url: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
  buyer_creative_id: "test_creative_id_551392"
  advertiser_name: "Google"
  event_notification_token: "token"
}
processing_time_ms: 7

Exchange 입찰자용 모바일 웹 배너

OpenRTB Protobuf

예 보기

id: "q39213i4x083QS49D4334b"
seatbid {
  bid {
    id: "T55L5u7y56cBy4x484B"
    impid: "1"
    price: 0.35
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "11573735693"
    crid: "test_creative_id_591839"
    w: 300
    h: 600
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 11573735693
      third_party_buyer_token: "w7KR11S30AAE1345q5aG7tz46OkB8u911zbR7HVMwk0E6zUx7Y0uo4cxz32kwa3bZ320H00QT5yYifRxY8z96r74bLedPf6Fb25Z4y0U7T3i3j9k587N2iFlZ5Kl20Z5vou8M5zFWAwa"
    }
  }
  seat: "8020:4047:162759"
}
bidid: "DQd2WoG7-96j6H89H-4uCI-1303QT599c50"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 170
}