本指南說明如何使用 Google Mobile Ads Unity Plugin，透過 AdMob 中介服務載入及顯示 BidMachine 廣告，包括出價整合作業。文中闡述如何將 BidMachine 新增至廣告單元的中介服務設定，以及如何將 BidMachine SDK 和轉接程式整合至 Unity 應用程式。
支援的整合項目和廣告格式
BidMachine 的 AdMob 中介服務轉接程式具備下列功能：
| 整合 | |
|---|---|
| 出價 | |
| 瀑布圖 | 1 |
| 格式 | |
| 開啟應用程式 | |
| 橫幅廣告 | |
| 插頁式廣告 | |
| 獎勵廣告 | |
| 插頁式獎勵廣告 | |
1 Waterfall 整合功能目前為封測版，如需存取權，請與客戶經理聯絡。
必要條件
繼續操作前，請先確認下列事項：
- 最新 Google Mobile Ads Unity Plugin 版本。
- Unity 編輯器 2019.4 以上版本。
- 如要在 Android 上部署
- Android API 級別 24 以上版本。
- 如要在 iOS 上部署
- iOS 部署目標為 13.0 以上版本。
- 已設定 Google Mobile Ads Unity Plugin 的有效 Unity 專案。詳情請參閱「開始使用」一文。
- 設定 AdMob 中介服務。
步驟 1：在 BidMachine 使用者介面中設定
登入 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」BidMachine。
步驟 3：匯入 BidMachine SDK 和轉接程式
整合 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 | 出價信號收集要求失敗，因為即時出價參數不含廣告格式，或不支援指定的格式。 |
| 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 Unity 中介服務外掛程式變更記錄
1.5.0 版
- 支援 BidMachine Android 轉接程式 3.8.0.0 版。
- 支援 BidMachine iOS 轉接程式 3.8.0.0 版。
- 使用 Google Mobile Ads Unity 外掛程式 11.5.0 版建構及測試。
1.4.2 版
- 支援 BidMachine Android 轉接程式 3.7.1.1 版。
- 支援 BidMachine iOS 轉接程式 3.7.1.0.1 版。
- 使用 Google Mobile Ads Unity 外掛程式 11.1.0 版建構及測試。
1.4.1 版
- 支援 BidMachine Android 轉接程式 3.7.0.0 版。
- 支援 BidMachine iOS 轉接程式 3.7.1.0 版。
- 使用 Google Mobile Ads Unity 外掛程式 11.1.0 版建構及測試。
1.4.0 版
- 支援 BidMachine Android 轉接程式 3.7.0.0 版。
- 支援 BidMachine iOS 轉接程式 3.7.0.0 版。
- 使用 Google Mobile Ads Unity 外掛程式 11.1.0 版建構及測試。
1.3.0 版
- 支援 BidMachine Android 轉接程式 3.7.0.0 版。
- 支援 BidMachine iOS 轉接程式 3.6.1.1 版。
- 使用 Google Mobile Ads Unity 外掛程式 11.1.0 版建構及測試。
1.2.1 版
- 支援 BidMachine Android 轉接程式 3.6.1.0 版。
- 支援 BidMachine iOS 轉接程式 3.6.1.0 版。
- 使用 Google Mobile Ads Unity 外掛程式 11.0.0 版建構及測試。
1.2.0 版
- 支援 BidMachine Android 轉接程式 3.6.1.0 版。
- 支援 BidMachine iOS 轉接程式 3.6.0.0 版。
- 使用 Google Mobile Ads Unity 外掛程式 11.0.0 版建構及測試。
1.1.0 版
- 支援 BidMachine Android 轉接程式 3.5.1.2 版。
- 支援 BidMachine iOS 轉接程式 3.6.0.0 版。
- 使用 Google Mobile Ads Unity 外掛程式 11.0.0 版建構及測試。
1.0.2 版
- 支援 BidMachine Android 轉接程式 3.5.1.2 版。
- 支援 BidMachine iOS 轉接程式 3.5.1.2 版。
- 使用 Google Mobile Ads Unity 外掛程式 11.0.0 版建構及測試。
1.0.1 版
- 支援 BidMachine Android 轉接程式 3.5.1.1 版。
- 支援 BidMachine iOS 轉接程式 3.5.1.0 版。
- 使用 Google Mobile Ads Unity 外掛程式 10.7.0 版建構及測試。
1.0.0 版
- 初始版本！
- 支援 BidMachine Android 轉接程式 3.5.1.0 版。
- 支援 BidMachine iOS 轉接程式 3.5.1.0 版。
- 使用 Google Mobile Ads Unity 外掛程式 10.6.0 版建構及測試。