Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

整合 LY Ads Network 與中介服務

選取平台： Android iOS Unity Flutter Android (舊版)

本指南說明如何使用 Google Mobile Ads Unity Plugin，透過中介服務載入及顯示 LY Ads Network 廣告，也會介紹如何整合刊登序列功能。內容涵蓋如何將 LY Ads Network 廣告聯播網新增至廣告單元的中介服務設定，以及如何將 LY Ads Network SDK 和轉接程式整合至 Unity 應用程式。

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

LY Ads Network 的 Ad Manager 中介服務轉接程式具備下列功能：

整合
出價
刊登序列
格式
橫幅廣告
插頁式廣告
已獲得獎勵

必要條件

繼續操作前，請確認下列事項：

最新 Google Mobile Ads Unity Plugin 版本。
Unity 編輯器 4 以上版本。
[出價]：如要整合出價功能支援的所有廣告格式，請使用 LY Ads Network 1.5.0 以上版本的 Google Mobile Ads 中介服務外掛程式 (建議使用最新版本)。
如要在 Android 上部署
- Android API 級別 24 以上版本。
如要在 iOS 上部署
- 部署目標為 iOS 13.0 以上版本。
已設定 Google Mobile Ads Unity Plugin 的有效 Unity 專案。詳情請參閱「設定 Google Mobile Ads Unity Plugin」。

設定中介服務。

步驟 1：在 LY Ads Network 廣告聯播網使用者介面完成所需設定

註冊並登入 LY 廣告聯播網帳戶。

新增應用程式

前往「App」分頁，然後點選「New registration」按鈕。

新的註冊項目

填寫表單，然後按一下「註冊」。

新註冊表單

記下應用程式 ID。

Android

註冊詳細資料

iOS

註冊詳細資料

建立廣告版位

在「應用程式」分頁中選取應用程式，即可查看應用程式詳細資料。在「Slot」(運算單元) 區段下方，按一下「Add」(新增)。

新增版位

填寫表單，提供時段詳細資料。在「出價類型」中，選取「標準」，為刊登序列中介服務設定這個廣告空間；選取「Google SDK 出價」，為出價設定這個廣告空間。填妥表單後，按一下「建立」。

新增版位表單

記下「Slot ID」(廣告空間 ID)。

運算單元詳細資料

建立第一個時段後，請在應用程式的詳細資料頁面點按「查看」，向 LY 廣告聯播網申請核准。請稍候。如有任何疑問，請洽詢 LY Ads Network 代表。

提出審查申請

建立 Reporting API 金鑰

前往「管理報表 API 金鑰」分頁，然後點選「建立 API 金鑰」按鈕。

「Reporting API Key」分頁

填寫表單，然後按一下「Save」。

Reporting API 金鑰表單

記下 API 金鑰 ID 和 API 金鑰密鑰。

Reporting API 金鑰表單

更新 app-ads.txt

Authorized Sellers for Apps (app-ads.txt) 是美國互動廣告協會科技實驗室 (IAB Tech Lab) 的一項計畫，旨在確保您的應用程式廣告空間僅於您授權的管道出售。為避免廣告收益大幅減少，請務必導入 app-ads.txt 檔案。如果尚未建立，請為 Ad Manager 建立 app-ads.txt 檔案。

如要為 LY 廣告聯播網導入 app-ads.txt，請參閱「關於 app-ads.txt」一文。

步驟 2：在 Ad Manager 使用者介面設定 LY Ads Network 需求

進行廣告單元的中介服務設定

Android

如需操作說明，請參閱 Android 指南中的步驟 2。

iOS

如需操作說明，請參閱 iOS 指南中的步驟 2。

步驟 3：匯入 LY Ads Network SDK 和轉接程式

OpenUPM-CLI

如果已安裝 OpenUPM-CLI，請在專案的根目錄執行下列指令，將 Google Mobile Ads LY 廣告聯播網中介服務 Plugin for Unity 安裝至專案：

openupm add com.google.ads.mobile.mediation.line

OpenUPM

在 Unity 專案編輯器中，依序選取「Edit」 >「專案設定」 >「Package Manager」，開啟「Unity Package Manager Settings」。

