本頁面由 Cloud Translation API 翻譯而成。

整合 Mintegral 與出價 (Beta 版)

本指南將說明如何使用 Google Mobile Ads SDK 載入使用中介服務涵蓋刊登序列和出價整合。涵蓋如何將 Mintegral 加入廣告單元的中介服務設定，以及如何將 Mintegral SDK 和轉接程式整合至 Android 應用程式。

支援的整合項目和廣告格式

Mintegral 的中介服務轉接程式具有下列功能：

整合
出價		¹
瀑布		²
格式
開啟應用程式	¹ ²
橫幅廣告
插頁式
已獲得獎勵
插頁式獎勵廣告
原生	¹ ³

¹ 出價整合功能已關閉 Beta 版。

² 刊登序列整合功能已開啟封閉測試版

需求條件

Android API 級別 21 以上

最新版 Google Mobile Ads SDK
完成中介服務入門指南

步驟 1：在 Mintegral UI 中設定設定

註冊或登入您的 Mintegral 帳戶。

尋找應用程式金鑰

前往「APP 設定」分頁，並記下「應用程式金鑰」。

新增應用程式

在「應用程式設定」分頁中，按一下「新增應用程式」按鈕。

選取「Platform」，然後填寫表單的其他部分。然後按一下「儲存」。

記下應用程式的 APP ID。

建立廣告刊登位置

建立應用程式後，前往「刊登位置和單元」分頁，然後按一下「新增刊登位置」按鈕 (如下所示)，建立廣告刊登位置。

輸入「刊登位置名稱」和「廣告格式」。

選取「標頭出價」做為「出價類型」。填寫表單的其他部分，然後按一下「Save」。

建立廣告刊登位置後，請記下刊登位置 ID。

按一下「1 個廣告單元」下拉式選單，並記下「廣告單元 ID」。

找出 Mintegral Reporting API 金鑰

出價

整合出價時不需要執行這個步驟。

瀑布

您需要提供 Mintegral Reporting API 金鑰，才能設定Ad Manager 廣告單元 ID。依序前往「Account」(帳戶) >「API Tools」(API 工具)。記下您的 Skey 和 Secret。

步驟 2：在使用者介面中設定 Mintegral 需求 Ad Manager

登入 Ad Manager 帳戶。

將 Mintegral 新增至公司

出價

整合出價時不需要執行這個步驟。

瀑布

依序前往「Admin」 >「Companies」，然後按一下「All Company」分頁中的「新增公司」按鈕。選取「廣告聯播網」。

選取「Mintegral」做為「廣告聯播網」，然後輸入不重複的名稱並啟用「中介服務」。

您不必輸入使用者名稱或密碼。完成後，按一下「Save」(儲存)。

啟用安全信號共用

出價

依序前往「管理」 >「通用設定」。前往「Ad Exchange 帳戶設定」分頁，然後開啟「安全信號共用」。按一下「儲存」。

瀑布

刊登序列整合不需要這個步驟。

設定 Mintegral 出價

出價

依序前往「廣告放送」 >「出價方」，然後按一下「SDK 出價」分頁下方的「新增出價方」。

選取「Mintegral」做為出價方。

開啟「將這個出價方的信號程式庫新增至允許的信號清單」，以及「允許與這個出價方共用信號」。然後按一下「Continue」。

點按「繼續」。

按一下「完成」。

瀑布

刊登序列整合不需要這個步驟。

設定廣告單元對應

出價

依序前往「廣告放送」 >「出價方」，然後在「SDK 出價」分頁下方，選取Mintegral 的公司。

前往「廣告單元對應」分頁，然後按一下「新增廣告單元對應」。

選擇「特定廣告單元」。選取廣告單元和格式、「行動應用程式」做為「廣告空間類型」，以及您的行動應用程式。接著，輸入上一節中取得的App Key, App ID, Placement ID, and Ad Unit ID 。最後按一下「儲存」。

瀑布

依序前往「廣告放送」 >「收益群組」，然後按一下「新增收益群組」按鈕。選取您的行動應用程式。

向下捲動，然後按一下「新增收益夥伴」。

