本指南說明如何使用 Google Mobile Ads Flutter Plugin，透過 AdMob 中介服務載入及顯示 BidMachine 廣告，包括出價整合。文中闡述如何將 BidMachine 新增至廣告單元的中介服務設定，以及如何將 BidMachine SDK 和轉接程式整合至 Flutter 應用程式。
支援的整合項目和廣告格式
BidMachine 的 AdMob 中介服務轉接程式具備下列功能：
| 整合 | |
|---|---|
| 出價 | 1 |
| 刊登序列 | |
| 格式 | |
| 開啟應用程式 | |
| 橫幅廣告 | |
| 插頁式廣告 | |
| 獎勵廣告 | |
| 插頁式獎勵廣告 | |
| 原生 | 2 |
1 出價整合功能目前為封閉 Beta 版，如要要求存取權，請與客戶經理聯絡。
2 原生廣告格式為 Alpha 版。其他支援的廣告格式皆為 Beta 版。請與客戶經理聯絡，要求存取權。
需求條件
- 最新 Google Mobile Ads Flutter Plugin
- Flutter 3.7.0 以上版本
- 如要在 Android 上部署
- Android API 級別 23 以上
- 如要在 iOS 上部署
- 部署目標為 iOS 13.0 以上版本
- 已設定 Google Mobile Ads Flutter Plugin 的有效 Flutter 專案。詳情請參閱「開始使用」一文。
- 完成中介服務入門指南的步驟
步驟 1：在 BidMachine UI 中設定
登入 BidMachine 帳戶資訊主頁。
建立新的刊登位置
前往「來源」分頁，然後在「來源」表格下方選取「編輯」按鈕。
系統會顯示所有刊登位置的清單。如要建立新的刊登位置，請按一下對話方塊中的「新增刊登位置」按鈕。
填寫表單，然後按一下「儲存」。
Android
iOS
最後，請記下刊登位置 ID。
Android
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 需求
進行廣告單元的中介服務設定
將 BidMachine 新增至 GDPR 和美國州級法規廣告合作夥伴名單
請按照「歐洲法規設定」和「美國州級法規設定」中的步驟，在 AdMob 使用者介面，將 BidMachine 新增至符合歐洲和美國州級法規的廣告合作夥伴名單。
步驟 3：匯入 BidMachine SDK 和轉接程式
透過 pub.dev 整合
在套件的 pubspec.yaml 檔案，新增下列依附元件和最新版本的 BidMachine SDK 與轉接程式：
dependencies:
gma_mediation_bidmachine: ^1.3.0
手動整合
下載適用於 BidMachine 的最新版 Google Mobile Ads 中介服務外掛程式，解壓縮下載的檔案，並將解壓縮的外掛程式資料夾及其內容新增至 Flutter 專案。接著，在 pubspec.yaml 檔案新增下列依附元件，以參照外掛程式：
dependencies:
gma_mediation_bidmachine:
path: path/to/local/package
步驟 4：在 BidMachine SDK 導入隱私權設定
歐盟同意聲明和 GDPR
為遵守《Google 歐盟地區使用者同意授權政策》，您必須向歐洲經濟區 (EEA)、英國和瑞士境內的使用者揭露特定資訊，並依法徵得使用者同意，才能使用 Cookie 或其他本機儲存空間，或針對廣告個人化用途收集、分享及使用個人資料。本政策是配合《歐盟地區電子通訊隱私指令》和《一般資料保護規則》(GDPR) 而制定。您有責任確認中介服務鏈中的每個廣告來源，皆已採用同意聲明機制。Google 無法將使用者的同意聲明選項自動傳遞至這類聯播網。
BidMachine 會自動讀取同意聲明管理平台 (包括 UMP SDK) 設定的 GDPR 同意聲明。詳情請參閱 BidMachine 的 Android 和 iOS《GDPR 指南》。
美國州級隱私權法律
美國州級隱私權法規定，使用者有權選擇拒絕「販售」其「個人資訊」(「販售」與「個人資訊」的定義請見法律規定)，且「賣方」必須在首頁上清楚顯示「請勿販售我的個人資訊」連結，供使用者點選。根據美國州級隱私權法律的法規遵循指南，您可以對 Google 廣告放送作業啟用「受限的資料處理」模式，但 Google 無法將這項設定套用至中介服務鏈的每個廣告聯播網。因此，如果中介服務鏈中有任何廣告聯播網可能販售個人資訊，請務必找出所有這類聯播網，並遵循各自適用的指引，確保符合相關法規。
BidMachine 會自動讀取同意聲明管理平台 (包括 UMP SDK) 設定的 GPP 同意聲明。詳情請參閱 BidMachine 的 Android 和 iOS GPP 指南。
步驟 5：新增必要程式碼
Android
整合 BidMachine 不需要額外程式碼。
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 | 出價信號收集要求失敗，因為 RTB 參數不含廣告格式，或指定的格式不受支援。 |
| 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 | 無法載入其中一個原生廣告圖片來源。 |
BidMachine Flutter 中介服務轉接程式的變更記錄
1.3.1 版 (開發中)
1.3.0 版本
- 支援 BidMachine Android 轉接程式 3.5.0.0 版。
- 支援 BidMachine iOS 轉接程式 3.5.0.0 版。
- 使用 Google Mobile Ads Flutter 外掛程式 6.0.0 版建構及測試。
1.2.0 版本
- 支援 BidMachine Android 轉接程式 3.5.0.0 版。
- 支援 BidMachine iOS 轉接程式 3.4.0.2 版。
- 使用 Google Mobile Ads Flutter 外掛程式 6.0.0 版建構及測試。
1.1.0 版本
- 支援 BidMachine Android 轉接程式 3.4.0.0 版。
- 支援 BidMachine iOS 轉接程式 3.4.0.1 版。
- 使用 Google Mobile Ads Flutter 外掛程式 6.0.0 版建構及測試。
1.0.0 版本
- 第 1 版。
- 支援 BidMachine Android 轉接程式 3.3.0.0 版。
- 支援 BidMachine iOS 轉接程式 3.4.0.0 版。
- 使用 Google Mobile Ads Flutter 外掛程式 6.0.0 版建構及測試。