將 InMobi 與中介服務整合

本指南將說明如何使用 Google Mobile Ads SDK 載入及顯示 透過中介服務在 InMobi 中放送的廣告 包括刊登序列和出價整合說明如何將 InMobi 新增到 廣告單元的中介服務設定,以及如何整合 InMobi SDK 插入 Unity 應用程式。

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

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

1 出價整合功能已關閉 Beta 版,請聯絡您的客戶經理,要求存取權。

需求條件

  • 最新版 Google Mobile Ads SDK
  • Unity 4 以上版本
  • 如何在 Android 上部署
    • Android API 級別 21 以上
  • 如何在 iOS 上部署
    • iOS 部署目標為 10.0 以上版本
  • 使用 Google 設定的 Unity 有效專案 Mobile Ads SDK詳情請見 詳情請參閱開始使用
  • 完成中介服務 入門指南

步驟 1:在 InMobi UI 中進行設定

步驟 2:在使用者介面中設定 InMobi 廣告需求 AdMob

調整廣告單元中介服務設定

Android

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

iOS

相關操作說明請參閱 iOS 指南中的步驟 2。

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

請按照 GDPR 設定美國州級法規設定 ,在 AdMob UI 和美國州級法規廣告合作夥伴清單中新增 InMobi

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

下載最新的 InMobi 專用 Google 行動廣告中介服務外掛程式 請點選下載連結 變更記錄和擷取 ZIP 檔案中的 GoogleMobileAdsInMobiMediation.unitypackage

在 Unity 專案編輯器中,依序選取「Assets」>「Assets」匯入套件 >自訂 封裝並選取GoogleMobileAdsInMobiMediation.unitypackage檔案 已下載完成。確認已選取所有檔案,然後按一下「匯入」

然後選取「素材資源」>「Play 服務解析器 >Android 解析器 >強制 解決。Unity Play 服務解析器程式庫將執行依附元件 然後將宣告的依附元件複製到 Assets/Plugins/Android 目錄。

步驟 4:在 InMobi SDK 中導入隱私權設定

根據 Google 歐盟地區使用者同意聲明 Google 政策,您必須確保使用者有揭露特定揭露事項。 只有當歐洲經濟區 (EEA) 使用者提供同意聲明,以及 如何使用裝置 ID 和個人資料這項政策反映了 歐盟電子通訊隱私指令和一般資料保護規定 法規 (GDPR)。徵求同意時,您必須指明每個廣告聯播網 中介服務鏈中可能收集、接收或使用個人資料,並 提供各個網路用量的相關資訊。Google 目前無法 將使用者的同意聲明選項自動傳送到這類聯播網。

InMobi 專用 Google 行動廣告中介服務外掛程式 2.1.0 新增了 InMobi.UpdateGDPRConsent() 方法可讓您將同意聲明資訊傳送至 InMobi。以下程式碼範例說明如何將同意聲明資訊傳送至 InMobi SDK。若您選擇呼叫此方法,建議您在 以便透過 Google Mobile Ads SDK 請求廣告。

using GoogleMobileAds.Api.Mediation.InMobi;
using System.Collections.Generic;
// ...

Dictionary<string, string> consentObject = new Dictionary<string, string>();
consentObject.Add("gdpr_consent_available", "true");
consentObject.Add("gdpr", "1");

InMobi.UpdateGDPRConsent(consentObject);

請參閱 InMobi 的 GDPR 實作說明 詳細資料 進一步瞭解 InMobi 接受的可能鍵和值 這個同意聲明物件

美國州級隱私權法律

