整合 Liftoff Monetize 與中介服務

本指南將說明如何使用 Google Mobile Ads SDK 載入及顯示 使用 從 Liftoff Monetize 的廣告 AdMob 中介服務、 包括出價和刊登序列整合說明如何新增 Liftoff 透過廣告單元的中介服務設定營利，以及如何整合 Vungle SDK 和轉接程式 iOS

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

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

¹ 出價 這個格式的整合功能目前仍在 Beta 版封測階段

² 出價 此格式的整合仍在公開測試階段

³ 瀑布 這個格式的整合功能目前仍在 Beta 版封測階段

需求條件

• iOS 部署目標為 12.0 以上版本

• [適用於出價]：Liftoff MonetizeAdapter 6.11.0.1 以上版本 (建議使用最新版本)

• 最新版 Google Mobile Ads SDK

• 完成中介服務 入門指南

步驟 1：在 Liftoff Monetize UI 中進行設定

註冊或登入 Liftoff Monetize 帳戶。

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

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

建立應用程式後，請在 Liftoff Monetize Applications 資訊主頁中選取您的應用程式。

記下「應用程式 ID」。

新增刊登位置

如要建立搭配 AdMob中介服務使用的新刊登位置，請前往「Liftoff Monetize Monetize」資訊主頁」，按一下「Add Placement」(新增刊登位置) 按鈕，然後從下拉式選單中選取應用程式。

以下提供新增刊登位置的詳細資料：

記下參考檔案 ID，然後點選「音效良好」。

找出 Reporting API 金鑰

開啟測試模式

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

在應用程式的「刊登位置參考 ID」部分底下，選取您想啟用測試廣告的應用程式。

步驟 2：在使用者介面中設定 Liftoff Monetize 需求 AdMob

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

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

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

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

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

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

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

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

新增 Liftoff Monetize 做為廣告來源

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

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

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

使用 CocoaPods (建議)

• 在專案的 Podfile 中新增下列程式碼：

  pod 'GoogleMobileAdsMediationVungle'
  

• 從指令列執行下列指令：

  pod install --repo-update
  

手動整合

• 下載最新版的 Vungle SDK 並在專案中連結 VungleSDK.framework

• 前往以下網址下載最新版的 Liftoff Monetize 轉接程式 變更記錄中的下載連結 並在專案中連結 LiftoffMonetizeAdapter.framework

• 將下列架構新增至專案：

  • AdSupport
  • AudioToolbox
  • AVFoundation
  • CFNetwork
  • CoreGraphics
  • CoreMedia
  • libz.tbd
  • MediaPlayer
  • QuartzCore
  • StoreKit
  • SystemConfiguration

步驟 4：在 Liftoff Monetize SDK 中導入隱私權設定

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

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

Liftoff Monetize 包含可讓您傳送同意聲明給 Vungle SDK 的 API。 以下程式碼範例說明如何將這項同意聲明資訊傳送給 Vungle SDK。如果選擇呼叫此方法，建議您一併呼叫 透過 Google Mobile Ads SDK 請求廣告。

import VungleAdsSDK
// ...

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

#import <VungleAdsSDK/VungleAdsSDK.h>
// ...

[VunglePrivacySettings setGDPRStatus:YES];
[VunglePrivacySettings setGDPRMessageVersion:@"v1.0.0"];

請參閱 GDPR 建議導入說明 ，以及在方法中提供的值。

美國州級隱私權法律

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

Liftoff Monetize 包含可讓您傳送同意聲明給 Vungle SDK 的 API。 以下程式碼範例說明如何將這項同意聲明資訊傳送給 Vungle SDK。如果選擇呼叫此方法，建議您一併呼叫 透過 Google Mobile Ads SDK 請求廣告。

import VungleAdsSDK
// ...

VunglePrivacySettings.setCCPAStatus(true)

#import <VungleAdsSDK/VungleAdsSDK.h>
// ...

