整合 Liftoff Monetize 與中介服務

本指南說明如何使用 Google Mobile Ads SDK，透過 AdMob Mediation 載入及顯示 Liftoff Monetize 廣告，涵蓋出價和瀑布流整合。本主題將說明如何將 Liftoff Monetize 新增至廣告單元的中介服務設定，以及如何將 Vungle SDK 和轉接程式整合至 Android 應用程式。

支援的整合和廣告格式

Liftoff Monetize 的中介服務適配器具備下列功能：

¹ 這個格式的出價整合功能目前為公開 Beta 版。

² 這類格式的階梯式廣告整合功能目前處於公開 Beta 版階段。

需求條件

• Android API 級別 21 以上

• [針對出價]：如要在出價中整合所有支援的廣告格式，請使用 Liftoff Monetize 轉接程式 7.3.0.0 以上版本 (建議使用最新版本)

• 最新版 Google Mobile Ads SDK

• 完成中介服務入門指南

步驟 1：在 Liftoff Monetize 使用者介面中設定相關設定

註冊或登入 Liftoff Monetize 帳戶。

按一下「Add Application」按鈕，將應用程式新增至 Liftoff Monetize 資訊主頁。

填寫表單，輸入所有必要詳細資料。

建立應用程式後，請從 Liftoff Monetize 應用程式資訊主頁選取應用程式。

記下應用程式 ID。

新增刊登位置

如要建立用於 AdMob 中介服務的新刊登位置，請前往 Liftoff 營利刊登位置資訊主頁，按一下「新增刊登位置」按鈕，然後從下拉式清單中選取應用程式。

新增刊登位置的詳細資訊如下：

記下「Reference ID」，然後按一下「Sounds Good」。

找出 Reporting API 金鑰

開啟測試模式

如要啟用測試廣告，請前往 Liftoff Monetize 資訊主頁，然後前往「應用程式」。

在應用程式的「刊登位置參考 ID」部分下方，選取要啟用測試廣告的應用程式。如要啟用測試廣告，請在「狀態」部分下方，將「測試模式」選項切換為「只顯示測試廣告」。

步驟 2：在 AdMob UI 中設定 Liftoff Monetize 需求

設定廣告單元的中介服務設定

您必須在廣告單元的中介服務設定中加入 Liftoff Monetize。

首先，請登入 AdMob 帳戶。接著，前往「Mediation」分頁。如果您有要修改的現有中介服務群組，請按一下該中介服務群組名稱進行編輯，然後跳到「將 Liftoff Monetize 新增為廣告來源」一節。

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

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

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

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

您現在應該會看到廣告單元資訊卡，其中顯示您選取的廣告單元：

新增 Liftoff Monetize 做為廣告來源

出價

在「廣告來源」部分的「出價」資訊卡下方，選取「新增廣告來源」。然後選取「Liftoff Monetize」。
按一下「如何簽署合作夥伴協議」，然後與 Liftoff Monetize 建立出價合作夥伴關係。
按一下「已瞭解並同意」，然後點選「繼續」。
如果您已對應 Liftoff Monetize，可以選取該對應項目。否則請按一下「新增對應」。
接下來，請輸入先前取得的應用程式 ID 和刊登位置參照 ID。然後按一下「完成」。

瀑布

在「廣告來源」部分的「刊登序列」資訊卡下方，選取「新增廣告來源」。然後選取「Liftoff Monetize」。

選取「Liftoff Monetize」，然後啟用「Optimize」切換鈕。輸入先前取得的 Reporting API Key，為 Liftoff Monetize 設定廣告來源最佳化。接著輸入 Liftoff Monetize 的有效千次曝光出價，然後按一下「繼續」。



如果您已為 Liftoff Monetize 建立對應項目，請選取該項目。否則請按一下「新增對應」。

接著，請輸入上一節中取得的應用程式 ID 和刊登位置參照 ID。然後按一下「完成」。

將 Liftoff 新增至 GDPR 和美國州級法規廣告合作夥伴清單

請按照GDPR 設定和美國州級法規設定中的步驟，將 Liftoff 新增至 AdMob 使用者介面中的 GDPR 和美國州級法規廣告合作夥伴名單。

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

Android Studio 整合 (建議)

在應用程式層級的 build.gradle.kts 檔案中，新增下列實作依附元件和設定。使用最新版的 Vungle SDK 和轉接程式：

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.6.0")
    implementation("com.google.ads.mediation:vungle:7.4.2.0")
}

