本指南說明如何使用 Google Mobile Ads SDK 透過中介服務載入並顯示 Liftoff Monetize 的廣告,涵蓋出價和瀑布流程整合。這篇文章將說明如何將 Liftoff Monetize 新增至廣告單元的中介設定,以及如何將 Vungle SDK 和轉接程式整合至Flutter 應用程式。
支援的整合和廣告格式
整合 | |
---|---|
出價 | |
瀑布 | |
格式 | |
開啟應用程式 | 1、 2 |
橫幅廣告 | 1。 |
插頁式 | |
已獲得獎勵 | |
插頁式獎勵廣告 | 1 |
原生 | 1、 2 |
1 出價 此格式的整合功能仍在公開測試階段
2 這類格式的階梯式廣告整合功能目前處於公開 Beta 版階段。
需求條件
- 最新版 Google Mobile Ads SDK
- Flutter 3.7.0 以上版本
- 如何在 Android 上部署
- Android API 級別 21 以上
- 如何在 iOS 上部署
- iOS 部署目標為 12.0 以上版本
- 使用 Google Mobile Ads SDK 設定的 Flutter 可運作專案。詳情請見 詳情請參閱開始使用。
- 完成中介服務入門指南
步驟 1:在 Liftoff Monetize 使用者介面中設定設定
按一下「Add Application」按鈕,將應用程式新增至 Liftoff Monetize 資訊主頁。
填寫表單,輸入所有必填的詳細資料。
Android
iOS
建立應用程式後,請從中選取應用程式 Liftoff Monetize 應用程式資訊主頁。
Android
iOS
記下應用程式 ID。
Android
iOS
新增刊登位置
如要建立可搭配 AdMob 中介服務使用的刊登位置,請前往 Liftoff 營利刊登位置資訊主頁,按一下「新增刊登位置」按鈕,然後從下拉式清單中選取應用程式。
新增刊登位置的詳細資訊如下:
開啟應用程式
選取「插頁式廣告」,然後輸入「刊登位置名稱」。然後選取「是」 [可略過] 並填寫表單的其餘部分。[僅限出價] 低於 「營利」,將「應用程式內出價」切換為「已啟用」。 按一下頁面底部的「繼續」按鈕,即可建立刊登位置。
橫幅廣告
選取「橫幅」,輸入「刊登位置名稱」,然後填寫表單的其餘部分。[僅限出價] 在「營利」下方,將「應用程式內出價」切換為開啟 切換至「啟用」。按一下畫面底部的 [繼續] 按鈕 網頁建立刊登位置
300x250 橫幅
選取「MREC」,輸入「刊登位置名稱」,然後填寫其餘部分 表單中要求的資訊。[僅限出價] 在「營利」下方,將「應用程式內出價」切換為開啟 切換至「啟用」。按一下畫面底部的 [繼續] 按鈕 網頁建立刊登位置
插頁式
選取「插頁式廣告」,輸入「刊登位置名稱」,然後填寫表單的其餘部分。[僅限出價] 在「營利」下方,將 將「應用程式內出價」切換為「已啟用」。按一下 [繼續] 按鈕 建立刊登位置
已獲得獎勵
選取「獎勵廣告」,輸入刊登位置名稱,然後填寫其餘部分 表單中要求的資訊。[僅限出價] 在「營利」下方,將「應用程式內出價」切換為開啟 切換至「啟用」。按一下頁面底部的「繼續」按鈕,即可建立刊登位置。
插頁式獎勵廣告
選取「獎勵」。輸入「刊登位置名稱」,啟用「可略過」和 填寫表單的其他部分。[僅限出價] 在「營利」下方切換鈕 將「應用程式內出價」切換為「已啟用」。按一下「繼續」按鈕 建立刊登位置
原生
選取「原生」,輸入「刊登位置名稱」,然後填寫其餘部分 表單中要求的資訊。[僅限出價] 在「營利」下方,將「應用程式內出價」切換為開啟 切換至「啟用」。按一下畫面底部的 [繼續] 按鈕 網頁建立刊登位置
記下「Reference ID」,然後按一下「Sounds Good」。
開啟應用程式
橫幅廣告
300x250 橫幅
插頁式
已獲得獎勵
插頁式獎勵廣告
原生
找出您的 Reporting API 金鑰
出價
出價整合不必執行這個步驟。
瀑布
除了 應用程式 ID 和 參考 ID 之外,您還需要提供 Liftoff Monetize 的 Reporting API 金鑰,才能設定 AdMob 廣告單元 ID。前往 Liftoff Monetize 報表資訊主頁,然後按一下「Reporting API Key」按鈕,即可查看「Reporting API Key」。
開啟測試模式
如要啟用測試廣告,請前往 Liftoff Monetize 資訊主頁,然後前往「應用程式」。
在應用程式的「刊登位置參考 ID」部分下方,選取要啟用測試廣告的應用程式。如要啟用測試廣告,請在「狀態」部分下方,將「測試模式」選項切換為「只顯示測試廣告」。
Android
iOS
步驟 2:在使用者介面中設定 Liftoff Monetize 需求 AdMob
調整廣告單元中介服務設定
新增 Liftoff 至 GDPR 和美國州級法規廣告合作夥伴名單
步驟 3:匯入 Vungle SDK 和 Liftoff Monetize 轉接程式
透過 pub.dev 整合
在套件的 pubspec.yaml
檔案中,新增下列依附元件,其中包含最新版本的Liftoff Monetize SDK 和轉接器:
dependencies:
gma_mediation_liftoffmonetize: ^1.0.0
手動整合
下載適用於 Liftoff Monetize 的最新版 Google 行動廣告中介服務外掛程式,解壓縮下載的檔案,然後將解壓縮的插件資料夾 (及其內容) 新增至您的 Flutter 專案。然後,在
pubspec.yaml
檔案,請新增下列依附元件:
dependencies:
gma_mediation_liftoffmonetize:
path: path/to/local/package
步驟 4:在 Liftoff Monetize SDK 中導入隱私權設定
歐盟同意聲明和 GDPR
根據 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 的說明文件,將 SKAdNetwork ID 新增至專案的 Info.plist
檔案。
步驟 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 | 無論刊登位置 ID 為何,Vungle SDK 一次只支援載入 1 個橫幅廣告。 |
106 | Vungle SDK 傳送的回呼指出廣告無法播放。 |
107 | Vungle SDK 尚未準備好播放廣告。 |
如要瞭解 Vungle SDK 產生的錯誤,請參閱「錯誤代碼:iOS 和 Android 適用的 Vungle SDK」。
Liftoff Monetize Flutter Mediation Adapter 變更記錄
1.1.0 版本
- 已確認與 Liftoff Monetize Android 轉接程式 7.4.0.1 相容
- 已確認與 LiftoffMonetize iOS 轉接器 7.4.0.1 相容
- 使用 Google 行動廣告 Flutter 外掛程式 5.1.0 版進行建構及測試。
1.0.0 版本
- 第 1 版。
- 已確認與 Liftoff Monetize Android 轉接器 7.3.1.0 相容
- 已確認與 LiftoffMonetize iOS 轉接器 7.3.2.0 相容
- 使用 Google 行動廣告 Flutter 外掛程式 5.1.0 版建立和測試。