整合 LY Ads Network 與中介服務

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

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

LY 廣告聯播網的中介服務轉接程式具備下列功能：

必要條件

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

• Android API 級別 24 以上。

• 最新 Google Mobile Ads SDK (Legacy) 版本。

• 設定中介服務。

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

註冊並登入 LY Ads Network 帳戶。

新增應用程式

前往「應用程式」分頁，然後點選「新增註冊」按鈕。

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

記下應用程式 ID。

建立廣告版位

在「應用程式」分頁中選取應用程式，即可查看應用程式詳細資料。在「位置」部分下方，按一下「新增」。

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

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

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

建立 Reporting API 金鑰

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

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

記下 API 金鑰 ID 和 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 需求

登入 Ad Manager 帳戶。

在「公司」中新增 LY Ads Network

啟用安全信號共用

透過出價要求共用安全信號

允許 SDK 出價共用安全信號

設定 LY Ads 廣告聯播網出價

設定廣告單元對應

步驟 3：匯入 LY 廣告聯播網 SDK 和轉接程式

整合 Android Studio (建議)

在應用程式層級的 Gradle 檔案中，新增下列導入依附元件：

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.5.0")
    implementation("com.google.ads.mediation:line:3.1.1.2")
}

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.google.ads.mediation:line:3.1.1.2'
}

手動整合

1. 下載最新版本 LY 廣告聯播網 SDK 的 .aar 檔案，並新增至專案。

2. 前往 Google 的 Maven 存放區，找到 LY 廣告聯播網轉接程式構件。選取最新版本，下載 LY Ads Network 轉接程式的 .aar 檔案並新增至專案。

步驟 4：新增必要程式碼

整合 LY Ads Network 不需要額外程式碼。

步驟 5：測試導入成果

啟用測試廣告

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

LY 廣告聯播網轉接程式包含輔助方法，可為 LY 廣告聯播網啟用測試模式。請先設定這個選項，再初始化 Google Mobile Ads SDK (Legacy)，確保資料能正確轉送至 LY 廣告聯播網 SDK。

LineMediationAdapter.Companion.setTestMode(true);
LineMediationSnippets.java

LineMediationAdapter.setTestMode(true)
LineMediationSnippets.kt

驗證測試廣告

如要確認您是否收到 LY 廣告聯播網 的測試廣告，請使用「LY 廣告聯播網」廣告來源，在廣告檢查器中啟用單一廣告來源測試。

選擇性步驟

聯播網專屬參數

LY Ads Network 轉接程式支援額外的要求參數，可使用 LineExtras 類別傳遞至轉接程式。這個類別建構函式包含下列參數：

enableAdSound

boolean：指定橫幅、插頁式和獎勵廣告的預設音效啟動狀態。

以下程式碼範例說明如何建立廣告請求並設定這些參數：

LineExtras lineExtras = new LineExtras(/* enableAdSound: */ true);
Bundle extras = lineExtras.build();

AdRequest request =
    new AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter.class, extras).build();
LineMediationSnippets.java

val lineExtras = LineExtras(enableAdSound = true)
val extras = lineExtras.build()

val request =
  AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter::class.java, extras).build()
LineMediationSnippets.kt

使用原生廣告

廣告顯示

LY Ads Network 轉接程式會填入 NativeAd 的下列欄位資料。

¹ 如果是原生廣告，LY Ads Network SDK 不會提供應用程式圖示素材資源。而是 LY 廣告聯播網轉接程式會將應用程式圖示填入透明圖片。

錯誤代碼

如果轉接程式無法從 LY 廣告聯播網接收廣告，您可以使用下列類別的 ResponseInfo.getAdapterResponses()，檢查廣告回應中的根本錯誤：

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

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

LINE Android 中介服務轉接程式變更記錄

3.1.1.2 版

• 將轉接程式的 Kotlin 依附元件固定為 1.9.0 (GMA NextGen SDK 支援的最低 Kotlin 版本)。

建構及測試時使用的版本：

• Google Mobile Ads SDK 25.4.0 版。
• Google Mobile Ads Next-Gen SDK 1.4.0 版。
• FiveAd SDK 3.1.1.1 版。