手動整合

• 下載最新的 Vungle Android SDK，然後在 libs 資料夾下解壓縮 .jar 檔案，並將檔案新增至專案。

• 前往 Google 的 Maven 存放區，找到 Liftoff Monetize 轉接器構件。選取最新版本，下載 Vungle 轉接器的 .aar 檔案，然後將其新增至專案。

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

歐盟同意聲明和 GDPR

根據 Google 的《歐盟地區使用者同意授權政策》，您必須確保向歐洲經濟區 (EEA) 境內使用者揭露特定資訊，並徵得使用者同意聲明，才能使用裝置 ID 和個人資料。本政策是配合《歐盟電子通訊隱私指令》和《一般資料保護規則》(GDPR) 的法規而制定。在徵求同意聲明時，您必須指出中介服務鏈中可能會收集、接收或使用個人資料的每個廣告聯播網，並提供每個聯播網的使用方式相關資訊。Google 目前無法自動將使用者的同意聲明選項傳送至這類網路。

Liftoff Monetize 包含 API，可讓您將同意聲明傳遞給 Vungle SDK。以下程式碼範例說明如何將此同意聲明資訊傳遞至 Vungle SDK。如果您選擇呼叫這個方法，建議您在透過 Google Mobile Ads SDK 要求廣告之前先呼叫這個方法。

import com.vungle.ads.VunglePrivacySettings;
// ...

VunglePrivacySettings.setGDPRStatus(true, "v1.0.0");

import com.vungle.ads.VunglePrivacySettings
// ...

VunglePrivacySettings.setGDPRStatus(true, "v1.0.0")

如要進一步瞭解詳情和可在方法中提供的值，請參閱 GDPR 建議的實作操作說明。

美國州級隱私權法律

美國州級隱私權法律 規定使用者有權選擇拒絕「販售」自己的「個人資訊」(如該法案對「販售」一詞的定義)，且「賣方」必須在首頁上提供顯眼的「不要販售我的個人資訊」連結，供使用者選擇拒絕。美國州級隱私權法律遵循指南提供啟用 Google 廣告放送服務的受限資料處理功能，但 Google 無法將這項設定套用至中介鏈中的每個廣告聯播網。因此，您必須在中介服務鏈中找出可能參與個人資訊販售的廣告聯播網，並遵循各個廣告聯播網的指示，確保符合規定。

Liftoff Monetize 包含 API，可讓您將同意聲明傳遞給 Vungle SDK。以下程式碼範例說明如何將此同意聲明資訊傳遞至 Vungle SDK。如果您選擇呼叫這個方法，建議您在透過 Google Mobile Ads SDK 要求廣告之前先呼叫這個方法。

import com.vungle.ads.VunglePrivacySettings;
// ...

VunglePrivacySettings.setCCPAStatus(true);

import com.vungle.ads.VunglePrivacySettings
// ...

VunglePrivacySettings.setCCPAStatus(true)

如要進一步瞭解詳情和可在方法中提供的值，請參閱「CCPA 導入」。

步驟 5：新增必要程式碼

整合 Liftoff Monetize 時不需要額外程式碼。

步驟 6：測試導入作業

啟用測試廣告

請務必為 AdMob 註冊測試裝置，並在 Liftoff Monetize 使用者介面中啟用測試模式。

驗證測試廣告

如要確認您是否收到 Liftoff Monetize 的測試廣告，請使用 Liftoff Monetize (出價) 和 Liftoff Monetize (刊登序列) 廣告來源，在廣告檢查器中啟用單一廣告來源測試。

選擇性步驟

網路專屬參數

Liftoff Monetize 轉接器支援下列額外要求參數，可傳遞至轉接器：

userId

字串，代表 Liftoff Monetize 的激勵使用者 ID。

adOrientation

整數，指定全螢幕廣告的呈現方向。

以下程式碼範例說明如何建立設定這些參數的廣告要求：

Bundle extras = new Bundle();
extras.putString(VungleConstants.KEY_USER_ID, "myUserID");
extras.putInt(VungleConstants.KEY_ORIENTATION, 1);

AdRequest request = new AdRequest.Builder()
   .addNetworkExtrasBundle(VungleAdapter.class, extras) // Rewarded.
   .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
   .build();

val extras = Bundle()
extras.putString(VungleConstants.KEY_USER_ID, "myUserID")
extras.putInt(VungleConstants.KEY_ORIENTATION, 1)

