將 LY 廣告聯播網與 AdMob 中介服務整合

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

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

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

整合
出價
刊登序列
格式
開啟應用程式
橫幅廣告
插頁式廣告
獎勵廣告
插頁式獎勵廣告
原生

必要條件

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

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

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

新增應用程式

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

新的註冊項目

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

新註冊表單

記下應用程式 ID。

Android

註冊詳細資料

iOS

註冊詳細資料

建立廣告版位

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

新增版位

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

新增版位表單

記下版位 ID。

運算單元詳細資料

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

提出審查申請

建立 Reporting API 金鑰

前往「Managing reporting API 金鑰」分頁，然後點選「Create 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 檔案。 如果還未設定應用程式的 app-ads.txt 檔案，請先完成相關作業。

如要為 LY Ads Network 導入 app-ads.txt，請參閱「關於 app-ads.txt」一文。

步驟 2：在 AdMob UI 中設定 LY Ads Network 需求

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

Android

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

iOS

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

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

在專案的根目錄中，安裝 LY 廣告聯播網的 Google Mobile Ads SDK for React Native 中介服務轉接程式。完成下列步驟：

  1. 將 Google Mobile Ads SDK for React Native 轉接程式 tar 檔案從 gma-sdk-react-native/adapters/line/ 目錄複製到專案的 local_packages/ 目錄。如果沒有 adapters 資料夾，請參閱「必要條件」。

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/line/gma-mediation-line-0.1.0.tgz local_packages/

    將 EXTRACT_DIR 替換為您擷取封存檔的目錄路徑。

  2. 使用偏好的套件管理工具安裝轉接程式套件：

    npm

    npm install ./local_packages/gma-mediation-line-0.1.0.tgz

    紗線

    yarn add ./local_packages/gma-mediation-line-0.1.0.tgz

步驟 4：新增必要程式碼

Android

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

iOS

整合 SKAdNetwork

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

步驟 5：測試導入成果

啟用測試廣告

請務必註冊 AdMob 測試裝置。

驗證測試廣告

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

選擇性步驟

聯播網專屬參數

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

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

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

import { LineMediationExtras } from '@google/gma-mediation-line';

const request = {
  // ...
  mediationExtras: [
    new LineMediationExtras({
      enableAdSound: true,
    }),
  ],
};

錯誤代碼

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

Android

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

iOS

GADMediationAdapterLine

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

Android

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

0.1.0 版

  • 第 1 版。