本指南將說明如何使用 Google Mobile Ads SDK,利用中介服務載入及顯示 LINE 上刊登的廣告 (涵蓋刊登序列整合)。說明如何在廣告單元的中介服務設定中加入 Line,以及如何將 Line SDK 和轉接程式整合至 Unity 應用程式。
支援的整合項目和廣告格式
路線的 AdMob 中介服務轉接程式具備下列功能:
整合項目 | |
---|---|
出價 | |
瀑布 | 1 |
格式 | |
橫幅廣告 | |
插頁式 | |
已獲得獎勵 |
1 刊登序列整合功能目前處於公開測試階段。
需求條件
- Unity 4 以上版本
- 最新版 Google Mobile Ads SDK
- 如何在 Android 上部署
- Android API 級別 21 以上
- 如何在 iOS 上部署
- iOS 部署目標為 12.0 以上版本
- 使用 Google Mobile Ads SDK 設定的有效 Unity 專案。詳情請參閱「開始使用」一文。
- 完成中介服務入門指南
步驟 1:在 Line UI 中進行設定
登入你的 Line 帳戶。
新增應用程式
依序點選「広管理 (廣告版位管理)」 >「不合格」 (媒體)。然後點選「newugugiationx (Create New)」。
填寫表單,然後按一下「登入」。
記下應用程式 ID。
建立廣告刊登位置
按一下要新增廣告刊登位置的應用程式 ID。然後選取「Alternative (Detail)」。
按一下「スススト 」、「Add Slot)」。
填妥表單,完成後按一下「(登入分頁符號) 註冊」。
記下運算單元 ID。
步驟 2:在使用者介面中設定 AdMob 委刊項需求
調整廣告單元中介服務設定
步驟 3:匯入 Line SDK 和轉接程式
從 Changelog (變更記錄) 下載連結下載適用於 Line 的最新版 Google 行動廣告中介服務外掛程式,並從 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
行整合不需要額外程式碼。
iOS
SKAdNetwork 整合
按照 Line 說明文件,將 SKAdNetwork ID 新增至專案的 Info.plist
檔案。
步驟 5:測試實作成果
啟用測試廣告
請務必為 AdMob。
如需瞭解如何啟用線性測試廣告,請按照 線條的 Android 和 iOS 說明文件 。
驗證測試廣告
如要確認您正在接收來自Line的測試廣告,請使用 Line (Waterfall) 廣告來源在廣告檢查器中啟用單一廣告來源測試。
選擇性步驟
聯播網專用參數
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 | 要求的廣告大小與支援行的橫幅廣告大小不符。 |
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 | 要求的廣告大小與支援行的橫幅廣告大小不符。 |
103 | com.google.ads.mediation.line | 無法載入原生廣告中的資訊圖示圖片素材資源。 |
Line Unity 中介服務外掛程式變更記錄
1.2.0 版
- 支援 Line Android Adapter 2.7.20240515.0。
- 支援 Line iOS Adapter 2.8.20240612.0。
- 使用 Google 行動廣告 Unity 外掛程式 9.1.1 版建立並測試。
1.1.2 版
- 支援 Line Android Adapter 2.7.20240515.0。
- 支援 Line iOS Adapter 2.7.20240411.0。
- 使用 Google 行動廣告 Unity 外掛程式 9.1.0 版建立並測試。
1.1.1 版
- 支援 Line Android 轉接器 2.7.20240214.1 版。
- 支援 Line iOS Adapter 2.7.20240411.0。
- 使用 Google 行動廣告 Unity 外掛程式 9.1.0 版建立並測試。
1.1.0 版
- 使用下列方法新增
LineMediationExtras
類別,支援傳遞中介服務額外項目。SetEnabledAdSound(bool)
- 支援 Line Android 轉接器 2.7.20240214.1 版。
- 支援 Line iOS Adapter 2.7.20240318.0。
- 使用 Google 行動廣告 Unity 外掛程式 9.0.0 版建立並測試。
1.0.0 版
- 初始版本。
- 支援 Line Android Adapter 2.6.20230607.0。
- 支援 Line iOS Adapter 2.6.20230609.0。
- 使用 Google 行動廣告 Unity 外掛程式 8.5.1 版建立並測試。