將 InMobi 與中介服務整合

本指南將說明如何使用 Google Mobile Ads SDK 透過 中介服務 載入及顯示 InMobi 廣告，涵蓋瀑布流和出價整合。本文將說明如何將 InMobi 新增至廣告單元的中介服務設定，以及如何將 InMobi SDK 和轉接程式整合至 iOS 應用程式。

支援的整合和廣告格式

InMobi 的中介服務轉接程式具有下列功能：

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

1 出價整合功能處於公開測試階段。

2 僅支援刊登序列中介服務。

需求條件

  • iOS 部署目標為 10.0 以上版本

  • 最新版 Google Mobile Ads SDK

  • 完成中介服務入門指南

步驟 1：在 InMobi UI 中設定設定

註冊 InMobi 帳戶。建立帳戶時，請不要勾選「使用 InMobi SSP 搭配 Google 公開出價」選項。

帳戶驗證完畢後，請登入。

新增應用程式

如要將應用程式新增至 InMobi 資訊主頁，請依序點選「Inventory」>「Inventory Settings」。

按一下「新增廣告空間」，然後在下拉式選單中選取「行動應用程式」管道。

在搜尋列中開始輸入已發布的應用程式商店 網址，然後從自動填入的結果中選取應用程式。按一下「繼續」。

如果您的應用程式尚未發布，請按一下「手動連結」，然後輸入必要詳細資料。按一下「繼續」。

查看「應用程式和網站法規遵循」設定，然後按一下「儲存並建立刊登位置」。

刊登位置

設定廣告空間後，系統會將您重新導向至刊登位置建立工作流程。

出價

選取廣告單元類型。輸入刊登位置名稱，然後分別為目標對象出價和合作夥伴選取「開啟」和「Google 公開出價」，並填寫表單的其餘部分。完成後，按一下「建立刊登位置」。

瀑布

選取廣告單元類型。接著輸入刊登位置名稱，然後選取「目標對象出價」的「關閉」，並填寫表單的其餘部分。完成後，請按一下「建立刊登位置」。

建立刊登位置後，系統會顯示詳細資料。請記下刊登位置 ID，這會用於設定 AdMob 廣告單元。

帳戶 ID

您可以依序前往「財務」>「付款設定」>「付款資訊」，查看 InMobi 帳戶 ID。

找出 InMobi Reporting API 金鑰

出價

出價整合不必執行這個步驟。

瀑布

依序前往「我的帳戶」>「帳戶設定」。前往「API Key」分頁，然後按一下「Generate API Key」。

選取需要該金鑰的使用者電子郵件，然後按一下「Generate API Key」。系統會產生包含 API 金鑰和使用者名稱/登入名稱的檔案。

只有帳戶的發布商管理員可以為所有使用者產生 API 金鑰。如果忘記先前產生的 API 金鑰，請在「API 金鑰」分頁中將滑鼠游標懸停在電子郵件上，即可重設 API 金鑰。

開啟測試模式

只針對所有即時曝光或特定測試裝置，為廣告空間啟用測試模式。

步驟 2：在 Ad Manager UI 中設定 InMobi 需求

新增 InMobi 至 GDPR 和美國州級法規廣告合作夥伴名單

按照 GDPR 設定和美國州級法規設定中的步驟，在 AdMob UI 的 GDPR 和美國州級法規廣告合作夥伴名單中新增 InMobi。

步驟 3：匯入 InMobi SDK 和轉接程式

  • 在專案的 Podfile 中加入以下行：

    pod 'GoogleMobileAdsMediationInMobi'

  • 從指令列執行下列指令：

    pod install --repo-update

手動整合

  • 下載最新版的 InMobi iOS SDK，並在專案中連結 InMobiSDK.framework。
  • 從變更記錄中的下載連結下載最新版的 InMobi 轉接器，並在專案中連結 InMobiAdapter.framework。
  • 將下列架構新增至專案
    • libsqlite3.0.tbd
    • libz.tbd
    • WebKit.framework

專案設定

在「Application Target」>「Build Settings」下方，將 -ObjC 標記新增至「Other Linker Flags」。

步驟 4：在 InMobi SDK 中實作隱私權設定

