整合 BidMachine 與中介服務

選取平台： Android iOS Unity Flutter Android (舊版)

本指南說明如何使用 Google Mobile Ads Flutter Plugin，透過 AdMob 中介服務載入及顯示 BidMachine 廣告，包括出價整合作業。文中闡述如何將 BidMachine 新增至廣告單元的中介服務設定，以及如何將 BidMachine SDK 和轉接程式整合至 Flutter 應用程式。

支援的整合項目和廣告格式

BidMachine 的 AdMob 中介服務轉接程式具備下列功能：

整合
出價
瀑布圖  1
格式
開啟應用程式
橫幅廣告
插頁式廣告
獎勵廣告
插頁式獎勵廣告
原生

1 Waterfall 整合功能目前為封測版，如需存取權，請與客戶經理聯絡。

必要條件

繼續操作前，請先確認下列事項：

  • 最新 Google Mobile Ads Flutter Plugin 版本。
  • Flutter 架構 3.7.0 以上版本。
  • 如要在 Android 上部署
    • Android API 級別 24 以上版本。
  • 如要在 iOS 上部署
    • iOS 部署目標為 13.0 以上版本。
  • 已設定 Google Mobile Ads Flutter Plugin 的有效 Flutter 專案。詳情請參閱「開始使用」一文。
  • 設定 AdMob 中介服務。

步驟 1：在 BidMachine 使用者介面中設定

登入 BidMachine 帳戶資訊主頁。

建立新的刊登位置

前往「來源」分頁，然後在「來源」表格下方，選取「編輯」按鈕。

來源資訊主頁

系統會顯示所有刊登位置的清單。如要建立新的刊登位置，請按一下對話方塊中的「新增刊登位置」按鈕。

編輯來源對話方塊

「刊登位置類型」部分請選取「出價」。填寫表單，然後按一下「儲存」。

Android

建立 Android 刊登位置

iOS

建立 iOS 刊登位置

最後，請記下刊登位置 ID。

Android

Android 刊登位置詳細資料

iOS

iOS 刊登位置詳細資料

更新 app-ads.txt

Authorized Sellers for Apps (app-ads.txt) 是美國互動廣告協會科技實驗室 (IAB Tech Lab) 的一項計畫，旨在確保您的應用程式廣告空間僅於您授權的管道出售。為避免廣告收益大幅減少，請務必導入 app-ads.txt 檔案。 如果還未設定應用程式的 app-ads.txt 檔案，請先完成相關作業。

如要為 BidMachine 導入 app-ads.txt，請前往「資訊主頁」的「app-ads.txt」分頁標籤。然後複製清單，並附加至網站的 app-ads.txt 檔案。

步驟 2：在 AdMob 使用者介面中設定 BidMachine 需求

進行廣告單元的中介服務設定

Android

如需操作說明，請參閱 Android 指南中的步驟 2。

iOS

如需操作說明，請參閱 iOS 指南中的步驟 2。

將 BidMachine 新增至 GDPR 和美國州級法規廣告合作夥伴名單

請按照「歐洲法規設定」和「美國州級法規設定」中的步驟操作，在 AdMob 使用者介面的歐洲和美國州級法規廣告合作夥伴名單，新增「BidMachine」BidMachine。

步驟 3：匯入 BidMachine SDK 和轉接程式

透過 pub.dev 整合

在套件的 pubspec.yaml 檔案，新增下列依附元件和最新版本的 BidMachine SDK 與轉接程式：

dependencies:
  gma_mediation_bidmachine: ^1.5.0

手動整合

下載適用於 BidMachine 的最新版 Google Mobile Ads 中介服務外掛程式，解壓縮下載的檔案，並將解壓縮的外掛程式資料夾及其內容新增至 Flutter 專案。接著，在 pubspec.yaml 檔案新增下列依附元件，以參照外掛程式：

dependencies:
  gma_mediation_bidmachine:
    path: path/to/local/package

iOS

整合 SKAdNetwork

請按照 BidMachine 的 SKAdNetwork 支援說明文件，將 SKAdNetwork ID 新增至專案的 Info.plist 檔案。

步驟 6：測試導入成果

啟用測試廣告

請務必註冊 AdMob 測試裝置。

請按照 BidMachine 說明文件 (Android和 iOS) 的操作指示，啟用 BidMachine 的測試模式。

驗證測試廣告

如要確認您是否收到 BidMachine 的測試廣告，請使用「BidMachine (出價)」廣告來源，在廣告檢查器中啟用單一廣告來源測試。

錯誤代碼

如果轉接程式無法從 BidMachine 接收廣告，發布商可以使用下列類別的 ResponseInfo，檢查廣告回應中的根本錯誤：

Android

io.bidmachine
com.google.ads.mediation.bidmachine

iOS

GADMediationAdapterBidMachine

以下是廣告無法載入時，BidMachine 轉接程式擲回的代碼和隨附訊息：

Android

錯誤代碼 網域 原因
100 com.google.ads.mediation.bidmachine 收到的刊登位置 ID 無效或空白。
101 com.google.ads.mediation.bidmachine 信號收集期間發生錯誤：找不到信號資料設定。
102 com.google.ads.mediation.bidmachine 信號收集期間收到無效的廣告格式。
103 com.google.ads.mediation.bidmachine 請求的廣告大小無法對應至 bidmachine.BannerSize
104 com.google.ads.mediation.bidmachine 已載入的 BidMachine 廣告請求已過期。
105 com.google.ads.mediation.bidmachine 無法顯示全螢幕廣告。
106 com.google.ads.mediation.bidmachine BidMachine SDK 傳回 onAdLoaded() 回呼，其中包含 null 廣告資料。

iOS

錯誤代碼 網域 原因
101 com.google.mediation.bidmachine 伺服器設定缺少必要的發布商 ID。
102 com.google.mediation.bidmachine 出價信號收集要求失敗，因為即時出價參數不含廣告格式，或不支援指定的格式。
103 com.google.mediation.bidmachine 載入廣告時，廣告設定無效。
104 com.google.mediation.bidmachine BidMachine SDK 將非橫幅廣告傳回橫幅廣告的 BidMachineAdProtocol didLoadAd 委派方法。這種情況不應發生。
105 com.google.mediation.bidmachine 全螢幕廣告尚未準備就緒，無法顯示。
106 com.google.mediation.bidmachine Bid Machine SDK 將非原生廣告傳回原生廣告的 BidMachineAdProtocol didLoadAd 委派方法。這種情況不應發生。
107 com.google.mediation.bidmachine 無法載入其中一個原生廣告圖片來源。
108 com.google.mediation.bidmachine BidMachine 不支援這個橫幅廣告大小。

BidMachine Flutter 中介服務轉接程式變更記錄

1.5.0 版本

1.4.2 版

1.4.1 版本

1.4.0 版本

1.3.2 版

1.3.1 版本

1.3.0 版本

1.2.0 版本

1.1.0 版本

1.0.0 版