[VunglePrivacySettings setCCPAStatus:YES];

請參閱 CCPA 建議導入操作說明 ，以及在方法中提供的值。

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

SKAdNetwork 整合

請遵循 Liftoff Monetize 的說明文件。 在專案的 Info.plist 檔案中新增 SKAdNetwork ID。

步驟 6：測試實作成果

啟用測試廣告

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

驗證測試廣告

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

選擇性步驟

聯播網專用參數

Liftoff Monetize 轉接程式支援額外的要求參數，可 必須透過 VungleAdNetworkExtras 類別傳遞至轉接程式。本課程 包含下列屬性：

userId

代表 Liftoff Monetize 的獎勵使用者 ID。

nativeAdOptionPosition

用於指定原生廣告隱私權圖示位置的整數。

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

#import "VungleAdapter.h"
// ...

let request = GADRequest()
let extras = VungleAdNetworkExtras()
extras.userId = "myUserID"
extras.nativeAdOptionPosition = 1
// ...
request.register(extras)

#import <LiftoffMonetizeAdapter/VungleAdapter.h>
// ...

GADRequest *request = [GADRequest request];
VungleAdNetworkExtras *extras = [[VungleAdNetworkExtras alloc] init];
extras.userId = @"myUserID";
extras.nativeAdOptionPosition = 1;
// ...
[request registerAdNetworkExtras:extras];

原生廣告顯示

Liftoff Monetize 轉接程式傳回原生廣告 GADNativeAd 如需儲存大量結構化物件 建議使用 Cloud Bigtable會填入以下項目 原生廣告欄位說明 的 GADNativeAd.

¹ Liftoff Monetize 轉接程式無法直接存取其原生的主要圖片素材資源 廣告。而是會改為填入 GADMediaView 包含影片或圖片

錯誤代碼

如果轉接程式無法收到 Liftoff Monetize 的廣告，發布商可以 使用 GADResponseInfo.adNetworkInfoArray 加入以下類別：

以下是 Liftoff Monetize 所擲回的代碼和相應訊息 轉接程式載入失敗時：

Liftoff Monetize 中介服務轉接程式變更記錄

7.4.0.0 版

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

建構及測試工具：

• Google Mobile Ads SDK 11.6.0 版。
• Vungle SDK 7.4.0 版。

7.3.2.0 版

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

建構及測試工具：

• Google Mobile Ads SDK 11.3.0 版。
• Vungle SDK 7.3.2 版。

7.3.1.1.0 版

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

建構及測試工具：

• Google Mobile Ads SDK 11.3.0 版。
• Vungle SDK 7.3.1.1 版。

7.3.1.0 版

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

建構及測試工具：

• Google Mobile Ads SDK 11.3.0 版。
• Vungle SDK 7.3.1 版。

7.3.0.0 版

• 已驗證與 Vungle SDK 7.3.0 的相容性。
• 修正無法在 Swift 中匯入轉接器的問題。
• 針對應用程式開啟頁面廣告格式，新增刊登序列和出價支援功能。

建構及測試工具：

• Google Mobile Ads SDK 11.2.0 版。
• Vungle SDK 7.3.0 版。

7.2.2.1 版

• 現在最低版本需求為 iOS 12.0。
• 現在需要 Google Mobile Ads SDK 11.0 以上版本。
• 將 Info.plist 包含在 LiftoffMonetizeAdapter.xcframework 內的架構中。

建構及測試工具：

• Google Mobile Ads SDK 11.0.1 版。
• Vungle SDK 7.2.2 版。

7.2.2.0 版

• 已驗證與 Vungle SDK 7.2.2 的相容性。
• 現在最低版本需求為 iOS 12.0 以上版本。

建構及測試工具：

• Google Mobile Ads SDK 11.0.0 版。
• Vungle SDK 7.2.2 版。

7.2.1.1 版

• 將 MREC 比對功能更新為符合 MREC 的任何大小，而非完全比對。