美國州級隱私權法律 規定使用者必須提供 即可選擇停用「銷售」功能代表「個人資訊」(如同法律定義 該條款中,透過顯眼的「請勿銷售我的個人」 資訊」請點選「銷售」裝置上的「銷售」連結以及派對首頁 美國州級隱私權 法規遵循指南可讓您 受限的資料處理 此設定不適用於每則廣告,但 Google 無法將這項設定套用至每則廣告 中介服務鏈中的聯播網因此,你必須找出每個廣告聯播網。 可參與個人銷售的 並遵循各自的指南 確保符合法規。

請參閱 InMobi 的 CCPA 說明文件

步驟 5:新增必要的額外程式碼

Android

您不需要在 InMobi 整合中另外加入程式碼。

iOS

SKAdNetwork 整合

追蹤 InMobi 的 說明文件 在專案的 Info.plist 檔案中新增 SKAdNetwork ID。

步驟 6:測試實作成果

啟用測試廣告

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

驗證測試廣告

如要確認您正在接收來自InMobi的測試廣告,請使用 InMobi (Bidding) and InMobi (Waterfall) 廣告來源在廣告檢查器中啟用單一廣告來源測試

選擇性步驟

Android

權限

為獲得最佳效能,InMobi 建議新增下列選用項目 授予應用程式 AndroidManifest.xml 檔案的權限。

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />

您可以選擇將這些權限加入 Plugins/Android/GoogleMobileAdsInMobiMediation/AndroidManifest.xml 檔案。

iOS

無須採取其他步驟即可整合 iOS 系統。

錯誤代碼

如果轉接程式無法接收 InMobi 的廣告,發布商可以查看 判斷錯誤的原因 位於「ResponseInfo」 類別:

Android

com.google.ads.mediation.inmobi.InMobiAdapter
com.google.ads.mediation.inmobi.InMobiMediationAdapter

iOS

GADMAdapterInMobi
GADMediationAdapterInMobi

以下是 InMobi 轉接器擲回的代碼和附帶訊息 如果發生以下情形,則代表廣告無法載入:

Android

錯誤代碼 原因
0-99 InMobi SDK 錯誤。請參閱程式碼 ,掌握更多詳細資訊。
100 在使用者介面中設定的 InMobi 伺服器參數 AdMob 遺失或無效。
101 無法初始化 InMobi SDK。
102 要求的廣告大小不符合 InMobi 支援的橫幅廣告大小。
103 廣告請求不是統一的原生廣告請求。
104 試圖請求 InMobi 廣告,卻未初始化 InMobi SDK。這個 理論上應該永遠不會發生,因為轉接程式會初始化 InMobi SDK 並未要求提供 InMobi 廣告。
105 InMobi 的廣告尚未準備好放送。
106 InMobi 無法顯示廣告。
107 InMobi 傳回缺少必要素材資源的原生廣告。
108 InMobi 的原生廣告圖片素材資源包含格式錯誤的網址。
109 轉接程式無法下載 InMobi 的原生廣告圖片素材資源。

iOS

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

InMobi Unity 中介服務外掛程式變更記錄

4.6.3 版

4.6.2 版

4.6.1 版

4.6.0 版

4.5.1 版

4.5.0 版

4.4.1 版

4.4.0 版

4.3.3 版

4.3.0 版

4.2.2 版

4.2.1 版

4.2.0 版

4.1.0 版

4.0.4 版

4.0.3 版

4.0.2 版

4.0.1 版

4.0.0 版

3.2.0 版

3.1.2 版

3.1.1 版

3.1.0 版

3.0.3 版

3.0.2 版

3.0.1 版

3.0.0 版

2.4.0 版

2.3.0 版本

  • 支援 Android 轉接器 7.2.9.0 版。
  • 支援 iOS 轉接器 7.3.2.0 版。

2.2.2 版本

  • 更新外掛程式,以支援新的 獎勵 API。
  • 支援 Android 轉接器 7.2.7.0 版。
  • 支援 iOS 轉接器 7.2.7.0 版。

2.2.1 版本

  • 支援 Android 轉接器 7.2.2.0 版。
  • 支援 iOS 轉接器 7.2.4.0 版。

2.2.0 版

  • 支援 Android 轉接器 7.2.1.0 版。
  • 支援 iOS 轉接器 7.2.0.0 版。

2.1.2 版

  • 支援 Android 轉接器 7.1.1.1 版。
  • 支援 iOS 轉接器 7.1.2.0 版。

2.1.1 版

  • 支援 Android 轉接器 7.1.1.1 版。
  • 支援 iOS 轉接器 7.1.1.2 版。

2.1.0 版

  • 支援 Android 轉接器 7.1.0.0 版。
  • 支援 iOS 轉接器 7.1.1.1 版。
  • 已新增 InMobi.UpdateGDPRConsent() 方法。

2.0.0 版

  • 支援 Android 轉接器 7.0.4.0 版。
  • 支援 iOS 轉接器 7.1.1.0 版。

1.0.0 版本

  • 第一版!
  • 支援 Android 轉接器 6.2.4.0 版。
  • 支援 iOS 轉接器 6.2.1.0 版。