將 AppLovin 與中介服務整合

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

支援的整合和廣告格式

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

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

¹ 只有中介服務支援橫幅廣告 (不含 MREC 橫幅廣告)。出價不支援任何類型的橫幅廣告。

需求條件

• 最新版 Google Mobile Ads SDK
• Flutter 3.7.0 以上版本
• 如何在 Android 上部署
  • Android API 級別 21 以上
• 如何在 iOS 上部署應用程式
  • iOS 部署目標為 12.0 以上版本
• 使用 Google Mobile Ads SDK 設定的正常運作 Flutter 專案。詳情請參閱「開始使用」一文。
• 完成中介服務入門指南

步驟 1：在 AppLovin UI 中設定

註冊或登入 AppLovin 帳戶。

如要設定 AdMob 廣告單元，您需要 AppLovin 的 SDK 金鑰和 報表金鑰。如要查看這兩個值，請依序前往 AppLovin UI >「帳戶」 >「鍵」，即可查看這兩個值。

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

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

出價

出價整合不必執行這個步驟。

瀑布

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

建立區域

出價

出價整合不必執行這個步驟。

瀑布

在 AppLovin UI 中，選取「營利」部分下方的「區域」，即可前往已註冊的區域 ID。如果您已為應用程式建立必要的區域，請直接跳到步驟 2。如要建立新的區域 ID，請按一下「建立區域」。

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

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

Android

iOS

建立區域後，您可以在「區域 ID」欄下方找到區域 ID。

Android

iOS

注意： 強烈建議您為每個 AdMob 廣告單元建立對應的 AppLovin 區域，以便 AdMob 更有效地在中介服務中最佳化廣告來源。

開啟測試模式

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

步驟 2：在 AdMob UI 中設定 AppLovin 需求

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

Android

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

iOS

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

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

重要事項： 請確認您具備帳戶管理權限，才能完成歐盟同意聲明和《一般資料保護規範》、《加州隱私權法案》和使用者訊息平台的設定。詳情請參閱「管理帳戶的使用者存取權」。

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

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

注意： 如果未整合相容的 AppLovin 和 Google Mobile Ads SDK 版本，可能會導致建構問題。

透過 pub.dev 整合

在套件的 pubspec.yaml 檔案中，新增下列依附元件，其中包含最新版本的 Applovin SDK 和轉接程式：

dependencies:
  gma_mediation_applovin: ^1.0.0

手動整合

請下載最新版的 Applovin 專用 Google 行動廣告中介服務外掛程式，解壓縮下載的檔案，然後將解壓縮的插件資料夾 (及其內容) 新增至 Flutter 專案。接著，請新增下列依附元件，在 pubspec.yaml 檔案中參照外掛程式：

dependencies:
  gma_mediation_applovin:
    path: path/to/local/package

步驟 4：在 AppLovin SDK 中實作隱私權設定

歐盟同意聲明和 GDPR

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

AppLovin 支援從共用偏好設定檔讀取同意聲明字串，並據此設定同意聲明狀態。

如果您未使用會將同意聲明字串寫入共用偏好的 CMP，可以使用 GmaMediationApplovin.setHasUserConsent() 和 GmaMediationApplovin.setIsAgeRestrictedUser() 方法。以下程式碼範例說明如何將同意資訊傳送至 AppLovin SDK。您必須先設定這些選項，再初始化 Google Mobile Ads SDK，才能確保這些選項能正確轉送至 AppLovin SDK。

import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...

GmaMediationApplovin.setHasUserConsent(true);
GmaMediationApplovin.setIsAgeRestrictedUser(true);

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

美國州級隱私權法律

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

AppLovin 適用的 Google 行動廣告中介外掛程式包含 GmaMediationApplovin.setDoNotSell() 方法。以下程式碼範例說明如何將同意資訊傳送至 AppLovin SDK。您必須先初始化 Google Mobile Ads SDK，再設定這些選項，確保這些選項能正確轉送至 AppLovin SDK。

import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...

GmaMediationApplovin.setDoNotSell(true);

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

步驟 5：新增必要程式碼

Android

您不需要額外程式碼即可整合 AppLovin。

iOS

SKAdNetwork 整合

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

步驟 6：測試導入作業

啟用測試廣告

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

重要事項： 在發布應用程式前，請停用 AdMob 和 Applovin 的測試模式。

驗證測試廣告

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

選擇性步驟

網路專屬參數

AppLovin 轉接器支援將 AppLovinMediationExtras 物件傳遞至廣告請求，以設定網路專屬參數。以下程式碼範例說明如何使用 isMuted 參數停用影片廣告的音訊：

AppLovinMediationExtras applovinExtras = AppLovinMediationExtras(isMuted: true)

AdRequest request = AdRequest(
    keywords: <String>['foo', 'bar'],
    contentUrl: 'http://foo.com/bar.html',
    mediationExtras: [applovinExtras],
);

最佳化

在啟動活動中新增對 GmaMediationApplovin.initializeSdk('sdkKey') 的呼叫，可讓 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	為同一個區塊要求多個廣告。AppLovin 一次只能在每個區域載入 1 則廣告。
106	廣告尚未準備好顯示。
108	AppLovin 轉接程式不支援所要求的廣告格式。

iOS

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

AppLovin Flutter 中介服務轉接器變更記錄

下一個版本

• 使用 Google 行動廣告 Flutter 外掛程式 5.2.0 版進行建構及測試。

1.2.0

• 已確認與 AppLovin Android 轉接器 12.6.1.0 相容。
• 已確認與 AppLovin iOS 轉接器 12.6.1.0 相容。
• 使用 Google 行動廣告 Flutter 外掛程式 5.1.0 版進行建構及測試。

1.1.0

• GmaMediationApplovin 的 API 不再是靜態。
• 已確認與 AppLovin Android 轉接器 12.4.3.0 相容。
• 已確認與 AppLovin iOS 轉接器 12.4.2.0 相容。
• 使用 Google 行動廣告 Flutter 外掛程式 5.1.0 版進行建構及測試。

1.0.0

• 第 1 版。
• 已確認與 AppLovin Android 轉接器 12.3.0.0 相容
• 已確認與 AppLovin iOS 轉接器 12.2.1.0 相容
• 使用 Google 行動廣告 Flutter 外掛程式 5.0.0 版進行建構及測試。