建構及測試工具：

• Google Mobile Ads SDK 10.14.0 版。
• Vungle SDK 7.2.1 版。

7.2.1.0 版

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

建構及測試工具：

• Google Mobile Ads SDK 10.14.0 版。
• Vungle SDK 7.2.1 版。

7.2.0.0 版

• 已驗證與 Vungle SDK 7.2.0 的相容性。
• 從橫幅廣告和插頁式廣告導入方式中移除已淘汰的 willBackgroundApplication 委派方法。
• 已將已淘汰的 childDirectedTreatment 方法替換為 GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment 屬性。

建構及測試工具：

• Google Mobile Ads SDK 10.14.0 版。
• Vungle SDK 7.2.0 版。

7.1.0.0 版

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

建構及測試工具：

• Google Mobile Ads SDK 10.10.0 版。
• Vungle SDK 7.1.0 版。

7.0.1.0 版

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

建構及測試工具：

• Google Mobile Ads SDK 10.7.0 版。
• Vungle SDK 7.0.1 版。

7.0.0.0 版

• 將轉接器名稱從 Vungle 改為 Liftoff Monetize。
• 已驗證與 Vungle SDK 7.0.0 的相容性。
• 已停止支援 armv7 架構。
• 新增對 arm64 模擬架構的支援。
• 現在須使用最低 iOS 11.0 版。
• 現在需要 Google Mobile Ads SDK 10.4.0 以上版本。

建構及測試工具：

• Google Mobile Ads SDK 10.4.0 版。
• Vungle SDK 7.0.0 版。

6.12.3.0 版

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

建構及測試工具：

• Google Mobile Ads SDK 10.2.0 版。
• Vungle SDK 6.12.3 版。

6.12.2.0 版

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

建構及測試工具：

• Google Mobile Ads SDK 10.0.0 版。
• Vungle SDK 6.12.2 版。

6.12.1.2 版

• 現在需要 Google Mobile Ads SDK 10.0.0 以上版本。

建構及測試工具：

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

6.12.1.1 版

• 已驗證與 Vungle SDK 6.12.1 的相容性。
• 新增橫幅廣告格式的出價支援。

建構及測試工具：

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

6.12.1.0 版

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

建構及測試工具：

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

6.12.0.0 版

• 已驗證與 Vungle SDK 6.12.0 的相容性。
• 為插頁式獎勵廣告格式新增刊登序列中介服務和出價支援。
• 新增原生廣告格式的出價支援。
• 更新轉接器以使用 didRewardUser API。
• 已移除 VungleAdNetworkExtras 中的 ordinal 額外項目。
• 現在需要 Google Mobile Ads SDK 9.8.0 以上版本。

建構及測試工具：

• Google Mobile Ads SDK 9.9.0 版。
• Vungle SDK 6.12.0 版。

6.11.0.2 版

• 新增原生廣告格式的刊登序列中介服務支援。

建構及測試工具：

• Google Mobile Ads SDK 9.8.0 版。
• Vungle SDK 6.11.0 版。

6.11.0.1 版

• 在出價插頁式廣告和獎勵廣告中，使用同一個刊登位置 ID 載入多則廣告的支援功能。

建構及測試工具：

• Google Mobile Ads SDK 9.6.0 版。
• Vungle SDK 6.11.0 版

6.11.0.0 版

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

建構及測試工具：

• Google Mobile Ads SDK 9.4.0 版。
• Vungle SDK 6.11.0 版

6.10.6.1 版

• 修正系統無法下載下一則廣告時，廣告委派會遭到移除的問題。這僅適用於自動快取設定刊登位置。
• 移除橫幅廣告中的 willPresentFullScreenView 和 adapterWillPresentFullScreenModal 回呼。

建構及測試工具：

• Google Mobile Ads SDK 9.0.0 版。
• Vungle SDK 6.10.6 版

6.10.6.0 版

