原生廣告

原生廣告會配合周圍內容和視覺設計設定格式，藉此提高曝光率和點擊率。原生廣告廣告空間可用於行動應用程式、電腦版網站和行動版網站。如要進一步瞭解原生廣告，請參閱「原生廣告總覽」。

公開出價和授權買家都支援原生廣告。

以下是原生廣告的工作流程：

1. 廣告空間傳送原生廣告呼叫給 Google。呼叫指定一或兩種原生廣告範本，每個範本都會指定偏好的原生欄位。
2. Google 向買家傳送 RTB 出價要求，其中包含廣告空間所要求的欄位清單。
3. 有興趣的買方透過回應傳回要求的欄位。
4. Google 舉行競價選出得標出價，並向發布商傳送買家提供的廣告素材資源。
5. 發布商將素材資源組合成原生廣告，並根據網站的設計調整廣告風格。

訊息格式

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_native 而非 BidRequest.imp.native.request 的出價要求。此外，端點必須傳回填入 BidResponse.seatbid.bid.adm_native 而非 BidResponse.seatbid.bid.adm 的出價回應，否則會從競價中篩除。

如果您使用買方 SDK來算繪原生廣告，請務必在提交素材資源以供審查時，在 declared_ad 中加入圖片 type。

原生廣告範本

原生廣告範本會說明原生廣告的元件，並決定出價要求中 OpenRTB 的 NativeRequest 或已淘汰的 Google RTB 通訊協定 NativeAdTemplate 的內容和結構。Google 支援兩種最常見的原生廣告範本，分別適用於非影片和影片原生廣告：

• 應用程式安裝廣告範本：宣傳並提高行動應用程式安裝量。
• 內容廣告範本：品牌或網路廣告的文字和圖像組合更為通用。
• 影片應用程式安裝廣告範本
• 影片內容廣告範本

其他範本對欄位、規格和大小可能有不同的規定。

應用程式安裝廣告範本

必填和建議欄位

下表中的欄位標示為「必填」或「建議」。規則如下：

• 標有「必填」的欄位為出價方必填欄位。
• 出價方不需要使用標示為「建議」的欄位，且如果提供這些欄位，出版商可以選擇是否顯示 (例如星號評分)。
• 行動號召 (CTA) 一律會標示為「建議」，因為如果出價方未傳送 CTA，系統會指派預設 CTA，但如果出價方傳送 CTA，系統一律會顯示 CTA。

下表列出應用程式安裝廣告範本的欄位。行動應用程式會使用這些欄位建立原生應用程式安裝廣告。

欄位	說明	是否為必填或建議項目？	是否一律顯示？	建議的圖片大小/半形字元上限	範例
廣告標題	應用程式名稱	必填	是	25 個半形字元	Flood-It!
圖片	應用程式的螢幕截圖或其他相關圖片	必填	否	視發布商所需的顯示比例而定，可為 1,200 像素 x 627 像素或 600 像素 x 600 像素。	<遊戲「Flood-It!」的螢幕截圖>
內文	應用程式的主文	必填	否	90 個半形字元	看似簡單，但挑戰性十足，令人愛不釋手！
應用程式圖示	應用程式圖示	必填	否	128 x 128 像素	<Flood-it! 應用程式圖示>
行動號召	偏好的使用者動作	建議	是	15 個字元	安裝
星級評等	代表應用程式在應用程式商店的評分的星星數量 (0 到 5 顆星)	建議	否	0 - 5	4.5
價格	應用程式的費用	建議	否	15 個字元	免費

文字長度相關注意事項

如果買方傳送的文字素材資源 (例如內文) 長度超過建議的字元上限，Google 或發布商可能會截斷文字並省略。請注意，中文、日文和韓文的可輸入字元數是「超過指定值後可能會被截斷」值的一半。例如，英文的標題上限為 90 個半形字元，中文則是 45 個半形字元。

圖片大小相關注意事項

發布商可以：

• 對稱裁剪主圖片，裁剪掉的比例最高可達 20%。
• 在不變更顯示比例的情況下縮放圖片。
• 系統可能會篩除顯示比例與高度和寬度明顯不同的圖片。

內容廣告範本

下表列出內容廣告範本的欄位。發布商會使用這些欄位建立原生內容廣告。