根據 Google 的《歐盟地區使用者同意授權政策》，您必須確保向歐洲經濟區 (EEA) 境內使用者揭露特定資訊，並徵得使用者同意聲明，才能使用裝置 ID 和個人資料。本政策是配合《歐盟電子通訊隱私指令》和《一般資料保護規則》(GDPR) 的法規而制定。徵求同意時，您必須在中介服務鏈中找出可能會收集、接收或使用個人資料的每個廣告聯播網，並提供各聯播網使用情形的相關資訊。Google 目前無法自動將使用者的同意聲明選項傳送給這類網路。

在 7.1.1.0 版中，InMobi 轉接程式新增了 GADMInMobiConsent 類別，可讓您傳送同意聲明資訊至 InMobi。下列程式碼範例會在 GADMInMobiConsent 類別上呼叫 updateGDPRConsent。如果您選擇呼叫這個方法，建議您在透過 Google Mobile Ads SDK 要求廣告之前先呼叫這個方法。

Swift

import InMobiAdapter
// ...

var consentObject = Dictionary<String, String>()
consentObject["gdpr"] = "1"
consentObject[IM_GDPR_CONSENT_AVAILABLE] = "true"

GADMInMobiConsent.updateGDPRConsent(consentObject)

Objective-C

#import <InMobiAdapter/InMobiAdapter.h>
// ...

NSMutableDictionary *consentObject = [[NSMutableDictionary alloc] init];
[consentObject setObject:@"1" forKey:@"gdpr"];
[consentObject setObject:@"true" forKey:IM_GDPR_CONSENT_AVAILABLE];

[GADMInMobiConsent updateGDPRConsent:consentObject];

如要進一步瞭解 InMobi 在這個同意聲明物件中接受的可能鍵值，請參閱 InMobi 的 GDPR 實作詳細資料。

美國州級隱私權法律

美國州級隱私權法律 規定使用者有權選擇拒絕「販售」自己的「個人資訊」(如該法案對「販售」一詞的定義)，且「賣方」必須在首頁上提供顯眼的「不要販售我的個人資訊」連結，供使用者選擇拒絕。美國州級隱私權法律遵循指南提供啟用 Google 廣告放送服務的受限的資料處理功能，但 Google 無法將這項設定套用至中介服務鏈中的每個廣告聯播網。因此，您必須在中介服務鏈中找出可能參與個人資訊銷售的廣告聯播網，並按照各廣告聯播網的指示確保遵守規定。

在 10.5.6.0 InMobi 轉接程式已新增支援，可透過 NSUserDefaults。 請按照 美國州級隱私權法律說明文件 中的指示，在 NSUserDefaults。

此外，請參閱 InMobi 的 《加州消費者隱私法》說明文件，瞭解如何在 InMobi 資訊主頁中啟用《加州消費者隱私法》設定。

步驟 5：需要額外代碼

SKAdNetwork 整合

請按照 InMobi 的說明文件，將 SKAdNetwork 識別碼新增至專案的 Info.plist 檔案。

步驟 6：測試導入作業

啟用測試廣告

請務必為 AdMob 註冊測試裝置，並在 InMobi 使用者介面中啟用測試模式。

驗證測試廣告

如要確認您是否收到 InMobi 的測試廣告，請使用 InMobi (出價) 和 InMobi (刊登序列) 廣告來源，在廣告檢查器中啟用單一廣告來源測試。

選擇性步驟

網路專屬參數

InMobi 轉接器支援其他可透過 GADInMobiExtras 類別傳遞至轉接器的請求參數。GADInMobiExtras 包含下列所有支援廣告格式通用的屬性：

