本指南將說明如何使用 Google Mobile Ads SDK 載入及顯示 使用 Liftoff Monetize 的廣告 中介服務,範圍涵蓋出價和 刊登序列整合說明如何將 Liftoff Monetize 加進廣告單元 以及如何將 Vungle SDK 和轉接程式整合至 Flutter 應用程式。
支援的整合和廣告格式
整合 | |
---|---|
出價 | |
瀑布 | |
格式 | |
開啟應用程式 | 1、 3 |
橫幅廣告 | 2。 |
插頁式 | |
已獲得獎勵 | |
插頁式獎勵廣告 | 2。 |
1 出價 這個格式的整合功能目前仍在 Beta 版封測階段
2 出價 此格式的整合功能仍在公開測試階段
3 瀑布 這個格式的整合功能目前仍在 Beta 版封測階段
需求條件
- 最新版 Google Mobile Ads SDK
- Flutter 3.7.0 以上版本
- 如何在 Android 上部署
- Android API 級別 21 以上
- 如何在 iOS 上部署
- iOS 部署目標為 12.0 以上版本
- 已設定的 Flutter 有效專案 Google Mobile Ads SDK。詳情請見 詳情請參閱開始使用。
- 完成中介服務 入門指南
步驟 1:在 Liftoff Monetize UI 中進行設定
步驟 2:在使用者介面中設定 Liftoff Monetize 需求 AdMob
調整廣告單元中介服務設定
將 Liftoff 新增至 GDPR 和美國州級法規廣告合作夥伴清單
請按照 GDPR 設定 和 美國州級法規設定 ,在 AdMob UI 和美國州級法規廣告合作夥伴清單中新增 Liftoff。
步驟 3:匯入 Vungle SDK 和 Liftoff Monetize 轉接程式
透過 pub.dev 整合
使用最新版本的
Liftoff Monetize 套件中的 SDK 和轉接程式
pubspec.yaml
檔案:
dependencies:
gma_mediation_liftoffmonetize: ^1.0.0
手動整合
下載最新版的 Google 行動廣告中介服務外掛程式
Liftoff Monetize、
解壓縮下載的檔案,然後新增擷取的外掛程式資料夾
(及其內容) 新增至 Flutter 專案然後,在
pubspec.yaml
檔案,新增下列依附元件:
dependencies:
gma_mediation_liftoffmonetize:
path: path/to/local/package
步驟 4:在 Liftoff Monetize SDK 中導入隱私權設定
歐盟地區同意授權和 GDPR
根據 Google 歐盟地區使用者同意聲明 Google 政策,您必須確保使用者有揭露特定揭露事項。 只有當歐洲經濟區 (EEA) 使用者提供同意聲明,以及 如何使用裝置 ID 和個人資料本政策是配合《歐盟電子通訊隱私指令》和《一般資料保護規則》(GDPR) 的法規而制定。在徵求同意聲明時,您必須指出中介服務鏈中可能會收集、接收或使用個人資料的每個廣告聯播網,並提供每個聯播網的使用方式相關資訊。Google 目前無法 將使用者的同意聲明選項自動傳送到這類聯播網。
Liftoff Monetize 的 Google 行動廣告中介服務外掛程式包含
GmaMediationLiftoffmonetize.setGDPRStatus()
方法。以下程式碼範例
中說明瞭如何將同意聲明資訊傳送至 Vungle SDK。如果您選擇
呼叫此方法,建議先呼叫這個方法,再透過
Google Mobile Ads SDK。
import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...
GmaMediationLiftoffmonetize.setGDPRStatus(true, "1.0.0");
查看 GDPR 建議導入操作說明: Android 和 iOS 版應用程式瞭解詳情 以及可在方法中提供的值
美國州級隱私權法律
美國州級隱私權法律 規定使用者必須提供 即可選擇停用「銷售」功能代表「個人資訊」(如同法律定義 該條款中,透過顯眼的「請勿銷售我的個人」 資訊」請點選「銷售」裝置上的「銷售」連結以及派對首頁美國州級隱私權法律遵循指南提供啟用 Google 廣告放送服務的受限資料處理功能,但 Google 無法將這項設定套用至中介服務鏈中的每個廣告聯播網。因此,你必須找出每個廣告聯播網。 可參與個人銷售的 並遵循各自的指南 確保符合法規。
Liftoff Monetize 的 Google 行動廣告中介服務外掛程式包含
GmaMediationLiftoffmonetize.setCCPAStatus()
方法。以下程式碼範例
中說明瞭如何將同意聲明資訊傳送至 Vungle SDK。如果您選擇
呼叫此方法,建議先呼叫這個方法,再透過
Google Mobile Ads SDK。
import 'package:gma_mediation_liftoffmonetize/gma_mediation_liftoffmonetize.dart';
// ...
GmaMediationLiftoffmonetize.setCCPAStatus(true);
請參閱以下 CCPA 建議導入說明: Android 和 iOS 應用程式瞭解詳情,並 可在方法中提供的值。
步驟 5:新增必要的程式碼
僅適用於搭載 Android
不需要額外的程式碼 Liftoff Monetize 整合。
iOS
SKAdNetwork 整合
追蹤 Liftoff Monetize 的
說明文件
在專案的 Info.plist
檔案中新增 SKAdNetwork ID。
步驟 6:測試實作成果
啟用測試廣告
請務必為AdMob 註冊測試裝置,並在 Liftoff Monetize 使用者介面中啟用測試模式。
驗證測試廣告
如要確認您正在接收來自Liftoff Monetize的測試廣告,請使用 Liftoff Monetize (Bidding) and Liftoff Monetize (Waterfall) 廣告來源在廣告檢查器中啟用單一廣告來源測試。
錯誤代碼
如果轉接程式無法從 Liftoff Monetize 接收廣告,發布商可以使用下列類別中的 ResponseInfo
,檢查廣告回應的底層錯誤:
Android
格式 | 類別名稱 |
---|---|
應用程式開啟頁面廣告 (出價) | com.google.ads.mediation.vungle.VungleMediationAdapter |
應用程式開啟頁面廣告 (刊登序列) | com.google.ads.mediation.vungle.VungleMediationAdapter |
橫幅廣告 (出價) | com.google.ads.mediation.vungle.VungleMediationAdapter |
橫幅廣告 (刊登序列) | com.vungle.mediation.VungleInterstitialAdapter |
插頁式廣告 (出價) | com.google.ads.mediation.vungle.VungleMediationAdapter |
插頁式廣告 (刊登序列) | com.vungle.mediation.VungleInterstitialAdapter |
獎勵廣告 (出價) | com.google.ads.mediation.vungle.VungleMediationAdapter |
獎勵廣告 (刊登序列) | com.vungle.mediation.VungleAdapter |
插頁式獎勵廣告 (出價) | com.google.ads.mediation.vungle.VungleMediationAdapter |
插頁式獎勵廣告 (刊登序列) | com.google.ads.mediation.vungle.VungleMediationAdapter |
iOS
格式 | 類別名稱 |
---|---|
應用程式開啟 (出價) | GADMediationAdapterVungle |
應用程式開啟頁面廣告 (刊登序列) | GADMediationAdapterVungle |
橫幅廣告 (出價) | GADMediationAdapterVungle |
橫幅廣告 (刊登序列) | GADMAdapterVungleInterstitial |
插頁式廣告 (出價) | GADMediationAdapterVungle |
插頁式廣告 (刊登序列) | GADMAdapterVungleInterstitial |
獎勵廣告 (出價) | GADMediationAdapterVungle |
獎勵廣告 (刊登序列) | GADMAdapterVungleRewardBasedVideoAd |
插頁式獎勵廣告 (出價) | GADMediationAdapterVungle |
插頁式獎勵廣告 (刊登序列) | GADMediationAdapterVungle |
以下是 Liftoff Monetize 所擲回的代碼和相應訊息 轉接程式載入失敗時:
Android
錯誤代碼 | 原因 |
---|---|
101 | 伺服器參數無效 (例如應用程式 ID 或刊登位置 ID)。 |
102 | 要求的橫幅廣告大小未對應至有效的 Liftoff Monetize 廣告 大小 |
103 | 必須提供Activity 背景資訊,才能要求 Liftoff Monetize
廣告。 |
104 | Vungle SDK 無法為同一個刊登位置載入多個廣告 編號。 |
105 | Vungle SDK 無法初始化。 |
106 | Vungle SDK 傳回成功的載入回呼,但 Banners.getBanner() 或 Vungle.getNativeAd() 傳回空值。 |
107 | Vungle SDK 尚未準備好播放廣告。 |
108 | Vungle SDK 傳回無效的出價權杖。 |
iOS
錯誤代碼 | 原因 |
---|---|
101 | 伺服器參數無效 (例如應用程式 ID 或刊登位置 ID)。 |
102 | 系統已為這個聯播網設定檔載入廣告。Vungle SDK 無法使用同一個刊登位置 ID 載入第二則廣告。 |
103 | 要求的廣告大小與支援的 Liftoff Monetize 不符 橫幅廣告尺寸 |
104 | Vungle SDK 無法顯示橫幅廣告。 |
105 | Vungle SDK 一次僅支援載入 1 個橫幅廣告,無論 刊登位置 ID |
106 | Vungle SDK 傳送了一則回呼,指出廣告無法播放。 |
107 | Vungle SDK 還無法播放廣告。 |
如要瞭解 Vungle SDK 的錯誤,請參閱「錯誤代碼:iOS 和 Android 適用的 Vungle SDK」。
Liftoff Monetize Flutter 中介服務轉接程式變更記錄
1.0.0 版本
- 第 1 版。
- 已通過提升相容性與 Liftoff Monetize Android 轉接程式 7.3.1.0 版的相容性
- 已通過提升相容性與 LiftoffMonetize iOS 轉接程式 7.3.2.0 版的相容性
- 使用 Google 行動廣告 Flutter 外掛程式 5.1.0 版建立和測試。