本指南將說明如何使用 Google Mobile Ads SDK,透過中介服務載入及顯示 Maio 中的廣告,涵蓋刊登序列整合機制。我們會說明如何將 Maio 新增至廣告單元的中介服務設定,以及如何將 Maio SDK 和轉接程式整合至Android 應用程式。
Maio 的資訊主頁介面使用日文文字做為標籤、按鈕和說明,本指南中的螢幕截圖尚未翻譯。不過,本指南的說明和操作說明會參照標籤和按鈕,說明對應的英文語言。例如「URL Vendor ーム」 例如「URL Scheme」等等
支援的整合項目和廣告格式
Maio 的 Ad Manager 中介服務轉接程式具備下列功能:
整合 | |
---|---|
出價 | |
瀑布 | |
格式 | |
橫幅廣告 | |
插頁式 | |
已獲得獎勵 | |
原生 |
需求條件
- Android API 級別 19 以上
- maio SDK 1.0.7 以上版本
最新版 Google Mobile Ads SDK
完成中介服務 入門指南
步驟 1:在 maio UI 中進行設定
首先,註冊或登入您的 Maio 帳戶。按一下左側欄中的「應用程式管理」按鈕,然後點選「新增應用程式」。
選取與偏好的廣告類型對應的分頁。
插頁式
輸入應用程式的「Name」(名稱),接著選取平台,並提供您的應用程式網址 (App URL)。選取「影片插頁式廣告」做為廣告類型,然後按一下「更新」。
已獲得獎勵
輸入應用程式的「Name」(名稱),接著選取平台,並提供您的應用程式網址 (App URL)。選取「影片獎勵」做為廣告類型,然後按一下「更新」。
在「Application Management」頁面中,記下「媒體 ID」。您需要在下一節設定 Ad Manager 廣告單元。
在「Zone Management」(可用區管理) 頁面中,記下「Zone ID」(區域 ID)。此外,您還需要在下一節設定 Ad Manager 廣告單元。
步驟 2:在使用者介面中設定 Ad Manager maio 需求
調整廣告單元中介服務設定
登入 Ad Manager 帳戶。
依序前往「廣告放送」>「收益群組」,然後按一下「新增收益群組」按鈕。
輸入收益群組的專屬「名稱」、將「狀態」設為「有效」、選取「廣告格式」,然後將「廣告空間類型」設為「行動應用程式」。接著在「指定目標」>「廣告空間」部分下,在「廣告空間」和「行動應用程式」下方,選取要新增中介服務的廣告單元。
接著,按一下「新增收益夥伴」按鈕。
如果您已經有maio的收益夥伴,則可以選取。否則,請選取「建立新的收益夥伴」。
選取「maio」做為「廣告聯播網」,然後輸入不重複的名稱並啟用「中介服務」。
開啟「自動資料收集」,然後輸入上一節中取得的API ID and API KEY 。
選取 [收益夥伴] 後,請選擇「Mobile SDK 中介服務」做為整合類型,選擇 Android 做為平台,狀態則選為「Active」。輸入上一節中取得的Media ID and Zone ID 。然後輸入「預設千次曝光出價」的值。
完成後,按一下頁面下方的「儲存」。
步驟 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.0.0")
implementation("com.google.ads.mediation:maio:1.1.16.2")
}
手動整合
- 下載最新版的 maio Android SDK,並將其加進專案。
- 前往 Google Maven 存放區中的 maio 轉接程式構件。選取最新版本,下載 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」例項。 |
0-10 | maio 傳回 SDK 相關錯誤。詳情請參閱 Maio 的程式碼。 |
101 | Maio 還沒有廣告。 |
102 | 伺服器參數無效 (例如缺少刊登位置 ID)。 |
103 | Maio 轉接程式不支援要求的廣告格式。 |
104 | 已載入這項聯播網設定的廣告。 |
maio Android 中介服務轉接程式變更記錄
下一個版本
- 將 Google Mobile Ads SDK 最低需求更新為 22.4.0 版。
版本 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 版
- 修正廣告載入失敗時,可能會導致出現 NullPointerException 的問題。
1.0.7.0 版
- 新增測試裝置 ID 至
AdRequest
來啟用測試模式的功能。 - 已驗證與 Maio SDK 1.0.7 版本的相容性。
1.0.6.0 版
- 首次發布!
- 新增對插頁式廣告和獎勵影片廣告的支援。