本指南將說明如何使用 Google Mobile Ads SDK 載入及顯示 使用 中介服務 則涵蓋刊登序列整合功能說明如何在廣告單元的 中介服務設定,以及如何將 maio SDK 和轉接程式整合到 Android 應用程式。
Maio 的資訊主頁介面使用日文文字做為標籤、按鈕、 以及本指南中的螢幕截圖尚未翻譯 不過在本指南的說明和操作說明中,標籤和按鈕的 都會有英文版的對等項目。「URL ストー廣告內容」例如 「URL Scheme」
支援的整合項目和廣告格式
maio 的中介服務轉接程式具有下列功能:
整合 | |
---|---|
出價 | |
瀑布 | |
格式 | |
橫幅廣告 | |
插頁式 | |
已獲得獎勵 | |
原生 |
需求條件
- Android API 級別 21 以上
- maio SDK 1.0.7 以上版本
最新版 Google Mobile Ads SDK
完成中介服務 入門指南
步驟 1:在 maio UI 中進行設定
步驟 2:在使用者介面中設定 maio 需求 Ad Manager
步驟 3:匯入 maio SDK 和轉接程式
整合 Android Studio (建議做法)
在專案層級的 settings.gradle.kts
檔案中新增以下內容
存放區:
dependencyResolutionManagement {
repositories {
google()
mavenCentral()
maven {
url = uri("https://imobile-maio.github.io/maven")
}
}
}
接著,在應用程式層級的 build.gradle.kts
檔案中新增以下內容
實作依附元件和設定使用最新版本的
maio SDK 和轉接程式:
dependencies {
implementation("com.google.android.gms:play-services-ads:23.3.0")
implementation("com.google.ads.mediation:maio:1.1.16.3")
}
手動整合
- 下載最新版本的 maio Android SDK 並新增至 加入您的專案
- 前往 Google 的 Maven 存放區中的 maio Adapter 構件。選取最新版本,下載 Maio 轉接器的 `.aar'檔案,然後將檔案加入專案中。
步驟 4:新增必要的程式碼
而且不需要額外的程式碼即可進行 Maio Android 整合。
步驟 5:測試實作成果
啟用測試廣告
請務必為 Ad Manager。
如果發布商使用 Google Mobile Ads SDK 11.6.0 以上版本,在發出請求時,會自動在註冊為測試裝置的手機和平板電腦上接收來自 maio 的測試廣告。
驗證測試廣告
如要確認您正在接收來自maio的測試廣告,請使用 maio (Waterfall) 廣告來源在廣告檢查器中啟用單一廣告來源測試。
錯誤代碼
如果轉接程式無法接收 maio 的廣告
發布商可以使用
ResponseInfo.getAdapterResponses()
加入以下類別:
格式 | 類別名稱 |
---|---|
插頁式 | jp.maio.sdk.android.mediation.admob.adapter.Interstitial |
已獲得獎勵 | jp.maio.sdk.android.mediation.admob.adapter.Rewarded |
以下是廣告無法載入時,maio 轉接程式擲回的代碼和隨附訊息:
錯誤代碼 | 原因 |
---|---|
0-10 | maio 傳回 SDK 相關錯誤。請參閱程式碼 及 maio 的說明文件 ,掌握更多詳細資訊。 |
101 | 小馬沒有可放送的廣告。 |
102 | 伺服器參數無效 (例如缺少刊登位置 ID)。 |
103 | 用來載入廣告的結構定義並非 `Activity` 執行個體。 |
maio Android 中介服務轉接程式變更記錄
1.1.16.3 版
- 將 Google Mobile Ads SDK 最低要求版本更新為 23.0.0。
- 已驗證與 maio SDK 1.1.16 版的相容性。
建構及測試工具:
- Google Mobile Ads SDK 23.0.0 版。
- Maio SDK 1.1.16 版。
1.1.16.2 版
- 已更新轉接程式,以便使用新的
VersionInfo
類別。 - 將 Google Mobile Ads SDK 最低需求更新至 22.0.0 版。
建構及測試工具:
- Google Mobile Ads SDK 22.0.0 版。
- Maio SDK 1.1.16 版。
1.1.16.1 版
- 已將
compileSdkVersion
和targetSdkVersion
更新至 API 31。 - 將 Google Mobile Ads SDK 最低需求更新至 21.0.0 版。
- 將 Android API 級別最低需求更新為 19。
建構及測試工具:
- Google Mobile Ads SDK 21.0.0 版。
- Maio SDK 1.1.16 版。
1.1.16.0 版
- 更新錯誤代碼,以便擷取其他 maio 錯誤。
- 已驗證與 maio SDK 1.1.16 版的相容性。
- 將 Google Mobile Ads SDK 最低需求版本更新為 20.4.0。
建構及測試工具:
- Google Mobile Ads SDK 20.4.0 版。
- Maio SDK 1.1.16 版。
1.1.15.0 版
- 已驗證與 maio SDK 1.1.15 版的相容性。
- 將 Google Mobile Ads SDK 最低版本更新至 20.0.0。
建構及測試工具:
- Google Mobile Ads SDK 20.0.0 版。
- Maio SDK 1.1.15 版。
1.1.14.0 版
- 已新增標準化轉接程式錯誤代碼和訊息。
- 已驗證與 maio SDK 1.1.14 版的相容性。
- 將 Google Mobile Ads SDK 最低需求版本更新為 19.8.0。
建構及測試工具:
- Google Mobile Ads SDK 19.8.0 版。
- Maio SDK 1.1.14 版。
1.1.13.0 版
- 已驗證與 maio SDK 1.1.13 版的相容性。
- 將 Google Mobile Ads SDK 最低需求版本更新為 19.5.0。
建構及測試工具:
- Google Mobile Ads SDK 19.5.0 版。
- Maio SDK 1.1.13 版。
1.1.12.0 版
- 將 Google Mobile Ads SDK 最低需求版本更新為 19.4.0。
建構及測試工具:
- Google Mobile Ads SDK 19.4.0 版。
- Maio SDK 1.1.12 版。
版本 1.1.11.1
- 現在,如果 maio 沒有準備好放送的廣告,廣告請求就會立即失敗,以限制逾時。
- 將 Google Mobile Ads SDK 最低要求版本更新為 19.1.0。
建構及測試工具:
- Google Mobile Ads SDK 19.1.0 版。
- Maio SDK 1.1.11 版。
版本 1.1.11.0
- 已驗證與 maio SDK 1.1.11 版的相容性。
- 將 Google Mobile Ads SDK 最低需求版本更新為 18.3.0。
建構及測試工具:
- Google Mobile Ads SDK 18.3.0 版。
- Maio SDK 1.1.11 版。
1.1.10.0 版
- 已驗證與 maio SDK 1.1.10 版的相容性。
- 將 Google Mobile Ads SDK 最低要求版本更新為 18.2.0。
1.1.8.0 版
- 已驗證與 maio SDK 1.1.8 版的相容性。
- 將 Google Mobile Ads SDK 最低版本更新至 18.1.0。
1.1.7.0 版
- 修正錯誤。
- 已驗證與 maio SDK 1.1.7 版的相容性。
1.1.6.1 版
- 更新轉接程式以支援新的 獎勵 API。
- 將 Google Mobile Ads SDK 最低需求更新至 17.2.0 版。
1.1.6.0 版
- 已驗證與 maio SDK 1.1.6 版的相容性。
1.1.5.0 版
- 已驗證與 maio SDK 1.1.5 版的相容性。
1.1.4.0 版
- 已驗證與 maio SDK 1.1.4 版的相容性。
1.1.3.1 版本
- 已更新轉接器,以便與執行個體類別 (而非單例模式) 搭配使用。
1.1.3.0 版
- 已驗證與 maio SDK 1.1.3 版的相容性。
1.1.2.1 版本
- 更新了轉接器,加入更新的初始化函式。
1.1.2.0 版
- 已驗證與 maio SDK 1.1.2 版的相容性。
1.1.1.1 版本
- 更新轉接程式以叫用
onRewardedVideoComplete()
廣告事件。
1.1.1.0 版
- 已驗證與 maio SDK 1.1.1 版的相容性。
1.1.0.0 版本
- 已驗證與 maio SDK 1.1.0 版的相容性。
1.0.8.0 版
- 已驗證與 maio SDK 1.0.8 版的相容性。
1.0.7.1 版
- 修正廣告失敗時可能會導致 NullPointerExceptions 的問題 載入。
1.0.7.0 版
- 將測試裝置 ID 新增至
AdRequest
,即可啟用測試模式。 - 已驗證與 maio SDK 1.0.7 版的相容性。
1.0.6.0 版
- 第一版!
- 新增對插頁式廣告和獎勵影片廣告的支援。