將 i-mobile 與中介服務整合

本指南說明如何使用 Google Mobile Ads Flutter Plugin，透過中介服務載入及顯示 i-mobile 廣告，也會介紹刊登序列整合作業。內容涵蓋如何將 i-mobile 加到廣告單元的中介服務設定，以及如何將 i-mobile SDK 和轉接程式整合至 Flutter 應用程式。

i-mobile 資訊主頁介面的標籤、按鈕和說明均為日文，本指南中的螢幕截圖未經翻譯。在說明和操作指引中，則以英文指稱相應標籤和按鈕，並以括號附註翻譯。

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

i-mobile 的 Ad Manager 中介服務轉接程式具備下列功能：

必要條件

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

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

步驟 1：在 i-mobile 使用者介面中設定

註冊或登入 i-mobile 帳戶。

按一下「サイト／アプリ管理」(網站/應用程式管理) 分頁標籤，然後點選應用程式平台按鈕，將應用程式新增至 i-mobile 資訊主頁。

填寫表單，然後按一下「新規登録 (Sign up)」按鈕。

如要建立新的廣告位置，請在「サイト／アプリ管理」(網站/應用程式管理) 分頁下方選取應用程式。

前往「広告スポット管理」(廣告位置管理) 分頁，然後按一下「新規広告スポット」(新增廣告位置) 按鈕。

接著，請填寫表單，提供廣告位置名稱、廣告位置大小和其他詳細資料。然後按一下「新規登録」(註冊) 按鈕。

新的廣告位置已建立完成。如要查看整合詳細資料，請按一下「アプリ設定取得 (Get App settings)」按鈕。

記下パブリッシャー ID (發布商 ID)、メディア ID (媒體 ID)和スポット ID (Spot ID)。稍後在 Ad Manager 使用者介面中設定 i-mobile 中介服務時，會需要用到這些參數。

更新 app-ads.txt

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

如要為 i-mobile 導入 app-ads.txt，請參閱其常見問題。

步驟 2：在 Ad Manager 使用者介面設定 i-mobile 需求

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

步驟 3：匯入 i-mobile SDK 和轉接程式

透過 pub.dev 整合

(僅適用於 Android) 在專案 android 目錄內的 build.gradle 檔案中，新增下列存放區：

  repositories {
      google()
      mavenCentral()
      maven {
          url = uri("https://imobile.github.io/adnw-sdk-android")
      }
  }

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

dependencies:
  gma_mediation_imobile: ^1.0.6

手動整合

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

dependencies:
  gma_mediation_imobile:
    path: path/to/local/package

步驟 4：加入必要程式碼

步驟 5：測試導入成果

啟用測試廣告

請務必為 Ad Manager 註冊測試裝置。i-mobile 提供測試用的版位 ID、媒體 ID 和發布商 ID，請參閱這裡。

驗證測試廣告

如要確認您是否收到 i-mobile 的測試廣告，請使用「i-mobile (刊登序列)」廣告來源，在廣告檢查器中啟用單一廣告來源測試。

錯誤代碼

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

以下是廣告無法載入時，i-mobile 轉接程式擲回的代碼和對應訊息：

i-mobile Flutter 中介服務轉接程式變更記錄

1.0.6 版

• 支援 i-mobile Android 轉接程式 2.3.2.5 版。
• 支援 i-mobile iOS 轉接程式 2.3.4.8 版。
• 使用 Google Mobile Ads Flutter 外掛程式 9.1.0 版建構及測試。

1.0.5 版

• 更新支援 Google Mobile Ads Flutter 外掛程式 9.1.0 版。
• 新增 Swift Package Manager 支援。
• 支援 i-mobile Android 轉接程式 2.3.2.4 版。
• 支援 i-mobile iOS 轉接程式 2.3.4.8 版。
• 使用 Google Mobile Ads Flutter 外掛程式 9.1.0 版建構及測試。

1.0.4 版本

• 支援 i-mobile Android 轉接程式 2.3.2.3 版。
• 支援 i-mobile iOS 轉接程式 2.3.4.7 版。
• 使用 Google Mobile Ads Flutter 外掛程式 8.0.0 版建構及測試。

1.0.3 版本

• 最低 Flutter 版本更新為 3.38.1
• 更新支援 Google Mobile Ads Flutter 外掛程式 8.0.0 版
• 支援 i-mobile Android 轉接程式 2.3.2.3 版。
• 支援 i-mobile iOS 轉接程式 2.3.4.6 版。
• 使用 Google Mobile Ads Flutter 外掛程式 8.0.0 版建構及測試。

1.0.2 版

• 支援 i-mobile Android 轉接程式 2.3.2.1 版。
• 支援 i-mobile iOS 轉接程式 2.3.4.3 版。
• 使用 Google Mobile Ads Flutter 外掛程式 6.0.0 版建構及測試。

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 版建構及測試。