本指南說明如何使用 Google Mobile Ads SDK，透過中介服務載入及顯示 i-mobile 廣告，也會介紹刊登序列整合作業，文中闡述如何將 i-mobile 新增至廣告單元的中介服務設定，以及如何將 i-mobile SDK 和轉接程式整合至 Flutter 應用程式。
i-mobile 資訊主頁介面的標籤、按鈕和說明均為日文，本指南中的螢幕截圖未經翻譯，在說明和操作指引中，則以英文指稱相應標籤和按鈕，並在括號中附上中文翻譯。
支援的整合功能和廣告格式
i-mobile 適用的 AdMob 中介服務轉接程式具備下列功能：
| 整合 | |
|---|---|
| 出價 | |
| 瀑布 | |
| 格式 | |
| 橫幅廣告 | |
| 插頁式 | |
| 已獲得獎勵 | |
| 原生 | |
需求條件
- 最新版 Google Mobile Ads SDK
- Flutter 3.7.0 以上版本
- 如要在 Android 上部署
- Android API 級別 23 以上版本
- 如要在 iOS 上部署
- 12.0 以上版本的 iOS 部署目標
- 已設定 Google Mobile Ads SDK 的有效 Flutter 專案。詳情請參閱「開始使用」一文。
- 完成中介服務入門指南的步驟
步驟 1：在 i-mobile 使用者介面中設定
按一下「サイト／アプリ管理」(網站/應用程式管理) 分頁標籤，然後點選應用程式平台的按鈕，將應用程式新增至 i-mobile 資訊主頁。
Android
iOS
填寫表單，然後按一下「新規登録」按鈕。
Android
iOS
如要建立新的廣告位置，請在「サイト／アプリ管理 (網站/應用程式管理)」分頁下方選取應用程式。
Android
iOS
前往「広告スポット管理」分頁，然後按一下「新規広告スポット」按鈕。
接著，請填寫表單，提供廣告位置名稱、廣告位置大小和其他詳細資料。然後點按「新規登録 (Sign up)」按鈕。
新的廣告位置已準備就緒。如要查看整合詳細資料，請按一下「アプリ設定取得 (Get App settings)」按鈕。
請記下パブリッシャー ID (發布商 ID)、メディア ID (媒體 ID) 和スポット ID (廣告空間 ID)。稍後在 AdMob 使用者介面中設定中介服務的 i-mobile 時，會需要用到這些參數。
Android
iOS
更新 app-ads.txt
Authorized Sellers for Apps (app-ads.txt) 是互動廣告協會科技實驗室 (IAB Tech Lab) 主持的一項計畫，旨在確保您的應用程式廣告空間僅於您授權的管道出售。為避免廣告收益大幅減少，請務必導入 app-ads.txt 檔案。
如果還未設定應用程式的 app-ads.txt 檔案，請先完成相關作業。
如要為 i-mobile 導入 app-ads.txt，請參閱他們的常見問題。
步驟 2：在 AdMob 使用者介面中設定 i-mobile 需求
進行廣告單元的中介服務設定
步驟 3：匯入 i-mobile SDK 和轉接程式
透過 pub.dev 整合
在套件的 pubspec.yaml 檔案，新增下列依附元件和最新版本的 i-mobile SDK 與轉接程式：
dependencies:
gma_mediation_imobile: ^
手動整合
下載適用於 i-mobile 的最新版本 Google Mobile Ads 中介服務外掛程式，解壓縮下載的檔案，並將解壓縮的外掛程式資料夾及其內容新增至 Flutter 專案。接著，在 pubspec.yaml 檔案新增下列依附元件，以參照外掛程式：
dependencies:
gma_mediation_imobile:
path: path/to/local/package
步驟 4：需要額外程式碼
Android
整合 i-mobile 時，不需要額外程式碼。
iOS
整合 SKAdNetwork
請按照 i-mobile 的說明文件，將 SKAdNetwork ID 新增至專案的 Info.plist 檔案。
步驟 5：測試導入成果
啟用測試廣告
請務必註冊 AdMob 測試裝置。 i-mobile 提供測試用的廣告空間 ID、媒體 ID 和發布商 ID，您可以在這裡找到這些 ID。
驗證測試廣告
如要確認您可收到 i-mobile 的測試廣告，請在廣告檢查器中啟用單一廣告來源測試，並將廣告來源設為「i-mobile (刊登序列)」。
錯誤代碼
如果轉接程式無法從 i-mobile 接收廣告，發布商可以使用下列類別下的 ResponseInfo，檢查廣告回應中的根本錯誤：
Android
| 格式 | 類別名稱 |
|---|---|
| 橫幅廣告 | com.google.ads.mediation.imobile.IMobileAdapter |
| 插頁式 | com.google.ads.mediation.imobile.IMobileAdapter |
| 原生 | com.google.ads.mediation.imobile.IMobileMediationAdapter |
iOS
| 格式 | 類別名稱 |
|---|---|
| 橫幅廣告 | IMobileAdapter |
| 插頁式 | IMobileAdapter |
| 原生 | GADMediationAdapterIMobile |
以下是廣告無法載入時，i-mobile 轉接程式擲回的代碼和對應訊息：
Android
| 錯誤代碼 | 原因 |
|---|---|
| 0-99 | i-mobile SDK 傳回錯誤。詳情請參閱「程式碼」一文。 |
| 101 | i-mobile 需要 Activity 內容才能載入廣告。 |
| 102 | 在 AdMob UI 中設定的 i-mobile 伺服器參數遺失或無效。 |
| 103 | 請求的廣告大小不符合 i-mobile 支援的橫幅廣告尺寸。 |
| 104 | i-mobile 的原生廣告載入成功回呼傳回空白原生廣告清單。 |
iOS
| 錯誤代碼 | 原因 |
|---|---|
| 0-10 | i-mobile SDK 傳回錯誤。詳情請參閱「程式碼」一文。 |
| 101 | 在 AdMob UI 中設定的 i-mobile 伺服器參數遺失或無效。 |
| 102 | 請求的廣告大小不符合 i-mobile 支援的橫幅廣告尺寸。 |
| 103 | i-mobile 無法顯示廣告。 |
| 104 | i-mobile 傳回空白原生廣告陣列。 |
| 105 | i-mobile 無法下載原生廣告素材資源。 |
| 106 | i-mobile 不支援使用同一個 Spot ID 請求多個中繼廣告。 |
i-mobile Flutter 中介服務轉接程式變更記錄
1.0.1 版
- 支援 i-mobile Android 轉接程式 2.3.2.1 版。
- 支援 i-mobile iOS 轉接程式 2.3.4.2 版。
- 使用 Google Mobile Ads Flutter 外掛程式 6.0.0 版建構及測試。
1.0.0 版本
- 第 1 版。
- 支援 i-mobile Android 轉接程式 2.3.2.0 版。
- 支援 i-mobile iOS 轉接程式 2.3.4.1 版。
- 使用 Google Mobile Ads Flutter 外掛程式 5.3.1 版建構及測試。