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

買方 SDK 廣告格式

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

將出價轉接程式整合至應用程式的發布商，可使用買家 SDK 算繪的廣告格式接受出價。顯示方式取決於您的 SDK 實作方式，以及您在出價回應中提交的 SDKRenderedAd。

您可以設定出價，納入買方 SDK 算繪的廣告或 Google Mobile Ads SDK 支援的任何其他廣告格式，但包含這兩種廣告的出價會遭到篩除。

需求條件

已核准的買方可使用買方 SDK 廣告。您和發布商都需要額外付出努力。請與技術客戶經理聯絡，為買方 SDK 廣告設定帳戶。接著，您可以導入出價轉接程式，讓 SDK 與 Google Mobile Ads SDK 進行通訊。發布商需要將您的 SDK 和轉接程式整合至行動應用程式。

建議您先提交廣告素材進行審查，再將其納入出價回應。如果您不清楚出價時的廣告素材類型，請與客戶技術顧問聯絡。

如果出價要求支援此廣告格式，您可以透過在出價回應中設定 sdk_rendered_ad 欄位，指定透過 SDK 轉譯的廣告。

出價要求

行動應用程式廣告空間的出價要求會納入發布商應用程式中的 SDK 和轉接程式詳細資料，您可以使用這些資料在下列欄位中顯示廣告：

SDK ID: 您可以使用出價要求，找出必須在出價回應中提供的 SDK ID，並使用 BidRequest.app.ext.installed_sdk.id 欄位。; 詳情請參閱 InstalledSdk 參考文件。
廣告單元對應: 您可以使用出價要求，找出與出價時段相符的廣告單元對應項目，並使用 BidRequest.imp.ext.ad_unit_mapping 欄位。; 詳情請參閱 AdUnitMapping 參考文件。
安全信號: 發布商可以與出價方共用安全信號。您可以在 BidRequest.imp.ext.buyer_generated_request_data.data 中找到這些資料。; 如要進一步瞭解安全信號的表示方式，請參閱 BuyerGeneratedRequestData 參考說明文件。
測試請求: 您可以使用 BidRequest.test 欄位確認出價要求是否為測試。; 如要進一步瞭解這個欄位，請參閱 BidRequest 參考文件。

出價要求範例

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

出價回應

出價回應中必須包含下列欄位：

BidResponse.seatbid.bid.adomain
BidResponse.seatbid.bid.ext.billing_id
BidResponse.seatbid.bid.crid
BidResponse.seatbid.bid.w
BidResponse.seatbid.bid.h

此外，出價回應必須填入 BidResponse.seatbid.bid.ext.sdk_rendered_ad 中的下列項目：

SDK ID

使用 id 欄位提供 ID，讓 SDK 呈現廣告。

您可以在 BidRequest.app.ext.installed_sdk 中找到 ID。

已宣告的廣告

使用 BidResponse.seatbid.bid.ext.sdk_rendered_ad.declared_ad 提供符合 BidRequest.imp.ext.creative_enforcement_settings 中規定的廣告素材，並代表廣告的算繪資料。請只填入 html_snippet、video_url、video_vast_xml 或 native_response 其中一個。

如果您未填入 declared_ad，我們將無法審查廣告素材，且所有含有廣告素材的出價都會從競價中篩除。

如要進一步瞭解已宣告的廣告，請參閱 DeclaredAd 參考說明文件。

算繪資料

使用 BidResponse.seatbid.bid.ext.sdk_rendered_ad.rendering_data 欄位提供資料，供買方 SDK 用於顯示廣告。

如要放送買方 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 提交廣告素材以供審查，再將廣告素材納入出價回應。

如要進一步瞭解 SdkRenderedAd 欄位，請參閱 OpenRTB 指南。

出價回應範例

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

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"

廣告素材審核

廣告素材必須先接受審查，確保符合我們的政策和發布商設定，才能放送。

您可以透過下列兩種方式提交廣告素材供審查：

Real-time Bidding API (建議)

您可以使用即時出價 API 的 buyers.creatives.create 方法，提交廣告素材以供審查。

這個 API 只要求每個廣告素材提交一次，並讓您查看廣告素材審查狀態。

出價回應

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

您必須使用 SdkRenderedAd 物件的 declared_ad 欄位，提交含有買方 SDK 廣告素材的出價回應以供審查。

只有在收到多個出價後，系統才會審查在出價回應中提交的廣告素材。在審查完成前提出的所有出價都會從競價中篩除。您可以使用即時出價介面或即時出價 API，在審查開始後查看廣告素材的狀態。

詳情請參閱廣告素材指南。