欄位	說明	是否為必填或建議項目？	是否一律顯示？	建議圖片大小/字元上限 *	範例
廣告標題	廣告標題	必填	是	25 個半形字元	最低房貸利率
圖片	廣告主要圖片	必填	否	視發布商所需的顯示比例而定，可為 1,200 像素 x 627 像素或 600 像素 x 600 像素。	<廣告的主要圖片>
內文	廣告素材	必填	否	90 個半形字元	你的布魯克林住家 - 價格更便宜，而且比你想像的更快！
標誌	廣告主標誌或其他相關小圖片	建議	否	128 x 128 像素	<NY Mortgage Inc. 的標誌>
行動號召	使用者偏好的動作	建議	否	15 個字元	詢價
廣告主	廣告主或品牌的識別文字	必填	否	25 個半形字元	NY Mortgage Inc.

影片應用程式安裝廣告範本

欄位	說明	是否為必填或建議項目？	是否一律顯示？	建議圖片大小/字元上限數量 *	範例
影片	播放影片廣告所需的必要素材資源都在這個影片 VAST 回應中。	必要	否	-	包含 Flood-It! 的 VAST XML 網址影片廣告
標題	應用程式名稱	必要	是	25 個半形字元	Flood-It!
圖片	在影片廣告被點擊之前或載入期間，播放器中顯示的圖像 (縮圖)。	必要	否	應與影片的顯示比例一致 (例如 16: 9 影片為 1280x720，640x480 影片為 4x3)。	遊戲「Flood-It!」的螢幕截圖。或從影片中
內文	應用程式的主文	必要	否	90 個半形字元	看似簡單，但挑戰性十足，令人愛不釋手！
應用程式圖示	應用程式圖示	必要	否	128 x 128 像素	Flood-it! 應用程式圖示
行動號召	偏好的使用者動作	必要	是	15 個字元	安裝
星級評等	代表應用程式在應用程式商店中的評分的星號數量 (0 到 5 顆星)	建議	否	0 - 5	4.5
價格	應用程式的費用	建議	否	15 個字元	免費

限制

• 影片：所有影片都必須採用 VAST 網址或 VAST 代碼的格式。無法指定 WebM、MP4 等原始影片檔案。

• 文字長度：如果買方在回應中指定文字素材資源 (例如 body)，Google 或發布商可能會截斷並省略該文字。請注意，中文、日文和韓文的可輸入字元數是「長度上限」值的一半。例如：英文的標題上限為 90，中文則是 45。

• 圖片大小：發布商可以：

  • 對稱裁剪主圖片，但只能在一個維度 (高度或寬度) 裁剪，裁剪掉的比例最高可達 20%。
  • 縮放圖片，但不變更顯示比例。

應用程式安裝廣告示例

影片內容廣告範本

欄位	說明	是否為必填或建議項目？	是否一律顯示？	建議圖片大小/字元上限數量 *	範例
影片	播放影片廣告所需的必要素材資源都在這個影片 VAST 回應中。	必要	是	-	包含 Flood-It! 的 VAST XML 網址影片廣告
標題	廣告標題	必要	是	25 個半形字元	最低房貸利率
圖片	在影片廣告被點擊之前或載入期間，播放器中顯示的圖像 (縮圖)。	必要	否	應與影片的顯示比例一致 (例如 16: 9 影片為 1280x720，640x480 影片為 4x3)。	影片的螢幕截圖
內文	廣告內容	必要	否	90 個半形字元	你的布魯克林甜蜜家園 - 比你想像的更便宜，更快到貨！
標誌	廣告主標誌或其他相關的小型圖片	建議	否	128 x 128 像素	NY Mortgage Inc. 的標誌
行動號召	使用者偏好的動作	必要	否	15 個字元	取得報價
廣告主	廣告主或品牌的識別文字	必要	否	25 個半形字元	NY Mortgage Inc.

中繼資料欄位

下列元資料欄位可供所有支援的廣告範本共用：