3.1.1.1 版

• 對應至 Line 的 ChildDirectedTreatment API：AgeRestrictedTreatment。

建構及測試時使用的版本：

• Google Mobile Ads SDK 25.4.0 版。
• Google Mobile Ads Next-Gen SDK 1.2.1 版。
• FiveAd SDK 3.1.1.1 版。

3.1.1.0 版

• 已驗證與 FiveAd SDK 3.1.1.0 版相容。

建構及測試時使用的版本：

• Google Mobile Ads SDK 25.2.0 版。
• Google Mobile Ads Next-Gen SDK 1.2.1 版。
• FiveAd SDK 3.1.1.0 版。

3.1.0.0 版

• 新增屬性，用於建構具有 GMA Next-Gen SDK 依附元件的轉接程式。
• 驗證與 FiveAd SDK 3.1.0.0 版相容。

建構及測試時使用的版本：

• Google Mobile Ads SDK 25.1.0 版。
• Google Mobile Ads Next-Gen SDK 0.25.0-beta01 版。
• FiveAd SDK 3.1.0.0 版。

3.0.1.2 版

建構及測試時使用的版本：

• Google Mobile Ads SDK 25.1.0 版。
• FiveAd SDK 3.0.1.2 版。

3.0.1.1 版

• 使用 Google Mobile Ads SDK 24.4.0 以上版本時，原生廣告曝光次數現在會遭到 FiveAd SDK 覆寫。

建構及測試時使用的版本：

• Google Mobile Ads SDK 24.9.0 版。
• FiveAd SDK 3.0.1.1 版。

3.0.1.0 版

• 新增支援功能：將 tagForUnderAgeOfConsent Google Mobile Ads SDK 參數轉送至 FiveAd SDK。
• 已驗證與 FiveAd SDK 3.0.1.0 版相容。

建構及測試時使用的版本：

• Google Mobile Ads SDK 24.9.0 版。
• FiveAd SDK 3.0.1.0 版。

3.0.0.0 版

• 已驗證與 FiveAd SDK 3.0.0.0 版相容。

建構及測試時使用的版本：

• Google Mobile Ads SDK 24.9.0 版。
• FiveAd SDK 3.0.0.0 版。

2.9.20251028.0 版

• 已驗證與 FiveAd SDK 2.9.20251028 版相容。

建構及測試時使用的版本：

• Google Mobile Ads SDK 24.7.0 版。
• FiveAd SDK 2.9.20251028.0 版

2.9.20250924.1 版

• 移除 Context 的類別層級參照。有助於減少記憶體流失問題。

建構及測試時使用的版本：

• Google Mobile Ads SDK 24.7.0 版。
• FiveAd SDK 2.9.20250924.1 版。

2.9.20250924.0 版

• 已驗證與 FiveAd SDK 2.9.20250924 版相容。

建構及測試時使用的版本：

• Google Mobile Ads SDK 24.6.0 版。
• FiveAd SDK 2.9.20250924.0 版

2.9.20250718.0 版

• 已驗證與 FiveAd SDK 2.9.20250718 版相容。

建構及測試時使用的版本：

• Google Mobile Ads SDK 24.3.0 版。
• FiveAd SDK 2.9.20250718.0 版。

2.9.20250519.0 版

• 已驗證與 FiveAd SDK 2.9.20250519 版相容。

建構及測試時使用的版本：

• Google Mobile Ads SDK 24.3.0 版。
• FiveAd SDK 2.9.20250519.0 版。

2.9.20250317.1 版

• 修正新版 FiveAd API 的出價廣告橫幅載入尺寸。

建構及測試時使用的版本：

• Google Mobile Ads SDK 24.1.0 版。
• FiveAd SDK 2.9.20250317.0 版

2.9.20250317.0 版

• 已驗證與 FiveAd SDK 2.9.20250317 版相容。

建構及測試時使用的版本：

• Google Mobile Ads SDK 24.1.0 版。
• FiveAd SDK 2.9.20250317.0 版

2.9.20250110.1 版

• Android 的 API 最低需求級別更新為 23。
• Google Mobile Ads SDK 最低需求版本更新為 24.0.0。