要求參數和值
setAgeGroup
使用者的年齡層。		 kIMSDKAgeGroupBelow18
kIMSDKAgeGroupBetween18And24
kIMSDKAgeGroupBetween25And29
kIMSDKAgeGroupBetween30And34
kIMSDKAgeGroupBetween35And44
kIMSDKAgeGroupBetween45And54
kIMSDKAgeGroupBetween55And64
kIMSDKAgeGroupAbove65
setEducationType
使用者的教育程度。		 kIMSDKEducationHighSchoolOrLess
kIMSDKEducationCollegeOrGraduate
kIMSDKEducationPostGraduateOrAbove
setLogLevel kIMSDKLogLevelNone
kIMSDKLogLevelError
kIMSDKLogLevelDebug
setAge 整數。使用者的年齡。
setYearOfbirth Integer. 使用者的出生年份。
setPostalCode 字串。使用者的郵遞區號。 通常為五位數字。
setAreaCode 字串。使用者的電話區碼 (電話號碼的一部分)。
setLanguage 字串。使用者的母語 (如果已知)。
setLoginId 字串。發布商網域中的登入 ID。
setSessionId 字串。發布商網域中的工作階段 ID。
setLocationWithCityStateCountry 字串。地點，包含城市、州/省和國家/地區做為參數。
setKeywords 字串。任何要在廣告請求中傳遞的內容相關關鍵字。
setInterests 字串。任何要在廣告請求中傳遞的內容相關字串。
setAdditionalParameters Dictionary 中。廣告請求中要傳遞的其他值。

以下程式碼範例說明如何設定這些廣告請求參數：

Swift

let request = GAMRequest()
let extras = GADInMobiExtras()
extras.ageGroup = kIMSDKAgeGroupBetween35And54
extras.areaCode = "12345"
request.registerAdNetworkExtras(extras)

Objective-C

GAMRequest *request = [GAMRequest request];
GADInMobiExtras *extras = [[GADInMobiExtras alloc] init];
extras.ageGroup = kIMSDKAgeGroupBetween35And54;
extras.areaCode = @"12345";
[request registerAdNetworkExtras:extras];

使用原生廣告

廣告顯示

InMobi 轉接器會將原生廣告傳回為GADNativeAd物件。為 GADNativeAd。

欄位 InMobi 轉接程式一律會納入的素材資源
廣告標題
圖片 1
媒體檢視
內文
應用程式圖示
行動號召
星級評等
商店
價格

1 InMobi 轉接器不會為原生廣告提供主要圖片素材資源的直接存取權。相反地，轉接器會使用影片或圖片填入GADMediaView。

曝光和點擊追蹤

Google Mobile Ads SDK 會偵測點擊，並將點擊轉送至 InMobi，以便同步點擊報表。

Google Mobile Ads SDK 會使用 InMobi SDK 的回呼來追蹤曝光，因此兩個資訊主頁的報表應會相符，差異很小或完全沒有差異。

錯誤代碼

如果轉接器無法從 InMobi 接收廣告，發布商可以使用 GADResponseInfo.adNetworkInfoArray 在下列類別下：

GADMAdapterInMobi
GADMediationAdapterInMobi

以下是 InMobi 轉接程式在廣告載入失敗時，所傳回的程式碼和隨附訊息：

錯誤代碼 原因
101 在使用者介面中設定的 InMobi 伺服器參數 Ad Manager 遺失或無效。
102 InMobi 轉接程式不支援所要求的廣告格式。
103 這個聯播網設定已載入 InMobi 廣告。
其他 InMobi SDK 傳回錯誤。詳情請參閱 IMRequestStatus.h。

InMobi iOS 中介服務適配器變更記錄

10.7.8.0 版

  • 已驗證與 InMobi SDK 10.7.8 的相容性。

建構及測試環境：

  • Google Mobile Ads SDK 11.10.0 版。
  • InMobi SDK 10.7.8 版。

10.7.5.1 版

  • 更新 CFBundleShortVersionString，使其包含三個元件，而非四個。

建構及測試環境：

  • Google Mobile Ads SDK 11.10.0 版。
  • InMobi SDK 10.7.5 版。

10.7.5.0 版

  • 已確認與 InMobi SDK 10.7.5 相容。

建構及測試環境：

  • Google Mobile Ads SDK 11.7.0 版。
  • InMobi SDK 10.7.5 版。

10.7.4.0 版

  • 已確認與 InMobi SDK 10.7.4 相容。

建構及測試工具：

  • Google Mobile Ads SDK 11.6.0 版。
  • InMobi SDK 10.7.4 版。

10.7.2.0 版

  • 已確認與 InMobi SDK 10.7.2 相容。

建構及測試環境：

  • Google Mobile Ads SDK 11.3.0 版。
  • InMobi SDK 10.7.2 版。

10.7.1.0 版

  • 已驗證與 InMobi SDK 10.7.1 的相容性。

建構及測試環境：

  • Google Mobile Ads SDK 11.2.0 版。
  • InMobi SDK 10.7.1 版。

