如要討論產品並提供意見，請加入 Google 廣告與評估社群伺服器中的官方 AdMob Discord 頻道。

本頁面由 Cloud Translation API 翻譯而成。

將 AppLovin 與中介服務整合

本指南說明如何使用 Google Mobile Ads SDK，透過中介服務載入及顯示 AppLovin 廣告，涵蓋出價和瀑布流整合。本文說明如何將 AppLovin 新增至廣告單元的中介服務設定，以及如何將 AppLovin SDK 和轉接程式整合至 Unity 應用程式。

支援的整合功能和廣告格式

AppLovin 適用的 AdMob 中介服務轉接程式具備下列功能：

整合
出價
瀑布
格式
橫幅廣告	¹
插頁式
已獲得獎勵

¹ 瀑布流僅支援 320x50 和 728x90 橫幅廣告大小。出價不支援橫幅廣告。

需求條件

最新版 Google Mobile Ads SDK
Unity 5.6 以上版本
[出價]：如要整合出價功能支援的所有廣告格式，請使用 Google 行動廣告中介服務外掛程式 (適用於 AppLovin) 4.2.0 以上版本 (建議使用最新版本)。
如要在 Android 裝置上部署，請按照下列步驟操作：
- Android API 級別 23 以上
如要在 iOS 裝置上部署，請按照下列步驟操作：
- iOS 部署目標為 12.0 以上版本
已設定 Google Mobile Ads SDK 的正常運作 Unity 專案。詳情請參閱「開始使用」一文。
完成中介服務入門指南

步驟 1：在 AppLovin 使用者介面中設定

註冊或登入 AppLovin 帳戶。

如要設定 AdMob 廣告單元，您需要 AppLovin SDK 金鑰和報表金鑰。如要查看這些值，請依序前往 AppLovin 使用者介面 >「帳戶」 >「金鑰」。

如果只打算整合出價，請繼續設定中介服務。

選取要進行中介服務的應用程式

出價

出價整合功能不需要執行這個步驟。

瀑布

在 AppLovin 使用者介面中，選取「Monetization」部分下方的「Applications」，即可前往已註冊的應用程式。從可用應用程式清單中，選取要搭配中介服務使用的應用程式。

建立區域

出價

出價整合功能不需要執行這個步驟。

瀑布

在 AppLovin 使用者介面中，選取「Monetization」(營利) 部分下方的「Zones」(區域)，即可查看已註冊的區域 ID。如果您已為應用程式建立必要區域，請跳到步驟 2。如要建立新的區域 ID，請按一下「建立區域」。

輸入「區域 ID」名稱，選取「Android」做為「平台」，然後選擇「廣告類型」。

選取「固定千次曝光出價」或「由 AppLovin 進行最佳化」，為區域設定「定價」。您可以為「固定千次曝光出價」選項，按國家/地區設定千次曝光出價。然後按一下「儲存」。

Android

iOS

建立區域後，區域 ID 會顯示在「區域 ID」欄中。

Android

iOS

更新 app-ads.txt

Authorized Sellers for Apps (簡稱 app-ads.txt) 是美國互動廣告協會科技實驗室 (IAB Tech Lab) 主持的一項計畫，旨在確保您的應用程式廣告空間只透過獲得您授權的管道出售。為避免廣告收益大幅減少，您必須導入 app-ads.txt 檔案。如果您尚未設定，請為應用程式設定 app-ads.txt 檔案。

如要為 AppLovin 導入 app-ads.txt，請將 AppLovin 新增至 app-ads.txt 檔案。

開啟測試模式

請按照 AppLovin 的「MAX 測試模式」指南操作，啟用 AppLovin 測試廣告。

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

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

Android

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

iOS

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

將 AppLovin Corp. 新增至 GDPR 和美國州級法規廣告合作夥伴名單

請按照「歐洲法規設定」和「美國州級法規設定」一文的步驟，在 AdMob 使用者介面中，將 Applovin Corp. 新增至歐洲和美國州級法規廣告合作夥伴名單。

步驟 3：匯入 AppLovin SDK 和轉接程式

OpenUPM-CLI

如果您已安裝 OpenUPM-CLI，可以從專案的根目錄執行下列指令，將 Google Mobile Ads Applovin 中介服務外掛程式安裝至 Unity 專案：

openupm add com.google.ads.mobile.mediation.applovin

OpenUPM

在 Unity 專案編輯器中，依序選取「Edit」 >「Project Settings」 >「Package Manager」，開啟「Unity Package Manager Settings」。

在「Scoped Registries」(範圍註冊表) 分頁中，新增 OpenUPM 做為範圍註冊表，並提供下列詳細資料：

名稱：OpenUPM
網址：https://package.openupm.com
範圍：com.google

OpenUPM 詳細資料

接著，依序前往「Window」 >「Package Manager」開啟 Unity Package Manager，然後從下拉式選單中選取「My Registries」。

Unity 登錄檔

選取「Google Mobile Ads Applovin Mediation」套件，然後按一下「Install」。

從 OpenUPM 安裝

Unity 套件

前往變更記錄中的下載連結，下載最新版適用於 Applovin 的 Google 行動廣告中介服務外掛程式，然後從 zip 檔案中解壓縮 GoogleMobileAdsApplovinMediation.unitypackage。

在 Unity 專案編輯器中，依序選取「Assets」 >「Import Package」 >「Custom Package」，然後找出下載的 GoogleMobileAdsApplovinMediation.unitypackage 檔案。確認已選取所有檔案，然後按一下「匯入」。

從 Unity 匯入

然後依序選取「Assets」 >「External Dependency Manager」 >「Android Resolver」 >「Force Resolve」。External Dependency Manager 程式庫會從頭執行依附元件解析作業，並將宣告的依附元件複製到 Unity 應用程式的 Assets/Plugins/Android 目錄。

