將 AppLovin 與中介服務整合

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

支援的整合和廣告格式

AppLovin 的 AdMob 中介服務適配器具有下列功能：

¹ 只有中介服務支援橫幅廣告 (不含 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 的 MAX 測試模式指南操作說明，啟用 AppLovin 測試廣告。

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

調整廣告單元中介服務設定

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

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

步驟 3：匯入 AppLovin 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 目前無法自動將使用者的同意聲明選項傳送給這類網路。

如果您未使用將同意聲明字串寫入共用偏好設定的 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 Mobile Ads 中介外掛程式包含 GmaMediationApplovin.setDoNotSell() 方法。以下程式碼範例說明如何將同意資訊傳送至 AppLovin SDK。您必須先初始化 Google Mobile Ads SDK，再設定這些選項，確保這些選項能正確轉送至 AppLovin SDK。

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

GmaMediationApplovin.setDoNotSell(true);

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

步驟 5：新增必要的程式碼

步驟 6：測試實作成果

啟用測試廣告

請務必為 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，檢查廣告回應的底層錯誤：

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

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

以下是 AppLovin 轉接器在廣告載入失敗時，所擲回的程式碼和隨附訊息：

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 版進行建構及測試。