10.6.4.0 版

  • 已驗證與 InMobi SDK 10.6.4 的相容性。
  • 將已淘汰的方法 GADMobileAds.sharedInstance.sdkVersion 替換為 GADMobileAds.sharedInstance.versionNumber。
  • 將 NSUserDefaults 的使用取代為 CFPreferences 函式。
  • 目前最低 iOS 版本為 12.0。
  • 現在需要 Google Mobile Ads SDK 11.0 以上版本。
  • 在 InMobiAdapter.xcframework 的架構中加入 Info.plist。

建構及測試環境：

  • Google Mobile Ads SDK 11.0.1 版。
  • InMobi SDK 10.6.4 版。

10.6.0.0 版

  • 已確認與 InMobi SDK 10.6.0 相容。
  • 為出價橫幅廣告、插頁式廣告和獎勵廣告格式新增浮水印支援。

建構及測試工具：

  • Google Mobile Ads SDK 10.13.0 版。
  • InMobi SDK 10.6.0 版。

10.5.8.0 版

  • 已確認與 InMobi SDK 10.5.8 相容。

建構及測試工具：

  • Google Mobile Ads SDK 10.10.0 版。
  • InMobi SDK 10.5.8 版。

10.5.6.0 版

  • 新增從 NSUserDefaults 讀取 IAB 美國隱私權字串的支援。
  • 已驗證與 InMobi SDK 10.5.6 的相容性。
  • 新增橫幅廣告 (包括 MREC)、插頁式廣告和獎勵廣告格式的出價支援功能。

建構及測試環境：

  • Google Mobile Ads SDK 10.9.0 版。
  • InMobi SDK 10.5.6 版。

10.5.5.0 版

  • 現在需要 Google Mobile Ads SDK 10.4.0 以上版本。
  • 更新轉接程式，以便使用 didRewardUser API。
  • 更新轉接程式，在主執行緒上初始化 InMobi SDK。

建構及測試環境：

  • Google Mobile Ads SDK 10.4.0 版。
  • InMobi SDK 10.5.5 版。

10.5.4.0 版

  • 已驗證與 InMobi SDK 10.5.4 的相容性。
  • 移除已淘汰的性別、生日和位置仲介 API 使用。
  • 已停止支援 armv7 架構。
  • 現在須使用最低 iOS 11.0 版。
  • 現在需要 Google Mobile Ads SDK 10.0.0 以上版本。

建構及測試環境：

  • Google Mobile Ads SDK 10.2.0 版。
  • InMobi SDK 10.5.4 版。

其他注意事項：

  • 這個版本是在 10.1.3.0 版之前建立，因此不會使用 didRewardUser API。

10.1.3.0 版

  • 已確認與 InMobi SDK 10.1.3 相容。
  • 現在需要 Google Mobile Ads SDK 10.4.0 以上版本。
  • 更新轉接程式，以便使用 didRewardUser API。

建構及測試環境：

  • Google Mobile Ads SDK 10.5.0 版。
  • InMobi SDK 10.1.3 版。

其他注意事項：

10.1.2.1 版

  • 已確認與 InMobi SDK 10.1.2 相容。
  • 修正原生廣告在可捲動 UI 中可能會呈現空白的問題。
  • 更新轉接程式，以便使用新的中介服務 API。
  • 新增支援功能，可將 COPPA 值轉送至 InMobi SDK。

建構及測試環境：

  • Google Mobile Ads SDK 9.14.0 版。
  • InMobi SDK 10.1.2 版。

10.1.2.0 版

  • 已驗證與 InMobi SDK 10.1.2 的相容性。

建構及測試環境：

  • Google Mobile Ads SDK 9.13.0 版。
  • InMobi SDK 10.1.2 版。

10.1.1.0 版

  • 已確認與 InMobi SDK 10.1.1 的相容性。

建構及測試環境：

  • Google Mobile Ads SDK 9.12.0 版。
  • InMobi SDK 10.1.1 版。

10.1.0.0 版

  • 已確認與 InMobi SDK 10.1.0 相容。
  • 更新轉接程式，以便使用 didRewardUser API。
  • 現在需要 Google Mobile Ads SDK 9.8.0 以上版本。

