將 Maio 與中介服務整合

本指南將說明如何使用 Google Mobile Ads SDK,使用 AdMob 中介服務、 涵蓋刊登序列整合的方式,從 maio 載入及顯示廣告。這篇文章將說明如何將 maio 新增至廣告單元的中介服務設定,以及如何將 maio SDK 和轉接程式整合至Android 應用程式。

maio 的資訊主頁介面會使用日文文字做為標籤、按鈕和說明,本指南的螢幕截圖尚未翻譯。不過,在本指南的說明和操作說明中,標籤和按鈕皆參照對應的英文語言。例如「URL ストー SAML」 例如「URL Scheme」。

支援的整合和廣告格式

maio 的中介服務轉接程式具有下列功能:

整合
出價
瀑布
格式
橫幅廣告
插頁式
已獲得獎勵
原生

需求條件

  • Android API 級別 21 以上
  • maio SDK 1.0.7 以上版本
  • 最新版 Google Mobile Ads SDK

  • 完成中介服務入門指南

步驟 1:在 maio UI 中設定設定

首先,註冊登入您的 maio 帳戶。按一下左側欄中的 [應用程式管理] 按鈕,然後按一下 [新增應用程式]

選取對應於所需「廣告類型」的標籤。

插頁式

輸入應用程式的「Name」(名稱),選取平台並提供您的應用程式網址。選取「插頁式影片」做為「廣告類型」,然後按一下「更新」

已獲得獎勵

輸入應用程式的名稱、選取平台,然後提供應用程式網址。選取「影片獎勵」做為「廣告類型」,然後按一下「更新」

在「Application Management」頁面中,記下「Media ID」。您必須在下一個部分設定 AdMob 廣告單元。

在「Zone Management」(可用區管理) 頁面中,記下「Zone ID」(可用區 ID)。您也需要在下一個部分設定 AdMob 廣告單元。

除了 Media IDZone ID 之外,您還需要 API IDAPI 金鑰,才能設定廣告單元 ID 進行中介服務。在「Reporting API」頁面中,請記下「API ID」和「API 金鑰」

步驟 2:在使用者介面中設定 maio 需求 AdMob

調整廣告單元中介服務設定

您需要將 maio 新增至廣告單元的中介服務設定。

首先,請登入 AdMob 帳戶。接著,前往「中介服務」分頁。如果您想修改現有的中介服務群組,請按一下中介服務群組的名稱加以編輯,然後跳到「新增為廣告來源」一節。 maio

如要建立新的中介服務群組,請選取「建立中介服務群組」

輸入廣告格式和平台,然後按一下「繼續」

為中介服務群組命名,然後選取要指定的地區。接著,將中介服務群組狀態設為「已啟用」,然後按一下「新增廣告單元」

將這個中介服務群組與一或多個現有AdMob 廣告單元建立關聯。接著點選「完成」

您現在應該會看到已填入所選廣告單元的廣告單元資訊卡:

新增 maio 做為廣告來源

在「Ad Source」部分的「Waterfall」資訊卡下方,選取「Add Ad Source」。然後選取 maio

選取「maio」並啟用「最佳化工具」切換鈕。輸入上一節取得的 API ID and API KEY,即可設定maio的廣告來源最佳化功能。 接著為maio 輸入有效千次曝光出價值,然後按一下「繼續」

如果 maio已有對應關係,可以選取該對應關係。否則請按一下「新增對應」

接著,輸入上一節取得的 Media ID and Zone ID。接著點選「完成」

步驟 3:匯入 maio SDK 和轉接程式

在專案層級的 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.5.0")
    implementation("com.google.ads.mediation:maio:1.1.16.3")
}

手動整合

  • 下載最新版的 maio Android SDK,並將其新增至專案。
  • 前往 Google 的 Maven 存放區,找到 maio 轉接程式構件。選取最新版本,下載 Maio 轉接器的 `.aar' 檔案,然後加入專案。

步驟 4:新增必要的程式碼

整合 Maio Android 時,不需要額外程式碼。

步驟 5:測試實作成果

啟用測試廣告

請務必為 AdMob。

如果發布商使用 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 版

  • compileSdkVersiontargetSdkVersion 更新至 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 版

  • 第一版!
  • 新增插頁式廣告和獎勵影片廣告支援功能。