本指南說明如何使用 Google Mobile Ads SDK 透過中介服務載入及顯示來自 maio 的廣告,並涵蓋瀑布流程整合。這篇文章將說明如何將 maio 新增至廣告單元的中介設定,以及如何將 maio SDK 和轉接程式整合至 Android 應用程式。
maio 的資訊主頁介面會使用日文文字做為標籤、按鈕和說明,本指南的螢幕截圖尚未翻譯。不過,本指南的說明和操作說明中,標籤和按鈕的參照項目為英文。例如,「URL スキーム」就是「URL Scheme」。
支援的整合和廣告格式
maio 的仲介適配器具備下列功能:
整合 | |
---|---|
出價 | |
瀑布 | |
格式 | |
橫幅廣告 | |
插頁式 | |
已獲得獎勵 | |
原生 |
需求條件
- Android API 級別 21 以上
- maio SDK 1.0.7 以上版本
最新版 Google Mobile Ads SDK
完成中介服務入門指南
步驟 1:在 maio UI 中設定設定
首先,請註冊或登入 Maio 帳戶。按一下左側欄中的「應用程式管理」按鈕,然後點選「新增應用程式」。
選取所需的「廣告類型」對應的分頁標籤。
插頁式
輸入應用程式的名稱、選取平台,然後提供應用程式網址。選取「插頁式影片」做為「廣告類型」,然後按一下「更新」。
已獲得獎勵
輸入應用程式的名稱、選取平台,然後提供應用程式網址。選取「影片獎勵」做為「廣告類型」,然後按一下「更新」。
在「Application Management」頁面中,記下「Media ID」。您必須在下一個部分設定 Ad Manager 廣告單元。
在「Zone Management」(可用區管理) 頁面中,記下「Zone ID」(可用區 ID)。您也需要在下一個部分設定 Ad Manager 廣告單元。
除了 Media ID 和 Zone ID 之外,您還需要 API ID 和 API 金鑰,才能設定廣告單元 ID 進行中介服務。在「Reporting API」頁面中,請記下「API ID」和「API 金鑰」。步驟 2:在 Ad Manager UI 中設定 Maio 需求
設定廣告單元的中介服務設定
登入 Ad Manager 帳戶。
前往「廣告放送」>「收益群組」,然後按一下「新增收益群組」按鈕。
為收益群組輸入專屬的名稱,將狀態設為有效,選取廣告格式,然後將廣告空間類型設為行動應用程式。在「指定目標」>「廣告空間」部分下方,選取要加入中介服務的「廣告空間」和「行動應用程式」下方的廣告單元。
接著,按一下「新增收益夥伴」按鈕。
如果您已為 maio 建立收益合作夥伴,請選取該合作夥伴。否則,請選取「建立新的收益夥伴」。
選取「maio」做為「廣告聯播網」,輸入不重複的「名稱」,並啟用「中介服務」。
開啟「自動資料收集」,然後輸入上一節取得的 API ID 和 API 金鑰。
選取「收益夥伴」後,請選擇「Mobile SDK 中介服務」做為「整合類型」、「Android」做為「平台」,以及「有效」做為「狀態」。輸入先前取得的 Media ID 和 Zone ID。接著輸入「Default CPM」值。
完成後,按一下頁面底部的「儲存」。
步驟 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.6.0")
implementation("com.google.ads.mediation:maio:1.1.16.3")
}
手動整合
- 下載最新版的 maio Android SDK,並將其新增至專案。
- 前往 Google 的 Maven 存放區,找到 maio 轉接程式構件。選取最新版本,下載 Maio 轉接器的 `.aar` 檔案,然後將其新增至專案。
步驟 4:新增必要程式碼
您不需要額外程式碼即可整合 maio Android。
步驟 5:測試導入作業
啟用測試廣告
請務必為 Ad Manager 註冊測試裝置。
如果發布商使用 Google Mobile Ads SDK 11.6.0 以上版本,在發出請求時,手機和平板電腦會自動從 maio 收到測試廣告,並註冊為測試裝置。
驗證測試廣告
如要確認您收到來自 maio 的測試廣告,請使用 maio (刊登序列) 廣告來源,在廣告檢查器中啟用單一廣告來源測試。
錯誤代碼
如果轉接器無法從 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 | Maio 沒有可用的廣告。 |
102 | 無效的伺服器參數 (例如缺少刊登位置 ID)。 |
103 | 用於載入廣告的內容並非「Activity」例項。 |
maio Android Mediation Adapter 變更記錄
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 版
- 更新轉接器,支援新的 Rewarded 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 版
- 第一版!
- 新增插頁式廣告和獎勵影片廣告支援功能。