在上一節選取您為 Mintegral建立的公司。選擇「Mobile SDK 中介服務」做為「整合類型」，「平台」選擇「Android」，「平台」則選擇「有效」。

輸入上一節取得的 App Key, App ID, Placement ID, and Ad Unit ID，以及預設千次曝光出價值。按一下「Save」(儲存)。

新增 Mintegral 至 GDPR 和美國州級法規廣告合作夥伴名單

請按照 GDPR 設定和美國州級法規設定，在 Ad Manager UI 和美國州級法規廣告合作夥伴清單中新增 Mintegral。

步驟 3：匯入 Mintegral SDK 和轉接程式

整合 Android Studio (建議做法)

在專案層級的 settings.gradle.kts 檔案中新增以下內容存放區：

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://dl-maven-android.mintegral.com/repository/mbridge_android_sdk_oversea")
    }
  }
}

接著，在應用程式層級的 build.gradle.kts 檔案中新增以下內容實作依附元件和設定使用最新版本的 Mintegral SDK 和轉接程式：

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.2.0")
    implementation("com.google.ads.mediation:mintegral:16.7.91.0")
}

手動整合

如要加入 Mintegral SDK，請前往 Android 適用的 Mintegral SDK。
前往 Mintegral 轉接器構件複製到 Google 的 Maven 存放區選取最新版本，下載 Mintegral 轉接程式的 .aar 檔案，並將其新增至專案中。

步驟 4：在 Mintegral SDK 中實作隱私權設定

歐盟地區使用者同意授權和 GDPR

根據 Google 歐盟地區使用者同意聲明 Google 政策，您必須確保使用者有揭露特定揭露事項。只有當歐洲經濟區 (EEA) 使用者提供同意聲明，以及如何使用裝置 ID 和個人資料這項政策反映了歐盟電子通訊隱私指令和一般資料保護規定法規 (GDPR)。徵求同意時，您必須指明每個廣告聯播網中介服務鏈中可能收集、接收或使用個人資料提供各個網路用量的相關資訊。Google 目前無法將使用者的同意聲明選項自動傳送到這類聯播網。

Mintegral SDK 包含用來傳送同意聲明的 setConsentStatus 方法將資訊傳送給 Mintegral SDK

下列程式碼範例說明如何將同意聲明資訊傳送至 Mintegral 將機器學習工作流程自動化你必須在初始化 Google Mobile Ads SDK ，確保這些素材資源正確轉送到 Mintegral SDK。

Java

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

MBridgeSDK sdk = MBridgeSDKFactory.getMBridgeSDK();
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON);

Kotlin

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

var sdk = MBridgeSDKFactory.getMBridgeSDK()
sdk.setConsentStatus(context, MBridgeConstans.IS_SWITCH_ON)

請參閱 Mintegral 的隱私權說明文件。瞭解詳情

美國州級隱私權法律

