本指南說明如何使用 Google Mobile Ads SDK,透過 AdMob 中介服務載入及顯示 Unity Ads 廣告,涵蓋瀑布式整合。本文說明如何將 Unity Ads 新增至廣告單元的中介服務設定,以及如何將 Unity Ads SDK 和轉接程式整合至 Android 應用程式。
支援的整合功能和廣告格式
Unity Ads 的中介服務介面卡具備下列功能:
整合 | |
---|---|
出價 | 1 |
瀑布 | |
格式 | |
橫幅廣告 | |
插頁式 | |
已獲得獎勵 | |
原生 |
1 出價整合功能目前為公開測試版。
需求條件
- Android API 級別 23 以上
- [出價]:如要整合出價功能支援的所有廣告格式,請使用 Unity 轉接程式 4.11.3.0 以上版本 (建議使用最新版本)
最新版 Google Mobile Ads SDK
完成中介服務入門指南
步驟 1:在 Unity Ads 使用者介面中設定
建立專案
在 Unity Ads 資訊主頁中,前往「Projects」並按一下「New」。
填寫表單,然後按一下「建立」即可新增專案。
前往「Unity Ads Monetization」,然後點按「Get started」。
在「New Project」模式中,選取「I will use Mediation」和「Google AdMob」做為「Mediation Partner」,然後按一下「Next」。
選取廣告設定選項,然後按一下「下一步」。
選取刊登位置設定,然後按一下「下一步」。
出價
瀑布
填寫表單,然後按一下「新增專案」。
記下「遊戲 ID」。
建立廣告單元和刊登位置
依序前往「Unity Ads Monetization」 >「Placements」,然後選取專案並點選「Add ad unit」。
輸入廣告單元名稱,然後選取平台和廣告格式。
出價
在「設定」中選取「出價」。在「刊登位置」下方輸入「刊登位置名稱」。
記下「刊登位置 ID」。
瀑布
在「設定」中選取「刊登序列」。在「刊登位置」下方,輸入「刊登位置名稱」、「地理位置標記」和「目標」。
記下「刊登位置 ID」。
最後,按一下「新增廣告單元」,儲存廣告單元和刊登位置。
找出 Unity Ads Reporting API 金鑰
出價
出價整合功能不需要執行這個步驟。
瀑布
依序前往「Unity Ads Monetization」 >「API management」,並記下「Monetization Stats API Access」中的「API Key」。
接著,依序前往「Unity Ads Monetization」 >「Organization Settings」, 並記下「Organization core ID」。
更新 app-ads.txt
Authorized Sellers for Apps (簡稱 app-ads.txt) 是美國互動廣告協會科技實驗室 (IAB Tech Lab) 主持的一項計畫,旨在確保您的應用程式廣告空間只透過獲得您授權的管道出售。為避免廣告收益大幅減少,您必須導入 app-ads.txt
檔案。
如果您尚未設定,請為應用程式設定 app-ads.txt 檔案。
如要為 Unity Ads 導入 app-ads.txt
,請參閱首次設定 app-ads.txt。
開啟測試模式
您可以在 Unity Ads 資訊主頁中啟用測試模式。依序前往「Unity Ads Monetization」>「Testing」。
如要強制應用程式進入測試模式,請按一下「Google Play 商店」旁的編輯按鈕,啟用「Override client test mode」(覆寫用戶端測試模式),然後選取「Force test mode ON (i.e. use test ads) for all devices」(強制所有裝置進入測試模式 (即使用測試廣告))。
或者,您也可以按一下「新增測試裝置」,為特定裝置啟用測試模式。
輸入測試裝置詳細資料,然後按一下「儲存」。
步驟 2:在 AdMob 使用者介面中設定 Unity Ads 需求
設定廣告單元的中介服務設定
您需要在廣告單元的中介服務設定中加入 Unity Ads。
請先登入 AdMob 帳戶。接著前往「中介服務」分頁。如要修改現有的中介服務群組,請按一下該群組的名稱進行編輯,然後跳到「將 Unity Ads 新增為廣告來源」一節。
如要建立新的中介服務群組,請選取「建立中介服務群組」。
輸入廣告格式和平台,然後按一下「繼續」。
為中介服務群組命名,然後選取指定地區。接著,將中介服務群組狀態設為「已啟用」,然後點按「新增廣告單元」。
將這個中介服務群組與一或多個現有的 AdMob 廣告單元建立關聯。接著點選「完成」。
您現在應該會看到廣告單元資訊卡,其中已填入您選取的廣告單元:
將 Unity Ads 新增為廣告來源
出價
在「廣告來源」部分的「出價」資訊卡下方,選取「新增廣告來源」。然後選取「Unity Ads」。按一下「如何簽署合作夥伴協議」,並與 Unity Ads 建立出價合作夥伴關係。
按一下「確認並同意」,然後按一下「繼續」。
如果已對應 Unity Ads,可以選取該對應。否則請按一下「新增對應」。
接著,輸入您在上一節取得的遊戲 ID 和刊登位置 ID。然後按一下「完成」。
瀑布
在「廣告來源」部分的「刊登序列」資訊卡下方,選取「新增廣告來源」。
選取「Unity Ads」,然後啟用「最佳化」切換鈕。輸入上節取得的 API 金鑰和機構核心 ID,為 Unity Ads 設定廣告來源最佳化功能。 然後輸入 Unity Ads 的有效千次曝光出價,並點選「繼續」。
如果已對應 Unity Ads,可以選取該對應。 否則,請按一下「新增對應」。
接著,輸入您在上一節取得的遊戲 ID 和刊登位置 ID。然後按一下「完成」。
將 Unity Ads 新增至 GDPR 和美國州級法規廣告合作夥伴名單
請按照「歐洲法規設定」和「美國州級法規設定」一文的步驟,在 AdMob 使用者介面中,將 Unity Ads 新增至歐洲和美國州級法規廣告合作夥伴名單。
步驟 3:匯入 Unity Ads SDK 和轉接程式
整合 Android Studio (建議)
在應用程式層級的 build.gradle.kts
檔案中,新增下列實作依附元件和設定。使用最新版 Unity Ads SDK 和轉接程式:
dependencies {
implementation("com.google.android.gms:play-services-ads:24.4.0")
implementation("com.unity3d.ads:unity-ads:4.15.0")
implementation("com.google.ads.mediation:unity:4.15.1.0")
}
手動整合
從 GitHub 存放區下載最新版 Unity Ads SDK (
unity-ads.aar
),並新增至專案。前往 Google 的 Maven 存放區,找到 Unity 廣告中介服務介面卡構件。選取最新版本,下載 Unity Ads 轉接程式的
.aar
檔案,然後新增至專案。
步驟 4:在 Unity Ads SDK 中導入隱私權設定
歐盟地區同意授權和 GDPR
根據 Google《歐盟地區使用者同意授權政策》,您必須確保向歐洲經濟區境內使用者揭露裝置 ID 和個人資料的使用方式,並徵得同意聲明。本政策是配合《歐盟地區電子通訊隱私指令》和《一般資料保護規則》(GDPR) 而制定。徵求同意聲明時,您必須指明中介服務鏈中可能會收集、接收或使用個人資料的每個廣告聯播網,並提供各聯播網的使用方式資訊。Google 目前無法自動將使用者的同意聲明選項傳送給這類聯播網。
在 SDK 2.0.0 版中,Unity Ads 新增了支援隱私權設定的 API。以下程式碼範例說明如何將這項同意聲明資訊傳遞至 Unity Ads SDK。如果您選擇手動將同意聲明資訊傳遞至 Unity Ads SDK,建議先呼叫這段程式碼,再透過 Google Mobile Ads SDK 請求廣告。
Java
import com.unity3d.ads.metadata.MetaData;
// ...
MetaData gdprMetaData = new MetaData(this);
gdprMetaData.set("gdpr.consent", true);
gdprMetaData.commit();
Kotlin
import com.unity3d.ads.metadata.MetaData
// ...
val gdprMetaData = MetaData(this)
gdprMetaData["gdpr.consent"] = true
gdprMetaData.commit()
如要瞭解詳情,以及各方法可提供的值,請參閱 Unity Ads 的「隱私權同意聲明和資料 API」和「遵守 GDPR 規定」指南。
美國州級隱私權法律
美國各州隱私權法規定,使用者有權選擇拒絕「販售」其「個人資訊」(如該法案對「販售」與「個人資訊」這兩個詞的定義),且「賣方」必須在首頁上提供顯眼的「請勿銷售我的個人資訊」連結,供使用者使用。《美國州級隱私權法律法規遵循指南》提供啟用 Google 廣告放送「受限的資料處理」模式的功能,但 Google 無法將這項設定套用至中介服務鏈中的每個廣告聯播網。因此,您必須找出中介服務鏈中可能參與銷售個人資訊的每個廣告聯播網,並遵循這些聯播網的指引,確保符合規定。
在 SDK 2.0.0 版中,Unity Ads 新增了支援隱私權設定的 API。以下程式碼範例說明如何將這項同意聲明資訊傳遞至 Unity Ads SDK。如果您選擇手動將同意聲明資訊傳遞至 Unity Ads SDK,建議先呼叫這段程式碼,再透過 Google Mobile Ads SDK 請求廣告。
Java
import com.unity3d.ads.metadata.MetaData;
// ...
MetaData ccpaMetaData = new MetaData(this);
ccpaMetaData.set("privacy.consent", true);
ccpaMetaData.commit();
Kotlin
import com.unity3d.ads.metadata.MetaData
// ...
val ccpaMetaData = MetaData(this)
ccpaMetaData["privacy.consent"] = true
ccpaMetaData.commit()
如要瞭解詳情和各個方法可提供的值,請參閱 Unity Ads 的「隱私權同意聲明和資料 API」和「遵守 CCPA 規定」指南。
步驟 5:新增必要程式碼
載入含有 Activity 內容的廣告
載入橫幅、插頁式和原生廣告格式時,請傳遞 Activity
環境資訊。
如果沒有活動內容,廣告載入就會失敗。
步驟 6:測試實作成果
啟用測試廣告
請務必註冊測試裝置,以便在 AdMob 中使用,並在 Unity Ads 使用者介面中啟用測試模式。
驗證測試廣告
如要確認您收到 Unity Ads 的測試廣告,請使用「Unity Ads (出價)」和「Unity Ads (刊登序列)」廣告來源,在廣告檢查器中啟用單一廣告來源測試。
錯誤代碼
如果中介服務介面卡無法從 Unity Ads 接收廣告,發布商可以使用下列類別的 ResponseInfo.getAdapterResponses()
,從廣告回應中檢查基礎錯誤:
com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter
以下是 UnityAds 轉接程式在廣告無法載入時擲回的程式碼和隨附訊息:
錯誤代碼 | 原因 |
---|---|
0-10 | UnityAds SDK 傳回錯誤。詳情請參閱程式碼。 |
101 | AdMob 使用者介面中設定的 UnityAds 伺服器參數遺失/無效。 |
102 | UnityAds 傳回的刊登位置處於 NO_FILL 狀態。 |
103 | UnityAds 傳回的刊登位置狀態為 DISABLED。 |
104 | UnityAds 嘗試顯示內容為空值的廣告。 |
105 | 用於從 Unity Ads 初始化、載入及/或顯示廣告的 Context 不是 Activity 例項。 |
106 | UnityAds 嘗試顯示尚未準備就緒的廣告。 |
107 | 裝置不支援 UnityAds。 |
108 | UnityAds 一次只能為每個刊登位置載入 1 則廣告。 |
109 | UnityAds 已完成,但處於 ERROR 狀態。 |
200-204 | UnityAds 橫幅專屬錯誤。詳情請參閱程式碼。 |
Unity Ads Android 中介服務介面卡異動記錄
4.15.1.0 版
- 已驗證與 Unity Ads SDK 4.15.1 的相容性。
建構及測試時使用的版本:
- Google Mobile Ads SDK 24.4.0 版。
- Unity Ads SDK 4.15.1 版。
4.15.0.0 版
- 如果內容不是活動,系統會更新為無法收集 RTB 橫幅廣告的信號 (因為 Unity Ads SDK 需要活動內容才能載入 RTB 橫幅廣告)。這項修正可提高發布商的廣告載入成功率。
- 已確認與 Unity Ads SDK 4.15.0 相容。
建構及測試時使用的版本:
- Google Mobile Ads SDK 24.3.0 版。
- Unity Ads SDK 4.15.0 版。
4.14.2.0 版
- 已確認與 Unity Ads SDK 4.14.2 相容。
建構及測試時使用的版本:
- Google Mobile Ads SDK 24.2.0 版。
- Unity Ads SDK 4.14.2 版。
版本 4.14.1.0
- 已驗證與 Unity Ads SDK 4.14.1 的相容性。
建構及測試時使用的版本:
- Google Mobile Ads SDK 24.1.0 版。
- Unity Ads SDK 4.14.1 版。
版本 4.14.0.0
- 已確認與 Unity Ads SDK 4.14.0 相容。
建構及測試時使用的版本:
- Google Mobile Ads SDK 24.0.0 版。
- Unity Ads SDK 4.14.0 版。
4.13.2.0 版
- 將最低 Android API 級別更新為 23。
- 將 Google Mobile Ads SDK 最低必要版本更新為 24.0.0。
建構及測試時使用的版本:
- Google Mobile Ads SDK 24.0.0 版。
- Unity Ads SDK 4.13.2 版。
4.13.1.0 版
- 已確認與 Unity Ads SDK 4.13.1 相容。
建構及測試時使用的版本:
- Google Mobile Ads SDK 23.6.0 版。
- Unity Ads SDK 4.13.1 版。
版本 4.13.0.0
- 從轉接程式中移除不必要的
Activity
內容檢查。 - 已確認與 Unity Ads SDK 4.13.0 相容。
建構及測試時使用的版本:
- Google Mobile Ads SDK 23.6.0 版。
- Unity Ads SDK 4.13.0 版。
版本 4.12.5.1
- 載入廣告時設定物件 ID,修正出價橫幅廣告載入失敗的問題。
建構及測試時使用的版本:
- Google Mobile Ads SDK 23.6.0 版。
- Unity Ads SDK 4.12.5 版。
4.12.5.0 版
- 已確認與 Unity Ads SDK 4.12.5 相容。
建構及測試時使用的版本:
- Google Mobile Ads SDK 23.5.0 版。
- Unity Ads SDK 4.12.5 版。
4.12.4.0 版
- 已確認與 Unity Ads SDK 4.12.4 相容。
建構及測試時使用的版本:
- Google Mobile Ads SDK 23.3.0 版。
- Unity Ads SDK 4.12.4 版。
4.12.3.0 版
- 已確認與 Unity Ads SDK 4.12.3 相容。
建構及測試時使用的版本:
- Google Mobile Ads SDK 23.3.0 版。
- Unity Ads SDK 4.12.3 版。
4.12.2.0 版
- 已驗證與 Unity Ads SDK 4.12.2 的相容性。
建構及測試時使用的版本:
- Google Mobile Ads SDK 23.2.0 版。
- Unity Ads SDK 4.12.2 版。
4.12.1.0 版
- 已驗證與 Unity Ads SDK 4.12.1 的相容性。
建構及測試時使用的版本:
- Google Mobile Ads SDK 23.2.0 版。
- Unity Ads SDK 4.12.1 版。
4.12.0.0 版
- 已確認與 Unity Ads SDK 4.12.0 相容。
建構及測試時使用的版本:
- Google Mobile Ads SDK 23.1.0 版。
- Unity Ads SDK 4.12.0 版。
4.11.3.0 版
- 新增橫幅、插頁式和獎勵廣告格式的出價支援。
- 已確認與 Unity Ads SDK 4.11.3 相容。
建構及測試時使用的版本:
- Google Mobile Ads SDK 23.1.0 版。
- Unity Ads SDK 4.11.3 版。
4.11.2.0 版
- 已確認與 Unity Ads SDK 4.11.2 相容。
建構及測試時使用的版本:
- Google Mobile Ads SDK 23.0.0 版。
- Unity Ads SDK 4.11.2 版。
4.10.0.0 版
- 將 Google Mobile Ads SDK 最低需求版本更新為 23.0.0。
- 已確認與 Unity Ads SDK 4.10.0 相容。
建構及測試時使用的版本:
- Google Mobile Ads SDK 23.0.0 版。
- Unity Ads SDK 4.10.0 版。
4.9.3.0 版
- 已確認與 Unity Ads SDK 4.9.3 相容。
建構及測試時使用的版本:
- Google Mobile Ads SDK 22.6.0 版。
- Unity Ads SDK 4.9.3 版。
4.9.2.0 版
- 已確認與 Unity Ads SDK 4.9.2 相容。
建構及測試時使用的版本:
- Google Mobile Ads SDK 22.3.0 版。
- Unity Ads SDK 4.9.2 版。
4.9.1.0 版
- 將 Google Mobile Ads SDK 最低版本要求更新為 22.3.0。
- 已確認與 Unity Ads SDK 4.9.1 相容。
建構及測試時使用的版本:
- Google Mobile Ads SDK 22.3.0 版。
- Unity Ads SDK 4.9.1 版。
4.8.0.0 版
- 當 Unity Ads SDK 叫用新的 onBannerShown() 回呼方法時,系統會回報廣告曝光次數。
- 已確認與 Unity Ads SDK 4.8.0 相容。
建構及測試時使用的版本:
- Google Mobile Ads SDK 22.2.0 版。
- Unity Ads SDK 4.8.0 版。
4.7.1.0 版
- 已驗證與 Unity Ads SDK 4.7.1 的相容性。
建構及測試時使用的版本:
- Google Mobile Ads SDK 22.1.0 版。
- Unity Ads SDK 4.7.1 版。
4.7.0.0 版
- 已確認與 Unity Ads SDK 4.7.0 相容。
建構及測試時使用的版本:
- Google Mobile Ads SDK 22.0.0 版。
- Unity Ads SDK 4.7.0 版。
4.6.1.1 版
- 更新轉接器,以使用新的
VersionInfo
類別。 - 將 Google Mobile Ads SDK 最低版本要求更新為 22.0.0。
建構及測試時使用的版本:
- Google Mobile Ads SDK 22.0.0 版。
- Unity Ads SDK 4.6.1 版。
版本 4.6.1.0
- 已驗證與 Unity Ads SDK 4.6.1 的相容性。
建構及測試時使用的版本:
- Google Mobile Ads SDK 21.5.0 版
- Unity Ads SDK 4.6.1 版。
版本 4.6.0.0
- 新增支援功能,可將 COPPA 資訊轉送至 Unity Ads SDK。
- 已確認與 Unity Ads SDK 4.6.0 相容。
- 將 Google Mobile Ads SDK 最低版本更新為 21.5.0。
建構及測試時使用的版本:
- Google Mobile Ads SDK 21.5.0 版
- Unity Ads SDK 4.6.0 版。
4.5.0.0 版
- 已確認與 Unity Ads SDK 4.5.0 相容。
- 將 Google Mobile Ads SDK 最低版本要求更新為 21.4.0。
建構及測試時使用的版本:
- Google Mobile Ads SDK 21.4.0 版
- Unity Ads SDK 4.5.0 版。
4.4.1.0 版
- 已確認與 Unity Ads SDK 4.4.1 相容。
建構及測試時使用的版本:
- Google Mobile Ads SDK 21.2.0 版
- Unity Ads SDK 4.4.1 版。
4.4.0.0 版
- 已確認與 Unity Ads SDK 4.4.0 相容。
- 將 Google Mobile Ads SDK 最低版本要求更新為 21.2.0。
建構及測試時使用的版本:
- Google Mobile Ads SDK 21.2.0 版
- Unity Ads SDK 4.4.0 版。
版本 4.3.0.0
- 已確認與 Unity Ads SDK 4.3.0 相容。
- 插頁式廣告和獎勵廣告開始播放時,系統現在會轉送
onAdOpened()
回呼。
建構及測試時使用的版本:
- Google Mobile Ads SDK 21.1.0 版
- Unity Ads SDK 4.3.0 版。
4.2.1.1 版
- 將
compileSdkVersion
和targetSdkVersion
更新至 API 31。 - 將 Google Mobile Ads SDK 最低需求版本更新為 21.0.0。
建構及測試時使用的版本:
- Google Mobile Ads SDK 21.0.0 版。
- Unity Ads SDK 4.2.1 版。
4.2.1.0 版
- 已確認與 Unity Ads SDK 4.2.1 相容。
建構及測試時使用的版本:
- Google Mobile Ads SDK 20.6.0 版。
- Unity Ads SDK 4.2.1 版。
4.1.0.0 版
- 已確認與 Unity Ads SDK 4.1.0 相容。
建構及測試時使用的版本:
- Google Mobile Ads SDK 20.6.0 版。
- Unity Ads SDK 4.1.0 版。
4.0.1.0 版
- 已確認與 Unity Ads SDK 4.0.1 相容。
- 將 Google Mobile Ads SDK 最低版本更新至 20.6.0。
建構及測試時使用的版本:
- Google Mobile Ads SDK 20.6.0 版。
- Unity Ads SDK 4.0.1 版。
4.0.0.0 版
- 已確認與 Unity Ads SDK 4.0.0 相容。
- 將 Google Mobile Ads SDK 最低版本更新為 20.5.0。
建構及測試時使用的版本:
- Google Mobile Ads SDK 20.5.0 版。
- Unity Ads SDK 4.0.0 版。
3.7.5.0 版
- 已驗證與 Unity Ads SDK 3.7.5 的相容性。
建構及測試時使用的版本:
- Google Mobile Ads SDK 20.2.0 版。
- Unity Ads SDK 3.7.5 版。
3.7.4.0 版
- 已確認與 Unity Ads SDK 3.7.4 相容。
建構及測試時使用的版本:
- Google Mobile Ads SDK 20.2.0 版。
- Unity Ads SDK 3.7.4 版。
3.7.2.0 版
- 已確認與 Unity Ads SDK 3.7.2 相容。
- 將 Google Mobile Ads SDK 最低版本要求更新為 20.2.0。
建構及測試時使用的版本:
- Google Mobile Ads SDK 20.2.0 版。
- Unity Ads SDK 3.7.2 版。
3.7.1.0 版
- 已確認與 Unity Ads SDK 3.7.1 相容。
- 將 Google Mobile Ads SDK 最低版本更新為 20.1.0。
建構及測試時使用的版本:
- Google Mobile Ads SDK 20.1.0 版。
- Unity Ads SDK 3.7.1 版。
3.6.2.0 版
- 已驗證與 Unity Ads SDK 3.6.2 的相容性。
- 修正問題:系統未轉送點擊回呼的獎勵廣告。
- 已從隨附的轉接程式版本中移除 UnityAds SDK。 發布商現在必須手動將 UnityAds SDK 納入為額外依附元件。
- 將 Google Mobile Ads SDK 最低版本要求更新為 19.8.0。
建構及測試時使用的版本:
- Google Mobile Ads SDK 19.8.0 版。
- Unity Ads SDK 3.6.2 版。
3.6.0.0 版
- 已確認與 Unity Ads SDK 3.6.0 相容。
- 將 Google Mobile Ads SDK 最低版本更新為 19.6.0。
建構及測試時使用的版本:
- Google Mobile Ads SDK 19.6.0 版。
- Unity Ads SDK 3.6.0 版。
3.5.1.1 版
- 修正嘗試要求多個插頁式和獎勵廣告時發生的問題。
建構及測試時使用的版本:
- Google Mobile Ads SDK 19.5.0 版。
- Unity Ads SDK 3.5.1 版。
3.5.1.0 版
- 已驗證與 Unity Ads SDK 3.5.1 的相容性。
- 修正導致智慧橫幅廣告請求失敗的問題。
建構及測試時使用的版本:
- Google Mobile Ads SDK 19.5.0 版。
- Unity Ads SDK 3.5.1 版。
3.5.0.0 版
- 已確認與 Unity Ads SDK 3.5.0 相容。
- 新增自動調整橫幅廣告支援。
- 將 Google Mobile Ads SDK 最低版本要求更新為 19.5.0。
建構及測試時使用的版本:
- Google Mobile Ads SDK 19.5.0 版。
- Unity Ads SDK 3.5.0 版。
版本 3.4.8.0
- 修正橫幅廣告遭到毀損時發生的
NullPointerException
錯誤。 - 將 Google Mobile Ads SDK 最低版本要求更新為 19.3.0。
建構及測試時使用的版本:
- Google Mobile Ads SDK 19.3.0 版。
- Unity Ads SDK 3.4.8 版。
3.4.6.1 版
- 建立的轉接程式版本未包含 Unity Ads SDK。發布商可選擇在 Unity 中介服務時使用 Unity Ads 服務,避免發生相依性衝突問題。
- 發布商可以在應用程式層級的
build.gradle
檔案中加入com.google.ads.mediation:unity-adapter-only:x.y.z.p
依附元件,選擇使用這項功能。
- 發布商可以在應用程式層級的
建構及測試時使用的版本:
- Google Mobile Ads SDK 19.1.0 版。
- Unity Ads SDK 3.4.6 版。
3.4.6.0 版
- 已確認與 Unity Ads SDK 3.4.6 相容。
- 現在,使用者點選橫幅廣告時,轉接程式會轉送
onAdOpened()
回呼。
建構及測試時使用的版本:
- Google Mobile Ads SDK 19.1.0 版。
- Unity Ads SDK 3.4.6 版。
3.4.2.3 版
- 新增描述性錯誤代碼和轉接程式載入/顯示失敗的原因。
- 將 Google Mobile Ads SDK 最低版本要求更新為 19.1.0。
建構及測試時使用的版本:
- Google Mobile Ads SDK 19.1.0 版。
- Unity Ads SDK 3.4.2 版。
3.4.2.2 版
- 修正 Unity Ads 回傳錯誤時發生的
ConcurrentModificationException
異常終止問題。
建構及測試時使用的版本:
- Google Mobile Ads SDK 19.0.1 版。
- Unity Ads SDK 3.4.2 版。
版本 3.4.2.1
- 改善 Unity 錯誤轉送功能,以便更早識別初始化和廣告載入失敗情形,並減少逾時。
- 將 Google Mobile Ads SDK 最低版本更新至 19.0.1。
建構及測試時使用的版本:
- Google Mobile Ads SDK 19.0.1 版。
- Unity Ads SDK 3.4.2 版。
3.4.2.0 版
- 已確認與 Unity Ads SDK 3.4.2 相容。
- 將 Google Mobile Ads SDK 最低版本更新至 18.3.0。
建構及測試時使用的版本:
- Google Mobile Ads SDK 18.3.0 版。
- Unity Ads SDK 3.4.2 版。
3.4.0.0 版
- 已確認與 Unity Ads SDK 3.4.0 相容。
- 將 Google Mobile Ads SDK 最低版本更新至 18.3.0。
建構及測試時使用的版本:
- Google Mobile Ads SDK 18.3.0 版。
- Unity Ads SDK 3.4.0 版。
3.3.0.0 版
- 已確認與 Unity Ads SDK 3.3.0 相容。
建構及測試時使用的版本:
- Google Mobile Ads SDK 18.2.0 版。
- Unity Ads SDK 3.3.0 版。
3.2.0.1 版
- 修正在呼叫
UnityAds.initialize()
之前呼叫loadAd()
時,發生的空值指標例外狀況異常終止問題。 - 將 Google Mobile Ads SDK 最低需求版本更新為 18.2.0。
3.2.0.0 版
- 修正導致橫幅廣告請求失敗的問題。
- 已確認與 Unity Ads SDK 3.2.0 相容。
- 將轉接頭遷移至 AndroidX。
- 將 Google Mobile Ads SDK 最低必要版本更新為 18.1.1。
3.1.0.0 版
- 開始支援彈性橫幅廣告大小。
- 如果要求的廣告大小與任何 Unity Ads 橫幅大小不相容,轉接程式會導致廣告請求失敗
- 已確認與 Unity Ads SDK 3.1.0 相容。
3.0.1.0 版
- 已驗證與 Unity Ads SDK 3.0.1 的相容性。
- 修正顯示插頁式廣告時導致「NPE」的錯誤。
3.0.0.2 版
- 更新轉接程式,支援新的公開測試版 Rewarded API。
- 將 Google Mobile Ads SDK 最低必要版本更新為 17.2.0。
3.0.0.1 版
- 新增 Unity Ads 橫幅支援。
3.0.0.0 版
- 已確認與 Unity Ads SDK 3.0.0 相容。
2.3.0.0 版
- 已確認與 Unity Ads SDK 2.3.0 相容。
2.2.1.1 版
- 更新轉接程式,叫用
onRewardedVideoComplete()
廣告事件。
2.2.1.0 版
- 已確認與 Unity Ads SDK 2.2.1 相容。
2.2.0.0 版
- 已確認與 Unity Ads SDK 2.2.0 相容。
2.1.2.0 版
- 已確認與 Unity Ads SDK 2.1.2 相容。
2.1.1.0 版
- 已確認與 Unity Ads SDK 2.1.1 相容。
2.1.0.0 版
- 更新轉接程式,使其與 Unity Ads SDK 2.1.0 相容。
2.0.8.0 版
- 已確認與 Unity Ads SDK 2.0.8 相容。
2.0.7.0 版
- 使用 Unity Ads 的點擊報表 (AdMob 和 Unity Ads 的點擊統計資料會相符)。
- 新增 onAdLeftApplication 回呼支援。
2.0.6.0 版
- 已確認與 Unity Ads SDK 2.0.6 相容。
2.0.5.0 版
- 現在,只要在 build.gradle 檔案的依附元件標記中新增下列內容,即可將轉接程式新增為編譯依附元件:
compile 'com.google.ads.mediation:unity:2.0.5.0'
- 改為以 aar 形式發布轉接程式,而非 jar 檔案 (詳情請參閱 README)。
2.0.4.0 版
- 修正錯誤:如果先載入中插廣告,系統會無法載入影片廣告。
2.0.2.0 版
- 將版本命名系統變更為 [Unity Ads SDK 版本].[轉接程式修補程式版本]。
- 將 Unity Ads SDK 的最低需求版本更新至 2.0.2 版。
- 將 Google Mobile Ads SDK 最低版本更新至 9.0.0 版。
- 應用程式不再需要呼叫 UnityAds.changeActivity(this)。
1.0.0 版本
- 原始版本。支援獎勵影片廣告和插頁式廣告。