本頁面由 Cloud Translation API 翻譯而成。

買方 SDK 廣告格式

買方 SDK 廣告會使用您的 SDK 顯示的廣告素材。

由整合您出價的發布商提供的行動應用程式廣告空間轉接器貼到自家應用程式，即可接受出價與買方 SDK 顯示的廣告格式一致廣告素材的顯示方式會根據 SDK 實作與 SDKRenderedAd 出價回應。

您可以設定出價，包括買方 SDK 顯示的廣告或任何其他格式 Google Mobile Ads SDK 支援，但所有則包含這兩個出價的出價都會被篩除。

需求條件

買方 SDK 廣告可供核准的買方使用。這種格式需要額外的功能。請與您的客戶技術顧問聯絡，設定您的帳戶以便放送買方 SDK 廣告接著，您可以導入出價轉接程式可讓 SDK 與 Google Mobile Ads SDK 通訊發布商必須導入 SDK 和轉接程式

建議您將廣告素材提交到評論，再將其納入出價回應。與客戶技術顧問聯絡如果您不知道出價時的廣告素材類型。

如果出價要求支援此廣告格式，您就可以指定要放送的廣告使用您 SDK 的技術，並在出價sdk_rendered_ad 回應。

出價要求

行動應用程式廣告空間的出價要求包含 SDK 的詳細資料，以及發布商應用程式中的轉接程式，且可用於在以下位置顯示：欄位：

SDK ID

您可以使用出價要求，找出您必須在出價中提供的id 買方 SDK 顯示的廣告。

請參閱下列欄位：

OpenRTB：BidRequest.app.ext.installed_sdk
Google RTB 通訊協定 (已淘汰)：BidRequest.mobile.installed_sdk

如要進一步瞭解 InstalledSdk 訊息，請前往 OpenRTB 和 Google 通訊協定指南

廣告單元對應

您可以使用出價要求，讀取與出價版位相符的廣告單元對應資料。

請參閱下列欄位：

OpenRTB：BidRequest.imp.ext.ad_unit_mapping
Google RTB 通訊協定 (已淘汰)：BidRequest.AdSlot.ad_unit_mapping

如要進一步瞭解 AdUnitMapping 物件，請參閱 OpenRTB 和 Google 通訊協定指南

安全信號

發布商可以與出價方共用安全信號。你可以透過 OpenRTB 的 BuyerGeneratedRequestData 物件或已淘汰的 Google 即時出價通訊協定的 SecureSignal 物件。

請參閱下列欄位：

OpenRTB：BidRequest.imp.ext.buyer_generated_request_data.data
Google RTB 通訊協定 (已淘汰)：BidRequest.AdSlot.SecureSignal.data

如要進一步瞭解安全信號的表示方式，請參閱 OpenRTB 和 Google 通訊協定指南

測試要求

您可閱讀「測試要求」欄位，瞭解出價要求是否為測試。

請參閱下列欄位：

OpenRTB：BidRequest.test
Google RTB 通訊協定 (已淘汰)：BidRequest.is_test

如要進一步瞭解 Test 欄位，請前往 OpenRTB 和 Google 通訊協定指南

出價要求範例

id: "<bid_request_id>"
imp {
  id: "1"
  banner {
    w: 320
    h: 50
    ...
  }
...
  adx_ext {
   ...
    ad_unit_mapping {
      keyvals {
        key: "key_1"
        value: "value_1"
      }
      keyvals {
        key: "key_2"
        value: "value_2"
      }
      ...
      format: FORMAT_BANNER
    }
  }
}
app {
 ...
  adx_ext {
    installed_sdk {
      id: "com.google.ads.mediation.partner.PartnerMediationAdapter"
      sdk_version {
        major: 1
        minor: 2
        micro: 30
      }
      adapter_version {
        major: 1
        minor: 2
        micro: 3000
      }
    }
    installed_sdk {
    ...
    }
    ...
  }
}
device {
  ...
}
user {
  ...
  }
  adx_ext {
    eids {
      source: "com.google.ads.mediation.partner.PartnerMediationAdapter"
      uids {
        id: "<partner_signal_string>"
      }
    }
  }
}
at: 1
tmax: 1000
cur: "USD"
test: 1
...
adx_ext {
  google_query_id: "<query_string>"
  ...
}