• 已驗證與 Vungle SDK 6.10.6 的相容性。
• 已驗證與 Google Mobile Ads SDK 9.0.0 版的相容性。
• 現在需要 Google Mobile Ads SDK 9.0.0 以上版本。

建構及測試工具：

• Google Mobile Ads SDK 9.0.0 版。
• Vungle SDK 6.10.6 版

6.10.5.1 版

• 為插頁式廣告和獎勵廣告格式新增出價支援。

建構及測試

• Google Mobile Ads SDK 8.13.0 版。
• Vungle SDK 6.10.5 版

6.10.5.0 版

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

建構及測試

• Google Mobile Ads SDK 8.13.0 版。
• Vungle SDK 6.10.5 版

6.10.4.0 版

• 已驗證與 Vungle SDK 6.10.4 的相容性。
• 更新轉接程式，以在 VungleAdNetworkExtras 中的 muteIsSet 布林值未明確設定時，沿用 Vungle 發布商資訊主頁中的靜音設定。

建構及測試

• Google Mobile Ads SDK 8.12.0 版。
• Vungle SDK 6.10.4 版

6.10.3.1 版

• 修正了第一次播放後，無法叫用插頁式廣告回呼的錯誤。
• 更新傳遞至 playAd 方法的 options 字典，在 extras 物件中加入發布者設定的靜音屬性。

建構及測試

• Google Mobile Ads SDK 8.12.0 版。
• Vungle SDK 6.10.3 版

6.10.3.0 版

• 已驗證與 Vungle SDK 6.10.3 的相容性。
• 現在最低版本需求為 iOS 10.0 以上版本。

建構及測試

• Google Mobile Ads SDK 8.11.0 版。
• Vungle SDK 6.10.3 版。

6.10.1.0 版

• 已驗證與 Vungle SDK 6.10.1 的相容性。
• 在使用 Google Mobile Ads SDK 8.0.0 或以上版本時輕鬆依附元件。
• 現在需要針對 Xcode 12.5 以上版本進行建構。

建構及測試

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

6.10.0.0 版 (已復原)

• 已驗證與 Vungle SDK 6.10.0 的相容性。
• 在使用 Google Mobile Ads SDK 8.0.0 或以上版本時輕鬆依附元件。
• 現在需要針對 Xcode 12.5 以上版本進行建構。

建構及測試

• Google Mobile Ads SDK 8.4.0 版。
• Vungle SDK 6.10.0 版。

6.9.2.0 版

• 已驗證與 Vungle SDK 6.9.2 的相容性。
• 現在需要 Google Mobile Ads SDK 8.3.0 以上版本。

建構及測試

• Google Mobile Ads SDK 8.3.0 版。
• Vungle SDK 6.9.2 版。

6.9.1.0 版

• 已驗證與 Vungle SDK 6.9.1 的相容性。
• 現在需要 Google Mobile Ads SDK 8.1.0 以上版本。
• 已新增標準化轉接程式錯誤代碼和訊息。
• 更新轉接介面以使用 .xcframework 格式。
• 移除載入廣告的 VungleSDKResetplacementForDifferentAdSize 錯誤檢查。
• 導入新的 SDK 委派回呼 vungleAdViewedForPlacement: 以追蹤曝光。

建構及測試

• Google Mobile Ads SDK 8.1.0 版。
• Vungle SDK 6.9.1 版。

6.8.1.0 版

• 已驗證與 Vungle SDK 6.8.1 的相容性。
• 現在需要 Google Mobile Ads SDK 7.66.0 以上版本。

建構及測試

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

6.8.0.0 版

• 已驗證與 Vungle SDK 6.8.0 的相容性。
• 現在需要 Google Mobile Ads SDK 7.65.0 以上版本。

建構及測試

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

6.7.1.0 版

