將 AppLovin 與中介服務整合

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

支援的整合和廣告格式

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

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

橫幅廣告 (不包含 MREC 橫幅廣告) 只能在中介服務中使用。出價不支援任何類型的橫幅廣告。

需求條件

  • 最新版 Google Mobile Ads SDK
  • Unity 5.6 以上版本
  • [針對出價]:適用於 AppLovin 4.2.0 以上版本的 Google 行動廣告中介外掛程式 (建議使用最新版本)
  • 如何在 Android 上部署
    • Android API 級別 21 以上
  • 如何在 iOS 上部署
    • iOS 部署目標為 12.0 以上版本
  • 使用 Google Mobile Ads SDK 設定的有效 Unity 專案。詳情請參閱開始使用
  • 完成中介服務入門指南

步驟 1:在 AppLovin UI 中設定

註冊登入 AppLovin 帳戶。

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

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

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

出價

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

瀑布

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

建立區域

出價

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

瀑布

在 AppLovin UI 上,選取「Monetization」區段下方的「Zones」,以取得您註冊的區域 ID。如果您已為應用程式建立必要區域,請跳到步驟 2。如要建立新的區域 ID,請按一下「建立區域」

輸入「Zone ID」(區域 ID) 的名稱,選取「Android」做為「Platform」,然後選擇「Ad Type」

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

Android

iOS

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

Android

iOS

開啟測試模式

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

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

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

Android

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

iOS

相關操作說明請參閱 iOS 指南中的步驟 2。

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

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

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

OpenUPM-CLI

如果您已安裝 OpenUPM-CLI,只要從專案的根目錄執行下列指令,即可將 Google 行動廣告 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」套件,然後按一下 [安裝]。

透過 OpenUPM 安裝

Unity 套件

變更記錄中的下載連結,下載最新版的 AppLovin 專用 Google 行動廣告中介插件,然後從 ZIP 檔案中擷取 GoogleMobileAdsAppLovinMediation.unitypackage

在 Unity 專案編輯器中,依序選取「Assets」>「Import Package」>「Custom Package」,然後找出您下載的 GoogleMobileAdsAppLovinMediation.unitypackage 檔案。確認已選取所有檔案,然後按一下「Import」

從 Unity 匯入

接著,依序選取「Assets」>「External Dependency Manager」>「Android Resolver」>「Force Resolve」。外部依附元件管理員程式庫會從頭執行依附元件解析作業,並將已宣告的依附元件複製到 Unity 應用程式的 Assets/Plugins/Android 目錄中。

強制解析

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

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

自 Google 行動廣告中介外掛程式 7.0.0 版起, AppLovin 支援從共用偏好設定讀取同意聲明字串,並據此設定同意聲明狀態。

如果您未使用 Applovin 適用的 Google 行動廣告中介外掛程式 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:測試導入作業

啟用測試廣告

請務必為 AdMob 註冊測試裝置,並在 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 為同一個區塊要求多個廣告。AppLovin 一次只能在每個區域載入 1 則廣告。
106 廣告尚未準備好顯示。
108 AppLovin 轉接程式不支援所要求的廣告格式。

iOS

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

AppLovin Unity 中介服務外掛程式變更記錄

8.0.2 版

7.4.1 版

7.4.0 版

7.3.1 版

7.3.0 版

7.2.2 版

7.2.1 版

7.2.0 版

7.1.0 版

7.0.1 版

7.0.0 版

6.9.1 版

6.9.0 版

6.8.0 版

6.7.0 版

6.6.0 版

6.5.1 版

6.5.0 版

6.4.3 版

6.4.2 版

6.4.1 版

6.4.0 版

6.3.1 版

6.3.0 版

6.2.1 版

6.2.0 版

6.1.0 版

6.0.0 版

5.1.3 版

5.1.2 版

5.1.1 版

5.1.0 版

5.0.0 版

4.8.1 版

4.8.0 版

4.7.0 版

4.6.2 版

4.6.1 版

4.6.0 版

4.5.8 版

4.5.7 版

4.5.6 版

4.5.5 版

4.5.4 版

4.5.3 版

4.5.2 版

4.5.1 版

4.5.0 版

4.4.1 版

4.4.0 版

4.3.0 版

4.2.0 版

  • 支援 AppLovin Android 轉接程式 9.4.2.0 版。
  • 支援 AppLovin iOS 轉接器 6.6.1.0 版。

版本 4.1.0

  • 更新外掛程式,以支援新的公開測試版 Rewarded API。
  • 支援 AppLovin Android 轉接器 9.2.1.1 版。
  • 支援 AppLovin iOS 轉接程式 6.3.0.0 版。

4.0.0 版

  • 支援 AppLovin Android 轉接器 9.2.1.0 版。
  • 支援 AppLovin iOS 轉接程式 6.2.0.0 版。

3.1.2 版

  • 支援 AppLovin Android 轉接器 8.1.4.0 版。
  • 支援 AppLovin iOS 轉接程式 5.1.2.0 版。

3.1.1 版本

  • 支援 AppLovin Android 轉接器 8.1.0.0 版。
  • 支援 AppLovin iOS 轉接器 5.1.1.0 版。

3.1.0 版本

  • 支援 AppLovin Android 轉接器 8.1.0.0 版。
  • 支援 AppLovin iOS 轉接器 5.1.0.0 版。

3.0.3 版

  • 支援 AppLovin Android 轉接器 8.0.2.1 版。
  • 支援 AppLovin iOS 轉接器 5.0.2.0 版。

3.0.2 版

  • 支援 AppLovin Android SDK 8.0.1 版。
  • 支援 AppLovin iOS SDK 5.0.1 版。

3.0.1 版本

  • 支援 AppLovin Android SDK 8.0.0 版。
  • 支援 AppLovin iOS SDK 5.0.1 版。
  • 新增 AppLovin.SetIsAgeRestrictedUser() 方法,用於指出使用者是否屬於年齡限制類別。

3.0.0 版本

  • 支援 AppLovin Android SDK 8.0.0 版。
  • 支援 AppLovin iOS SDK 5.0.1 版。
  • 新增 AppLovin.SetHasUserConsent() 方法,將使用者同意聲明標記轉送至 AppLovin SDK。

2.0.0 版

  • 支援 AppLovin Android SDK 7.8.6 版。
  • 支援 AppLovin iOS SDK 5.0.1 版。

1.2.1 版本

  • 支援 AppLovin Android SDK 7.8.6 版。
  • 支援 AppLovin iOS SDK 4.8.3 版。

1.2.0 版本

  • 支援 AppLovin Android SDK 7.8.5 版。
  • 支援 AppLovin iOS SDK 4.8.3 版。

1.1.0 版本

  • 支援 AppLovin Android SDK 7.7.0 版。
  • 支援 AppLovin iOS SDK 4.7.0 版。

1.0.0 版本

  • 第一版!
  • 支援 AppLovin Android SDK 7.4.1 版。
  • 支援 AppLovin iOS SDK 4.4.1 版。