本頁面由 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 帳戶。

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

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

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

出價

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

瀑布

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

建立區域

出價

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

瀑布

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

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

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

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

開啟測試模式

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

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

登入 Ad Manager 帳戶。

在「公司」中新增 Applovin

出價

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

瀑布

依序前往「管理」 >「公司」，然後點選「所有公司」分頁中的「新增公司」按鈕。選取「廣告聯播網」。

選取 Applovin 做為廣告聯播網，輸入專屬的名稱，並啟用中介服務。開啟「自動資料收集」，然後輸入前一個部分取得的「報表索引鍵」。

您不需要輸入使用者名稱或密碼。完成後，請按一下「儲存」。

啟用安全信號共用

出價

依序前往「管理」 >「通用設定」。前往「Ad Exchange 帳戶設定」分頁標籤，查看並開啟「安全信號共用」切換鈕。按一下「儲存」。

瀑布

瀑布式整合不必執行這個步驟。

設定 Applovin 出價

出價

前往「廣告放送」 >「出價方」，然後點選「SDK 出價」分頁標籤下方的「新增出價方」。

選取 Applovin 做為出價方。

開啟「將此出價方的信號程式庫加入信號許可清單」和「允許與這個出價方共用信號」。然後按一下「繼續」。

按一下「繼續」。

按一下 [完成]。

瀑布

瀑布式整合不必執行這個步驟。

設定廣告單元對應

出價

依序前往「廣告放送」 >「出價方」，然後在「SDK 出價」分頁下方選取 Applovin 的公司名稱。

前往「廣告單元對應」分頁，然後點選「新增廣告單元對應」。

選擇「特定廣告單元」。選取廣告單元和格式、行動應用程式做為廣告空間類型，以及您的行動應用程式。接著，輸入前一個部分取得的 SDK 金鑰。最後，按一下「儲存」。

瀑布

依序前往「廣告放送」 >「收益群組」，然後按一下「新增收益群組」按鈕。選取行動應用程式。

向下捲動並按一下「新增收益夥伴」。

選取您在上一節為 Applovin 建立的公司。請選擇「Mobile SDK 中介服務」做為「整合類型」，選擇「iOS」做為「平台」，並選擇「有效」做為「狀態」。

輸入應用程式的套件 ID，以及在上一節取得的SDK 索引鍵和區域 ID，以及預設千次曝光定價值。按一下「儲存」。

注意：自動資料收集功能需要幾天的時間來收集資料，才能準確計算中介服務聯播網的動態千次曝光出價。計算出有效千次曝光出價後，系統會自動為您更新。

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

請按照GDPR 設定和美國州級法規設定中的步驟操作，將 Applovin Corp. 新增至 Ad Manager UI 中的 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：測試導入作業

啟用測試廣告

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

驗證測試廣告

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

選擇性步驟

網路專屬參數

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

Swift

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

Objective-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	使用者是兒童。