美國州級隱私權法律規定使用者必須提供即可選擇停用「銷售」功能代表「個人資訊」(如同法律定義該條款中，透過顯眼的「請勿銷售我的個人」資訊」請點選「銷售」裝置上的「銷售」連結以及派對首頁美國州級隱私權法規遵循指南可讓您受限的資料處理此設定不適用於每則廣告，但 Google 無法將這項設定套用至每則廣告中介服務鏈中的聯播網因此，你必須找出每個廣告聯播網。可參與個人銷售的並遵循各自的指南確保符合法規。

Mintegral SDK 包含用來傳送同意聲明的 setDoNotTrackStatus 方法將資訊傳送給 Mintegral SDK

下列程式碼範例說明如何將同意聲明資訊傳送至 Mintegral 將機器學習工作流程自動化如果您需要呼叫此方法，請將其呼叫晚於初始化 Google Mobile Ads SDK 但在透過 Google Mobile Ads SDK 請求廣告之前。

Java

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

MBridgeSDK mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK();
mBridgeSDK.setDoNotTrackStatus(false);

Kotlin

import com.mbridge.msdk.out.MBridgeSDKFactory
// ...

var mBridgeSDK = MBridgeSDKFactory.getMBridgeSDK()
mBridgeSDK.setDoNotTrackStatus(false)

請參閱 Mintegral 的隱私權說明文件。瞭解詳情

步驟 5：新增必要的程式碼

使用 Mintegral 整合時不需要額外程式碼。

步驟 6：測試實作成果

啟用測試廣告

請務必為 Ad Manager。

如要取得適用於橫幅廣告、插頁式廣告、獎勵和原生廣告格式的 Mintegral 測試廣告，Mintegral 建議使用 Mintegral Test ID 頁面中提供的應用程式金鑰、應用程式 ID、刊登位置 ID 和廣告單元 ID。

驗證測試廣告

如要確認您正在接收來自Mintegral的測試廣告，請使用 Mintegral (Bidding) and Mintegral (Waterfall) 廣告來源在廣告檢查器中啟用單一廣告來源測試。

選擇性步驟

將 Mintegral 新增至 CCPA 廣告合作夥伴名單

請按照《加州消費者隱私法》設定將 Mintegral 加入 Ad Manager UI。

原生廣告

廣告顯示

Mintegral 轉接程式會將原生廣告傳回 NativeAd 如需儲存大量結構化物件建議使用 Cloud Bigtable會填入以下項目欄位的 NativeAd。

欄位	Mintegral 轉接器一律包含素材資源
廣告標題
圖片	1
內文
圖示
行動號召
星級評等
商店
價格
廣告主

¹ Mintegral 轉接器不支援可讓使用者直接存取原生廣告的主要圖片素材資源。相反地轉接程式會填入 MediaView 包含影片或圖片

錯誤代碼

如果轉接程式無法接收來自 Mintegral 的廣告，您可以查看判斷錯誤的原因 ResponseInfo.getAdapterResponses() 加入以下類別：

com.mbridge.msdk
com.google.ads.mediation.mintegral.MintegralMediationAdapter

以下是 Mintegral 轉接器擲回的代碼和相關訊息廣告無法載入時：

錯誤代碼	網域	原因
101	com.google.ads.mediation.mintegral	伺服器參數無效 (例如缺少應用程式 ID 或刊登位置 ID)。
102	com.google.ads.mediation.mintegral	要求的廣告大小不符合 Mintegral 支援的橫幅廣告大小。
103	com.google.ads.mediation.mintegral	出價回應遺失或無效。
104	com.google.ads.mediation.mintegral	Mintegral SDK 傳回未供應廣告的錯誤。
101	com.google.mediation.mintegral	伺服器參數無效 (例如缺少應用程式 ID 或刊登位置 ID)。
102	com.google.mediation.mintegral	Mintegral SDK 傳回未供應廣告的錯誤。
103	com.google.mediation.mintegral	Mintegral SDK 無法顯示廣告。
104	com.google.mediation.mintegral	要求的廣告大小不符合 Mintegral 支援的橫幅廣告大小。

Mintegral Android 中介服務轉接程式變更記錄

16.7.91.0 版

已驗證與 Mintegral SDK 16.7.91 的相容性。

建構及測試工具：

Google Mobile Ads SDK 23.2.0 版。
Mintegral SDK 16.7.91 版。

16.7.81.0 版

已驗證與 Mintegral SDK 16.7.81 的相容性。

建構及測試工具：

Google Mobile Ads SDK 23.2.0 版。
Mintegral SDK 16.7.81 版。

版本 16.7.71.0

已驗證與 Mintegral SDK 16.7.71 的相容性。

建構及測試工具：

Google Mobile Ads SDK 23.1.0 版。
Mintegral SDK 16.7.71 版。

16.7.61.0 版

已驗證與 Mintegral SDK 16.7.61 的相容性。

建構及測試工具：

Google Mobile Ads SDK 23.1.0 版。
Mintegral SDK 16.7.61 版。

16.7.51.0 版

已驗證與 Mintegral SDK 16.7.51 的相容性。

建構及測試工具：

Google Mobile Ads SDK 23.1.0 版。
Mintegral SDK 16.7.51 版。

16.7.41.0 版

已驗證與 Mintegral SDK 16.7.41 的相容性。

建構及測試工具：

Google Mobile Ads SDK 23.1.0 版。
Mintegral SDK 16.7.41 版。

16.7.31.0 版

已驗證與 Mintegral SDK 16.7.31 的相容性。

建構及測試工具：

Google Mobile Ads SDK 23.1.0 版。
Mintegral SDK 16.7.31 版。

16.7.21.0 版

已驗證與 Mintegral SDK 16.7.21 的相容性。

建構及測試工具：

Google Mobile Ads SDK 23.0.0 版。
Mintegral SDK 16.7.21 版。

16.7.11.0 版

已驗證與 Mintegral SDK 16.7.11 的相容性。

建構及測試工具：

Google Mobile Ads SDK 23.0.0 版。
Mintegral SDK 16.7.11 版。

版本 16.6.71.0

已驗證與 Mintegral SDK 16.6.71 的相容性。

建構及測試工具：

Google Mobile Ads SDK 23.0.0 版。
Mintegral SDK 16.6.71 版。

16.6.61.0 版

將 Google Mobile Ads SDK 最低要求版本更新為 23.0.0。
已驗證與 Mintegral SDK 16.6.61 的相容性。

建構及測試工具：

Google Mobile Ads SDK 23.0.0 版。
Mintegral SDK 16.6.61 版。

16.6.51.0 版

已驗證與 Mintegral SDK 16.6.51 的相容性。

建構及測試工具：

Google Mobile Ads SDK 22.6.0 版。
Mintegral SDK 16.6.51 版。

16.6.41.0 版

已驗證與 Mintegral SDK 16.6.41 的相容性。

建構及測試工具：

Google Mobile Ads SDK 22.6.0 版。
Mintegral SDK 16.6.41 版。

16.6.34.0 版

已驗證與 Mintegral SDK 16.6.34 的相容性。

建構及測試工具：

Google Mobile Ads SDK 22.6.0 版。
Mintegral SDK 16.6.34 版。

16.6.21.0 版

已驗證與 Mintegral SDK 16.6.21 的相容性。

建構及測試工具：

Google Mobile Ads SDK 22.6.0 版。
Mintegral SDK 16.6.21 版。

16.5.91.1 版

新增應用程式開啟頁面廣告格式的出價支援。

建構及測試工具：

Google Mobile Ads SDK 22.6.0 版。
Mintegral SDK 16.5.91 版。

16.5.91.0 版

已驗證與 Mintegral SDK 16.5.91 的相容性。
將 Google Mobile Ads SDK 最低需求更新至 22.6.0 版。

建構及測試工具：

Google Mobile Ads SDK 22.6.0 版。
Mintegral SDK 16.5.91 版。

16.5.51.0 版

已驗證與 Mintegral SDK 16.5.51 的相容性。

建構及測試工具：

Google Mobile Ads SDK 22.3.0 版。
Mintegral SDK 16.5.51 版。

16.5.41.0 版

已驗證與 Mintegral SDK 16.5.41 的相容性。

建構及測試工具：

Google Mobile Ads SDK 22.3.0 版。
Mintegral SDK 16.5.41 版。

16.5.31.0 版

已驗證與 Mintegral SDK 16.5.31 的相容性。
將轉接器還原為依附於 Google Mobile Ads SDK 22.3.0 版。
新增應用程式開啟頁面廣告格式的刊登序列支援功能。

建構及測試工具：

Google Mobile Ads SDK 22.3.0 版。
Mintegral SDK 16.5.31 版。

16.5.21.0 版

已驗證與 Mintegral SDK 16.5.21 的相容性。
將 Google Mobile Ads SDK 最低需求更新至 22.4.0 版。

建構及測試工具：

Google Mobile Ads SDK 22.4.0 版。
Mintegral SDK 16.5.21 版。

16.5.11.0 版

為出價廣告新增浮水印支援功能。
已驗證與 Mintegral SDK 16.5.11 的相容性。

建構及測試工具：

Google Mobile Ads SDK 22.2.0 版。
Mintegral SDK 16.5.11 版。

16.4.91.0 版

已驗證與 Mintegral SDK 16.4.91 的相容性。

建構及測試工具：

Google Mobile Ads SDK 22.2.0 版。
Mintegral SDK 16.4.91 版。

16.4.81.0 版

已驗證與 Mintegral SDK 16.4.81 的相容性。

建構及測試工具：

Google Mobile Ads SDK 22.2.0 版。
Mintegral SDK 16.4.81 版。

版本 16.4.71.0

已驗證與 Mintegral SDK 16.4.71 的相容性。

建構及測試工具：

Google Mobile Ads SDK 22.2.0 版。
Mintegral SDK 16.4.71 版。

16.4.61.0 版

已驗證與 Mintegral SDK 16.4.61 的相容性。

建構及測試工具：

Google Mobile Ads SDK 22.1.0 版。
Mintegral SDK 16.4.61 版。

16.4.51.0 版

已驗證與 Mintegral SDK 16.4.51 的相容性。

建構及測試工具：

Google Mobile Ads SDK 22.1.0 版。
Mintegral SDK 16.4.51 版。

16.4.41.0 版

修正橫幅廣告顯示大小不正確的問題。
已驗證與 Mintegral SDK 16.4.41 的相容性。

建構及測試工具：

Google Mobile Ads SDK 22.0.0 版。
Mintegral SDK 16.4.41 版。

16.4.31.0 版

已驗證與 Mintegral SDK 16.4.31 的相容性。

建構及測試工具：

Google Mobile Ads SDK 22.0.0 版。
Mintegral SDK 16.4.31 版。

16.4.21.0 版

已更新轉接程式，以便使用新的 VersionInfo 類別。
將 Google Mobile Ads SDK 最低需求更新至 22.0.0 版。
已驗證與 Mintegral SDK 16.4.21 的相容性。

建構及測試工具：

Google Mobile Ads SDK 22.0.0 版。
Mintegral SDK 16.4.21 版。

16.3.91.0 版

已驗證與 Mintegral SDK 16.3.91 的相容性。

建構及測試工具：

Google Mobile Ads SDK 21.5.0 版。
Mintegral SDK 16.3.91 版。

16.3.81.0 版

已驗證與 Mintegral SDK 16.3.81 的相容性。

建構及測試工具：

Google Mobile Ads SDK 21.5.0 版。
Mintegral SDK 16.3.81 版。

16.3.71.0 版

已驗證與 Mintegral SDK 16.3.71 的相容性。

建構及測試工具：

Google Mobile Ads SDK 21.5.0 版。
Mintegral SDK 16.3.71 版。

16.3.61.0 版

已驗證與 Mintegral SDK 16.3.61 的相容性。

建構及測試工具：

Google Mobile Ads SDK 21.5.0 版。
Mintegral SDK 16.3.61 版。

16.3.51.1 版

新增橫幅廣告 (包括 MREC)、插頁式廣告、獎勵廣告和原生廣告格式的刊登序列支援。
將 Google Mobile Ads SDK 最低要求版本更新為 21.5.0。

建構及測試工具：

Google Mobile Ads SDK 21.5.0 版。
Mintegral SDK 16.3.51 版。

16.3.51.0 版

已驗證與 Mintegral SDK 16.3.51 的相容性。

建構及測試工具：

Google Mobile Ads SDK 21.4.0 版。
Mintegral SDK 16.3.51 版。

16.3.41.0 版

已驗證與 Mintegral SDK 16.3.41 的相容性。
將 Google Mobile Ads SDK 最低需求版本更新為 21.4.0。

建構及測試工具：

Google Mobile Ads SDK 21.4.0 版。
Mintegral SDK 16.3.41 版。

16.3.11.0 版

已驗證與 Mintegral SDK 16.3.11 的相容性。
將轉接程式更新為顯示獎勵廣告時，將轉接器在 onAdClosed() 前快轉 onUserEarnedReward()。

建構及測試工具：

Google Mobile Ads SDK 21.3.0 版。
Mintegral SDK 16.3.11 版。

16.2.61.0 版

初始版本！
新增橫幅廣告 (包括 MREC)、插頁式廣告、獎勵和原生廣告格式的出價支援功能。

建構及測試工具：

Google Mobile Ads SDK 21.3.0 版。
Mintegral SDK 16.2.61 版。