本指南說明如何使用 Google Mobile Ads SDK，透過中介服務載入及顯示 i-mobile 廣告，也會介紹刊登序列整合作業，主要內容如下： 1. 如何將 i-mobile 新增至廣告單元的中介服務設定； 2. 如何將 i-mobile SDK 和轉接程式整合至 iOS 應用程式。
i-mobile 資訊主頁介面的標籤、按鈕和說明均為日文，本指南中的螢幕截圖未經翻譯，在說明和操作指引中，則以英文指稱相應標籤和按鈕，並在括號中附上中文翻譯。
支援的整合功能和廣告格式
i-mobile 中介服務轉接程式具備下列功能：
| 整合 | |
|---|---|
| 出價 | |
| 瀑布 | |
| 格式 | |
| 橫幅廣告 | |
| 插頁式 | |
| 已獲得獎勵 | |
| 原生 | |
需求條件
- 12.0 以上版本的 iOS 部署目標
最新版 Google Mobile Ads SDK
完成中介服務入門指南的步驟
步驟 1：在 i-mobile 使用者介面中設定
按一下「サイト／アプリ管理」(網站/應用程式管理) 分頁標籤，然後點選應用程式平台的按鈕，將應用程式新增至 i-mobile 資訊主頁。
填寫表單，然後按一下「新規登録」按鈕。
如要建立新的廣告位置，請在「サイト／アプリ管理 (網站/應用程式管理)」分頁下方選取應用程式。
前往「広告スポット管理」分頁，然後按一下「新規広告スポット」按鈕。
接著，請填寫表單，提供廣告位置名稱、廣告位置大小和其他詳細資料。然後點按「新規登録 (Sign up)」按鈕。
新的廣告位置已準備就緒。如要查看整合詳細資料，請按一下「アプリ設定取得 (Get App settings)」按鈕。
請記下パブリッシャー ID (發布商 ID)、メディア ID (媒體 ID) 和スポット ID (廣告空間 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 需求
進行廣告單元的中介服務設定
登入 Ad Manager 帳戶。
依序前往「廣告放送」>「收益群組」，然後按一下「新增收益群組」按鈕。
輸入收益群組的專屬名稱，將「狀態」設為「有效」， 選取「廣告格式」，並將「廣告空間類型」設為「行動應用程式」。 在「指定目標」>「廣告空間」部分下方，選取要加入中介服務的「廣告空間」和「行動應用程式」。
接著，按一下「新增收益夥伴」按鈕。
如果已有 i-mobile 的收益夥伴，可直接選取，否則，請選取「建立新的收益夥伴」。
將「廣告聯播網」設為「i-mobile」，輸入專屬「名稱」，並啟用「中介服務」。
開啟「自動資料收集」，然後輸入「登入名稱」和「API 密碼」。
選取「收益夥伴」後，將「整合類型」設為「Mobile SDK 中介服務」、「平台」設為「iOS」，並將「狀態」設為「有效」。輸入上一節取得的「發布商 ID」、「媒體 ID」和「廣告空間 ID」。然後輸入預設千次曝光出價值。
完成後，按一下頁面下方的「儲存」。
步驟 3：匯入 i-mobile SDK 和轉接程式
使用 CocoaPods (建議)
在專案的 Podfile 中新增下列指令列：
pod 'GoogleMobileAdsMediationIMobile'
在指令列執行：
pod install --repo-update手動整合
- 下載最新版 i-mobile SDK，並在專案中連結
ImobileSdkAds.framework。 - 找到變更記錄中的下載連結，下載最新版本 i-mobile 轉接程式，並在專案中連結
IMobileAdapter.framework。
步驟 4：新增必要程式碼
整合 SKAdNetwork
請按照 i-mobile 的說明文件，將 SKAdNetwork ID 新增至專案的 Info.plist 檔案。
步驟 5：測試導入成果
啟用測試廣告
請務必為 Ad Manager 註冊測試裝置。i-mobile 提供測試用的廣告空間 ID、媒體 ID 和發布商 ID，您可以在這裡找到這些 ID。
驗證測試廣告
如要確認您可收到 i-mobile 的測試廣告，請在廣告檢查器中啟用單一廣告來源測試，並將廣告來源設為「i-mobile (刊登序列)」。
選擇性步驟
使用原生廣告
廣告顯示
i-mobile 轉接程式會填入
GADNativeAd
的下列欄位資料。
| 欄位 | i-mobile 轉接程式一律納入的素材資源 |
|---|---|
| 廣告標題 | |
| 圖片 | |
| 內文 | |
| 應用程式圖示 | 1 |
| 行動號召 | |
| 星級評等 | |
| 商店 | |
| 價格 |
1 對於原生廣告，i-mobile SDK 不會提供應用程式圖示素材資源。而是以透明圖片填入應用程式圖示。
錯誤代碼
如果轉接程式無法從 i-mobile 接收廣告，發布商可以使用下列類別的 GADResponseInfo.adNetworkInfoArray，檢查廣告回應中的根本錯誤：
| 格式 | 類別名稱 |
|---|---|
| 橫幅廣告 | IMobileAdapter |
| 插頁式 | IMobileAdapter |
| 原生 | GADMediationAdapterIMobile |
以下是廣告無法載入時，i-mobile 轉接程式擲回的代碼和對應訊息：
| 錯誤代碼 | 原因 |
|---|---|
| 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 iOS 中介服務轉接程式變更記錄
下一個版本
- 啟用 -fobjc-arc 和 -fstack-protector-all。
2.3.4.2 版
- 現在需要 Google Mobile Ads SDK 12.0.0 以上版本。
建構及測試時使用的版本：
- Google Mobile Ads SDK 12.0.0 版。
- i-mobile SDK 2.3.4 版。
2.3.4.1 版
- 更新
CFBundleShortVersionString，從四個元件改為三個。
建構及測試時使用的版本：
- Google Mobile Ads SDK 11.10.0 版。
- i-mobile SDK 2.3.4 版。
2.3.4.0 版
- 已驗證與 i-mobile SDK 2.3.4 版相容。
- 新增支援功能，可在
adSDKVersion中傳回 i-mobile SDK 版本。
建構及測試時使用的版本：
- Google Mobile Ads SDK 11.2.0 版。
- i-mobile SDK 2.3.4 版。
2.3.3.0 版
- 已驗證與 i-mobile SDK 2.3.3 版相容。
建構及測試時使用的版本：
- Google Mobile Ads SDK 11.1.0 版。
- i-mobile SDK 2.3.3 版。
2.3.2.1 版
- 已從橫幅、插頁式和原生廣告導入作業中，移除已淘汰的
willBackgroundApplication委派方法。 - 現在最低須使用 iOS 12.0 版。
- 現在需要 Google Mobile Ads SDK 11.0 以上版本。
Info.plist包含在IMobileAdapter.xcframework內的架構中。
建構及測試時使用的版本：
- Google Mobile Ads SDK 11.0.1 版。
- i-mobile SDK 2.3.2 版。
2.3.2.0 版
- 已驗證與 i-mobile SDK 2.3.2 版相容。
- 已停止支援
armv7架構。 - 現在最低須使用 iOS 11.0 版。
- 現在需要 Google Mobile Ads SDK 10.4.0 以上版本。
建構及測試時使用的版本：
- Google Mobile Ads SDK 10.4.0 版。
- i-mobile SDK 2.3.2 版。
2.3.1.0 版
- 已驗證與 i-mobile SDK 2.3.1 相容。
建構及測試時使用的版本：
- Google Mobile Ads SDK 10.3.0 版。
- i-mobile SDK 2.3.1 版。
2.3.0.1 版
- 現在需要 Google Mobile Ads SDK 10.0.0 以上版本。
建構及測試時使用的版本：
- Google Mobile Ads SDK 10.0.0 版。
- i-mobile SDK 2.3.0 版。
2.3.0.0 版
- 已驗證與 i-mobile SDK 2.3.0 相容。
- 現在需要 Google Mobile Ads SDK 9.8.0 以上版本。
建構及測試時使用的版本：
- Google Mobile Ads SDK 9.13.0 版。
- i-mobile SDK 2.3.0 版。
2.2.0.1 版
- 現在需要 Google Mobile Ads SDK 9.0.0 以上版本。
建構及測試時使用的版本：
- Google Mobile Ads SDK 9.0.0 版。
- i-mobile SDK 2.2.0 版。
2.2.0.0 版
- 已驗證與 i-mobile SDK 2.2.0 版相容。
建構及測試時使用的版本
- Google Mobile Ads SDK 8.13.0 版。
- i-mobile SDK 2.2.0 版。
2.1.0.1 版
- 放寬對 Google Mobile Ads SDK 8.0.0 以上版本的依附元件。
建構及測試時使用的版本
- Google Mobile Ads SDK 8.4.0 版。
- i-mobile SDK 2.1.0 版。
2.1.0.0 版
- 已驗證與 i-mobile SDK 2.1.0 版相容。
- 現在需要 Google Mobile Ads SDK 8.1.0 以上版本。
- 更新轉接程式，改用
.xcframework格式。
建構及測試時使用的版本
- Google Mobile Ads SDK 8.1.0 版。
- i-mobile SDK 2.1.0 版。
2.0.33.1 版
- 新增標準化的轉接程式錯誤代碼和訊息。
- 現在，介面卡會限制使用相同 i-mobile Spot ID 請求多個插頁式廣告。
- 現在輕觸原生廣告時，轉接程式會轉送
-nativeAdWillLeaveApplication:回呼。 - 現在需要 Google Mobile Ads SDK 7.68.0 以上版本。
建構及測試時使用的版本
- Google Mobile Ads SDK 7.68.0 版。
- i-mobile SDK 2.0.33 版。
2.0.33.0 版
- 已驗證與 i-mobile SDK 2.0.33 版相容。
- 現在需要 Google Mobile Ads SDK 7.65.0 以上版本。
- 現在最低須使用 iOS 9.0 版。
建構及測試時使用的版本
- Google Mobile Ads SDK 7.65.0 版。
- i-mobile SDK 2.0.33 版。
2.0.32.0 版
- 已驗證與 i-mobile SDK 2.0.32 版相容。
- 現在需要 Google Mobile Ads SDK 7.60.0 以上版本。
- 新增支援將 320x50 和 320x100 廣告縮放至更符合自動調整橫幅廣告請求大小。
- 已停止支援 i386 架構。
建構及測試時使用的版本
- Google Mobile Ads SDK 7.60.0 版。
- i-mobile SDK 2.0.32 版。
2.0.31.0 版
- 已驗證與 i-mobile SDK 2.0.31 版相容。
建構及測試時使用的版本
- Google Mobile Ads SDK 7.53.1 版。
- i-mobile SDK 2.0.31 版。
2.0.29.0 版
- 初始版本！
- 支援橫幅、插頁式和原生廣告。
建構及測試時使用的版本
- Google Mobile Ads SDK 7.52.0 版。
- i-mobile SDK 2.0.29 版。