出價回應

出價回應中必須填寫下列欄位：

OpenRTB：
- BidResponse.seatbid.bid.adomain
- BidResponse.seatbid.bid.ext.billing_id
- BidResponse.seatbid.bid.crid
- BidResponse.seatbid.bid.w
- BidResponse.seatbid.bid.h
Google RTB 通訊協定 (已淘汰)：
- BidResponse.Ad.click_through_url
- BidResponse.Ad.AdSlot.billing_id
- BidResponse.Ad.buyer_creative_id
- BidResponse.Ad.width
- BidResponse.Ad.height

此外，出價回應必須包含 SdkRenderedAd，且包括：

SDK ID

請使用 id 欄位提供 ID，讓 SDK 顯示廣告。

您可以透過下列欄位在出價要求中找到 ID：

OpenRTB：BidRequest.app.ext.installed_sdk
Google RTB 通訊協定 (已淘汰)：BidRequest.mobile.installed_sdk

如要進一步瞭解 InstalledSdk 訊息，請前往 OpenRTB 和 Google 通訊協定指南

聲明的廣告

請使用 declared_ad 欄位提供符合出價要求的廣告素材在第 CreativeEnforcementSettings 項相關規定，以及廣告的轉譯資料僅限 html_snippet、video_url、video_vast_xml 或應填入 native_response。

OpenRTB：BidResponse.seatbid.bid.ext.sdk_rendered_ad.declared_ad
Google RTB 通訊協定 (已淘汰)：BidResponse.ad.sdk_rendered_ad.declared_ad

如果您沒有填入 declared_ad，我們將無法審查廣告素材，系統會從競價中篩除所有包含該廣告素材的出價。

轉譯資料

請使用 rendering_data 欄位，為買方 SDK 提供以下資料：用來顯示廣告的資訊

OpenRTB：BidResponse.seatbid.bid.ext.sdk_rendered_ad.rendering_data
Google RTB 通訊協定 (已淘汰)：BidResponse.ad.sdk_rendered_ad.rendering_data

要刊登買方 SDK 廣告的出價必須在 declared_ad中指定廣告素材 ] 欄位。宣告的廣告必須如實呈現 rendering_data。

以下是 SdkRenderedAd 物件的範例：

{
  "id": "1234567",
  "rendering_data": "\xd58...,\xd4\x89\xd\xf9",
  "declared_ad": {
    "html_snippet": "<iframe src=\"https://example.com/ads?id=123&
      curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
  }
}

我們建議您使用即時出價 API 將廣告素材提交到評論並且在出價回應中納入這些網址

詳情請參閱 Google 和 OpenRTB 通訊協定指南，進一步瞭解「SdkRenderedAd」欄位。

出價回應範例

以下是每種廣告格式的出價回應範例：

id: "<bid_request_id>"
seatbid {
  bid {
    id: "<bidder_generated_response_id>"
    impid: "1"
    price: 99
    adomain: "https://play.google.com/store/apps/details?id=com.test.app"
    cid: "<billing_id>"
    crid: "<creative_id>"
    w: 320
    h: 50
    burl: "https://abc.com/billing?td=fn&win_price=${AUCTION_PRICE}"
    adx_ext {
      sdk_rendered_ad {
        id: "com.google.ads.mediation.partner.PartnerMediationAdapter"
        rendering_data: "<rendering_data_string>"
        declared_ad {
          click_through_url: "https://play.google.com/store/apps/details?id=com.test.app"
          html_snippet: "<!doctype html> <html> ... </html>"
        }
      }
      event_notification_token {
        payload: "<payload_string>"
      }
      billing_id: 141763360450
    }
  }
}
bidid: "<bidder_generated_response_id>"
cur: "USD"

插頁式