Google RTB 通訊協定	OpenRTB 等值	說明
NativeAd.click_link_url	Link.url	使用者點按廣告後，瀏覽器會呼叫的網址。 可做為重新導向鏈結的第一個步驟，最終會導向到達網頁。針對原生廣告，建議您使用 click_link_url 做為欄位，設定使用者最終前往的目的地。如果是動態到達網頁，則必須使用這個欄位。
Ad.click_through_url	Bid.adomain	如果出價方打算出價，就必須設定此屬性。這是程式碼片段的到達網頁網址集合，包括使用者點選顯示廣告後會前往的網址，以及在轉譯廣告中顯示的任何網址。請勿加入與最終到達網頁無關的廣告伺服器中介呼叫。傳回片段或影片廣告，但宣告沒有 click_through_url 的 BidResponse 會遭到捨棄。只有在設定 html_snippet、video_url 或 native_ad 時，才設定這個欄位。這項資料會用做目的地網址宣告，例如用於對發布商封鎖的網址或廣告分類進行後續篩選。使用原生廣告時，請參閱 NativeAd.click_link_url。 對於非原生廣告，這項功能不會用於點擊追蹤或任何其他廣告功能，只會用於到達網頁網址宣告。 針對原生廣告，如果未設定 NativeAd.click_link_url，系統會使用 click_through_url 的第一個值，將使用者導向到達網頁。此外，所有值都會用於做為到達網址宣告 (類似非原生情況)。
NativeAd.click_tracking_urls	Link.clicktrackers	選用設定。可讓廣告客戶追蹤使用者對廣告的點擊次數的其他網址。
Ad.ad_choices_destination_url	BidExt.ad_choices_destination_url	連結至廣告偏好設定或停用頁面。如果有此標誌，原生廣告素材就會加上標準 AdChoices 圖示，並連結到這個網址。系統支援原生廣告，但出價回應中的原生訊息不包含這項資訊。
Ad.impression_tracking_url	NativeResponse.imptrackers	原生曝光應使用 Authorized Buyers 即時出價 proto 中的 impression_tracking_url 或 OpenRTB 中的原生曝光追蹤器追蹤。

Google RTB 通訊協定必要和建議欄位

required_fields 和 recommended_fields 是由發布商指定。我們將說明如何轉譯這些位元欄位，以判斷欄位是否為必填或建議填寫。

位元欄位會使用二進位值的每個位元來儲存 true 或 false 陳述式，這等同於傳送許多布林信號 (例如 is_logo_required 或 is_header_required)，但所有信號都會一起打包。

注意：在 OpenRTB 中，BidRequest.imp.native.request_native.assets.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	是

出價要求中的原生廣告範本表示法

收到含有原生廣告空間的出價要求時，系統會根據所使用的通訊協定，以不同形式納入原生廣告範本。我們建議使用 OpenRTB，因為 Google 通訊協定已淘汰。

在 OpenRTB 中，原生廣告範本會透過 NativeRequest 訊息加以描述。在 Google RTB 通訊協定中，會使用 NativeAdTemplate 說明。這些訊息會提供原生廣告空間的詳細資訊，包括：

• 必要或建議填寫的欄位。
• 圖片、標誌和應用程式圖示的尺寸。
• 廣告算繪樣式的規格。

注意：對於 style_layout_type 欄位，PIXEL 表示原生單位為固定大小，而 FLUID 則表示會縮放至填滿所屬欄的寬度，並調整高度以保留顯示比例。指定 FLUID 時，高度和寬度可能會顯示為 1x1。

OpenRTB 素材資源 ID

OpenRTB 會在出價要求中傳遞資產陣列，描述您應在回應中傳回的原生廣告結構。請注意，要求中的每個素材資源都會有 ID，且必須在回應中指定對應的素材資源。如需這些 ID 在要求和回應之間的對應方式示例，請參閱原生出價要求範例和原生出價回應範例。

出價回應中原生廣告的表示法

在出價原生廣告空間時，買方必須填入出價要求中指定的必要欄位。在 OpenRTB 中，您可以使用 BidResponse.seatbid.bid.adm_native 執行這項操作 (使用 Protobuf)，或使用 BidResponse.seatbid.bid.adm 執行這項操作 (使用 JSON)。如果是已淘汰的 Google 通訊協定，則可使用 BidResponse.ad.native_ad 欄位完成這項操作。

出價要求範例

注意：如要瞭解回應中哪些項目為必填或選填，請參閱出價要求中的原生廣告範本。在 OpenRTB 中，您可以在 BidRequest.imp.native 中找到這個值。對於已淘汰的 Google 通訊協定，您可以在 BidRequest.adslot.native_ad_template 中找到這項資訊。

非影片出價要求

OpenRTB Protobuf

顯示範例

序列化要求

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
}

OpenRTB JSON

顯示範例

{
  "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
  }
}

Google

顯示範例

序列化要求

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
}

出價回應範例

非影片出價回應

OpenRTB Protobuf

顯示範例

序列化回應

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"

OpenRTB JSON

顯示範例

{
  "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"
}

Google

顯示範例

序列化回應

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/"
    }
  }
}