將 i-mobile 與中介服務整合

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

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

支援的整合功能和廣告格式

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

整合
出價
瀑布
格式
橫幅廣告
插頁式
已獲得獎勵

需求條件

  • 最新版 Google Mobile Ads SDK
  • Unity 5.6 以上版本
  • 如要在 Android 上部署
    • Android API 級別 23 以上版本
  • 如要在 iOS 上部署
    • 12.0 以上版本的 iOS 部署目標
  • 已設定 Google Mobile Ads SDK 的有效 Unity 專案。詳情請參閱「開始使用」一文。
  • 完成中介服務入門指南的步驟

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

註冊或登入 i-mobile 帳戶。

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

Android

iOS

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

Android

iOS

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

Android

iOS

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

create_ad_spot

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

new_ad_spot_form

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

ad_spot_list

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

Android

iOS

更新 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 需求

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

Android

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

iOS

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

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

OpenUPM-CLI

如果已安裝 OpenUPM-CLI，可以從專案的根目錄執行下列指令，將 Google Mobile Ads i-mobile 中介服務外掛程式安裝至 Unity 專案：

openupm add com.google.ads.mobile.mediation.imobile

OpenUPM

在 Unity 專案編輯器中，依序選取「Edit」 >「Project Settings」 >「Package Manager」，開啟「Unity Package Manager Settings」。

在「Scoped Registries」(範圍註冊表) 分頁中，新增 OpenUPM 做為範圍註冊表，並提供下列詳細資料：

  • 名稱：OpenUPM
  • 網址：https://package.openupm.com
  • 範圍：com.google

OpenUPM 詳細資料

接著，依序前往「Window」 >「Package Manager」，開啟 Unity Package Manager，然後從下拉式選單選取「My Registries」。

Unity 登錄檔

選取「Google Mobile Ads IMobile Mediation」套件，然後按一下「Install」。

從 OpenUPM 安裝

Unity 套件

前往變更記錄，找到 i-mobile 適用的 Google 行動廣告中介服務外掛程式下載連結，下載最新版本，並從 zip 檔案中解壓縮 GoogleMobileAdsIMobileMediation.unitypackage。

在 Unity 專案編輯器中，依序選取「Assets」 >「Import Package」 >「Custom Package」，然後找出下載的 GoogleMobileAdsIMobileMediation.unitypackage 檔案。確認已選取所有檔案，然後按一下「匯入」。

從 Unity 匯入

然後依序選取「Assets」 >「External Dependency Manager」 >「Android Resolver」 >「Force Resolve」。External Dependency Manager 程式庫會從頭執行依附元件解析作業，並將宣告的依附元件複製到 Unity 應用程式的 Assets/Plugins/Android 目錄。

強制解決

步驟 4：需要額外程式碼

Android

整合 i-mobile 時，不需要額外程式碼。

iOS

整合 SKAdNetwork

請按照 i-mobile 的說明文件，將 SKAdNetwork ID 新增至專案的 Info.plist 檔案。

步驟 5：測試導入成果

啟用測試廣告

請務必為 Ad Manager 註冊測試裝置。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 Ad Manager 使用者介面中設定的 i-mobile 伺服器參數遺失或無效。
103 請求的廣告大小不符合 i-mobile 支援的橫幅廣告尺寸。
104 i-mobile 的原生廣告載入成功回呼傳回空白原生廣告清單。

iOS

錯誤代碼 原因
0-10 i-mobile SDK 傳回錯誤。詳情請參閱「程式碼」一文。
101 Ad Manager 使用者介面中設定的 i-mobile 伺服器參數遺失或無效。
102 請求的廣告大小不符合 i-mobile 支援的橫幅廣告尺寸。
103 i-mobile 無法顯示廣告。
104 i-mobile 傳回空白原生廣告陣列。
105 i-mobile 無法下載原生廣告素材資源。
106 i-mobile 不支援使用同一個 Spot ID 請求多個中繼廣告。

i-mobile Unity 中介服務外掛程式變更記錄

1.3.7 版

1.3.6 版

1.3.5 版

1.3.4 版

1.3.3 版

1.3.2 版

1.3.1 版

1.3.0 版

1.2.2 版

1.2.1 版

1.2.0 版

1.1.0 版

1.0.2 版

1.0.1 版

1.0.0 版本