本指南說明如何使用 Google Mobile Ads SDK 透過中介服務載入並顯示 Liftoff Monetize 的廣告,涵蓋出價和瀑布流程整合。這篇文章將說明如何將 Liftoff Monetize 新增至廣告單元的中介設定,以及如何將 Vungle SDK 和轉接程式整合至Unity 應用程式。
支援的整合和廣告格式
整合 | |
---|---|
出價 | 1 |
瀑布 | |
格式 | |
開啟應用程式 | 2 |
橫幅廣告 | |
插頁式 | |
已獲得獎勵 | |
插頁式獎勵廣告 |
1:出價整合功能處於公開 Beta 版階段。
2 瀑布 此格式的整合功能仍在公開測試階段
需求條件
- 最新版 Google Mobile Ads SDK
- Unity 4 以上版本
- (出價):Liftoff Monetize 專用的 Google 行動廣告中介外掛程式 3.8.2 以上版本 (建議使用最新版本)
- 如何在 Android 上部署
- Android API 級別 21 以上
- 如何在 iOS 上部署
- iOS 部署目標為 12.0 以上版本
- 使用 Google Mobile Ads SDK 設定的 Unity 可運作專案。詳情請見 詳情請參閱開始使用。
- 完成中介服務入門指南
步驟 1:在 Liftoff Monetize 使用者介面中設定設定
按一下「Add Application」按鈕,將應用程式新增至 Liftoff Monetize 資訊主頁。
填寫表單,輸入所有必填的詳細資料。
Android
iOS
建立應用程式後,請從中選取應用程式 Liftoff Monetize 應用程式資訊主頁。
Android
iOS
記下應用程式 ID。
Android
iOS
新增刊登位置
如要建立可搭配 AdMob 中介服務使用的刊登位置,請前往 Liftoff 營利刊登位置資訊主頁,按一下「新增刊登位置」按鈕,然後從下拉式清單中選取應用程式。
新增刊登位置的詳細資訊如下:
開啟應用程式
選取「插頁式廣告」,然後輸入「刊登位置名稱」。然後選取「是」 [可略過] 並填寫表單的其餘部分。[僅限出價] 低於 「營利」,將「應用程式內出價」切換為「已啟用」。 按一下頁面底部的「繼續」按鈕,即可建立刊登位置。
橫幅廣告
選取「橫幅」,輸入「刊登位置名稱」,然後填寫表單的其餘部分。[僅限出價] 在「營利」下方,將「應用程式內出價」切換為開啟 切換至「啟用」。按一下畫面底部的 [繼續] 按鈕 網頁建立刊登位置
300x250 橫幅
選取「MREC」,輸入「刊登位置名稱」,然後填寫其餘部分 表單中要求的資訊。[僅限出價] 在「營利」下方,將「應用程式內出價」切換為開啟 切換至「啟用」。按一下畫面底部的 [繼續] 按鈕 網頁建立刊登位置
插頁式
選取「插頁式廣告」,輸入「刊登位置名稱」,然後填寫表單的其餘部分。[僅限出價] 在「營利」下方,將 將「應用程式內出價」切換為「已啟用」。按一下 [繼續] 按鈕 建立刊登位置
已獲得獎勵
選取「獎勵廣告」,輸入刊登位置名稱,然後填寫其餘部分 表單中要求的資訊。[僅限出價] 在「營利」下方,將「應用程式內出價」切換為開啟 切換至「啟用」。按一下頁面底部的「繼續」按鈕,即可建立刊登位置。
插頁式獎勵廣告
選取「獎勵」。輸入「刊登位置名稱」,啟用「可略過」和 填寫表單的其他部分。[僅限出價] 在「營利」下方切換鈕 將「應用程式內出價」切換為「已啟用」。按一下「繼續」按鈕 建立刊登位置
原生
選取「原生」,輸入「刊登位置名稱」,然後填寫其餘部分 表單中要求的資訊。[僅限出價] 在「營利」下方,將「應用程式內出價」切換為開啟 切換至「啟用」。按一下畫面底部的 [繼續] 按鈕 網頁建立刊登位置
記下「Reference ID」,然後按一下「Sounds Good」。
開啟應用程式
橫幅廣告
300x250 橫幅
插頁式
已獲得獎勵
插頁式獎勵廣告
原生
找出您的 Reporting API 金鑰
出價
出價整合不必執行這個步驟。
瀑布
除了 應用程式 ID 和 參考 ID 之外,您還需要提供 Liftoff Monetize 的 Reporting API 金鑰,才能設定 AdMob 廣告單元 ID。前往 Liftoff Monetize 報表資訊主頁,然後按一下「Reporting API Key」按鈕,即可查看「Reporting API Key」。
開啟測試模式
如要啟用測試廣告,請前往 Liftoff Monetize 資訊主頁,然後前往「應用程式」。
在應用程式的「刊登位置參考 ID」部分下方,選取要啟用測試廣告的應用程式。如要啟用測試廣告,請在「狀態」部分下方,將「測試模式」選項切換為「只顯示測試廣告」。
Android
iOS
步驟 2:在使用者介面中設定 Liftoff Monetize 需求 Ad Manager
調整廣告單元中介服務設定
新增 Liftoff 至 GDPR 和美國州級法規廣告合作夥伴名單
步驟 3:匯入 Vungle SDK 和 Liftoff Monetize 轉接程式
從Changelog 中的下載連結,下載最新版的 Liftoff Monetize 專用 Google 行動廣告中介插件,然後從 ZIP 檔案中解壓縮 GoogleMobileAdsVungleMediation.unitypackage
。
在 Unity 專案編輯器中,依序選取「Assets」>「Assets」匯入套件 >
Custom Package,並找出 GoogleMobileAdsVungleMediation.unitypackage
檔案
下載。確認已選取所有檔案,然後按一下「匯入」。
接著,依序選取「Assets」>「Play Services Resolver」>「Android Resolver」>「Force Resolve」。Unity Play 服務解析器程式庫將執行以下作業
從頭開始依附元件解析,並將宣告的依附元件複製到
Assets/Plugins/Android
目錄。
步驟 4:在 Liftoff Monetize SDK 中導入隱私權設定
歐盟同意聲明和 GDPR
根據 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 Mobile Ads 中介服務外掛程式包含將同意資訊傳送至 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 的說明文件,將 SKAdNetwork ID 新增至專案的 Info.plist
檔案。
步驟 6:測試導入作業
啟用測試廣告
請務必為Ad Manager 註冊測試裝置,並在 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 | 無論刊登位置 ID 為何,Vungle SDK 一次只支援載入 1 個橫幅廣告。 |
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 版
- 更新外掛程式,以支援新的公開測試版 Rewarded 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 版。