強制解決

步驟 4：在 AppLovin SDK 中導入隱私權設定

歐盟地區同意授權和 GDPR

根據 Google《歐盟地區使用者同意授權政策》，您必須確保向歐洲經濟區境內使用者揭露裝置 ID 和個人資料的使用方式，並徵得同意聲明。本政策是配合《歐盟地區電子通訊隱私指令》和《一般資料保護規則》(GDPR) 而制定。徵求同意聲明時，您必須指明中介服務鏈中可能會收集、接收或使用個人資料的每個廣告聯播網，並提供各聯播網的使用方式資訊。Google 目前無法自動將使用者的同意聲明選項傳送給這類聯播網。

自 Google Mobile Ads 中介服務外掛程式 7.0.0 版起，AppLovin 支援從共用偏好設定讀取同意聲明字串，並據此設定同意聲明狀態。

如果您未使用 Google Mobile Ads 中介服務外掛程式 (適用於 Applovin 7.0.0 以上版本)，或未使用將同意聲明字串寫入共用偏好的 CMP，則可使用 AppLovin.SetHasUserConsent() 和 AppLovin.SetIsAgeRestrictedUser() 方法。下列程式碼範例說明如何將同意聲明資訊傳遞至 AppLovin SDK。您必須在初始化 Google Mobile Ads SDK 之前設定這些選項，確保系統能將這些選項正確轉送至 AppLovin SDK。

using GoogleMobileAds.Api.Mediation.AppLovin;
// ...

AppLovin.SetHasUserConsent(true);

此外，如果使用者屬於設有年齡限制的類別，您也可以將下列旗標設為 true。

AppLovin.SetIsAgeRestrictedUser(true);

詳情請參閱 AppLovin 的隱私權設定。

美國州級隱私權法律

美國各州隱私權法規定，使用者有權選擇拒絕「販售」其「個人資訊」(如該法案對「販售」與「個人資訊」這兩個詞的定義)，且「賣方」必須在首頁上提供顯眼的「請勿銷售我的個人資訊」連結，供使用者使用。《美國州級隱私權法律法規遵循指南》提供啟用 Google 廣告放送「受限的資料處理」模式的功能，但 Google 無法將這項設定套用至中介服務鏈中的每個廣告聯播網。因此，您必須找出中介服務鏈中可能參與銷售個人資訊的每個廣告聯播網，並遵循這些聯播網的指引，確保符合規定。

適用於 AppLovin 的 Google Mobile Ads 中介服務外掛程式 6.3.1 版包含 AppLovin.SetDoNotSell() 方法。下列程式碼範例說明如何將同意聲明資訊傳遞至 AppLovin SDK。您必須先設定這些選項，再初始化 Google Mobile Ads SDK，確保這些選項能正確轉送至 AppLovin SDK。

using GoogleMobileAds.Api.Mediation.AppLovin;
// ...

AppLovin.SetDoNotSell(true);

詳情請參閱 AppLovin 的隱私權文件。

步驟 5：新增必要程式碼

Android

整合 AppLovin 時，不需要額外程式碼。

iOS

整合 SKAdNetwork

請按照 AppLovin 的說明文件，將 SKAdNetwork ID 新增至專案的 Info.plist` 檔案。

步驟 6：測試實作成果

啟用測試廣告

請務必註冊測試裝置，並在 Applovin 使用者介面中啟用測試模式。

驗證測試廣告

如要確認您是否收到來自 Applovin 的測試廣告，請使用Applovin (出價) 和 Applovin (刊登序列) 廣告來源，在廣告檢查器中啟用單一廣告來源測試。

選擇性步驟

最佳化

在啟動活動中加入對 AppLovin.Initialize() 的呼叫，可讓 AppLovin 在應用程式啟動後立即追蹤事件。

錯誤代碼

如果介面卡無法從 AppLovin 接收廣告，發布商可以使用下列類別下的 ResponseInfo，從廣告回應中檢查基礎錯誤：

Android

com.google.ads.mediation.applovin.mediation.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter

iOS

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

以下是廣告無法載入時，AppLovin 轉接程式擲回的代碼和隨附訊息：

Android

錯誤代碼	原因
-1009 至 -1, 204	AppLovin SDK 傳回錯誤。詳情請參閱 AppLovin 說明文件。
101	要求的廣告大小不符合 AppLovin 支援的橫幅大小。
103	內容為空值。
104	AppLovin 出價權杖為空白。
105	針對同一區域要求多個廣告。每個區域一次只能載入 1 則廣告。
106	廣告尚未準備就緒，無法顯示。
108	AppLovin 轉接程式不支援要求的廣告格式。
109	Context 不是 Activity 執行個體。
110	無效的伺服器參數 (例如 SDK 金鑰為空值)。
112	使用者是孩童。

iOS

錯誤代碼	原因
-1009 至 -1, 204	AppLovin SDK 傳回錯誤。詳情請參閱 AppLovin 說明文件。
101	要求的廣告大小不符合 AppLovin 支援的橫幅大小。
102	在 AdMob 使用者介面中設定的 AppLovin 伺服器參數遺失/無效。
103	無法顯示 AppLovin 廣告。
104	針對同一區域要求多個廣告。每個區域一次只能載入 1 則廣告。
105	找不到 AppLovin SDK 金鑰。
107	出價權杖為空白。
108	AppLovin 轉接程式不支援要求的廣告格式。
110	AppLovin 傳送了載入成功的回呼，但載入的廣告數量為零。
111	無法擷取 AppLovin SDK 的執行個體。
112	使用者是孩童。
113	尚未初始化 AppLovin SDK 共用執行個體。
114	AppLovin SDK 無法傳回出價權杖。