整合行與中介服務 (Beta 版)

本指南將說明如何使用 Google Mobile Ads SDK 載入及顯示 使用「 」的第 LINE 則廣告 AdMob 中介服務， 則涵蓋刊登序列整合功能說明如何在廣告單元的 中介服務設定，以及如何將 Line SDK 和轉接程式整合至 Android 應用程式。

Line 的資訊主頁介面採用日文文字做為標籤， 按鈕和說明本指南中的螢幕截圖沒有 翻譯。在本指南的說明和操作說明中，標籤和 按鈕會翻譯為英文對應的英文版本。

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

Line 的中介服務轉接程式具有下列功能：

^{1 個} 刊登序列整合功能目前處於公開測試階段。

需求條件

• Android API 級別 21 以上

• 最新版 Google Mobile Ads SDK

• 完成中介服務 入門指南

步驟 1：在 Line UI 中進行設定

步驟 2：在使用者介面中設定 AdMob 委刊項需求

調整廣告單元中介服務設定

您需要將 Line 新增至廣告單元的中介服務設定。

首先，請登入 AdMob 帳戶。接著，前往「中介服務」分頁。如果您想修改現有的中介服務群組，請按一下中介服務群組的名稱加以編輯，然後跳到「新增為廣告來源」一節。 Line

如要建立新的中介服務群組，請選取「建立中介服務群組」。

輸入廣告格式和平台，然後按一下「繼續」。

為中介服務群組命名，然後選取要指定的地區。接著，將中介服務群組狀態設為「已啟用」，然後按一下「新增廣告單元」。

將這個中介服務群組與一或多個現有AdMob 廣告單元建立關聯。接著點選「完成」。

您現在應該會看到已填入所選廣告單元的廣告單元資訊卡：

新增 Line 做為廣告來源

在「Ad Source」部分的「Waterfall」資訊卡下方，選取「Add Ad Source」。然後選取 Line。

如果 Line已有對應關係，可以選取該對應關係。否則請按一下「新增對應」。

接著，輸入上一節取得的 Application ID and Slot ID。接著點選「完成」。

步驟 3：匯入 Line SDK 和 Adapter

整合 Android Studio (建議做法)

在應用程式層級的 build.gradle.kts 檔案中新增以下實作項目 依附元件和設定使用最新版 Line SDK 和轉接器：

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

手動整合

1. 下載最新版本的 Line SDK 的 .aar 檔案並將其新增至您的專案。

2. 前往「LineAdapter 構件」 複製到 Google 的 Maven 存放區選取最新版本，下載一行 轉接程式的 .aar 檔案，並將其新增至專案中。

步驟 4：新增必要的程式碼

行整合不需要額外程式碼。

步驟 5：測試實作成果

啟用測試廣告

請務必為 AdMob。

如需瞭解如何啟用線性測試廣告，請按照 折線圖的說明文件 。

驗證測試廣告

如要確認您正在接收來自Line的測試廣告，請使用 Line (Waterfall) 廣告來源在廣告檢查器中啟用單一廣告來源測試。

選擇性步驟

聯播網專用參數

折線轉接器支援其他可傳遞的要求參數 透過 LineExtras 類別傳送至轉接程式。此類別建構函式包括 分別是

enableAdSound

用於指定橫幅廣告預設音效起始狀態的 boolean。 插頁式廣告和獎勵廣告。

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

LineExtras lineExtras = new LineExtras(true);
Bundle extras = lineExtras.build();

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

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

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

使用原生廣告

廣告顯示

LINE 轉接器會填入以下項目 原生廣告進階欄位說明 的 NativeAd。

¹ 針對原生廣告，Line SDK 未提供應用程式圖示素材資源。不過，Line 轉接程式會填入應用程式 帶有透明圖片的圖示

錯誤代碼

如果轉接程式無法收到 Line 的廣告，您可以查看 判斷錯誤的原因 ResponseInfo.getAdapterResponses() 加入以下類別：

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

以下是 LINE 轉接器擲回的代碼和附加訊息 如果發生以下情形，則代表廣告無法載入：

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

版本 2.8.20240808.0

• 已驗證 FiveAd SDK 2.8.20240808.0 版相容性

建構及測試工具：

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

版本 2.8.20240722.0

• 已驗證 FiveAd SDK 2.8.20240722.0 版相容性

建構及測試工具：

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

版本 2.7.20240515.0

• 已驗證 FiveAd SDK 2.7.20240515.0 版相容性

建構及測試工具：

• 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.0 版的相容性。

建構及測試工具：

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

版本 2.7.20240214.0

• 已驗證 FiveAd SDK 2.7.20240214.0 版的相容性。

建構及測試工具：

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

版本 2.7.20240126.0

• 已驗證 FiveAd SDK 2.7.20240126.0 版的相容性。

建構及測試工具：

• 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 版。