在「Scoped Registries」分頁中，將 OpenUPM 新增為指定範圍套件來源，並提供下列詳細資料：

名稱：OpenUPM
網址：https://package.openupm.com
範圍：com.google

OpenUPM 詳細資料

接著，依序前往「Window」 >「Package Manager」，開啟 Unity Package Manager，然後從下拉式選單中選取「My Registries」。

Unity 登錄檔

選取「Google Mobile Ads Line Mediation」套件，然後按一下「Install」。

從 OpenUPM 安裝

Unity 套件

前往變更記錄，找到 LY 廣告聯播網適用的最新版本 Google 行動廣告中介服務外掛程式下載連結，並從 ZIP 檔案解壓縮 GoogleMobileAdsLineMediation.unitypackage。

在 Unity 專案編輯器中，依序選取「Assets」 >「Import Package」 >「Custom Package」，然後找出下載的 GoogleMobileAdsLineMediation.unitypackage 檔案。確認已選取所有檔案，然後按一下「匯入」。

從 Unity 匯入

接著，依序選取「Assets」 >「External Dependency Manager」 >「Android Resolver」 >「Force Resolve」。External Dependency Manager 程式庫會從頭開始解析依附元件，並將宣告的依附元件複製到 Unity 應用程式的 Assets/Plugins/Android 目錄。

強制解決

步驟 4：新增必要程式碼

Android

整合 LY 廣告聯播網不需要額外程式碼。

iOS

整合 SKAdNetwork

請按照 LY 廣告聯播網的說明文件，將 SKAdNetwork ID 新增至專案的 Info.plist 檔案。

步驟 5：測試導入成果

啟用測試廣告

請務必為 Ad Manager 註冊測試裝置。

驗證測試廣告

如要確認您可收到 LY Ads Network 的測試廣告，請在廣告檢查器中啟用單一廣告來源測試，並將廣告來源設為「LY Ads Network」。

選擇性步驟

聯播網專屬參數

LY 廣告聯播網 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);

錯誤代碼

如果轉接程式無法從 LY Ads Network 接收廣告，發布商可以使用下列類別的 ResponseInfo，檢查廣告回應中的根本錯誤：

Android

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

iOS

GADMediationAdapterLine

以下是廣告無法載入時，LY 廣告聯播網轉接程式擲回的代碼和對應訊息：

Android

錯誤代碼	網域	原因
1-10	com.five_corp.ad	LY 廣告聯播網 SDK 傳回與 SDK 相關的錯誤。詳情請參閱 LY Ads Network 的說明文件。
101	com.google.ads.mediation.line	應用程式 ID 遺漏或無效。
102	com.google.ads.mediation.line	缺少版位 ID，或是 ID 無效。
103	com.google.ads.mediation.line	請求的廣告大小不符合 LY 廣告聯播網支援的橫幅廣告大小。
104	com.google.ads.mediation.line	缺少活動背景資訊，因此無法載入插頁式或獎勵廣告。
105	com.google.ads.mediation.line	LY Ads 廣告聯播網 SDK 無法顯示插頁式或獎勵廣告。
106	com.google.ads.mediation.line	缺少資產，因此無法載入原生廣告。
107	com.google.ads.mediation.line	FiveAd SDK 傳回空值廣告載入器。

iOS

錯誤代碼	網域	原因
1-10	由 LY 廣告聯播網 SDK 傳送	LY 廣告聯播網 SDK 傳回 SDK 專屬錯誤，詳情請參閱 LY Ads Network 的說明文件。
101	com.google.ads.mediation.line	伺服器參數無效 (例如缺少應用程式 ID 或版位 ID)。
102	com.google.ads.mediation.line	請求的廣告大小不符合 LY Ads Network 支援的橫幅廣告大小。
103	com.google.ads.mediation.line	無法載入原生廣告中的資訊圖示圖片素材資源。
104	com.google.ads.mediation.line	無法收集出價信號。
105	com.google.ads.mediation.line	無法初始化 LINE Ads SDK 廣告載入器。