val request = AdRequest.Builder()
   .addNetworkExtrasBundle(VungleAdapter::class, extras) // Rewarded.
   .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
   .build()

原生廣告轉譯

Liftoff Monetize 轉接程式會將原生廣告傳回為 NativeAd 物件。這會為 NativeAd 填入下列原生廣告欄位說明。

¹ Liftoff Monetize 轉接器不會提供原生廣告的主要圖片素材資源直接存取權。而是將影片或圖片填入 MediaView。

錯誤代碼

如果轉接器無法從 Liftoff Monetize 接收廣告，發布商可以使用 ResponseInfo.getAdapterResponses() 在下列類別下，檢查廣告回應的基礎錯誤：

以下是 Liftoff 營利適配器在廣告載入失敗時，所傳送的代碼和隨附訊息：

如要瞭解 Vungle SDK 的錯誤，請參閱「錯誤代碼：iOS 和 Android 適用的 Vungle SDK」。

Liftoff Monetize Android 中介服務適配器變更記錄

7.4.2.0 版

• 已驗證與 Vungle SDK 7.4.2 的相容性。

建構及測試時使用：

• Google Mobile Ads SDK 23.5.0 版。
• Vungle SDK 7.4.2 版。

7.4.1.0 版

• 已驗證與 Vungle SDK 7.4.1 的相容性。

建構及測試時使用：

• Google Mobile Ads SDK 23.3.0 版。
• Vungle SDK 7.4.1 版。

7.4.0.1 版

• 新增出價和刊登序列橫幅廣告的自訂廣告尺寸支援功能。

建構及測試時使用：

• Google Mobile Ads SDK 23.2.0 版。
• Vungle SDK 版本 7.4.0。

7.4.0.0 版

• 擴充 VungleInterstitialAdapter 類別，從 VungleMediationAdapter 新增 Google Ad Manager 應用程式開啟廣告格式的刊登序列支援。
• 已驗證與 Vungle SDK 7.4.0 的相容性。

建構及測試時使用：

• Google Mobile Ads SDK 23.2.0 版。
• Vungle SDK 版本 7.4.0。

7.3.2.0 版

• 已驗證與 Vungle SDK 7.3.2 的相容性。

建構及測試時使用：

• Google Mobile Ads SDK 23.0.0 以上版本。
• Vungle SDK 版本 7.3.2。

7.3.1.0 版

• 已驗證與 Vungle SDK 7.3.1 的相容性。

建構及測試時使用：

• Google Mobile Ads SDK 23.0.0 以上版本。
• Vungle SDK 版本 7.3.1。

7.3.0.0 版

• 將最低必要的 Google Mobile Ads SDK 版本更新至 23.0.0。
• 已驗證與 Vungle SDK 7.3.0 的相容性。
• 新增應用程式開啟廣告格式的刊登序列和出價支援功能。

建構及測試時使用：

• Google Mobile Ads SDK 23.0.0 以上版本。
• Vungle SDK 版本 7.3.0。

7.1.0.0 版

• 已驗證與 Vungle SDK 7.1.0 的相容性。

建構及測試時使用：

• Google Mobile Ads SDK 22.3.0 版。
• Vungle SDK 版本 7.1.0。

7.0.0.1 版

• 修正 Google Mobile Ads SDK 未記錄出價原生廣告的曝光次數的問題。
• 將轉接器改回依賴 Google Mobile Ads SDK 22.3.0 版本。

建構及測試時使用：

• Google Mobile Ads SDK 22.3.0 版。
• Vungle SDK 版本 7.0.0。

7.0.0.0 版

• 新增支援功能，可為所有瀑布流廣告格式載入具有相同刊登位置 ID 的多個廣告。
• 將轉換器名稱從 Vungle 改為 Liftoff Monetize。
• 已驗證與 Vungle SDK 7.0.0 的相容性。

建構及測試時使用：

• Google Mobile Ads SDK 22.4.0 版。
• Vungle SDK 版本 7.0.0。

版本 6.12.1.1

• 更新轉接器，以便使用新的 VersionInfo 類別。
• 將 Google Mobile Ads SDK 最低要求版本更新至 22.0.0。

建構及測試時使用：

• Google Mobile Ads SDK 22.0.0 版。
• Vungle SDK 6.12.1 版。

6.12.1.0 版

• 已驗證與 Vungle SDK 6.12.1 的相容性。

建構及測試時使用：

• Google Mobile Ads SDK 21.4.0 以上版本。
• Vungle SDK 6.12.1 版。

6.12.0.1 版