建構及測試環境：

  • Google Mobile Ads SDK 9.11.0 版。
  • InMobi SDK 10.1.0 版。

10.0.7.0 版

  • 已驗證與 InMobi SDK 10.0.7 的相容性。

建構及測試環境：

  • Google Mobile Ads SDK 9.5.0 版。
  • InMobi SDK 10.0.7 版。

10.0.5.0 版

  • 已確認與 InMobi SDK 10.0.5 相容。

建構及測試工具：

  • Google Mobile Ads SDK 9.2.0 版。
  • InMobi SDK 10.0.5 版。

10.0.2.1 版

  • 已驗證與 Google Mobile Ads SDK 9.0.0 版的相容性。
  • 現在需要 Google Mobile Ads SDK 9.0.0 以上版本。

建構及測試工具：

  • Google Mobile Ads SDK 9.0.0 版。
  • InMobi SDK 10.0.2 版。

10.0.2.0 版

  • 已驗證與 InMobi SDK 10.0.2 的相容性。

採用以下工具建構及測試

  • Google Mobile Ads SDK 8.13.0 版。
  • InMobi SDK 10.0.2 版。

10.0.1.0 版

  • 已確認與 InMobi SDK 10.0.1 相容。

採用以下工具建構及測試

  • Google Mobile Ads SDK 8.12.0 版。
  • InMobi SDK 10.0.1 版。

10.0.0.0 版

  • 已確認與 InMobi SDK 10.0.0 相容。
  • 目前最低 iOS 版本為 10.0。

採用以下工具建構及測試

  • Google Mobile Ads SDK 8.11.0 版。
  • InMobi SDK 10.0.0 版。

9.2.1.0 版

  • 已確認與 InMobi SDK 9.2.1 相容。

採用以下工具建構及測試

  • Google Mobile Ads SDK 8.9.0 版。
  • InMobi SDK 9.2.1 版。

9.2.0.0 版

  • 已驗證與 InMobi SDK 9.2.0 的相容性。
  • 在使用 Google Mobile Ads SDK 8.0.0 或以上版本時輕鬆依附元件。

採用以下工具建構及測試

  • Google Mobile Ads SDK 8.8.0 版。
  • InMobi SDK 版本 9.2.0。

9.1.7.0 版

  • 已確認與 InMobi SDK 9.1.7 的相容性。
  • 現在需要 Google Mobile Ads SDK 8.3.0 以上版本。

建構及測試

  • Google Mobile Ads SDK 8.3.0 版。
  • InMobi SDK 9.1.7 版。

9.1.5.0 版

  • 已驗證與 InMobi SDK 9.1.5 的相容性。
  • 現在需要 Google Mobile Ads SDK 8.1.0 以上版本。

採用以下工具建構及測試

  • Google Mobile Ads SDK 8.1.0 版。
  • InMobi SDK 9.1.5 版。

9.1.1.1 版

  • 更新轉接程式，以便使用 .xcframework 格式。
  • 現在需要 Google Mobile Ads SDK 8.0.0 以上版本。

採用以下工具建構及測試

  • Google Mobile Ads SDK 8.0.0 版。
  • InMobi SDK 9.1.1 版。

9.1.1.0 版

  • 已確認與 InMobi SDK 9.1.1 的相容性。
  • 現在需要 Google Mobile Ads SDK 7.68.0 以上版本。

採用以下工具建構及測試

  • Google Mobile Ads SDK 7.68.0 版。
  • InMobi SDK 9.1.1 版。

9.1.0.0 版

  • 已確認與 InMobi SDK 9.1.0 相容。
  • 現在需要 Google Mobile Ads SDK 7.65.0 以上版本。

建構及測試

  • Google Mobile Ads SDK 7.65.0 版。
  • InMobi SDK 9.1.0 版。

9.0.7.2 版

  • 在未指定兒童導向內容處理方式的情況下，獎勵廣告不再預設為 coppa=0。

建構及測試

  • Google Mobile Ads SDK 7.61.0 版。
  • InMobi SDK 9.0.7 版。

9.0.7.1 版

  • 現在需要 Google Mobile Ads SDK 7.61.0 以上版本。
  • 新增標準化轉接器錯誤代碼和訊息。

採用以下工具建構及測試

  • Google Mobile Ads SDK 7.61.0 版。
  • InMobi SDK 9.0.7 版。

