歡迎加入 Google 廣告與評估社群伺服器的官方 Ad Manager Discord 頻道，與成員一起討論產品並提供意見回饋。

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

將 AppLovin 與中介服務整合

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

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

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

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

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

需求條件

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

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

註冊或登入 AppLovin 帳戶。

如要設定 Ad Manager 廣告單元，您需要 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 檔案。如果尚未建立，請為 Ad Manager 建立 app-ads.txt 檔案。

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

開啟測試模式

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

步驟 2：在 Ad Manager 使用者介面設定 AppLovin 需求

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

Android

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

iOS

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

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

請按照「歐洲法規設定」和「美國州級法規設定」中的步驟，在 Ad Manager 使用者介面，將 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 歐盟地區使用者同意聲明政策》，您必須向歐洲經濟區、英國和瑞士的使用者揭露特定資訊，並在法律有相關規定時，取得他們對使用 Cookie 或其他本機儲存空間的同意聲明，以及對收集、分享及使用個人資料進行廣告個人化的同意聲明。本政策是配合《歐盟地區電子通訊隱私指令》和《一般資料保護規則》(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：測試導入成果

啟用測試廣告

請務必為 Ad Manager 註冊測試裝置，並在 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	Ad Manager 使用者介面中設定的 AppLovin 伺服器參數遺失/無效。
103	無法顯示 AppLovin 廣告。
104	針對同一區域要求多個廣告。每個區域一次只能載入 1 則廣告。
105	找不到 AppLovin SDK 金鑰。
107	出價權杖為空白。
108	AppLovin 轉接程式不支援所請求的廣告格式。
110	AppLovin 已傳送成功載入回呼，但載入的廣告數量為零。
111	無法擷取 AppLovin SDK 的執行個體。
112	使用者是孩童。
113	AppLovin SDK 共用執行個體尚未初始化。
114	AppLovin SDK 無法傳回出價權杖。