• 已驗證與 Vungle SDK 6.7.1 的相容性。
• 現在需要 Google Mobile Ads SDK 7.64.0 以上版本。
• 修正獎勵廣告無法顯示時無法呼叫 didFailToPresentWithError: 的問題。

建構及測試

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

6.7.0.0 版

• 已驗證與 Vungle SDK 6.7.0 的相容性。
• 現在需要 Google Mobile Ads SDK 7.62.0 以上版本。
• 新增同時播放多則橫幅廣告的支援功能。
• 現在系統會記錄點擊發生時使用的是點擊，而不是關閉廣告的時間。
• 橫幅廣告和插頁式廣告現在都會將 willLeaveApplication 回呼。

建構及測試

• Google Mobile Ads SDK 7.62.0 版。
• Vungle SDK 6.7.0 版。

6.5.3.0 版

• 已驗證與 Vungle SDK 6.5.3 的相容性。
• 現在需要 Google Mobile Ads SDK 7.58.0 以上版本。
• 新增智慧型和自動調整橫幅廣告支援功能。
• 新增橫幅廣告 (320x50、300x50、728x90) 廣告的支援。
• 在播放廣告時新增影片方向選項。
• 修正在第一次重新整理後無法呼叫 report_ad 的錯誤。
• 修正較長的刊登序列廣告供應情形延遲問題。
• 停止支援 i386 架構。

建構及測試

• Google Mobile Ads SDK 7.58.0 版。
• Vungle SDK 6.5.3 版。

6.4.6.0 版

• 已驗證與 Vungle SDK 6.4.6 的相容性。
• 新增對橫幅廣告 (MREC) 廣告的支援。
• 修正 doReceive 插頁式廣告：回呼重複呼叫的錯誤。
• 移除之前未在正確時間叫用轉接器 WillLeaveApplication 的回呼。

建構及測試

• Google Mobile Ads SDK 7.52.0 版。
• Vungle SDK 6.4.6 版。

6.3.2.3 版

• 修正 [GADMAdapterVungle 獎勵 Ad adAvailable:] 中的當機問題。

6.3.2.2 版

• 修正 Vungle SDK 初始化失敗時，Vungle 轉接程式無法載入獎勵廣告的錯誤。現在，轉接程式會嘗試在後續的獎勵廣告請求中重新初始化 Vungle SDK。
• 現在需要 Google Mobile Ads SDK 7.42.2 以上版本。

6.3.2.1 版

• 更新轉接程式以使用新的獎勵 API。
• 現在需要 Google Mobile Ads SDK 7.41.0 以上版本。

6.3.2.0 版

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

6.3.0.0 版

• 已驗證與 Vungle SDK 6.3.0 的相容性。
• 已將 VungleRouterConsent 類別中的 updateConsentStatus 方法更新為 updateConsentStatus:consentMessageVersion:。

6.2.0.3 版

• 已將 adapterDidCompletePlayingRewardBasedVideoAd: 回呼新增至轉接程式。

6.2.0.2 版

• 已新增包含 updateConsentStatus 和 getConsentStatus 方法的 VungleRouterConsent 類別

6.2.0.1 版

• 已正確更新 Vungle SDK 初始化器。

6.2.0.0 版

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

5.4.0.0 版

• 已驗證與 Vungle SDK 5.4.0 的相容性。
• 更新轉接程式，以便正確回報 Google Mobile Ads SDK 的點擊。

5.3.2.0 版

• 將兩個額外項目新增至 VungleAdNetworkExtras：
  • ordinal：代表廣告顯示順序的整數 遊戲工作階段
  • flexViewAutoDismissSeconds：設定在以下時間過後自動關閉 Flex View 廣告： 指定秒數
• 已驗證與 Vungle SDK 5.3.2 的相容性。

5.3.0.0 版

• 將部署目標更新為 iOS 8。
• 已驗證與 Vungle SDK 5.3.0 的相容性。

5.2.0.0 版

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

5.1.1.0 版

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

5.1.0.0 版

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

較舊版本

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