本指南說明如何使用 Google Mobile Ads SDK 透過中介服務載入並顯示 Liftoff Monetize 的廣告,涵蓋出價和瀑布流程整合。本篇文章將說明如何將 Liftoff Monetize 新增至廣告單元的中介設定,以及如何將 Vungle SDK 和轉接程式整合至 Unity 應用程式。
支援的整合和廣告格式
整合 | |
---|---|
出價 | |
瀑布 | |
格式 | |
開啟應用程式 | 1, 2 |
橫幅廣告 | 1 |
插頁式 | |
已獲得獎勵 | |
插頁式獎勵廣告 | 1 |
1 這個格式的出價整合功能目前為公開 Beta 版。
2 這類格式的瀑布流程整合功能處於公開 Beta 版階段。
需求條件
- 最新版 Google Mobile Ads SDK
- Unity 4 以上版本
- [出價]:如要在出價中整合所有支援的廣告格式,請使用 AppLovin 適用的 Google 行動廣告中介服務外掛程式 5.1.0 以上版本 (建議使用最新版本)
- 如何在 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」,輸入「刊登位置名稱」,然後填寫表單的其餘部分。[僅限出價] 在「營利」下方,將「應用程式內出價」切換鈕切換為「已啟用」。按一下頁面底部的「繼續」按鈕,即可建立刊登位置。
插頁式
選取「插頁式廣告」,輸入「刊登位置名稱」,然後填寫表單的其餘部分。[僅限出價] 在「營利」下方,將「應用程式內出價」切換鈕切換為「已啟用」。按一下頁面底部的「繼續」按鈕,建立刊登位置。
已獲得獎勵
選取「Rewarded」,輸入「Placement Name」,然後填寫表單的其餘部分。[僅限出價] 在「營利」下方,將「應用程式內出價」切換鈕切換為「已啟用」。按一下頁面底部的「繼續」按鈕,即可建立刊登位置。
插頁式獎勵廣告
選取「獎勵」。輸入「刊登位置名稱」,啟用「可略過」,然後填寫表單的其餘部分。[僅限出價] 在「營利」下方,將「應用程式內出價」切換鈕切換為「已啟用」。按一下頁面底部的「繼續」按鈕,即可建立刊登位置。
原生
選取「原生」,輸入「刊登位置名稱」,然後填寫表單的其餘部分。[僅限出價] 在「營利」下方,將「應用程式內出價」切換鈕切換為「已啟用」。按一下頁面底部的「繼續」按鈕,即可建立刊登位置。
記下「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:在 AdMob UI 中設定 Liftoff Monetize 需求
設定廣告單元的中介服務設定
將 Liftoff 新增至 GDPR 和美國州級法規廣告合作夥伴清單
請按照GDPR 設定和美國州級法規設定中的步驟,將 Liftoff 新增至 AdMob 使用者介面中的 GDPR 和美國州級法規廣告合作夥伴名單。
步驟 3:匯入 Vungle SDK 和 Liftoff Monetize 轉接程式
OpenUPM-CLI
如果您已安裝 OpenUPM-CLI,只要從專案根目錄執行下列指令,即可將 Google 行動廣告 Liftoff 營利中介服務外掛程式 (適用於 Unity) 安裝到專案中:
openupm add com.google.ads.mobile.mediation.liftoffmonetize
OpenUPM
在 Unity 專案編輯器中,依序選取「Edit」 >「Project Settings」 >「Package Manager」,即可開啟 Unity Package Manager Settings。
在「Scoped Registries」分頁下方,將 OpenUPM 新增為受限登錄,並提供下列詳細資料:
- 名稱:
OpenUPM
- 網址:
https://package.openupm.com
- 範圍:
com.google
接著,前往「Window」 >「Package Manager」開啟 Unity Package Manager,然後從下拉式選單中選取「My Registries」。
選取「Google Mobile Ads Liftoff Monetize Mediation」套件,然後按一下「安裝」。
Unity 套件
從變更記錄中的下載連結,下載最新版的 Liftoff Monetize 專用 Google 行動廣告中介外掛程式,然後從 ZIP 檔案中解壓縮 GoogleMobileAdsLiftoffMonetizeMediation.unitypackage
。
在 Unity 專案編輯器中,依序選取「Assets」 >「Import Package」 >「Custom Package」,然後找出您下載的 GoogleMobileAdsLiftoffMonetizeMediation.unitypackage
檔案。確認已選取所有檔案,然後按一下「Import」。
接著,依序選取「Assets」 >「External Dependency Manager」 >「Android Resolver」 >「Force Resolve」。外部依附元件管理員程式庫會從頭執行依附元件解析作業,並將已宣告的依附元件複製到 Unity 應用程式的 Assets/Plugins/Android
目錄中。
步驟 4:在 Liftoff Monetize SDK 中實作隱私權設定
歐盟同意聲明和 GDPR
根據 Google 的《歐盟地區使用者同意授權政策》,您必須確保向歐洲經濟區 (EEA) 境內使用者揭露特定資訊,並徵得使用者同意聲明,才能使用裝置 ID 和個人資料。本政策是配合《歐盟電子通訊隱私指令》和《一般資料保護規則》(GDPR) 的法規而制定。在徵求同意聲明時,您必須指出中介服務鏈中可能會收集、接收或使用個人資料的每個廣告聯播網,並提供每個聯播網的使用方式相關資訊。Google 目前無法自動將使用者的同意聲明選項傳送給這類網路。
Liftoff Monetize 專用的 Google Mobile Ads 中介服務外掛程式包含將同意資訊傳送至 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:測試導入作業
啟用測試廣告
請務必為 AdMob 註冊測試裝置,並在 Liftoff Monetize 使用者介面中啟用測試模式。
驗證測試廣告
如要確認您是否收到 Liftoff Monetize 的測試廣告,請使用 Liftoff Monetize (出價) 和 Liftoff Monetize (刊登序列) 廣告來源,在廣告檢查器中啟用單一廣告來源測試。
錯誤代碼
如果轉接程式無法從 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 營利適配器在廣告載入失敗時,所擲回的程式碼和隨附訊息:
Android
錯誤代碼 | 原因 |
---|---|
101 | 無效的伺服器參數 (例如應用程式 ID 或刊登位置 ID)。 |
102 | 請求的橫幅大小無法對應至有效的 Liftoff Monetize 廣告大小。 |
103 | Liftoff Monetize 需要 Activity 背景資訊才能要求廣告。 |
104 | Vungle SDK 無法為同一個刊登位置 ID 載入多個廣告。 |
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.2 版
- 支援 Liftoff Monetize Android 轉接器 7.4.2.0 版。
- 支援 Liftoff Monetize iOS 轉接器 7.4.2.0 版。
- 使用 Google 行動廣告 Unity 外掛程式 9.4.0 版進行建構及測試。
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 專案時發生建構失敗的問題。 - 更新隱私權 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 版。