本指南將說明如何使用 Google Mobile Ads SDK 載入及顯示 使用 Liftoff Monetize 的廣告 中介服務,範圍涵蓋出價和 刊登序列整合說明如何將 Liftoff Monetize 加進廣告單元 以及如何將 Vungle SDK 和轉接程式整合至 Unity 應用程式。
支援的整合和廣告格式
整合 | |
---|---|
出價 | |
瀑布 | |
格式 | |
開啟應用程式 | 1、 3 |
橫幅廣告 | 2。 |
插頁式 | |
已獲得獎勵 | |
插頁式獎勵廣告 | 2。 |
1 出價 這個格式的整合功能目前仍在 Beta 版封測階段
2 出價 此格式的整合功能仍在公開測試階段
3 瀑布 這個格式的整合功能目前仍在 Beta 版封測階段
需求條件
- 最新版 Google Mobile Ads SDK
- Unity 4 以上版本
- (出價): Liftoff Monetize 的 Google 行動廣告中介服務外掛程式 3.8.2 以上版本 (建議使用最新版本)
- 如何在 Android 上部署
- Android API 級別 21 以上
- 如何在 iOS 上部署
- iOS 部署目標為 12.0 以上版本
- 已設定的 Unity 有效專案 Google Mobile Ads SDK。詳情請見 詳情請參閱開始使用。
- 完成中介服務 入門指南
步驟 1:在 Liftoff Monetize UI 中進行設定
步驟 2:在使用者介面中設定 Liftoff Monetize 需求 AdMob
調整廣告單元中介服務設定
將 Liftoff 新增至 GDPR 和美國州級法規廣告合作夥伴清單
請按照 GDPR 設定 和 美國州級法規設定 ,在 AdMob UI 和美國州級法規廣告合作夥伴清單中新增 Liftoff。
步驟 3:匯入 Vungle SDK 和 Liftoff Monetize 轉接程式
下載 Liftoff 專用的最新版 Google 行動廣告中介服務外掛程式
透過
變更記錄,然後將
ZIP 檔案中的 GoogleMobileAdsVungleMediation.unitypackage
。
在 Unity 專案編輯器中,依序選取「Assets」>「Assets」匯入套件 >
Custom Package,並找出 GoogleMobileAdsVungleMediation.unitypackage
檔案
下載。確認已選取所有檔案,然後按一下「匯入」。
然後選取「素材資源」>「Play 服務解析器 >Android 解析器 >
強制解析。Unity Play 服務解析器程式庫將執行以下作業
從頭開始依附元件解析,並將宣告的依附元件複製到
Assets/Plugins/Android
目錄。
步驟 4:在 Liftoff Monetize SDK 中導入隱私權設定
歐盟地區同意授權和 GDPR
根據 Google 歐盟地區使用者同意聲明 Google 政策,您必須確保使用者有揭露特定揭露事項。 只有當歐洲經濟區 (EEA) 使用者提供同意聲明,以及 如何使用裝置 ID 和個人資料本政策是配合《歐盟電子通訊隱私指令》和《一般資料保護規則》(GDPR) 的法規而制定。在徵求同意聲明時,您必須指出中介服務鏈中可能會收集、接收或使用個人資料的每個廣告聯播網,並提供每個聯播網的使用方式相關資訊。Google 目前無法 將使用者的同意聲明選項自動傳送到這類聯播網。
Liftoff Monetize 的 Google 行動廣告中介服務外掛程式包括: 將同意聲明資訊傳遞至 Vungle SDK。下列程式碼範例說明 將同意聲明資訊傳送至 Vungle SDK。如果您選擇將此名稱命名為 方法,建議您先完成這項操作,再透過 Google Mobile Ads SDK。
using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...
LiftoffMonetize.SetGDPRStatus(true, "v1.0.0");
#if UNITY_IPHONE
LiftoffMonetize.SetGDPRMessageVersion("v1.0.0");
#endif
查看 GDPR 建議導入操作說明: Android 和 iOS 版應用程式瞭解詳情 以及可在方法中提供的值
美國州級隱私權法律
美國州級隱私權法律 規定使用者必須提供 即可選擇停用「銷售」功能代表「個人資訊」(如同法律定義 該條款中,透過顯眼的「請勿銷售我的個人」 資訊」請點選「銷售」裝置上的「銷售」連結以及派對首頁美國州級隱私權法律遵循指南提供啟用 Google 廣告放送服務的受限資料處理功能,但 Google 無法將這項設定套用至中介服務鏈中的每個廣告聯播網。因此,你必須找出每個廣告聯播網。 可參與個人銷售的 並遵循各自的指南 確保符合法規。
Liftoff Monetize 的 Google 行動廣告中介服務外掛程式包括: 將同意聲明資訊傳遞至 Vungle SDK。以下程式碼範例說明如何將同意資訊傳送至 Vungle SDK。如果您選擇呼叫這個方法,建議您在透過 Google Mobile Ads SDK 要求廣告之前先呼叫這個方法。
using GoogleMobileAds.Mediation.LiftoffMonetize.Api;
// ...
LiftoffMonetize.SetCCPAStatus(true);
請參閱以下 CCPA 建議導入說明: Android 和 iOS 應用程式瞭解詳情,並 可在方法中提供的值。
步驟 5:新增必要的程式碼
僅適用於搭載 Android
不需要額外的程式碼 Liftoff Monetize 整合。
iOS
SKAdNetwork 整合
追蹤 Liftoff Monetize 的
說明文件
在專案的 Info.plist
檔案中新增 SKAdNetwork ID。
步驟 6:測試實作成果
啟用測試廣告
請務必為AdMob 註冊測試裝置,並在 Liftoff Monetize 使用者介面中啟用測試模式。
驗證測試廣告
如要確認您正在接收來自Liftoff Monetize的測試廣告,請使用 Liftoff Monetize (Bidding) and Liftoff Monetize (Waterfall) 廣告來源在廣告檢查器中啟用單一廣告來源測試。
錯誤代碼
如果轉接程式無法從 Liftoff Monetize 接收廣告,發布商可以使用下列類別中的 ResponseInfo
,檢查廣告回應的底層錯誤:
Android
格式 | 類別名稱 |
---|---|
應用程式開啟頁面廣告 (出價) | com.google.ads.mediation.vungle.VungleMediationAdapter |
應用程式開啟頁面廣告 (刊登序列) | com.google.ads.mediation.vungle.VungleMediationAdapter |
橫幅廣告 (出價) | com.google.ads.mediation.vungle.VungleMediationAdapter |
橫幅廣告 (刊登序列) | com.vungle.mediation.VungleInterstitialAdapter |
插頁式廣告 (出價) | com.google.ads.mediation.vungle.VungleMediationAdapter |
插頁式廣告 (刊登序列) | com.vungle.mediation.VungleInterstitialAdapter |
獎勵廣告 (出價) | com.google.ads.mediation.vungle.VungleMediationAdapter |
獎勵廣告 (刊登序列) | com.vungle.mediation.VungleAdapter |
插頁式獎勵廣告 (出價) | com.google.ads.mediation.vungle.VungleMediationAdapter |
插頁式獎勵廣告 (刊登序列) | com.google.ads.mediation.vungle.VungleMediationAdapter |
iOS
格式 | 類別名稱 |
---|---|
應用程式開啟 (出價) | GADMediationAdapterVungle |
應用程式開啟頁面廣告 (刊登序列) | GADMediationAdapterVungle |
橫幅廣告 (出價) | GADMediationAdapterVungle |
橫幅廣告 (刊登序列) | GADMAdapterVungleInterstitial |
插頁式廣告 (出價) | GADMediationAdapterVungle |
插頁式廣告 (刊登序列) | GADMAdapterVungleInterstitial |
獎勵廣告 (出價) | GADMediationAdapterVungle |
獎勵廣告 (刊登序列) | GADMAdapterVungleRewardBasedVideoAd |
插頁式獎勵廣告 (出價) | GADMediationAdapterVungle |
插頁式獎勵廣告 (刊登序列) | GADMediationAdapterVungle |
以下是 Liftoff Monetize 所擲回的代碼和相應訊息 轉接程式載入失敗時:
Android
錯誤代碼 | 原因 |
---|---|
101 | 伺服器參數無效 (例如應用程式 ID 或刊登位置 ID)。 |
102 | 要求的橫幅廣告大小未對應至有效的 Liftoff Monetize 廣告 大小 |
103 | 必須提供Activity 背景資訊,才能要求 Liftoff Monetize
廣告。 |
104 | Vungle SDK 無法為同一個刊登位置載入多個廣告 編號。 |
105 | Vungle SDK 無法初始化。 |
106 | Vungle SDK 傳回成功的載入回呼,但 Banners.getBanner() 或 Vungle.getNativeAd() 傳回空值。 |
107 | Vungle SDK 尚未準備好播放廣告。 |
108 | Vungle SDK 傳回無效的出價權杖。 |
iOS
錯誤代碼 | 原因 |
---|---|
101 | 伺服器參數無效 (例如應用程式 ID 或刊登位置 ID)。 |
102 | 系統已為這個聯播網設定檔載入廣告。Vungle SDK 無法使用同一個刊登位置 ID 載入第二則廣告。 |
103 | 要求的廣告大小與支援的 Liftoff Monetize 不符 橫幅廣告尺寸 |
104 | Vungle SDK 無法顯示橫幅廣告。 |
105 | Vungle SDK 一次僅支援載入 1 個橫幅廣告,無論 刊登位置 ID |
106 | Vungle SDK 傳送了一則回呼,指出廣告無法播放。 |
107 | Vungle SDK 還無法播放廣告。 |
如要瞭解 Vungle SDK 的錯誤,請參閱「錯誤代碼:iOS 和 Android 適用的 Vungle SDK」。
Liftoff Monetize Unity 中介服務外掛程式變更記錄
5.2.1 版
DummyClient
已重新命名為PlaceholderClient
。- 支援 Liftoff Monetize Android 轉接程式版本 7.4.0.1。
- 支援 Liftoff Monetize iOS 轉接程式版本 7.4.0.1。
- 使用 Google 行動廣告 Unity 外掛程式 9.2.0 版建立並測試。
5.2.0 版
- 支援 Liftoff Monetize Android 轉接程式版本 7.4.0.0。
- 支援 Liftoff Monetize iOS 轉接程式版本 7.4.0.0。
- 使用 Google 行動廣告 Unity 外掛程式 9.1.1 版建立並測試。
5.1.1 版
- 支援 Liftoff Monetize Android 轉接器 7.3.2.0 版。
- 支援 Liftoff Monetize iOS 轉接程式版本 7.3.2.0。
- 使用 Google 行動廣告 Unity 外掛程式 9.1.0 版建立並測試。
5.1.0 版
- 修正了
NullPointerException
在匯出為 Android 專案時導致建構失敗的問題。 - 更新 Privacy API:
- 已移除
UpdateConsentStatus()
和UpdateCCPAStatus()
方法。 - 移除
VungleConsentStatus
和VungleCCPAStatus
列舉。 - 已將
SetGDPRStatus(bool)
方法更新為SetGDPRStatus(bool, String)
。
- 已移除
- 已從
LiftoffMonetizeMediationExtras
類別中移除下列方法:SetAllPlacements(String[])
SetSoundEnabled(bool)
- 支援 Liftoff Monetize Android 轉接程式 7.3.1.0 版。
- 支援 Liftoff Monetize iOS 轉接程式版本 7.3.1.0。
- 使用 Google 行動廣告 Unity 外掛程式 9.1.0 版建立並測試。
5.0.0 版
- 已修正
MediationExtras
重複定義的警告。 - 支援 Liftoff Monetize Android 轉接程式版本 7.1.0.0。
- 支援 Liftoff Monetize iOS 轉接程式版本 7.2.1.1。
- 請使用 Google 行動廣告 Unity 外掛程式 8.7.0 版建立並測試。
4.0.0 版
- 將 Unity 中介服務外掛程式從 Vungle 改為 Liftoff Monetize。
- 已將轉接頭內容移至
GoogleMobileAds/Mediation/LiftoffMonetize/
。 - 重構轉接程式命名空間以使用
GoogleMobileAds.Mediation.LiftoffMonetize
。 - 已將下列方法新增至
LiftoffMonetize
類別:SetGDPRStatus(bool)
SetGDPRMessageVersion(String)
SetCCPAStatus(bool)
- 支援 Liftoff Monetize Android 轉接程式版本 6.12.1.1。
- 支援 Liftoff Monetize iOS 轉接程式版本 7.0.1.0。
- 使用 Google 行動廣告 Unity 外掛程式 8.4.1 版建構及測試。
3.9.2 版
- 已更新
Vungle
類別:- 已新增
UpdateCCPAStatus(VungleCCPAStatus)
方法。 - 已移除
GetCurrentConsentStatus()
方法。 - 已移除
GetCurrentConsentMessageVersion()
方法。
- 已新增
- 支援 Vungle Android 轉接器 6.12.1.0 版。
- 支援 Vungle iOS 轉接器 6.12.2.0 版。
- 請使用 Google 行動廣告 Unity 外掛程式 7.4.1 版建立並測試。
3.9.1 版
- 支援 Vungle Android 轉接器 6.12.1.0 版。
- 支援 Vungle iOS 轉接器 6.12.1.1 版。
- 請使用 Google 行動廣告 Unity 外掛程式 7.4.0 版建立並測試。
3.9.0 版
- 支援 Vungle Android 轉接程式 6.12.0.0 版。
- 支援 Vungle iOS 轉接程式 6.12.0.0 版。
- 請使用 Google 行動廣告 Unity 外掛程式 7.2.0 版建立並測試。
3.8.2 版
- 支援 Vungle Android 轉接程式 6.11.0.2 版。
- 支援 Vungle iOS 轉接程式 6.11.0.1 版。
- 使用 Google 行動廣告 Unity 外掛程式 7.1.0 版進行建構及測試。
3.8.1 版
- 支援 Vungle Android 轉接器 6.11.0.1 版。
- 支援 Vungle iOS 轉接器 6.11.0.0 版。
- 請使用 Google 行動廣告 Unity 外掛程式 7.0.2 版建立並測試。
3.8.0 版
- 支援 Vungle Android 轉接器 6.11.0.0 版。
- 支援 Vungle iOS 轉接器 6.11.0.0 版。
- 使用 Google 行動廣告 Unity 外掛程式 7.0.0 版建立並測試。
3.7.5 版
- 支援 Vungle Android 轉接器 6.10.5.0 版。
- 支援 Vungle iOS 轉接器 6.10.6.1 版。
- 使用 Google 行動廣告 Unity 外掛程式 7.0.0 版建立並測試。
3.7.4 版
- 支援 Vungle Android 轉接程式 6.10.4.0 版。
- 支援 Vungle iOS 轉接器 6.10.6.1 版。
- 使用 Google 行動廣告 Unity 外掛程式 7.0.0 版建立並測試。
3.7.3 版
3.7.2 版
3.7.1 版
3.7.0 版
3.6.0 版
3.5.1 版
3.5.0 版
3.4.1 版
3.4.0 版
3.3.1 版
- 使用
.aar
版本將vungle-extras-library.jar
重新封裝至vungle-unity-android-library.aar
,以支援 Unity 2020。- 升級至這個版本時,請從專案中移除
vungle-extras-library.jar
。
- 升級至這個版本時,請從專案中移除
- 支援 Vungle Android 轉接器 6.5.3.0 版。
- 支援 Vungle iOS 轉接器 6.5.3.0 版。
3.3.0 版
3.2.0 版
版本 3.1.4
- 支援 Android 轉接器 6.3.24.1 版。
- 支援 iOS 轉接器 6.3.2.3 版。
3.1.3 版
- 支援 Android 轉接程式 6.3.24.1 版。
- 支援 iOS 轉接程式 6.3.2.2 版。
版本 3.1.2
- 更新外掛程式,以支援新的 Open-beta 獎勵 API。
- 支援 Android 轉接器 6.3.24.1 版。
- 支援 iOS 轉接器 6.3.2.1 版。
3.1.1 版本
- 支援 Android 轉接程式 6.3.24.0 版。
- 支援 iOS 轉接器 6.3.2.0 版。
- 更新
Vungle.UpdateConsentStatus()
方法,將consentMessageVersion
參數設為選用項目。如果是 iOS 裝置,系統會忽略consentMessageVersion
的值。 - 已淘汰適用於 iOS 的
Vungle.GetCurrentConsentMessageVersion()
。
3.1.0 版本
- 支援 Android 轉接器 6.3.17.0 版。
- 支援 iOS 轉接器 6.3.0.0 版。
- 更新
Vungle.UpdateConsentStatus()
方法,針對發布商提供的同意授權訊息版本使用額外的String
參數。 - 新增
Vungle.GetCurrentConsentMessageVersion()
方法,以取得發布商提供的同意授權訊息版本。
3.0.1 版本
- 支援 Android 轉接器 6.2.5.1 版。
- 支援 iOS 轉接器 6.2.0.3 版。
3.0.0 版本
- 支援 Android 轉接器 6.2.5.0 版。
- 支援 iOS 轉接器 6.2.0.2 版。
- 新增了下列方法:
Vungle.UpdateConsentStatus()
方法,用於設定將記錄在 Vungle SDK 中的同意聲明狀態。Vungle.GetCurrentConsentStatus()
方法,取得使用者的目前同意聲明狀態。
2.0.0 版
- 支援 Android 轉接器 5.3.2.1 版。
- 支援 iOS 轉接器 6.2.0.0 版。
1.1.0 版本
- 支援 Android 轉接器 5.3.2.1 版。
- 支援 iOS 轉接器 5.4.0.0 版。
1.0.0 版本
- 第一版!
- 支援 Android 轉接器 5.3.0.0 版。
- 支援 iOS 轉接器 5.3.0.0 版。