本指南說明如何使用 Google Mobile Ads SDK 透過 AdMob 中介服務、瀑布流程整合,載入及顯示 Line 廣告。本指南將說明如何將 Line 新增至廣告單元的中介服務設定,以及如何將 Line SDK 和轉接程式整合至 Android 應用程式。
Line 的資訊主頁介面採用日文文字做為標籤、按鈕和說明。本指南中的螢幕截圖尚未翻譯。不過,在本指南的說明和操作說明中,標籤和按鈕會經過翻譯,並以括號註明的英文對應語言。
支援的整合和廣告格式
Line 的中介服務轉接程式具有下列功能:
整合 | |
---|---|
出價 | |
瀑布 | 1 |
格式 | |
橫幅廣告 | |
插頁式 | |
已獲得獎勵 | |
原生 |
1 瀑布整合功能目前處於公開測試階段。
需求條件
- Android API 級別 21 以上
最新版 Google Mobile Ads SDK
完成中介服務入門指南
步驟 1:在 Line UI 中進行設定
登入 Line 帳戶。
新增應用程式
依序按一下「廣告版位管理」>「媒體」。然後按一下「新規作成」。
填寫表單,然後按一下「登録」。
記下應用程式 ID。
建立廣告刊登位置
按一下要新增廣告刊登位置的應用程式 ID。接著選取「詳細」。
按一下 [スススト ONE (Add Slot)] (新增版位)。
填寫表單,完成後按一下「(登録) 註冊」。
請記下運算單元 ID。
步驟 2:在使用者介面中設定 AdMob 委刊項需求
調整廣告單元中介服務設定
您需要將 Line 新增至廣告單元的中介服務設定。
首先,請登入 AdMob 帳戶。接著,前往「中介服務」分頁。如果您想修改現有的中介服務群組,請按一下中介服務群組的名稱加以編輯,然後跳到「新增為廣告來源」一節。 Line
如要建立新的中介服務群組,請選取「建立中介服務群組」。
輸入廣告格式和平台,然後按一下「繼續」。
為中介服務群組命名,然後選取要指定的地區。接著,將中介服務群組狀態設為「已啟用」,然後按一下「新增廣告單元」。
將這個中介服務群組與一或多個現有AdMob 廣告單元建立關聯。接著點選「完成」。
您現在應該會看到已填入所選廣告單元的廣告單元資訊卡:
新增 Line 做為廣告來源
在「Ad Source」部分的「Waterfall」資訊卡下方,選取「Add Ad Source」。然後選取 Line。
選取「Line」。 接著為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.5.0")
implementation("com.google.ads.mediation:line:2.8.20240827.0")
}
手動整合
下載最新版 Line SDK 的
.aar
檔案,然後加入專案。前往 Google 的 Maven 存放區,找到Line 轉接器構件。選取最新版本,下載 Line 轉接器的
.aar
檔案,然後將其新增至專案。
步驟 4:新增必要程式碼
您不需要額外的程式碼即可整合 LINE。
步驟 5:測試實作成果
啟用測試廣告
請務必為 AdMob。
如需瞭解如何啟用線性測試廣告,請按照 折線圖的說明文件 。
驗證測試廣告
如要確認您正在接收來自Line的測試廣告,請使用 Line (Waterfall) 廣告來源在廣告檢查器中啟用單一廣告來源測試。
選擇性步驟
網路專屬參數
Line 轉接程式支援額外請求參數,可透過 LineExtras
類別傳遞至轉接程式。此類別建構函式包含下列參數:
enableAdSound
boolean
用於指定橫幅廣告、插頁式廣告和獎勵廣告的預設音效起始狀態。
以下程式碼範例說明如何建立可設定這些參數的廣告要求:
Java
LineExtras lineExtras = new LineExtras(true);
Bundle extras = lineExtras.build();
AdRequest request = new AdRequest.Builder()
.addNetworkExtrasBundle(LineMediationAdapter.class, extras)
.build();
Kotlin
val lineExtras = LineExtras(true)
val extras = lineExtras.build()
val request = AdRequest.Builder()
.addNetworkExtrasBundle(LineMediationAdapter::class.java, extras)
.build()
使用原生廣告
廣告顯示
Line 轉接器會為
NativeAd
填入下列
原生廣告進階欄位說明
。
欄位 | Line 轉接程式一律會納入的素材資源 |
---|---|
廣告標題 | |
圖片 | |
內文 | |
應用程式圖示 | 1 |
行動號召 | |
星級評等 | |
商店 | |
價格 |
1 針對原生廣告,Line SDK 不提供應用程式圖示素材資源。相反地,Line 轉接器會使用透明圖片填入應用程式圖示。
錯誤代碼
如果轉接器無法從 Line 接收廣告,您可以使用
ResponseInfo.getAdapterResponses()
在下列類別下檢查廣告回應的基礎錯誤:
com.line.ads
com.google.ads.mediation.line.LineMediationAdapter
以下是廣告無法載入時,Line 轉接程式擲回的代碼和隨附訊息:
錯誤代碼 | 網域 | 原因 |
---|---|---|
1-10 | com.five_corp.ad | Line SDK 傳回 SDK 專屬錯誤。詳情請參閱 Line 的說明文件。 |
101 | com.google.ads.mediation.line | 應用程式 ID 遺失或無效。 |
102 | com.google.ads.mediation.line | 缺少或無效的時間段 ID。 |
103 | com.google.ads.mediation.line | 要求的廣告大小與支援行的橫幅廣告大小不符。 |
104 | com.google.ads.mediation.line | 活動內容不完整,因此無法載入插頁式廣告或獎勵廣告。 |
105 | com.google.ads.mediation.line | Line SDK 無法顯示插頁式廣告或獎勵廣告。 |
106 | com.google.ads.mediation.line | 缺少素材資源,因此無法載入原生廣告。 |
LINE Android 中介服務轉接程式變更記錄
下一個版本
- 導入 AdLoader,為橫幅廣告啟用即時出價功能。
- 導入 AdLoader,啟用插頁式廣告的即時出價功能。
- 導入 AdLoader,為獎勵廣告啟用即時出價。
2.8.20240827.0 版
- 已驗證 FiveAd SDK 2.8.20240827.0 版相容性
建構及測試環境:
- Google Mobile Ads SDK 23.3.0 版。
- FiveAd SDK 版本 2.8.20240827.0
版本 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。