9.0.7.0 版

  • 已確認與 InMobi SDK 9.0.7 相容。

採用以下工具建構及測試

  • Google Mobile Ads SDK 7.60.0 版。
  • InMobi SDK 9.0.7 版。

9.0.6.0 版

  • 已驗證與 InMobi SDK 9.0.6 的相容性。
  • 更新 InMobi iOS 轉接器 CocoaPod 依附元件，以便使用 InMobiSDK/Core。
  • 現在需要 Google Mobile Ads SDK 7.60.0 以上版本。

採用以下工具建構及測試

  • Google Mobile Ads SDK 7.60.0 版
  • InMobi SDK 9.0.6 版

9.0.4.0 版

  • 已驗證與 InMobi SDK 9.0.4 的相容性。
  • 當 InMobi SDK 初始化失敗時，轉接程式現在會提早失敗。
  • 已停止支援 i386 架構。

採用以下工具建構及測試

  • Google Mobile Ads SDK 7.57.0 版
  • InMobi SDK 9.0.4 版

9.0.0.0 版

  • 已驗證與 InMobi SDK 9.0.0 的相容性。
  • 移除橫幅廣告、插頁式廣告和獎勵廣告格式的出價功能。

採用以下工具建構及測試

  • Google Mobile Ads SDK 7.53.1 版
  • InMobi SDK 9.0.0 版

7.4.0.0 版

  • 已驗證與 InMobi SDK 7.4.0 的相容性。

7.3.2.1 版

  • 修正轉接程式因無效的中介設定而無法初始化的問題。

7.3.2.0 版

  • 已確認與 InMobi SDK 7.3.2 相容。
  • 為橫幅廣告、插頁式廣告和獎勵廣告格式新增適配器出價功能。

7.3.0.0 版

  • 已確認與 InMobi SDK 7.3.0 相容。
  • 已移除原生內容和應用程式安裝廣告要求的支援功能。應用程式必須使用 Unified Native Ads API 要求原生廣告。
  • 現在需要 Google Mobile Ads SDK 7.46.0 以上版本。

7.2.7.0 版

  • 已確認與 InMobi SDK 7.2.7 相容。
  • 更新轉接器，以便使用新的獎勵 API。
  • 現在需要 Google Mobile Ads SDK 7.42.2 以上版本。
  • 新增支援彈性橫幅廣告尺寸。

7.2.4.0 版

  • 已確認與 InMobi SDK 7.2.4 相容。

7.2.1.0 版

  • 已驗證與 InMobi SDK 7.2.1 的相容性。

7.2.0.0 版

  • 已確認與 InMobi SDK 7.2.0 相容。

7.1.2.0 版

  • 已確認與 InMobi SDK 7.1.2 相容。

版本 7.1.1.2

  • 在轉換器中新增 adapterDidCompletePlayingRewardBasedVideoAd: 回呼。

7.1.1.1 版

  • 已新增提供 updateGDPRConsent 和 getConsent 方法的 GADInMobiConsent 類別

7.1.1.0 版

  • 已驗證與 InMobi SDK 7.1.1 的相容性。

7.1.0.0 版

  • 已確認與 InMobi SDK 7.1.0 相容。

7.0.4.1 版

  • 修正當轉接器與其他網路搭配使用時，會發生重複符號錯誤的問題。

7.0.4.0 版

  • 更新轉接程式，使其與 InMobi SDK 7.0.4 相容。
  • 新增原生影片廣告支援。
  • InMobi 的 SDK 不會為含有影片素材資源的廣告提供圖片。為避免潛在的 NullPointerException，當轉接器收到其中一種廣告時，會自動建立空白的 NativeAd.Image，並將其納入應用程式收到的廣告物件圖片資產陣列中。建議使用此轉接器的發布商在與 InMobi 進行中介時，避免直接使用圖片資產，而是在 UI 中使用 GADMediaView。GADMediaView 會自動為含有影片的廣告顯示影片素材資源，以及為不含影片的廣告顯示圖像素材資源。

6.2.1.0 版

  • 已確認與 inMobi SDK 6.2.1 相容

舊版

  • 支援橫幅廣告、插頁式廣告、獎勵影片廣告和原生廣告格式。