本指南將說明如何使用 Google Mobile Ads SDK 載入及顯示 使用 中介服務 則涵蓋刊登序列整合功能說明如何將 Unity 廣告 以及如何將 Unity 廣告 SDK 和轉接程式整合到 Android 應用程式。
支援的整合項目和廣告格式
Unity Ads 的中介服務轉接程式具備下列功能:
整合 | |
---|---|
出價 | |
瀑布 | |
格式 | |
橫幅廣告 | |
插頁式 | |
已獲得獎勵 | |
原生 |
需求條件
- Android API 級別 21 以上
最新版 Google Mobile Ads SDK
完成中介服務 入門指南
步驟 1:在 Unity Ads UI 中進行設定
步驟 2:在使用者介面中設定 Unity 廣告需求 Ad Manager
新增 Unity Ads 至 GDPR 和美國州級法規廣告合作夥伴名單
步驟 3:匯入 Unity Ads SDK 和轉接程式
整合 Android Studio (建議做法)
在應用程式層級的 build.gradle.kts
檔案中新增以下實作項目
依附元件和設定使用最新版的 Unity Ads SDK
和轉接器:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.unity3d.ads:unity-ads:4.12.1")
implementation("com.google.ads.mediation:unity:4.12.2.0")
}
手動整合
從
unity-ads.aar
GitHub 存放區 然後加入專案中前往 Unity Ads 轉接程式構件 複製到 Google 的 Maven 存放區選取最新版本,下載 Unity 廣告轉接程式的
.aar
檔案,並將其加進專案。
步驟 4:在 Unity Ads SDK 中導入隱私權設定
歐盟地區使用者同意授權和 GDPR
根據 Google 歐盟地區使用者同意聲明 Google 政策,您必須確保使用者有揭露特定揭露事項。 只有當歐洲經濟區 (EEA) 使用者提供同意聲明,以及 如何使用裝置 ID 和個人資料這項政策反映了 歐盟電子通訊隱私指令和一般資料保護規定 法規 (GDPR)。徵求同意時,您必須指明每個廣告聯播網 中介服務鏈中可能收集、接收或使用個人資料,並 提供各個網路用量的相關資訊。Google 目前無法 將使用者的同意聲明選項自動傳送到這類聯播網。
在 SDK 2.0.0 版中,Unity Ads 新增了 API,支援隱私權設定。 以下範例程式碼說明如何將這項同意聲明資訊傳遞至 Unity 廣告 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 無法將這項設定套用至每則廣告 中介服務鏈中的聯播網因此,你必須找出每個廣告聯播網。 可參與個人銷售的 並遵循各自的指南 確保符合法規。
在 SDK 2.0.0 版中,Unity Ads 新增了 API,支援隱私權設定。 以下範例程式碼說明如何將這項同意聲明資訊傳遞至 Unity 廣告 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:新增必要的程式碼
Unity Ads 整合不需要其他程式碼。
步驟 6:測試實作成果
啟用測試廣告
請務必為Ad Manager 註冊測試裝置,並在 Unity Ads 使用者介面中啟用測試模式。
驗證測試廣告
如要確認您正在接收來自Unity Ads的測試廣告,請使用 Unity Ads (Waterfall) 廣告來源在廣告檢查器中啟用單一廣告來源測試。
錯誤代碼
如果轉接程式無法接收來自 Unity Ads 的廣告,
發布商可以使用
ResponseInfo.getAdapterResponses()
加入以下類別:
com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter
以下是 UnityAds 轉接程式在 如果發生以下情形,則代表廣告無法載入:
錯誤代碼 | 原因 |
---|---|
0-10 | UnityAds SDK 傳回錯誤。請參閱程式碼 ,掌握更多詳細資訊。 |
101 | 在使用者介面中設定的 UnityAds 伺服器參數 Ad Manager 遺失或無效。 |
102 | UnityAds 傳回了 NO_FILL 狀態的刊登位置。 |
103 | UnityAds 傳回處於「已停用」狀態的刊登位置。 |
104 | UnityAds 嘗試顯示結構定義為空值的廣告。 |
105 | 用於初始化、載入和/或顯示 Unity 廣告廣告的環境並不是 Activity 例項。 |
106 | UnityAds 嘗試顯示還無法放送的廣告。 |
107 | 裝置不支援 UnityAds。 |
108 | UnityAds 一次只能為每個刊登位置載入 1 則廣告。 |
109 | UnityAds 已完成,並顯示「ERROR」狀態。 |
200-204 | UnityAds 橫幅廣告相關錯誤。請參閱程式碼 ,掌握更多詳細資訊。 |
Unity 廣告 Android 中介服務轉接程式變更記錄
版本 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 有助於避免依附元件衝突問題。
- 發布商可以選擇加入
com.google.ads.mediation:unity-adapter-only:x.y.z.p
依附元件 應用程式層級的build.gradle
檔案。
- 發布商可以選擇加入
建構及測試工具:
- 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 版
- 修正呼叫
loadAd()
時發生空值指標例外狀況異常終止的問題 再呼叫UnityAds.initialize()
。 - 將 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 橫幅廣告大小
- 已驗證與 Unity Ads SDK 3.1.0 的相容性。
版本 3.0.1.0
- 已驗證與 Unity Ads SDK 3.0.1 的相容性。
- 修正會導致「NPE」的錯誤同時顯示插頁式廣告
3.0.0.2 版
- 更新轉接程式,以支援新的開放式 Beta 版 獎勵 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 廣告的點擊報表 (AdMob 和 Unity 廣告的點擊統計資料 。
- 新增了 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 version].[adapter 修補程式 version]。
- 將 Unity Ads SDK 最低需求更新至 2.0.2 版。
- 將 Google Mobile Ads SDK 最低要求更新至 9.0.0 版。
- 應用程式不再需要呼叫 UnityAds.changeActivity(這個)。
1.0.0 版本
- 原始版本。支援獎勵式影片廣告和插頁式廣告。