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

將 Unity 廣告與中介服務整合

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

支援的整合和廣告格式

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

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

¹ 出價整合功能處於封閉式 Beta 版，請與客戶經理聯絡，要求取得存取權。

需求條件

iOS 部署目標為 12.0 以上版本

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

步驟 1：在 Unity Ads UI 中設定設定

註冊或登入 Unity Ads。

建立專案

在 Unity Ads 資訊主頁中，前往「Projects」，然後按一下「Create Project」。

填寫表單，然後按一下「Create Project」新增專案。

依序前往「營利」 >「開始使用」，然後點選「開始使用」。

在「Project Setup」互動視窗中，選取「I plan to use Mediation」，並在「Mediation Partner」中選取「Google AdMob」，然後按一下「Next」。

選取廣告設定，然後點選「下一步」。

填寫表單，然後點選「新增專案」。

記下遊戲 ID。

建立廣告單元

依序前往「營利」 >「廣告單元」，然後按一下「新增廣告單元」。

輸入廣告單元名稱，然後選取平台和廣告格式。

最後，按一下「建立」即可儲存廣告單元。

新增刊登位置

出價

請與 Google 客戶經理聯絡，建立出價刊登位置。

瀑布

建立專案後，請依序前往「營利」 >「刊登位置」。如要建立新的刊登位置，請按一下廣告單元的「新增刊登位置」。

填寫必要詳細資料，然後按一下「新增刊登位置」。

記下刊登位置 ID。

找出 Unity Ads Reporting API 金鑰

出價

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

瀑布

除了 遊戲 ID 和 刊登位置 ID 之外，您還需要 Unity Ads API 金鑰和 機構組織核心 ID，才能設定 AdMob 廣告單元 ID。

依序前往「營利」 >「設定」 >「API 管理」，並記下「營利統計資料 API 存取金鑰」。

接著，依序前往「營利」 >「機構設定」，然後記下「機構核心 ID」。

開啟測試模式

您可以透過 Unity Ads 資訊主頁啟用測試模式。在專案設定下方，選取「Testing」分頁。

如要為應用程式強制啟用測試模式，請按一下「Apple App Store」旁邊的「編輯」按鈕，勾選「覆寫用戶端測試模式」，然後選取「為所有裝置強制啟用測試模式 (即使用測試廣告)」。

或者，您也可以按一下「新增測試裝置」按鈕，為特定裝置啟用測試模式。

填寫表單，然後按一下「儲存」。

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

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

您必須在廣告單元中介服務設定中加入 Unity Ads 。

首先，請登入 AdMob 帳戶。接著，前往「Mediation」分頁。如果您有要修改的現有中介服務群組，請按一下該中介服務群組的名稱進行編輯，然後跳到「新增 Unity Ads 做為廣告來源」一節。

如要建立新的中介服務群組，請選取「建立中介服務群組」。

輸入廣告格式和平台，然後按一下「繼續」。

為中介服務群組命名，並選取指定地區。接著，將中介服務群組狀態設為「已啟用」，然後按一下「新增廣告單元」。

將這個中介服務群組與一或多個現有的AdMob 廣告單元建立關聯。然後按一下「完成」。

您現在應該會看到廣告單元資訊卡，其中顯示您選取的廣告單元：

新增「 Unity Ads 」做為廣告來源

在「廣告來源」部分的「刊登序列」資訊卡下方，選取「新增廣告來源」。然後選取「Unity Ads」。

選取「Unity Ads」，然後啟用「最佳化」切換鈕。輸入先前取得的 API 金鑰和 機構核心 ID，為 Unity Ads 設定廣告來源最佳化。接著，輸入 Unity Ads 的有效千次曝光出價，然後按一下「繼續」。

如果您已為 Unity Ads 建立對應項目，請選取該項目。否則請按一下「新增對應」。

接著，輸入先前取得的 遊戲 ID 和 刊登位置 ID。然後按一下「完成」。

注意：廣告來源最佳化功能需要幾天的時間才能收集足夠的資料，準確計算中介服務聯播網的有效千次曝光出價。在此期間，廣告來源最佳化狀態為 PENDING，因此您必須手動設定聯播網的有效千次曝光出價。計算出有效千次曝光出價後，廣告來源就會自動開始為您更新有效千次曝光出價。

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

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

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

使用 CocoaPods (建議做法)

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

手動整合

下載最新版的 Unity Ads SDK，並在專案中連結 UnityAds.framework。
從Changelog 中的下載連結下載最新版 Unity Ads 轉接器，並連結專案中的 UnityAdapter.framework。

步驟 4：在 Unity Ads SDK 中導入隱私權設定

歐盟同意聲明和 GDPR

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

在 SDK 2.0.0 版中，Unity Ads 新增了一個 API 來支援隱私權設定。以下程式碼範例會說明如何將這項同意聲明資訊傳遞至 Unity Ads SDK。如果您選擇手動將同意資訊傳遞至 Unity Ads SDK，建議您在透過 Google Mobile Ads SDK 要求廣告之前，先呼叫這段程式碼。

Swift

import UnityAds
// ...

let gdprMetaData = UADSMetaData()
gdprMetaData.set("gdpr.consent", value: true)
gdprMetaData.commit()

Objective-C

#import <UnityAds/UnityAds.h>
// ...

UADSMetaData *gdprMetaData = [[UADSMetaData alloc] init];
[gdprMetaData set:@"gdpr.consent" value:@YES];
[gdprMetaData commit];

如需詳情和各個方法可提供的值，請參閱 Unity Ads 的隱私權同意聲明和資料 API 和遵循 GDPR 指南。

美國州級隱私權法律

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

Swift

import UnityAds
// ...

let ccpaMetaData = UADSMetaData()
ccpaMetaData.set("privacy.consent", value: true)
ccpaMetaData.commit()

Objective-C

#import <UnityAds/UnityAds.h>
// ...

UADSMetaData *ccpaMetaData = [[UADSMetaData alloc] init];
[ccpaMetaData set:@"privacy.consent" value:@YES];
[ccpaMetaData commit];

如需詳情和各個方法可提供的值，請參閱 Unity Ads 的隱私權同意聲明和資料 API，以及遵守 CCPA 和指南。

步驟 5：新增必要程式碼

SKAdNetwork 整合

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

編譯錯誤

Swift

整合 Swift 時不需要額外程式碼。

Objective-C

如果是 Unity Ads 轉接器 4.4.0.0 以上版本，您必須按照 Unity 說明文件中的整合步驟操作。

步驟 6：測試導入作業

啟用測試廣告

請務必為 AdMob 註冊測試裝置，並在 Unity Ads UI 中啟用測試模式。

驗證測試廣告

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

錯誤代碼

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

GADMAdapterUnity
GADMediationAdapterUnity

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

錯誤代碼	原因
0-9	UnityAds SDK 傳回錯誤。詳情請參閱 Unity 的說明文件。
101	在 AdMob UI 中設定的 UnityAds 伺服器參數遺失/無效。
102	裝置不支援 UnityAds。
103	UnityAds 完成顯示作業，錯誤狀態為 kUnityAdsFinishStateError。
104	呼叫初始化器後，Unity 廣告物件會變成空值。
105	廣告尚未就緒，因此無法顯示 Unity Ads。
106	UnityAds 呼叫了含有刊登位置狀態 kUnityAdsPlacementStateNoFill 的刊登位置變更回呼。
107	UnityAds 呼叫了含有刊登位置狀態 kUnityAdsPlacementStateDisabled 的刊登位置變更回呼。
108	這個刊登位置已載入廣告。UnityAds SDK 不支援為同一個刊登位置載入多個廣告。