本指南說明如何使用 Google Mobile Ads SDK 透過中介服務載入及顯示 Line 廣告,並介紹瀑布流整合。這篇文章將說明如何將 Line 新增至廣告單元的中介設定,以及如何將 Line SDK 和轉接程式整合至 Unity 應用程式。
支援的整合和廣告格式
Line 的 Ad Manager 中介服務轉接程式具有下列功能:
整合 | |
---|---|
出價 | |
瀑布 | 1 |
格式 | |
橫幅廣告 | |
插頁式 | |
已獲得獎勵 |
1 瀑布式整合功能目前為封閉式 Beta 版,請與客戶經理聯絡,要求存取權。
需求條件
- Unity 4 以上版本
- 最新版 Google Mobile Ads SDK
- 如何在 Android 上部署
- Android API 級別 21 以上
- 如何在 iOS 上部署應用程式
- iOS 部署目標為 12.0 以上版本
- 使用 Google Mobile Ads SDK 設定的正常運作 Unity 專案。詳情請參閱「開始使用」一文。
- 完成中介服務入門指南
步驟 1:在 Line UI 中設定設定
登入 Line 帳戶。
新增應用程式
依序按一下「廣告版位管理」 >「媒體」。然後按一下「新規建立」。
填寫表單,然後按一下「登録」。
記下應用程式 ID。
建立廣告刊登位置
按一下要新增廣告刊登位置的應用程式 ID。接著選取「詳細」。
按一下「スロット 追加 (Add Slot)」。
填寫表單,完成後按一下「(登録) 註冊」。
記下時段 ID。
步驟 2:在 Ad Manager UI 中設定 Line 需求
設定廣告單元的中介服務設定
步驟 3:匯入 Line SDK 和轉接程式
從Changelog 中的下載連結,下載最新版的 Google 行動廣告中介服務 Line 外掛程式,並從 ZIP 檔案中擷取 GoogleMobileAdsLineMediation.unitypackage
。
在 Unity 專案編輯器中,依序選取「Assets」>「Import Package」>「Custom Package」,然後找出您下載的 GoogleMobileAdsLineMediation.unitypackage
檔案。確認已選取所有檔案,然後按一下「Import」。
接著,依序選取「Assets」>「Play Services Resolver」>「Android Resolver」>「Force Resolve」。Unity Play 服務解析器程式庫會從頭執行依附元件解析作業,並將宣告的依附元件複製到 Unity 應用程式的 Assets/Plugins/Android
目錄中。
步驟 4:新增必要程式碼
Android
您不需要額外的程式碼即可整合 LINE。
iOS
SKAdNetwork 整合
請按照 Line 的說明文件將 SKAdNetwork 識別碼新增至專案的 Info.plist
檔案。
步驟 5:測試導入作業
啟用測試廣告
請務必為 AdMob 註冊測試裝置。
請按照 Line 的 Android 和 iOS 說明文件中的操作說明,啟用 Line 測試廣告。
驗證測試廣告
如要確認您收到來自 Line 的測試廣告,請使用 Line (刊登序列) 廣告來源,在廣告檢查器中啟用單一廣告來源測試。
選擇性步驟
網路專屬參數
Line Unity 中介服務外掛程式支援下列額外要求參數,可透過 LineMediationExtras
類別傳遞至轉接器:
SetEnableAdSound(boolean)
:指定橫幅、插頁式和獎勵廣告的預設音效啟動狀態。
以下程式碼範例說明如何建立設定這些參數的廣告要求:
using GoogleMobileAds.Api;
using GoogleMobileAds.Mediation.Line.Api;
// ...
var adRequest = new AdRequest();
var lineExtras = new LineMediationExtras();
lineExtras.SetEnableAdSound(true);
adRequest.MediationExtras.Add(lineExtras);
錯誤代碼
如果轉接程式無法從 Line 接收廣告,發布商可以使用下列類別中的 ResponseInfo
,檢查廣告回應的底層錯誤:
Android
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
iOS
GADMediationAdapterLine
當廣告無法載入時,Line 轉接程式會擲回以下代碼和隨附訊息:
Android
錯誤代碼 | 網域 | 原因 |
---|---|---|
1-10 | com.five_corp.ad | Line SDK 傳回 SDK 專屬錯誤。詳情請參閱 Line 的說明文件。 |
101 | com.google.ads.mediation.line | 缺少或無效的應用程式 ID。 |
102 | com.google.ads.mediation.line | 缺少或無效的時間表 ID。 |
103 | com.google.ads.mediation.line | 請求的廣告大小與 Line 支援的橫幅廣告大小不符。 |
104 | com.google.ads.mediation.line | 活動內容不完整,因此無法載入插頁式廣告或獎勵廣告。 |
105 | com.google.ads.mediation.line | Line SDK 無法顯示插頁式或獎勵廣告。 |
106 | com.google.ads.mediation.line | 缺少素材資源,因此無法載入原生廣告。 |
iOS
錯誤代碼 | 網域 | 原因 |
---|---|---|
1-10 | 由 Line SDK 傳送 | Line SDK 傳回 SDK 專屬錯誤。詳情請參閱 Line 的說明文件。 |
101 | com.google.ads.mediation.line | 無效的伺服器參數 (例如缺少應用程式 ID 或時段 ID)。 |
102 | com.google.ads.mediation.line | 請求的廣告大小與 Line 支援的橫幅廣告大小不符。 |
103 | com.google.ads.mediation.line | 無法在原生廣告中載入資訊圖示圖片素材資源。 |
Line Unity Mediation 外掛程式變更記錄
1.4.0 版
- 支援 Line Android 轉接器 2.8.20240827.0 版。
- 支援 Line iOS 轉接程式 2.9.20241106.1 版。
- 使用 Google 行動廣告 Unity 外掛程式 9.4.0 版進行建構及測試。
1.3.1 版
- 支援 Line Android 轉接器 2.8.20240808.0 版。
- 支援 Line iOS 轉接器 2.8.20240612.0 版。
- 使用 Google 行動廣告 Unity 外掛程式 9.2.0 版進行建構及測試。
1.3.0 版
- 支援 Line Android 轉接器 2.8.20240722.0 版。
- 支援 Line iOS 轉接器 2.8.20240612.0 版。
- 使用 Google 行動廣告 Unity 外掛程式 9.2.0 版進行建構及測試。
1.2.0 版
- 支援 Line Android 轉接程式 2.7.20240515.0 版。
- 支援 Line iOS 轉接器 2.8.20240612.0 版。
- 使用 Google 行動廣告 Unity 外掛程式 9.1.1 版建構及測試。
1.1.2 版
- 支援 Line Android 轉接程式 2.7.20240515.0 版。
- 支援 Line iOS 轉接程式 2.7.20240411.0 版。
- 使用 Google 行動廣告 Unity 外掛程式 9.1.0 版進行建構及測試。
1.1.1 版
- 支援 Line Android 轉接程式 2.7.20240214.1。
- 支援 Line iOS 轉接程式 2.7.20240411.0 版。
- 使用 Google 行動廣告 Unity 外掛程式 9.1.0 版進行建構及測試。
1.1.0 版
- 新增了
LineMediationExtras
類別,並提供下列方法,以便傳遞中介服務額外項目。SetEnabledAdSound(bool)
- 支援 Line Android 轉接程式 2.7.20240214.1。
- 支援 Line iOS 轉接器 2.7.20240318.0 版。
- 使用 Google 行動廣告 Unity 外掛程式 9.0.0 版進行建構及測試。
1.0.0 版
- 初始版本。
- 支援 Line Android 轉接程式版本 2.6.20230607.0。
- 支援 Line iOS 轉接程式 2.6.20230609.0。
- 使用 Google 行動廣告 Unity 外掛程式 8.5.1 版建構及測試。