建構及測試時使用的版本：

• Google Mobile Ads SDK 24.0.0 版。
• FiveAd SDK 2.9.20250110.0 版

2.9.20250110.0 版

• 已移除已淘汰的 UnifiedNativeAdMapper 類別，改用 NativeAdMapper
• 修正信號收集程序。
• 修正刊登序列插頁式和獎勵廣告格式的初始化程序。
• 已驗證與 FiveAd SDK 2.9.20250110 版相容。

建構及測試時使用的版本：

• Google Mobile Ads SDK 23.6.0 版。
• FiveAd SDK 2.9.20250110.0 版

2.9.20241129.0 版

• 新增對橫幅、插頁式、獎勵和原生廣告格式的出價支援。
• 已驗證與 FiveAd SDK 2.9.20241129 版相容。

建構及測試時使用的版本：

• Google Mobile Ads SDK 23.5.0 版。
• FiveAd SDK 2.9.20241129.0 版

2.8.20240827.0 版

• 已驗證與 FiveAd SDK 2.8.20240827 版相容。

建構及測試時使用的版本：

• Google Mobile Ads SDK 23.3.0 版。
• FiveAd SDK 2.8.20240827.0 版

2.8.20240808.0 版

• 已驗證與 FiveAd SDK 2.8.20240808 版相容。

建構及測試時使用的版本：

• Google Mobile Ads SDK 23.2.0 版。
• FiveAd SDK 2.8.20240808.0 版

2.8.20240722.0 版

• 已驗證與 FiveAd SDK 2.8.20240722 版相容。

建構及測試時使用的版本：

• Google Mobile Ads SDK 23.2.0 版。
• FiveAd SDK 2.8.20240722.0 版

2.7.20240515.0 版

• 已驗證與 FiveAd SDK 2.7.20240515 版相容。

建構及測試時使用的版本：

• Google Mobile Ads SDK 23.1.0 版。
• FiveAd SDK 2.7.20240515.0 版

2.7.20240214.1 版

• Google Mobile Ads SDK 最低需求版本更新為 23.0.0。
• 已驗證與 FiveAd SDK 2.7.20240214 版相容。

建構及測試時使用的版本：

• Google Mobile Ads SDK 23.0.0 版。
• FiveAd SDK 2.7.20240214.0 版。

2.7.20240214.0 版

• 已驗證與 FiveAd SDK 2.7.20240214 版相容。

建構及測試時使用的版本：

• Google Mobile Ads SDK 22.6.0 版。
• FiveAd SDK 2.7.20240214.0 版。

2.7.20240126.0 版

• 已驗證與 FiveAd SDK 2.7.20240126 版相容。

建構及測試時使用的版本：

• Google Mobile Ads SDK 22.6.0 版。
• FiveAd SDK 2.7.20240126.0 版。

2.7.20240112.0 版

• 移除已淘汰的 FiveAdViewEventListener，改用 FiveAdCustomLayoutEventListener、FiveAdVideoRewardEventListener、FiveAdInterstitialEventListener 和 FiveAdNativeEventListener。
• 已驗證與 FiveAd SDK 2.7.20240112 版相容。
• Google Mobile Ads SDK 最低需求版本更新為 22.6.0。

建構及測試時使用的版本：

• Google Mobile Ads SDK 22.6.0 版。
• FiveAd SDK 2.7.20240112 版。

2.6.20230607.1 版

• 新增 LineExtras 類別，供發布商定義橫幅、插頁式和獎勵廣告格式的預設音效設定。
• Google Mobile Ads SDK 最低需求版本更新為 22.4.0。

建構及測試時使用的版本：

• Google Mobile Ads SDK 22.4.0 版。
• FiveAd SDK 2.6.20230607 版。

2.6.20230607.0 版

• 第 1 版。
• 支援橫幅、插頁式、獎勵和原生廣告格式。
• 已驗證與 FiveAd SDK 2.6.20230607 版相容。

建構及測試時使用的版本：

• Google Mobile Ads SDK 22.1.0 版。
• FiveAd SDK 2.6.20230607 版。