整合 LY Ads Network 與中介服務

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

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

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

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

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

必要條件

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

  • 最新 Google Mobile Ads Flutter Plugin 版本。
  • Flutter 架構 3.7.0 以上版本。
  • 如要在 Android 上部署
    • Android API 級別 24 以上版本。
  • 如要在 iOS 上部署
    • iOS 部署目標為 13.0 以上版本。
  • 已設定 Google Mobile Ads Flutter Plugin 的有效 Flutter 專案。詳情請參閱「設定 Google Mobile Ads Flutter Plugin」。
  • 設定中介服務。

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

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

    新增應用程式

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

    新的註冊項目

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

    新註冊表單

    記下應用程式 ID。

    Android

    註冊詳細資料

    iOS

    註冊詳細資料

    建立廣告版位

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

    新增版位

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

    新增運算單元表單

    記下版位 ID。

    運算單元詳細資料

    建立第一個版位後，請在應用程式詳細資料頁面上按一下「Review」，取得 LY 廣告聯播網的核准。請稍候。如有任何疑問，請洽詢 LY Ads Network 代表。

    提出審查申請

    建立 Reporting API 金鑰

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

    「Reporting API Key」分頁

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

    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 廣告聯播網 SDK 和轉接程式

    透過 pub.dev 整合

    在套件的 pubspec.yaml 檔案，新增下列依附元件和最新版本的 LY 廣告聯播網 SDK 與轉接程式：

    dependencies:
  gma_mediation_line: ^2.2.1

    手動整合

    下載適用於 LY 廣告聯播網 的最新版本 Google Mobile Ads 中介服務外掛程式，解壓縮下載的檔案，並將解壓縮的外掛程式資料夾及其內容新增至 Flutter 專案。接著，在 pubspec.yaml 檔案新增下列依附元件，以參照外掛程式：

    dependencies:
  gma_mediation_line:
    path: path/to/local/package

    步驟 4：新增必要程式碼

    Android

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

    iOS

    整合 SKAdNetwork

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

    步驟 5：測試導入成果

    啟用測試廣告

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

    驗證測試廣告

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

    選擇性步驟

    聯播網專屬參數

    LY 廣告聯播網 Flutter 中介服務外掛程式支援下列額外請求參數，可透過 LineMediationExtras 類別傳遞至轉接程式：

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

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

    LineMediationExtras lineExtras = LineMediationExtras(enableAdSound: true)

AdRequest request = AdRequest(
    keywords: <String>['foo', 'bar'],
    contentUrl: 'http://foo.com/bar.html',
    mediationExtras: [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，或是 ID 無效。
    102 com.google.ads.mediation.line 缺少版位 ID，或是 ID 無效。
    103 com.google.ads.mediation.line 請求的廣告大小不符合 LY Ads Network 支援的橫幅廣告大小。
    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 廣告載入器。

    Line Flutter 中介服務轉接程式變更記錄

    2.2.2 版 (開發中)

    • 現在最低須使用 iOS 15.0 版。

    2.2.1 版本

    2.2.0 版

    2.1.3 版

    2.1.2 版

    2.1.1 版

    2.1.0 版

    2.0.0 版

    1.0.6 版

    1.0.5 版

    1.0.4 版本

    1.0.3 版本

    1.0.2 版

    1.0.1 版

    1.0.0 版