本指南說明如何使用 Google Mobile Ads SDK,透過中介服務載入及顯示 Unity Ads 廣告,也會介紹刊登序列整合作業,內容涵蓋如何將 Unity Ads 加到廣告單元的中介服務設定,以及如何將 Unity Ads SDK 和轉接程式整合至 Android 應用程式。
支援的整合功能和廣告格式
Unity Ads 中介服務轉接程式具備下列功能:
整合 | |
---|---|
出價 | 1 |
瀑布 | |
格式 | |
橫幅廣告 | |
插頁式 | |
已獲得獎勵 | |
原生 |
1 出價整合功能目前為公開測試版。
需求條件
- Android API 級別 23 以上版本
- [出價]:如要整合出價功能支援的所有廣告格式,請使用 Unity 轉接程式 4.16.0.1 以上版本 (建議採用最新版本)
最新版 Google Mobile Ads SDK
完成中介服務入門指南的步驟
步驟 1:在 Unity Ads 使用者介面中設定
建立專案
在 Unity Ads 資訊主頁中,前往「Projects」,然後按一下「New」。
填寫表單,然後按一下「建立」即可新增專案。
前往「Unity Ads Monetization」,然後點按「開始使用」。
在「New Project」模式中,選取「I will use Mediation」和「Google AdMob」做為「Mediation Partner」,然後按一下「Next」。
選取廣告設定選項,然後按一下「下一步」。
選取刊登位置設定,然後按一下「下一步」。
出價
瀑布
填寫表單,然後按一下「新增專案」。
記下「遊戲 ID」。
建立廣告單元和刊登位置
依序前往「Unity Ads Monetization」 >「Placements」,然後選取專案並點選「Add ad unit」。
輸入廣告單元名稱,然後選取平台和廣告格式。
依序前往「營利」 >「刊登位置」,然後點選「新增廣告單元」。
輸入廣告單元名稱,然後選取平台和廣告格式。
在「設定」中選取「Waterfall」。在「刊登位置」下方,輸入「刊登位置名稱」、「地理位置標記」和「目標」。
記下「刊登位置 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
檔案。
如果尚未建立,請為 Ad Manager 建立 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:在 Ad Manager 使用者介面設定 Unity Ads 需求
登入 Ad Manager 帳戶。
在「公司」中新增 Unity Ads
出價
整合出價功能不需要執行這個步驟。
瀑布
依序前往「管理」 >「公司」,然後按一下「所有公司」分頁中的「新增公司」按鈕,選取「廣告聯播網」。
將「廣告聯播網」設為「Unity Ads」,輸入專屬「名稱」,並啟用「中介服務」。 開啟「自動收集資料」,然後輸入在上一個部分取得的「API 金鑰」和「機構核心 ID」。
不需要輸入「使用者名稱」或「密碼」。完成後請點選「儲存」。
啟用安全信號共用
出價
依序前往「管理」 >「通用設定」。前往「Ad Exchange 帳戶設定」分頁,查看並開啟「安全信號共用」。按一下「儲存」。
瀑布
整合刊登序列不需要執行這個步驟。
透過出價要求共用安全信號
出價
依序前往「廣告空間」 >「安全信號」。在「安全信號」下方,搜尋「Unity Ads」,然後開啟「啟用應用程式整合」。
按一下 [儲存]。
瀑布
整合刊登序列不需要執行這個步驟。
允許 SDK 出價共用安全信號
出價
依序前往「廣告放送」 >「需求管道設定」。在「預設設定」分頁中,為「SDK 出價」開啟「允許安全信號共用」。
按一下 [儲存]。
瀑布
整合刊登序列不需要執行這個步驟。
設定 Unity Ads 出價
出價
依序前往「廣告放送」 >「出價方」,然後按一下「前往 SDK 出價」。
按一下「新增出價方」。
選取「Unity Ads」做為出價方。
按一下「繼續」,即可為這個出價方啟用 SDK 出價。
按一下 [完成]。
瀑布
整合刊登序列不需要執行這個步驟。
設定廣告單元對應
出價
依序前往「廣告放送」 >「出價方」,然後按一下「前往 SDK 出價」。
選取 Unity Ads 的公司。
前往「廣告單元對應」分頁,然後按一下「新增廣告單元對應」。
選擇「特定廣告單元」。選取廣告單元和格式,並將「廣告空間類型」設為「行動應用程式」。接著選取「行動應用程式」,然後輸入在上一個部分取得的「遊戲 ID」和「刊登位置 ID」。最後按一下「儲存」。
瀑布
依序前往「廣告放送」 >「收益群組」,然後按一下「新增收益群組」按鈕,選取「行動應用程式」。
向下捲動並按一下「新增收益夥伴」。
選取您先前為 Unity Ads 建立的公司。將「整合類型」設為「Mobile SDK 中介服務」、「平台」設為「Android」,並將「狀態」設為「有效」。
輸入在上一個部分取得的「遊戲 ID」和「刊登位置 ID」,以及「預設千次曝光出價」的值。按一下「儲存」。
注意:自動資料收集功能需要幾天的時間來收集資料,才能準確計算中介服務聯播網的動態千次曝光出價。一旦計算完畢,系統就會代您自動更新有效千次曝光出價。
將 Unity Ads 新增至 GDPR 和美國州級法規廣告合作夥伴名單
請按照「歐洲法規設定」和「美國州級法規設定」中的步驟,在 Ad Manager 使用者介面,將 Unity Ads 新增至歐洲和美國州級法規廣告合作夥伴名單。
步驟 3:匯入 Unity Ads SDK 和轉接程式
整合 Android Studio (建議)
在應用程式層級的 build.gradle.kts
檔案中,新增下列導入依附元件和設定。請使用最新版 Unity Ads SDK 和轉接程式:
dependencies {
implementation("com.google.android.gms:play-services-ads:24.5.0")
implementation("com.unity3d.ads:unity-ads:4.16.1")
implementation("com.google.ads.mediation:unity:4.16.1.0")
}
手動整合
從 GitHub 存放區下載最新版 Unity Ads SDK (
unity-ads.aar
),並加入專案。前往 Google 的 Maven 存放區,找到 Unity Ads 轉接程式構件。選取最新版本,下載 Unity Ads 轉接程式的
.aar
檔案並新增至專案。
步驟 4:在 Unity Ads SDK 中導入隱私權設定
歐盟地區同意授權和 GDPR
為遵守《Google 歐盟地區使用者同意聲明政策》,您必須向歐洲經濟區、英國和瑞士的使用者揭露特定資訊,並在法律有相關規定時,取得他們對使用 Cookie 或其他本機儲存空間的同意聲明,以及對收集、分享及使用個人資料進行廣告個人化的同意聲明。本政策是配合《歐盟地區電子通訊隱私指令》和《一般資料保護規則》(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:測試導入成果
啟用測試廣告
請務必為 Ad Manager 註冊測試裝置,並在 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 | Ad Manager 使用者介面中設定的 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.16.1.0 版
- Unity Ads SDK 4.16.1 版相容性驗證完成。
建構及測試時使用的版本:
- Google Mobile Ads SDK 24.5.0 版。
- Unity Ads SDK 4.16.1 版。
4.16.0.1 版
- 已從橫幅即時出價廣告的轉接程式中移除尺寸檢查。
建構及測試時使用的版本:
- Google Mobile Ads SDK 24.5.0 版。
- Unity Ads SDK 4.16.0 版。
4.16.0.0 版
- 驗證與 Unity Ads SDK 4.16.0 版的相容性。
建構及測試時使用的版本:
- Google Mobile Ads SDK 24.5.0 版。
- Unity Ads SDK 4.16.0 版。
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 版本
- 原始版本。支援獎勵影片廣告和插頁式廣告。