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

將 AppLovin 與中介服務整合

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

支援的整合和廣告格式

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

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

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

需求條件

iOS 部署目標為 12.0 以上版本
[出價]：AppLovin 轉接器 6.3.0.0 以上版本 (建議使用最新版本)

最新版 Google Mobile Ads SDK
完成中介服務入門指南

步驟 1：在 AppLovin UI 中設定

註冊或登入 AppLovin 帳戶。

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

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

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

出價

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

瀑布

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

建立區域

出價

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

瀑布

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

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

選取「Flat CPM」或「Optimized by AppLovin」，為區域設定「定價」。您可以為固定千次曝光出價選項，依國家/地區設定千次曝光出價。然後按一下「儲存」。

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

開啟測試模式

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

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

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

按照 GDPR 設定和美國州級法規設定中的步驟，在 AdMob UI 中將 Applovin Corp. 加入 GDPR 和美國州級法規廣告合作夥伴名單。

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

使用 CocoaPods (建議)

在專案的 Podfile 中加入以下行：
```
pod 'GoogleMobileAdsMediationAppLovin'
```
在指令列中執行：
```
pod install --repo-update
```

手動整合

下載最新版 AppLovin iOS SDK，並在專案中連結 ApplovinSDK.framework。
請從變更記錄中的下載連結，以及專案中的連結 ApplovinAdapter.framework 下載最新版的 AppLovin 轉接器。
將下列架構新增至專案：
- AdSupport
- AVFoundation
- CoreGraphics
- CoreMedia
- CoreTelephony
- StoreKit
- SystemConfiguration
- UIKit
- WebKit
- libz.tbd

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

歐盟同意聲明和 GDPR

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

自 SDK 12.0.0 版起，AppLovin 支援從UserDefaults讀取同意聲明字串，並據此設定同意聲明狀態。

如果您未使用 AppLovin SDK 12.0.0 以上版本，或未使用會將同意聲明字串寫入UserDefaults的 CMP，您可以使用 setHasUserContent 方法。以下範例會將同意資訊傳遞至 AppLovin SDK。您必須先設定這些選項，再初始化 Google Mobile Ads SDK，確保這些選項能正確轉送至 AppLovin SDK。

Swift

import AppLovinSDK
// ...

ALPrivacySettings.setHasUserConsent(true)

Objective-C

#import <AppLovinSDK/AppLovinSDK.h>
// ...

[ALPrivacySettings setHasUserConsent:YES];

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

宣告兒童使用者

自 AppLovin SDK 13.0.0 起，AppLovin 不再支援設有年齡限制的使用者旗標，您也不得在適用法律定義的「子項」中初始化或使用 AppLovin SDK。如需更多資訊，請參閱 AppLovin 的說明文件：禁止使用兒童資料或兒童專用服務/應用程式。

針對使用 Google Mobile Ads SDK 宣告下列任一項設定的應用程式，AppLovin 轉接器 13.0.0.1 以上版本會自動停用 AppLovin 中介服務：

如果您使用 AppLovin 轉接程式 12.6.1.0 以下版本，請參閱 AppLovin 的說明文件瞭解如何透過 AppLovin SDK 設定設有年齡限制的使用者標記。

美國州級隱私權法律

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

AppLovin SDK 包含 setDoNotSell 方法，可讓發布者選擇拒絕銷售個人資訊。

以下範例會將這項同意聲明資訊傳遞至 AppLovin SDK。您必須先設定這些選項，再初始化 Google Mobile Ads SDK，確保這些選項能正確轉送至 AppLovin SDK。

Swift

import AppLovinSDK
// ...

ALPrivacySettings.setDoNotSell(true)

Objective-C

#import <AppLovinSDK/AppLovinSDK.h>
// ...

[ALPrivacySettings setDoNotSell:YES];

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

步驟 5：新增必要程式碼

SKAdNetwork 整合

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

步驟 6：測試導入作業

啟用測試廣告

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

驗證測試廣告

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

選擇性步驟

聯播網專用參數

AppLovin 轉接器支援 muteAudio，這是可選的額外功能，可用來停用影片廣告的音訊。您可以使用 GADMAdapterAppLovinExtras 類別將此參數傳遞至轉接器，且必須在每個廣告請求中設定此參數。設定方式如下：

Swift

let request = GAMRequest()
let extras = GADMAdapterAppLovinExtras()
extras.muteAudio = false
request.register(extras)

目標-C

GAMRequest *request = [GAMRequest request];
GADMAdapterAppLovinExtras * extras = [[GADMAdapterAppLovinExtras alloc] init];
extras.muteAudio = NO;
[request registerAdNetworkExtras:extras];

最佳化

在應用程式啟動時立即初始化 AppLovin SDK，即可讓 AppLovin 在應用程式啟動時立即追蹤事件。

Swift

let sdk = ALSdk.shared(withKey: "sdkKey")
sdk?.initializeSdk()

Objective-C

ALSdk *sdk = [ALSdk sharedWithKey:@"sdkKey"];
[sdk initializeSdk];

錯誤代碼

如果轉接器無法從 AppLovin 接收廣告，發布商可以使用 GADResponseInfo.adNetworkInfoArray 在下列類別下：

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

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

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