• 新增對橫幅廣告格式的出價支援。
• 已驗證與 Vungle SDK 6.12.0 的相容性。
• 將最低要求的 Google Mobile Ads SDK 版本更新至 21.4.0。

建構及測試時使用：

• Google Mobile Ads SDK 21.4.0 以上版本。
• Vungle SDK 版本 6.12.0。

6.12.0.0 版

• 新增插頁式獎勵廣告格式的刊登序列中介服務和出價支援功能。
• 新增原生廣告格式的出價支援功能。

建構及測試時使用：

• Google Mobile Ads SDK 21.1.0 版。
• Vungle SDK 版本 6.12.0。

6.11.0.3 版

• 新增原生廣告格式的刊登序列中介服務支援功能。
• 將最低要求的 Google Mobile Ads SDK 版本更新至 21.1.0。

建構及測試時使用：

• Google Mobile Ads SDK 21.1.0 版。
• Vungle SDK 版本 6.11.0。

6.11.0.2 版

• 新增支援在獎勵出價廣告中，針對相同的刊登位置 ID 載入多個廣告。

建構及測試時使用：

• Google Mobile Ads SDK 21.0.0 版。
• Vungle SDK 版本 6.11.0。

6.11.0.1 版

• 將 compileSdkVersion 和 targetSdkVersion 更新至 API 31。
• 將 Google Mobile Ads SDK 最低要求版本更新至 21.0.0。
• 將最低 Android API 級別更新為 19。

建構及測試時使用：

• Google Mobile Ads SDK 21.0.0 版。
• Vungle SDK 版本 6.11.0。

6.11.0.0 版

• 已驗證與 Vungle SDK 6.11.0 的相容性。

建構及測試時使用：

• Google Mobile Ads SDK 20.6.0 版。
• Vungle SDK 版本 6.11.0。

6.10.5.0 版

• 已驗證與 Vungle SDK 6.10.5 的相容性。
• 將最低要求的 Google Mobile Ads SDK 版本更新至 20.6.0。

建構及測試時使用：

• Google Mobile Ads SDK 20.6.0 版。
• Vungle SDK 版本 6.10.5。

6.10.4.0 版

• 已驗證與 Vungle SDK 6.10.4 的相容性。

建構及測試時使用：

• Google Mobile Ads SDK 20.5.0 版。
• Vungle SDK 版本 6.10.4。

6.10.3.0 版

• 已驗證與 Vungle SDK 6.10.3 的相容性。

建構及測試時使用：

• Google Mobile Ads SDK 20.5.0 版。
• Vungle SDK 版本 6.10.3。

6.10.2.1 版

• 已確認與 Vungle SDK 6.10.2 相容。
• 新增插頁式廣告和獎勵廣告格式的出價支援。
• 將 Google Mobile Ads SDK 最低要求版本更新至 20.5.0。

建構及測試時使用：

• Google Mobile Ads SDK 20.5.0 版。
• Vungle SDK 6.10.2 版。

6.10.2.0 版

• 已確認與 Vungle SDK 6.10.2 相容。
• 修正轉接程式問題：在要求橫幅廣告和插頁式廣告時，將參數 serverParameters 替換為 mediationExtras，以便取得 Vungle 網路專屬參數。

建構及測試時使用：

• Google Mobile Ads SDK 20.3.0 版。
• Vungle SDK 6.10.2 版。

6.10.1.0 版

• 已驗證與 Vungle SDK 6.10.1 的相容性。
• 將最低必要的 Google Mobile Ads SDK 版本更新至 20.3.0。
• Vungle 的橫幅廣告 API 現在支援 MREC 廣告。
• 更新標準化錯誤代碼和訊息。

建構及測試時使用：

• Google Mobile Ads SDK 20.3.0 版。
• Vungle SDK 6.10.1 版。

6.9.1.1 版

• 將最低要求的 Google Mobile Ads SDK 版本更新至 20.0.0。

建構及測試時使用：

• Google Mobile Ads SDK 20.0.0 版。
• Vungle SDK 版本 6.9.1。

版本 6.9.1.0

• 已驗證與 Vungle SDK 6.9.1 的相容性。
• 新增 OMSDK 支援。
• 修正多項錯誤。
• 支援 Vungle onAdViewed 回呼的獎勵廣告。
• 將最低要求的 Google Mobile Ads SDK 版本更新至 19.7.0。

建構及測試時使用：

• Google Mobile Ads SDK 19.7.0 版。
• Vungle SDK 版本 6.9.1。