id: "<bid_request_id>"
seatbid {
  bid {
    id: "<bidder_generated_response_id>"
    impid: "1"
    price: 400
    adomain: "https://play.google.com/store/apps/details?id=com.test.app"
    cid: "<billing_id>"
    crid: "<creative_id>"
    w: 412
    h: 775
    adx_ext {
      sdk_rendered_ad {
        id: "com.google.ads.mediation.partner.PartnerMediationAdapter"
        rendering_data: "<rendering_data_string>"
        declared_ad {
          click_through_url: "https://play.google.com/store/apps/details?id=com.test.app"
          video_vast_xml: "<VAST version=\"2.0\"><Ad>...</Ad></VAST>"
        }
      }
      event_notification_token {
        payload: "<payload_string>"
      }
    }
  }
}
bidid: "<bidder_generated_response_id>"
cur: "USD"

獎勵影片廣告

id: "<bid_request_id>"
seatbid {
  bid {
    id: "<bidder_generated_response_id>"
    impid: "1"
    price: 400
    adomain: "https://play.google.com/store/apps/details?id=com.test.app"
    cid: "<billing_id>"
    crid: "<creative_id>"
    w: 412
    h: 775
    adx_ext {
      sdk_rendered_ad {
        id: "com.google.ads.mediation.partner.PartnerMediationAdapter"
        rendering_data: "<rendering_data_string>"
        declared_ad {
          click_through_url: "https://play.google.com/store/apps/details?id=com.test.app"
          video_vast_xml: "<VAST version=\"2.0\"><Ad>...</Ad></VAST>"
        }
      }
      event_notification_token {
        payload: "<payload_string>"
      }
    }
  }
}
bidid: "<bidder_generated_response_id>"
cur: "USD"

原生

id: "<bid_request_id>"
seatbid {
  bid {
    id: "<bidder_generated_response_id>"
    impid: "1"
    price: 400
    adomain: "https://play.google.com/store/apps/details?id=com.test.app"
    cid: "<billing_id>"
    crid: "<creative_id>"
    w: 1200
    h: 627
    adx_ext {
      sdk_rendered_ad {
        id: "com.google.ads.mediation.partner.PartnerMediationAdapter"
        rendering_data: "<rendering_data_string>"
        declared_ad {
          click_through_url: "https://play.google.com/store/apps/details?id=com.test.app"
          native_response {
            ...
            assets {
              id: 1
              title {
                text: ""
              }
            }
            assets {
              id: 2
              data {
                value: "<some_string>"
              }
            }
            assets {
              id: 3
              data {
                value: "View now"
              }
            }
            assets {
              id: 4
              img {
                url: "<valid_image_url>"
                w: 1200
                h: 627
                type: 3
              }
            }
            assets {
              id: 5
              img {
                url: "<valid_image_url>"
                w: 100
                h: 100
                type: 1
              }
            }
            assets {
              id: 6
              data {
                value: ""
              }
            }
            assets {
              id: 7
              data {
                value: "<some_string>"
              }
            }
            link {
              url: "<destination_link>"
            }
          }
        }
      }
      event_notification_token {
        payload: "<payload_string>"
      }
    }
  }
}
bidid: "<bidder_generated_response_id>"
cur: "USD"

廣告素材審核

廣告素材必須先經過審查才能放送，確保符合政策和發布商可以管理叢集設定，像是節點資源調度、安全性和其他預先設定項目

您可以透過下列兩種方式將廣告素材送審：

即時出價 API (建議)

您可以使用 buyers.creatives.create敬上這個方法將廣告素材送審。

在 API 中，每個廣告素材只需要提交一次。您可以查看廣告素材的審查狀態。

出價回應

您可以直接在出價回應中提交新的廣告素材。

您必須使用 SdkRenderedAd 物件的 declared_ad 欄位才能提交提供的買方 SDK 廣告素材進行審查

先通過多次出價後，才會審核透過出價回應提交的廣告素材。在審查完成前的所有出價都會從競價中篩除。您可以使用即時出價介面。或即時出價 API ，在審核開始後檢查廣告素材狀態。

請參閱廣告素材指南以瞭解瞭解詳情

買方 SDK 廣告格式

需求條件

出價要求

出價要求範例

出價回應

出價回應範例

橫幅廣告

插頁式

獎勵影片廣告

原生

廣告素材審核