6.8.1.1 版

• 將最低要求的 Google Mobile Ads SDK 版本更新至 19.6.0。

建構及測試時使用：

• Google Mobile Ads SDK 19.6.0 版。
• Vungle SDK 6.8.1 版。

6.8.1.0 版

• 已驗證與 Vungle SDK 6.8.1 的相容性。
• 將最低要求的 Google Mobile Ads SDK 版本更新至 19.5.0。

建構及測試時使用：

• Google Mobile Ads SDK 19.5.0 版。
• Vungle SDK 6.8.1 版。

版本 6.8.0.0

• 已驗證與 Vungle SDK 6.8.0 的相容性。
• 更新轉接器，在重新整理或銷毀橫幅廣告時，不會轉送 onAdClosed()。
• 移除 FlexFeed 和 FlexView (已在 Vungle 6.8.0 中淘汰)。
• 將 Google Mobile Ads SDK 最低要求版本更新至 19.4.0。

建構及測試時使用：

• Google Mobile Ads SDK 19.4.0 版。
• Vungle SDK 6.8.0 版。

6.7.1.0 版

• 已驗證與 Vungle SDK 6.7.1 的相容性。
• 修正錯誤：如果使用應用程式內容載入廣告，廣告不會載入。
• 已將 targetSdkVersion 更新至 API 29。
• 將最低要求的 Google Mobile Ads SDK 版本更新至 19.3.0。

建構及測試時使用：

• Google Mobile Ads SDK 19.3.0 版。
• Vungle SDK 6.7.1 版。

6.7.0.0 版

• 已確認與 Vungle SDK 6.7.0 相容。
• 更新轉接器，以支援內嵌自動調整橫幅廣告要求。
• 插頁式和獎勵廣告現在預設為未靜音。
• 插頁式廣告現在會在點選時轉送 onAdLeftApplication() 回呼。
• 將最低必要的 Google Mobile Ads SDK 版本更新至 19.2.0。

建構及測試時使用：

• Google Mobile Ads SDK 19.2.0 版。
• Vungle SDK 版本 6.7.0。

6.5.3.0 版

• 已確認與 Vungle SDK 6.5.3 相容。
• 新增支援 Vungle 的橫幅廣告格式。
• 將最低要求的 Google Mobile Ads SDK 版本更新至 19.0.1。

建構及測試時使用：

• Google Mobile Ads SDK 19.0.1 版。
• Vungle SDK 版本 6.5.3。

6.4.11.1 版

• 修正橫幅廣告無法重新整理的問題。

6.4.11.0 版

• 已確認與 Vungle SDK 6.4.11 相容。
• 開始支援橫幅廣告。
• 已將轉接程式遷移至 AndroidX。
• 將最低必要的 Google Mobile Ads SDK 版本更新至 18.2.0。

版本 6.3.24.1

• 更新轉接器，支援新的公開測試版 Rewarded API。
• 將最低必要的 Google Mobile Ads SDK 版本更新至 17.2.0。

6.3.24.0 版

• 已確認與 Vungle SDK 6.3.24 相容。

6.3.17.0 版

• 已驗證與 Vungle SDK 6.3.17 的相容性。

6.3.12.0 版

• 已驗證與 Vungle SDK 6.3.12 的相容性。

6.2.5.1 版

• 更新轉接程式，以便叫用 onRewardedVideoComplete() 廣告事件。

6.2.5.0 版

• 已驗證與 Vungle SDK 6.2.5 的相容性。

版本 5.3.2.1

• 更新轉接程式，正確回報點擊次數給 Google Mobile Ads SDK。

5.3.2.0 版

• 已驗證與 Vungle SDK 5.3.2 的相容性。
• 更新 Android Studio 3.0 的 Adapter 專案。
• 已將下列方法新增至 Bundle 建構工具類別。
  • setOrdinalViewCount：每當發布商從 Vungle 收到序數資料報表時，就會使用這個欄位傳遞中介服務序數。
  • setFlexViewCloseTimeInSec：這個選項可讓 Flex 廣告在指定秒數後自動關閉。

5.3.0.0 版

• 已驗證與 Vungle SDK 5.3.0 的相容性。

5.1.0.0 版

• 更新轉接器，使其與 Vungle SDK 5.1.0 相容。
• 將版本命名系統變更為 [Vungle SDK 版本]。[轉接程式修補程式版本]。

舊版

• 新增對插頁式和獎勵影片廣告格式的支援。